CMCheckColors, fonction (icm.h)

Article
08/24/2023

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

Syntaxe

BOOL CMCheckColors(
  HCMTRANSFORM hcmTransform,
  LPCOLOR      lpaInputColors,
  DWORD        nColors,
  COLORTYPE    ctInput,
  LPBYTE       lpaResult
);

Paramètres

hcmTransform

Descripteur en transformation de couleur à utiliser.

lpaInputColors

Pointeur vers un tableau de structures COLOR pour case activée par rapport à la gamme de sortie.

nColors

Spécifie le nombre d'éléments du tableau.

ctInput

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

lpaResult

Pointeur vers une mémoire tampon dans laquelle placer un tableau d’octets contenant les résultats des tests. Chaque octet de la mémoire tampon correspond à une structure COLOR , et à la sortie a été défini sur 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 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 gamme que l’indique une valeur de résultat de n. Ces valeurs sont généralement générées à partir du gamutTag dans le profil ICC.

Valeur retournée

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

Si cette fonction échoue, la valeur de retour est FALSE. Si la fonction échoue, la CMM doit appeler SetLastError pour définir la dernière erreur sur une valeur d’erreur valide définie dans Winerror.h.

Notes

Chaque CMM est nécessaire pour exporter cette fonction.

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

Spécifications


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

Partager via