Fonction CMTranslateColors (icm.h)

Article
02/26/2024

Traduit un tableau de couleurs d’un espace de couleurs source en espace de couleur de destination à l’aide d’une transformation de couleur.

Syntaxe

BOOL CMTranslateColors(
  HCMTRANSFORM hcmTransform,
  LPCOLOR      lpaInputColors,
  DWORD        nColors,
  COLORTYPE    ctInput,
  LPCOLOR      lpaOutputColors,
  COLORTYPE    ctOutput
);

Paramètres

hcmTransform

Spécifie la transformation de couleur à utiliser.

lpaInputColors

Pointe vers un tableau de structures COLOR à traduire.

nColors

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

ctInput

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

lpaOutputColors

Pointe vers une mémoire tampon dans laquelle un tableau de structures COLOR traduites doit être placé.

ctOutput

Spécifie le type de couleur de sortie.

Valeur retournée

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

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

Remarques

Chaque CMM est nécessaire pour exporter cette fonction.

Si les types de couleurs d’entrée et de sortie ne sont pas compatibles avec la transformation de couleur, cette fonction doit échouer.

Notez que cette fonction doit prendre en charge la traduction sur place. Autrement dit, chaque fois que l’empreinte mémoire de la sortie est inférieure ou égale à l’empreinte mémoire de l’entrée, cette fonction doit être en mesure de traduire les couleurs bitmap même si les mémoires tampons source et de destination sont identiques.

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

Partager via