CheckBitmapBitBits, fonction (icm.h)

Article
08/24/2023

Vérifie si les pixels d’un bitmap spécifié se trouvent dans la gamut de sortie d’une transformation spécifiée.

Syntaxe

BOOL CheckBitmapBits(
  HTRANSFORM    hColorTransform,
  PVOID         pSrcBits,
  BMFORMAT      bmInput,
  DWORD         dwWidth,
  DWORD         dwHeight,
  DWORD         dwStride,
  PBYTE         paResult,
  PBMCALLBACKFN pfnCallback,
  LPARAM        lpCallbackData
);

Paramètres

hColorTransform

Gérez la transformation de couleur à utiliser.

pSrcBits

Pointeur vers la bitmap vers case activée par rapport au gamut de sortie.

bmInput

Spécifie le format de l’image bitmap. Doit être défini sur l’une des valeurs du type énuméré BMFORMAT .

dwWidth

Spécifie le nombre de pixels par ligne d’analyse de la bitmap.

dwHeight

Spécifie le nombre de lignes d’analyse de l’image bitmap.

dwStride

Spécifie le nombre d’octets entre la ligne d’analyse de début et le début de la suivante. Si la valeur est égale à zéro, les lignes d’analyse bitmap sont supposées être rembourrées afin d’être alignées sur DWORD.

paResult

Pointeur vers un tableau d’octets où les résultats du test doivent être placés. Cette mémoire tampon de résultats doit contenir au moins autant d’octets que de pixels dans la bitmap.

pfnCallback

Pointeur vers une fonction de rappel appelée régulièrement par CheckBitmapBitBits pour signaler la progression et permettre au processus d’appel d’annuler le test bitmap. (Voir ICMProgressProcCallback).

lpCallbackData

Données transmises à la fonction de rappel, par exemple, pour identifier le test bitmap sur lequel la progression est signalée.

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. Pour obtenir des informations d’erreur étendues, appelez GetLastError.

Remarques

Si le format d’entrée n’est pas compatible avec la transformation de couleur, la fonction CheckBitmapBitBits échoue.

Cette fonction place les résultats des tests dans la mémoire tampon pointée par paResult. Chaque octet de la mémoire tampon correspond à un pixel dans la bitmap 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 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.

Lorsque l’un des BMFORMAT à virgule flottante, BM_32b_scARGB ou BM_32b_scRGB est utilisé, les données de couleur vérifiées ne doivent pas contenir de NaN ou d’infini. NaN et infinity ne sont pas considérés comme représentant des valeurs de composants de couleur légitimes, et le résultat de la vérification des pixels contenant naN ou infini n’a aucun sens en termes de couleur. Les valeurs NaN ou infini dans les données de couleur en cours de traitement seront gérées en mode silencieux et aucune erreur ne sera retournée.

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

Partager via