Condividi tramite

Funzione CMCheckColors (icm.h)

  • Articolo

Determina se i colori specificati si trovano all'interno della gamma di output di una trasformazione specificata.

Sintassi

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

Parametri

hcmTransform

Handle per la trasformazione del colore da usare.

lpaInputColors

Puntatore a una matrice di strutture COLOR per verificare la gamma di output.

nColors

Specifica il numero di elementi nella matrice.

ctInput

Specifica il tipo di colore di input.

lpaResult

Puntatore a un buffer in cui inserire una matrice di byte contenente i risultati del test. Ogni byte nel buffer corrisponde a una struttura COLOR e all'uscita è stato impostato su un valore senza segno compreso tra 0 e 255. Il valore 0 indica che il colore è in gamut, mentre un valore diverso da zero indica che è fuori gamma. Per qualsiasi numero intero n in modo che 0 <n< 255, un valore di risultato pari a n + 1 indica che il colore corrispondente è almeno al di fuori della gamma come sarebbe indicato da un valore di risultato pari a n. Questi valori vengono in genere generati dal gamutTag nel profilo CPI.

Valore restituito

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

Se questa funzione ha esito negativo, il valore restituito è FALSE. Se la funzione non riesce, il 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 il tipo di colore di input non è compatibile con la trasformazione del colore CMCheckColors ha esito negativo.

Requisiti

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

Vedi anche