References ▼
Describes color effects.
typedef struct{BOOL bEnabled;long lBrightness;long lContrast;long lHue;long lSaturation;BOOL bInvert;BOOL bDEnabled;long lDBrightness;long lDContrast;long lDHue;long lDSaturation;BOOL bDInvert;} COLOR_ATTRIBUTES;
TRUE to enable effects.
The relative lightness or darkness of a color. Value range: -100 to 100.
Describes apparent difference in lightness between lighter and darker pixels. Value range: -100 to 100.
The color reflected from or transmitted through an object. Value range: -180 to 180.
The strength or purity of a color. Value range: -100 to 100.
TRUE to invert colors.
Default enable effects
Default brightness value. Original default value is 10.
Default contrast value. Original default value is 0.
Default Hue value. Original default value is 0.
Default Saturation value. Original default value is 0.
Default Invert value. Original default value is FALSE.
Describes cropping area.
typedef struct{long lLeft;long lTop;long lRight;long lBottom;BOOL bEnabled;long lDLeft;long lDTop;long lDRight;long lDBottom;BOOL bDEnabled;} CROP_ATTRIBUTES;
The left coordinate of the cropped rectangle. The default value is 0.
The top coordinate of the cropped rectangle. The default value is 0.
The right coordinate of the cropped rectangle. The default value is 1.
The bottom coordinate of the cropped rectangle. The default value is 1.
Flag that indicates whether to enable or disable affect area. Possible values are:
| Value | Meaning |
|---|---|
| TRUE | Enable affect area. |
| FALSE | Disable affect area. |
Default left.
Default top.
Default right.
Default bottom.
Default effect area enable status
Retrieves the current effect area attributes.
A valid pointer to a CROP_ATTRIBUTES structure to be updated with the current effect area attributes.
| Return | Description |
|---|---|
| S_OK | Successful. |
| < 0 | An error occurred. |
Sets the effect area attributes. If successful, effect is applied only to the passed rectangle.
A CROP_ATTRIBUTES structure that contains the effect area attributes to set.
| Return | Description |
|---|---|
| S_OK | Successful. |
| < 0 | An error occurred. |
Determines whether the filter input pin is currently connected.
| Return | Description |
|---|---|
| S_OK | Connected. |
| S_FALSE | Otherwise. |
Determines whether the filter output pin is currently connected.
| Return | Description |
|---|---|
| S_OK | Connected. |
| S_FALSE | Otherwise. |
Sets the color attribute. Attributes are set permanently, cant be canceled, and if the filter is streaming, effect will take place immediately.
A COLOR_ATTRIBUTES structure that contains color attributes to set.
| Return | Description |
|---|---|
| S_OK | Successful. |
| S_FALSE | Otherwise. |
Retrieves the current color attributes.
A valid pointer to a COLOR_ATTRIBUTES structure to be updated with the current settings.
| Return | Description |
|---|---|
| S_OK | Successful. |
| S_FALSE | Otherwise. |
Retrieves the current media dimensions.
A valid pointer to a long variable to be updated with the input media width. NULL can be passed if this value is not needed.
A valid pointer to a long variable to be updated with the input media height. NULL can be passed if this value is not needed.
A valid pointer to a long variable to be updated with the output media width. NULL can be passed if this value is not needed.
A valid pointer to a long variable to be updated with the output media height. NULL can be passed if this value is not needed.
| Return | Description |
|---|---|
| S_OK | Successful. |
| S_FALSE | Otherwise. |
Gets the bits per pixel of the current connected input and output media formats.
A valid pointer to an integer to be updated with the input media bits per pixel value. NULL can be passed if this value is not needed.
A valid pointer to an integer to be updated with the output media bits per pixel value. NULL can be passed if this value is not needed.
| Return | Description |
|---|---|
| S_OK | Successful. |
| S_FALSE | Otherwise. |