Struttura DDCOLORCONTROL (ddraw.h)

La struttura DDCOLORCONTROL definisce i controlli colore associati a un oggetto VPE (Video Port Extensions) di Microsoft DirectDraw.

Sintassi

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;

Members

dwSize

Specifica le dimensioni in byte della struttura DDCOLORCONTROL.

dwFlags

Indica un set di flag che specificano i membri della struttura che contengono dati validi. Quando la struttura viene restituita da DdVideoPortColorControl, indica anche quali opzioni sono supportate dall'oggetto VPE. Questo membro può essere un OR bit per bit dei valori elencati nella tabella seguente.

Contrassegno	Significato
DDCOLOR_BRIGHTNESS	Il membro lBrightness contiene dati validi.
DDCOLOR_CONTRAST	Il membro lContrast contiene dati validi.
DDCOLOR_COLORENABLE	Il membro lColorEnable contiene dati validi.
DDCOLOR_GAMMA	Il membro lGamma contiene dati validi.
DDCOLOR_HUE	Il membro lHue contiene dati validi.
DDCOLOR_SATURATION	Il membro lSaturation contiene dati validi.
DDCOLOR_SHARPNESS	Il membro lSharpness contiene dati validi.

lBrightness

Specifica l'intensità di luminanza (livello nero), in unità IRE*100. Questo membro può variare da 0 a 10.000, con un valore predefinito pari a 750 (7,5 IRE).

lContrast

Specifica la differenza relativa tra valori di luminanza di intensità superiore e inferiore, in unità IRE*100. Questo membro può variare da 0 a 20.000, con un valore predefinito di 10.000 (100 IRE). I valori più alti del contrasto causano la tendenza dei valori di luminanza più scuri verso il nero e causano la tendenza dei valori di luminanza più chiari verso il bianco. I valori inferiori del contrasto causano lo spostamento di tutti i valori di luminanza verso i valori di luminanza centrale.

lHue

Specifica la relazione di fase dei componenti di dominanza. Hue viene specificato in gradi, con un intervallo valido compreso tra -180 e 180. Il valore predefinito è 0 gradi.

lSaturation

Specifica l'intensità del colore, in unità IRE*100. Questo membro può variare da 0 a 20.000, con un valore predefinito di 10.000 (100 IRE).

lSharpness

Specifica la nitidezza in unità arbitrarie. L'intervallo valido è compreso tra 0 e 10, con un valore predefinito pari a 5.

lGamma

Controlla la quantità di correzione gamma applicata ai valori di luminanza. L'intervallo valido è compreso tra 1 e 500 unità gamma, con valore predefinito 1.

lColorEnable

Specifica un flag che indica se viene utilizzato il colore. Se questo membro è zero, il colore non viene utilizzato; se è 1, viene usato il colore. Il valore predefinito è 1.

dwReserved1

Riservato per l'uso del sistema e deve essere ignorato.

Requisiti

Requisito	Valore
Intestazione	ddraw.h

Vedi anche

• DdVideoPortColorControl