CSPROPERTY_VIDCAP_VIDEOPROCAMP (Windows Embedded CE 6.0)
1/6/2010
This enumeration defines values that represent the properties in the PROPSETID_VIDCAP_VIDEOPROCAMP property set.
Syntax
typedef enum {
CSPROPERTY_VIDEOPROCAMP_BRIGHTNESS,
CSPROPERTY_VIDEOPROCAMP_CONTRAST,
CSPROPERTY_VIDEOPROCAMP_HUE,
CSPROPERTY_VIDEOPROCAMP_SATURATION,
CSPROPERTY_VIDEOPROCAMP_SHARPNESS,
CSPROPERTY_VIDEOPROCAMP_GAMMA,
CSPROPERTY_VIDEOPROCAMP_COLORENABLE,
CSPROPERTY_VIDEOPROCAMP_WHITEBALANCE,
CSPROPERTY_VIDEOPROCAMP_BACKLIGHT_COMPENSATION,
CSPROPERTY_VIDEOPROCAMP_GAIN,
} CSPROPERTY_VIDCAP_VIDEOPROCAMP;
Elements
CSPROPERTY_VIDEOPROCAMP_BRIGHTNESS
Used to set and get the brightness setting. This property is optional.The property value (operation data) is a LONG.
The Value member of the CSPROPERTY_VIDEOPROCAMP_S structure is used to specify the brightness. This value is expressed in IRE units times 100 for NTSC sources. For non-NTSC sources, the units are arbitrary, with 0 representing blanking and 10000 representing pure white.
Every video capture minidriver must define a range and default value for this property. The required range must be -10000 through +10000. The default value must be 750 (7.5 IRE).
Brightness is also known as the black level. Modifying the brightness setting shifts the entire video signal equally for all luminance values.
CSPROPERTY_VIDEOPROCAMP_CONTRAST
Used to set or get the camera's contrast (luma gain) setting. This property is optional.The property value (operation data) is a LONG.
The Value member of the CSPROPERTY_VIDEOPROCAMP_S structure is used to specify the contrast value. The contrast value is expressed as a gain factor multiplied by 100.
Every video capture minidriver must define a range and default value for the Value member of this property. The required range must be 0 to 10000. The default value must be 100 (1x).
CSPROPERTY_VIDEOPROCAMP_HUE
Used to set and get the hue setting of the camera. This property is optional.The property value (operation data) is a LONG.
The Value member of the CSPROPERTY_VIDEOPROCAMP_S structure is used to specify the hue setting. The value of the hue setting is expressed in degrees multiplied by 100.
Every video capture minidriver must define a range and default value for the Value member of this property. The required range must be -18000 to 18000 (-180 to +180 degrees). The default value must be 0.
CSPROPERTY_VIDEOPROCAMP_SATURATION
Used to set and get the saturation, or chroma gain, setting of the camera. This property is optional.The property value (operation data) is a LONG.
The Value member of the CSPROPERTY_VIDEOPROCAMP_S structure is used to specify the saturation setting. The value of the saturation setting is expressed as gain multiplied by 100.
Every video capture minidriver must define a range and default value for this property. The required range must be 0 through 10000. The default value must be 100 (1x).
CSPROPERTY_VIDEOPROCAMP_SHARPNESS
Used to set and get the camera's sharpness setting. This property is optional.The property value (operation data) is a LONG.
The Value member of the CSPROPERTY_VIDEOPROCAMP_S structure is used to specify the sharpness setting. Sharpness is expressed in arbitrary units.
Every video capture minidriver must define a range and default value for the value of this property. The required range must be 0 through 100. The default value must be 50.
CSPROPERTY_VIDEOPROCAMP_GAMMA
Used to get and set the camera's gamma setting. This property is optional.The property value (operation data) is a LONG.
The Value member of the CSPROPERTY_VIDEOPROCAMP_S structure is used to specify the gamma setting. The value of the gamma setting is expressed in gamma multiplied by 100.
Every video capture minidriver must define a range and default value for this property. The required range must be 1 through 500. The default value is typically 100 (gamma = 1) or 220 (gamma = 2.2), depending on the display medium and video hardware.
CSPROPERTY_VIDEOPROCAMP_COLORENABLE
Used to set and retrieve the color enable setting. This property is optional.The property value (operation data) is a LONG.
The Value member of the CSPROPERTY_VIDEOPROCAMP_S structure is used to specify the color enable setting. A value of 0 indicates that color is disabled. The default value of 1 indicates that color is enabled.
This value may be either 0 or 1. The default value for this property is 1
CSPROPERTY_VIDEOPROCAMP_WHITEBALANCE
Used to set or get the camera's white balance setting. This property is optional.The property value (operation data) is a LONG.
The Value member of the CSPROPERTY_VIDEOPROCAMP_S structure specifies the white balance setting. The white balance value is expressed as a color temperature, in degrees Kelvin.
The range and default value for white balance is device-dependent. Every video capture minidriver must define a range and default value for this property.
CSPROPERTY_VIDEOPROCAMP_BACKLIGHT_COMPENSATION
Used to set and get the backlight compensation setting on the camera. This property is optional.The property value (operation data) is a LONG.
The Value member of the CSPROPERTY_VIDEOPROCAMP_S structure is used to specify the backlight compensation. A value of 0 indicates that the backlight compensation is disabled. The default value of 1 indicates that the backlight compensation is enabled.
This value may be either 0 or 1. The default value for this property is 1.
The values used in the property sets are multiplied by 100 to give improved granularity.
CSPROPERTY_VIDEOPROCAMP_GAIN
Used to set or get the camera gain. This property is optional.The property value (operation data) is a LONG.
The Value member of the CSPROPERTY_VIDEOPROCAMP_S structure specifies the requested or current gain, depending on whether this is a get or set request.
The OEM defines the range for gain; the default resolution is 1.
Remarks
The following table summarizes the usages for the CSPROPERTY_VIDCAP_VIDEOPROCAMP property types.
| Property | Get | Set | Target | Property Descriptor Type | Property Value Type |
|---|---|---|---|---|---|
CSPROPERTY_VIDEOPROCAMP_BRIGHTNESS |
Yes |
Yes |
Filter |
LONG |
|
CSPROPERTY_VIDEOPROCAMP_CONTRAST |
Yes |
Yes |
Filter |
CSPROPERTY_VIDEOPROCAMP_S |
LONG |
CSPROPERTY_VIDEOPROCAMP_HUE |
Yes |
Yes |
Filter |
CSPROPERTY_VIDEOPROCAMP_S |
LONG |
CSPROPERTY_VIDEOPROCAMP_SATURATION |
Yes |
Yes |
Filter |
CSPROPERTY_VIDEOPROCAMP_S |
LONG |
CSPROPERTY_VIDEOPROCAMP_SHARPNESS |
Yes |
Yes |
Filter |
CSPROPERTY_VIDEOPROCAMP_S |
LONG |
CSPROPERTY_VIDEOPROCAMP_GAMMA |
Yes |
Yes |
Filter |
CSPROPERTY_VIDEOPROCAMP_S |
LONG |
CSPROPERTY_VIDEOPROCAMP_COLORENABLE |
Yes |
Yes |
Filter |
CSPROPERTY_VIDEOPROCAMP_S |
LONG |
CSPROPERTY_VIDEOPROCAMP_WHITEBALANCE |
Yes |
Yes |
Filter |
CSPROPERTY_VIDEOPROCAMP_S |
LONG |
CSPROPERTY_VIDEOPROCAMP_BACKLIGHT_COMPENSATION |
Yes |
Yes |
Filter |
CSPROPERTY_VIDEOPROCAMP_S |
LONG |
CSPROPERTY_VIDEOPROCAMP_GAIN |
Yes |
Yes |
Filter |
CSPROPERTY_VIDEOPROCAMP_S |
LONG |
Requirements
| Header | csmedia.h |
| Windows Embedded CE | Windows Embedded CE 6.0 and later |