Share via


DDCOLORCONTROL

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This structure defines the color controls associated with a DirectDrawVideoPort object, 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;

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::GetColorControls method, it also indicates which options are supported by the device.

    The following table shows the possible flags.

    Flag Description

    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 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