DDCOLORCONTROL 結構 (ddraw.h)
DDCOLORCONTROL 結構會定義與 Microsoft DirectDraw 視訊埠延伸模組相關聯的色彩控件， (VPE) 物件。
語法
typedef struct _DDCOLORCONTROL {
DWORD dwSize;
DWORD dwFlags;
LONG lBrightness;
LONG lContrast;
LONG lHue;
LONG lSaturation;
LONG lSharpness;
LONG lGamma;
LONG lColorEnable;
DWORD dwReserved1;
} *LPDDCOLORCONTROL, DDCOLORCONTROL;
成員
dwSize
指定這個 DDCOLORCONTROL 結構的位元元組大小。
dwFlags
指出一組旗標，指定哪些結構成員包含有效的數據。 當 DdVideoPortColorControl 傳回 結構時，它也會指出 VPE 物件支援哪些選項。 此成員可以是下表所列值的位 OR。
| 旗標 | 意義 |
|---|---|
DDCOLOR_BRIGHTNESS |
lBrightness 成員包含有效的數據。 |
DDCOLOR_CONTRAST |
lContrast 成員包含有效的數據。 |
DDCOLOR_COLORENABLE |
lColorEnable 成員包含有效的數據。 |
DDCOLOR_GAMMA |
lGamma 成員包含有效的數據。 |
DDCOLOR_HUE |
lHue 成員包含有效的數據。 |
DDCOLOR_SATURATION |
lSaturation 成員包含有效的數據。 |
DDCOLOR_SHARPNESS |
lSharpness 成員包含有效的數據。 |
lBrightness
以 IRE 單位*100 指定黑色等級) (亮度。 此成員的範圍可以從 0 到 10,000，預設值為 750 (7.5 IRE) 。
lContrast
以 IRE 單位*100 指定較高和較低強度亮度值之間的相對差異。 此成員的範圍可以從 0 到 20,000，預設值為 10,000 (100 IRE) 。 較高的對比值會導致較深的亮度值傾向黑色，並導致較淺的亮度值傾向於白色。 較低的對比值會導致所有亮度值都移至中間的亮度值。
lHue
指定 chrominance 元件的階段關聯性。 Hue 是以度為單位指定，有效範圍為 -180 到 180。 預設值為 0 度。
lSaturation
以 IRE 單位*100 指定色彩強度。 此成員的範圍可以從 0 到 20,000，預設值為 10,000 (100 IRE) 。
lSharpness
指定任意單位的尖峰度。 有效範圍是 0 到 10，預設值為 5。
lGamma
控制套用至亮度值的 Gamma 校正數量。 有效範圍是 1 到 500 個 gamma 單位，預設值為 1。
lColorEnable
指定旗標，指出是否使用色彩。 如果這個成員為零，則不會使用色彩;如果是 1，則會使用色彩。 預設值為 1。
dwReserved1
保留供系統使用，且應予以忽略。
規格需求
| 需求 | 值 |
|---|---|
| 標頭 | ddraw.h |