Partager via

CheckColors, fonction (icm.h)

  • Article

Détermine si les couleurs d’un tableau se trouvent dans la gamme de sortie d’une transformation spécifiée.

Syntaxe

BOOL CheckColors(
  HTRANSFORM hColorTransform,
  PCOLOR     paInputColors,
  DWORD      nColors,
  COLORTYPE  ctInput,
  PBYTE      paResult
);

Paramètres

hColorTransform

Gérez la transformation de couleur à utiliser.

paInputColors

Pointeur vers un tableau de structures nColorsCOLOR à traduire.

nColors

Contient le nombre d’éléments dans les tableaux pointés par paInputColors et paResult.

ctInput

Spécifie le type de couleur d’entrée.

paResult

Pointeur vers un tableau d’octets nColors qui reçoit les résultats du test.

Valeur retournée

Si cette fonction réussit, la valeur de retour est TRUE.

Si cette fonction échoue, la valeur de retour est FALSE. Pour obtenir des informations d’erreur étendues, appelez GetLastError.

Remarques

Si le type de couleur d’entrée n’est pas compatible avec la transformation de couleur, CheckColors échoue.

La fonction place les résultats des tests dans le tableau pointé vers paResult. Chaque octet du tableau correspond à un élément COLOR dans le tableau pointé par paInputColors et a une valeur non signée comprise entre 0 et 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 n’importe quel 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 l’indique une valeur de résultat de n.

Les informations hors gamut dans les étiquettes gamut créées dans WCS utilisent la distance de couleur perceptive dans CIECAM02, qui est la racine carrée moyenne dans CIECAM02 espace Jab. La distance dans les balises de gamut de profil ICC héritées est la racine carrée moyenne dans l’espace CIELAB. Nous vous recommandons d’utiliser l’espace CIECAM02 lorsqu’il est disponible, car il fournit des métriques de distance plus précises.

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 icm.h
Bibliothèque Mscms.lib
DLL Mscms.dll

Voir aussi