DDCOLORCONTROL-Struktur (ddraw.h)
Die DDCOLORCONTROL-Struktur definiert die Farbsteuerelemente, die einem VpE-Objekt (Microsoft DirectDraw Video Port Extensions) zugeordnet sind.
Syntax
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;
Member
dwSize
Gibt die Größe dieser DDCOLORCONTROL-Struktur in Byte an.
dwFlags
Gibt einen Satz von Flags an, die angeben, welche Strukturmember gültige Daten enthalten. Wenn die Struktur von DdVideoPortColorControl zurückgegeben wird, gibt sie auch an, welche Optionen vom VPE-Objekt unterstützt werden. Dieser Member kann ein bitweises OR der in der folgenden Tabelle aufgeführten Werte sein.
| Flag | Bedeutung |
|---|---|
DDCOLOR_BRIGHTNESS |
Das lBrightness-Element enthält gültige Daten. |
DDCOLOR_CONTRAST |
Das lContrast-Element enthält gültige Daten. |
DDCOLOR_COLORENABLE |
Das lColorEnable-Element enthält gültige Daten. |
DDCOLOR_GAMMA |
Das lGamma-Element enthält gültige Daten. |
DDCOLOR_HUE |
Das lHue-Element enthält gültige Daten. |
DDCOLOR_SATURATION |
Der lSaturation-Member enthält gültige Daten. |
DDCOLOR_SHARPNESS |
Das lSharpness-Element enthält gültige Daten. |
lBrightness
Gibt die Helligkeitsintensität (Schwarzstufe) in IRE-Einheiten*100 an. Dieser Member kann zwischen 0 und 10.000 liegen, wobei der Standardwert 750 (7,5 IRE) ist.
lContrast
Gibt den relativen Unterschied zwischen Werten mit höherer und niedrigerer Luminanz in IRE-Einheiten*100 an. Dieser Member kann zwischen 0 und 20.000 mit einem Standardwert von 10.000 (100 IRE) liegen. Höhere Kontrastwerte führen dazu, dass dunklere Leuchtdichtewerte zu Schwarz tendieren und hellere Leuchtdichtewerte zu Weiß neigen. Niedrigere Kontrastwerte bewirken, dass sich alle Leuchtdichtewerte in Richtung der mittleren Leuchtdichte bewegen.
lHue
Gibt die Phasenbeziehung der Chrominanzkomponenten an. Der Farbton wird in Grad mit einem gültigen Bereich von -180 bis 180 angegeben. Der Standardwert ist 0 Grad.
lSaturation
Gibt die Farbintensität in IRE-Einheiten*100 an. Dieser Member kann zwischen 0 und 20.000 mit einem Standardwert von 10.000 (100 IRE) liegen.
lSharpness
Gibt die Schärfe in beliebigen Einheiten an. Der gültige Bereich ist 0 bis 10, mit einem Standardwert von 5.
lGamma
Steuert die Menge der Gammakorrektur, die auf die Leuchtdichtewerte angewendet wird. Der gültige Bereich beträgt 1 bis 500 Gammaeinheiten, wobei der Standardwert 1 ist.
lColorEnable
Gibt ein Flag an, das angibt, ob Farbe verwendet wird. Wenn dieser Member 0 ist, wird keine Farbe verwendet. wenn es 1 ist, wird Farbe verwendet. Der Standardwert ist 1.
dwReserved1
Reserviert für die Systemverwendung und sollte ignoriert werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header | ddraw.h |