DDCOLORCONTROL

The DDCOLORCONTROL structure 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

Size of the structure, in bytes. This member must be initialized before the structure can be used.

dwFlags

The following flags specifying which structure members contain valid data . When the structure is returned by the IDirectDrawColorControl::GetColorControls method, it also indicates which options are supported by the device.

DDCOLOR_BRIGHTNESS

The lBrightness member contains valid data.

DDCOLOR_COLORENABLE

The lColorEnable member contains valid data.

DDCOLOR_CONTRAST

The lContrast member contains valid data.

DDCOLOR_GAMMA

The lGamma member contains valid data.

DDCOLOR_HUE

The lHue member contains valid data.

DDCOLOR_SATURATION

The lSaturation member contains valid data.

DDCOLOR_SHARPNESS

The lSharpness member contains valid data.

lBrightness

Luminance intensity, in IRE units times 100. The valid range is from 0 through 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 from 0 through 20,000. The default value is 10,000 (100 IRE). Higher values of contrast cause darker luminance values to tend toward black and lighter luminance values to tend toward white. Lower values of contrast cause all luminance values to move toward the middle of the scale.

lHue

Phase relationship of the chrominance components. Hue is specified in degrees, and the valid range is from –180 through 180, with a default of 0.

lSaturation

Color intensity, in IRE units times 100. The valid range is from 0 through 20,000. The default value is 10,000, which translates to 100 IRE.

lSharpness

Sharpness, in arbitrary units. The valid range is from 0 through 10, with a default of 5.

lGamma

Controls the amount of gamma correction applied to the luminance values. The valid range is from 1 through 500 gamma units, with a default of 1.

lColorEnable

Flag indicating whether color is used. If this member is 0, color is not used; if it is 1, color is used. The default value is 1.

dwReserved1

Reserved.

Requirements

  Windows NT/2000: Requires Windows 2000.
  Windows 95/98: Requires Windows 95 or later. Available as a redistributable for Windows 95.
  Header: Declared in ddraw.h.