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

Weitere Informationen

• DdVideoPortColorControl