Structure DDCOLORCONTROL (ddraw.h)

La structure DDCOLORCONTROL définit les contrôles de couleur associés à un objet d’extensions de port vidéo (VPE) Microsoft DirectDraw.

Syntaxe

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;

Membres

dwSize

Spécifie la taille en octets de cette structure DDCOLORCONTROL.

dwFlags

Indique un ensemble d’indicateurs qui spécifient quels membres de structure contiennent des données valides. Lorsque la structure est retournée par DdVideoPortColorControl, elle indique également les options prises en charge par l’objet VPE. Ce membre peut être un or au niveau du bit des valeurs répertoriées dans le tableau suivant.

Indicateur	Signification
DDCOLOR_BRIGHTNESS	Le membre lBrightness contient des données valides.
DDCOLOR_CONTRAST	Le membre lContrast contient des données valides.
DDCOLOR_COLORENABLE	Le membre lColorEnable contient des données valides.
DDCOLOR_GAMMA	Le membre lGamma contient des données valides.
DDCOLOR_HUE	Le membre lHue contient des données valides.
DDCOLOR_SATURATION	Le membre lSaturation contient des données valides.
DDCOLOR_SHARPNESS	Le membre lSharpness contient des données valides.

lBrightness

Spécifie l’intensité de la luminance (niveau noir), en unités IRE*100. Ce membre peut être comprise entre 0 et 10 000, avec une valeur par défaut de 750 (7,5 IRE).

lContrast

Spécifie la différence relative entre les valeurs de luminance d’intensité plus élevée et inférieure, en unités IRE*100. Ce membre peut être comprise entre 0 et 20 000, avec une valeur par défaut de 10 000 (100 IRE). Des valeurs de contraste plus élevées font que les valeurs de luminance plus sombres tendent vers le noir et que les valeurs de luminance plus claires tendent vers le blanc. Des valeurs de contraste inférieures entraînent le déplacement de toutes les valeurs de luminance vers les valeurs de luminance moyenne.

lHue

Spécifie la relation de phase des composants chrominance. La teinte est spécifiée en degrés, avec une plage valide de -180 à 180. La valeur par défaut est 0 degré.

lSaturation

Spécifie l’intensité de couleur, en unités IRE*100. Ce membre peut être comprise entre 0 et 20 000, avec une valeur par défaut de 10 000 (100 IRE).

lSharpness

Spécifie la netteté en unités arbitraires. La plage valide est comprise entre 0 et 10, avec une valeur par défaut de 5.

lGamma

Contrôle la quantité de correction gamma appliquée aux valeurs de luminance. La plage valide est comprise entre 1 et 500 unités gamma, avec une valeur par défaut de 1.

lColorEnable

Spécifie un indicateur indiquant si la couleur est utilisée. Si ce membre est égal à zéro, la couleur n’est pas utilisée ; si elle est 1, la couleur est utilisée. La valeur par défaut est 1.

dwReserved1

Réservés à l’utilisation du système et doivent être ignorés.

Configuration requise

Condition requise	Valeur
En-tête	ddraw.h

Voir aussi

• DdVideoPortColorControl