Microsoft Windows CE 3.0  

DDCOLORCONTROL

Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.

The DDCOLORCONTROLstructure defines the color controls associated with a DirectDrawVideoPortObject, an overlay surface, or a primary surface.

typedef struct _DDCOLORCONTROL {
DWORD
dwSize
;
DWORD
dwFlags
;
LONG
lBrightness
;
LONG
lContrast
;
LONG
lHue
;
LONG
lSaturation
;
LONG
lSharpness
;
LONG
lGamma
;
LONG
lColorEnable
;
DWORD
dwReserved1
;
} DDCOLORCONTROL, FAR *LPDDCOLORCONTROL;

Members

dwSize
The size of the structure, in bytes. This member must be initialized before use.
dwFlags
Flags specifying which structure members contain valid data. When the structure is returned by the IDirectDrawColorControl::GetColorControlsmethod, it also indicates which options are supported by the device.
DDCOLOR_BRIGHTNESS The lBrightnessmember contains valid data.
DDCOLOR_COLORENABLE The lColorEnablemember contains valid data.
DDCOLOR_CONTRAST The lContrastmember contains valid data.
DDCOLOR_GAMMA The lGammamember contains valid data.
DDCOLOR_HUE The lHuemember contains valid data.
DDCOLOR_SATURATION The lSaturationmember contains valid data.
DDCOLOR_SHARPNESS The lSharpnessmember contains valid data.
lBrightness
Luminance intensity, in IRE units times 100. The valid range is 0 to 10,000. The default is 750, which translates to 7.5 IRE.
lContrast
Relative difference between higher and lower intensity luminance values in IRE units times 100. The valid range is 0 to 20,000. The default value is 10,000 (100 IRE). Higher values of contrast cause darker luminance values to move towards black, and cause lighter luminance values to move towards white. Lower values of contrast cause all luminance values to move towards the middle luminance values.
lHue
Phase relationship of the chrominance components. Hue is specified in degrees and the valid range is –180 to 180. The default is zero.
lSaturation
Color intensity, in IRE units times 100. The valid range is 0 to 20,000. The default value is 10,000, (100 IRE).
lSharpness
Sharpness in arbitrary units. The valid range is 0 to 10. The default is 5.
lGamma
Controls the amount of gamma correction applied to the luminance values. The valid range is 1 to 500 gamma units, with a default of 1.
lColorEnable
Flag indicating whether color is used. If this member is zero, color is not used; if it is 1, then color is used. The default is 1.
dwReserved1
This member is reserved.

Requirements

Runs on Versions Declared in
Windows CE OS 2.12 or later. Version 2.12 requires DXPAK 1.0 or later. ddraw.h