STRUCTURE COLORADJUSTMENT (wingdi.h)

Article
03/13/2024

La structure COLORADJUSTMENT définit les valeurs d’ajustement des couleurs utilisées par les fonctions StretchBlt et StretchDIBits lorsque le mode stretch est HALFTONE. Vous pouvez définir les valeurs d’ajustement des couleurs en appelant la fonction SetColorAdjustment .

Syntaxe

typedef struct tagCOLORADJUSTMENT {
  WORD  caSize;
  WORD  caFlags;
  WORD  caIlluminantIndex;
  WORD  caRedGamma;
  WORD  caGreenGamma;
  WORD  caBlueGamma;
  WORD  caReferenceBlack;
  WORD  caReferenceWhite;
  SHORT caContrast;
  SHORT caBrightness;
  SHORT caColorfulness;
  SHORT caRedGreenTint;
} COLORADJUSTMENT, *PCOLORADJUSTMENT, *LPCOLORADJUSTMENT;

Membres

caSize

Taille de la structure en octets.

caFlags

Spécifie la façon dont l’image de sortie doit être préparée. Ce membre peut avoir la valeur NULL ou toute combinaison des valeurs suivantes.

Valeur	Signification
CA_NEGATIVE	Spécifie que le négatif de l’image d’origine doit être affiché.
CA_LOG_FILTER	Spécifie qu’une fonction logarithmique doit être appliquée à la densité finale des couleurs de sortie. Cela augmente le contraste des couleurs lorsque la luminance est faible.

caIlluminantIndex

Type de source de lumière standard sous laquelle l’image est vue. Ce membre peut être défini sur l’une des valeurs suivantes.

Valeur	Signification
ILLUMINANT_DEVICE_DEFAULT	Valeur par défaut de l’appareil. Standard utilisé par les appareils de sortie.
ILLUMINANT_A	Lampe en tungstène.
ILLUMINANT_B	Soleil de midi.
ILLUMINANT_C	NTSC jour.
ILLUMINANT_D50	Impression normale.
ILLUMINANT_D55	Imprimer du papier.
ILLUMINANT_D65	Lumière du jour standard. Standard pour les CRT et les images.
ILLUMINANT_D75	Lumière du nord.
ILLUMINANT_F2	Lampe blanche froide.
ILLUMINANT_TUNGSTEN	Identique à ILLUMINANT_A.
ILLUMINANT_DAYLIGHT	Identique à ILLUMINANT_C.
ILLUMINANT_FLUORESCENT	Identique à ILLUMINANT_F2.
ILLUMINANT_NTSC	Identique à ILLUMINANT_C.

caRedGamma

Spécifie la nième valeur de correction gamma de puissance pour la primaire rouge des couleurs source. La valeur doit être comprise entre 2500 et 65 000. Une valeur de 10 000 signifie aucune correction gamma.

caGreenGamma

Spécifie la nième valeur de correction gamma de puissance pour la primaire verte des couleurs sources. La valeur doit être comprise entre 2500 et 65 000. Une valeur de 10 000 signifie aucune correction gamma.

caBlueGamma

Spécifie la nième valeur de correction gamma de puissance pour le bleu primaire des couleurs sources. La valeur doit être comprise entre 2500 et 65 000. Une valeur de 10 000 signifie aucune correction gamma.

caReferenceBlack

Référence noire pour les couleurs source. Toutes les couleurs plus sombres que celles-ci sont traitées comme du noir. La valeur doit être comprise entre 0 et 4 000.

caReferenceWhite

Référence blanche pour les couleurs sources. Toutes les couleurs plus claires que celle-ci sont traitées comme du blanc. La valeur doit être comprise entre 6 000 et 10 000.

caContrast

Quantité de contraste à appliquer à l’objet source. La valeur doit être comprise entre -100 et 100. La valeur 0 signifie qu’aucun réglage de contraste n’est appliqué.

caBrightness

Quantité de luminosité à appliquer à l’objet source. La valeur doit être comprise entre -100 et 100. La valeur 0 signifie qu’il n’y a pas d’ajustement de luminosité.

caColorfulness

Quantité de couleurs à appliquer à l’objet source. La valeur doit être comprise entre -100 et 100. La valeur 0 signifie qu’il n’y a pas d’ajustement de la couleur.

caRedGreenTint

Quantité d’ajustement de teinte rouge ou verte à appliquer à l’objet source. La valeur doit être comprise entre -100 et 100. Les nombres positifs s’ajustent vers le rouge et les nombres négatifs s’ajustent vers le vert. Zéro signifie qu’il n’y a pas de réglage de teinte.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
En-tête	wingdi.h (inclure Windows.h)

Voir aussi

Bitmap Structures

Vue d’ensemble des bitmaps