Funzione CMTranslateColors (icm.h)

  • Articolo

Converte una matrice di colori da uno spazio colore di origine in uno spazio colori di destinazione usando una trasformazione di colore.

Sintassi

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

Parametri

hcmTransform

Specifica la trasformazione del colore da utilizzare.

lpaInputColors

Punta a una matrice di strutture COLOR da convertire.

nColors

Specifica il numero di elementi nella matrice.

ctInput

Specifica il tipo di colore dell'input.

lpaOutputColors

Punta a un buffer in cui deve essere inserita una matrice di strutture COLOR tradotte.

ctOutput

Specifica il tipo di colore di output.

Valore restituito

Se questa funzione ha esito positivo, il valore restituito è TRUE.

Se questa funzione ha esito negativo, il valore restituito è FALSE. CMM deve chiamare SetLastError per impostare l'ultimo errore su un valore di errore valido definito in Winerror.h.

Commenti

Ogni CMM è necessario per esportare questa funzione.

Se i tipi di colore di input e di output non sono compatibili con la trasformazione del colore, questa funzione dovrebbe non riuscire.

Si noti che questa funzione deve supportare la conversione sul posto. Ovvero, ogni volta che il footprint di memoria dell'output è minore o uguale al footprint di memoria dell'input, questa funzione deve essere in grado di convertire i colori bitmap anche se i buffer di origine e di destinazione sono uguali.

Requisiti

Requisito Valore
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Intestazione icm.h

Vedi anche