Fonction TranslateBitmapBits (icm.h)

Article
03/06/2024

Traduit les couleurs d’une bitmap ayant un format défini afin de produire une autre bitmap dans un format demandé.

Syntaxe

BOOL TranslateBitmapBits(
  HTRANSFORM    hColorTransform,
  PVOID         pSrcBits,
  BMFORMAT      bmInput,
  DWORD         dwWidth,
  DWORD         dwHeight,
  DWORD         dwInputStride,
  PVOID         pDestBits,
  BMFORMAT      bmOutput,
  DWORD         dwOutputStride,
  PBMCALLBACKFN pfnCallBack,
  LPARAM        ulCallbackData
);

Paramètres

hColorTransform

Identifie la transformation de couleur à utiliser.

pSrcBits

Pointeur vers la bitmap à traduire.

bmInput

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

Notes

Cette fonction ne prend pas en charge BM_XYZTRIPLETS ou BM_YxyTRIPLETS en tant qu’entrées.

dwWidth

Spécifie le nombre de pixels par ligne de balayage dans la bitmap d’entrée.

dwHeight

Spécifie le nombre de lignes d’analyse dans la bitmap d’entrée.

dwInputStride

Spécifie le nombre d’octets entre le début d’une ligne d’analyse et le début de la suivante dans la bitmap d’entrée ; si la valeur est égale à zéro, la fonction suppose que les lignes d’analyse sont remplies de manière à être alignées sur DWORD.

pDestBits

Pointeur vers la mémoire tampon dans laquelle placer la bitmap traduite.

bmOutput

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

dwOutputStride

Spécifie le nombre d’octets entre le début d’une ligne d’analyse et le début de la suivante dans la bitmap de sortie ; si la valeur est égale à zéro, la fonction suppose que les lignes d’analyse doivent être complétées pour être alignées sur DWORD.

pfnCallBack

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

ulCallbackData

Données renvoyées à la fonction de rappel, par exemple, pour identifier la traduction qui signale la progression.

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 les formats d’entrée et de sortie ne sont pas compatibles avec la transformation de couleur, cette fonction échoue.

Lorsque l’un des BMFORMAT à virgule flottante, BM_32b_scARGB ou BM_32b_scRGB sont utilisés, les données de couleur en cours de traduction ne doivent pas contenir de NaN ou d’infini. NaN et l’infini ne sont pas considérés comme représentant des valeurs légitimes des composants de couleur, et le résultat de la traduction de 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 sont gérées en mode silencieux et aucune erreur n’est retournée.

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