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
-
The 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.
DDCOLOR_BRIGHTNESS |
The iBrightness member contains valid data. |
DDCOLOR_CONTRAST |
The iContrast member contains valid data. |
DDCOLOR_COLORENABLE |
The lColorEnable member contains valid data. |
DDCOLOR_GAMMA |
The iGamma member contains valid data. |
DDCOLOR_HUE |
The iHue member contains valid data. |
DDCOLOR_SATURATION |
The iSaturation member contains valid data. |
DDCOLOR_SHARPNESS |
The iSharpness member contains valid data. |
-
lBrightness
-
Luminance intensity (Black Level) in IRE units*100. Range is 0 to 10,000. The default is 750 (7.5 IRE)
-
lContrast
-
Relative difference between higher and lower intensity luminance values in IRE units*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 tend towards black, and cause lighter luminance values to tend 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 0.
-
lSaturation
-
Color intensity in IRE units*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 value 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 value is 1.
-
dwReserved1
-
This member is reserved.
QuickInfo
Windows NT: Use version 5.0 or later.
Windows: Use Windows 95 or later. Available as a redistributable for Windows 95.
Windows CE: Unsupported.
Header: Declared in ddraw.h.