CheckColorsInGamut, fonction (wingdi.h)

Article
03/13/2024

La fonction CheckColorsInGamut détermine si un ensemble de triples RVB spécifié se trouve dans la gamme de sortie d’un appareil spécifié. Les triples RVB sont interprétés dans l’espace de couleurs logique d’entrée.

Syntaxe

BOOL CheckColorsInGamut(
  HDC         hdc,
  LPRGBTRIPLE lpRGBTriple,
  LPVOID      dlpBuffer,
  DWORD       nCount
);

Paramètres

hdc

Gérez le contexte de l’appareil dont la gamut de sortie doit être vérifiée.

lpRGBTriple

Pointeur vers un tableau de triples RVB vers case activée.

dlpBuffer

Pointeur vers la mémoire tampon dans laquelle les résultats doivent être placés. Cette mémoire tampon doit être d’au moins aussi grande que nCount octets.

nCount

Nombre d’éléments dans le tableau de triples.

Valeur retournée

Si cette fonction réussit, la valeur de retour est une valeur différente de zéro.

Si cette fonction échoue, la valeur de retour est zéro.

Remarques

La fonction place les résultats du test dans la mémoire tampon pointée vers lpBuffer. Chaque octet de la mémoire tampon correspond à un triple RVB et a une valeur non signée comprise entre CM_IN_GAMUT (= 0) et CM_OUT_OF_GAMUT (= 255). La valeur 0 indique que la couleur est en gamut, tandis qu’une valeur différente de zéro indique qu’elle est hors gamut. Pour tout entier n tel que 0 <n< 255, une valeur de résultat de n + 1 indique que la couleur correspondante est au moins aussi éloignée de la gamut que serait indiquée par une valeur de résultat de n, comme spécifié par la spécification de format de profil ICC. Pour plus d’informations sur la spécification de format de profil ICC, consultez les sources répertoriées dans Informations supplémentaires .

Notez que pour que cette fonction réussisse, WCS doit être activé pour le handle de contexte d’appareil transmis via le paramètre hDC . WCS peut être activé pour un handle de contexte d’appareil en appelant la fonction SetICMMode .

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]
Plateforme cible	Windows
En-tête	wingdi.h
Bibliothèque	Gdi32.lib
DLL	Gdi32.dll

Partager via