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.

A version of this page is also available for

4/8/2010

This structure defines the color controls associated with a DirectDrawVideoPortobject, an overlay surface, or a primary surface.

Syntax


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

typedef struct _DDCOLORCONTROL {
  DWORD 
dwSize;
  DWORD 
dwFlags;
  LONG 
lBrightness;
  LONG 
lContrast;
  LONG 
lHue;
  LONG 
lSaturation;
  LONG 
lSharpness;
  LONG 
lGamma;
  LONG 
lColorEnable;
} 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.

The following table shows the possible flags.

Flag	Description
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 toward black, and cause lighter luminance values to move toward white.

Lower values of contrast cause all luminance values to move toward 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.

The default is 1.

lColorEnable

Flag indicating whether color is used.

If this member is zero, color is not used.

If this member is 1, color is used.

The default is 1.

Requirements

Header	ddraw.h
Windows Embedded CE	Windows Embedded CE 6.0 and later
Windows Mobile	Pocket PC for Windows Mobile Version 5.0 and later, Smartphone for Windows Mobile Version 5.0 and later



DDCOLORCONTROL