Condividi tramite

Funzione CheckColors (icm.h)

  • Articolo

Determina se i colori in una matrice si trovano all'interno del intervallo di output di una trasformazione specificata.

Sintassi

BOOL CheckColors(
  HTRANSFORM hColorTransform,
  PCOLOR     paInputColors,
  DWORD      nColors,
  COLORTYPE  ctInput,
  PBYTE      paResult
);

Parametri

hColorTransform

Gestire la trasformazione del colore da usare.

paInputColors

Puntatore a una matrice di strutture nColorsCOLOR da tradurre.

nColors

Contiene il numero di elementi nelle matrici a cui punta paInputColors e paResult.

ctInput

Specifica il tipo di colore di input.

paResult

Puntatore a una matrice di byte nColors che riceve i risultati del test.

Valore restituito

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

Se questa funzione ha esito negativo, il valore restituito è FALSE. Per informazioni sull'errore estese, chiamare GetLastError.

Commenti

Se il tipo di colore di input non è compatibile con la trasformazione del colore, CheckColors ha esito negativo.

La funzione inserisce i risultati dei test nella matrice a cui punta paResult. Ogni byte nella matrice corrisponde a un elemento COLOR nella matrice a cui punta paInputColors e ha un valore senza segno compreso tra 0 e 255. Il valore 0 indica che il colore è in gamma, 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 di n +1 indica che il colore corrispondente è almeno per quanto riguarda il gamut come sarebbe indicato da un valore di risultato di n.

Le informazioni out-of-gamut nei tag di gamma creati in WCS usano la distanza di colore percetuale in CIECAM02, ovvero la radice quadrata media in CIECAM02 spazio Jab. La distanza nei tag di gamma di profili ICC legacy è la radice quadrata media nello spazio CIELAB. È consigliabile usare lo spazio CIECAM02 quando è disponibile perché fornisce metriche di distanza più accurate in modo perceputivo.

Requisiti

Requisito Valore
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Intestazione icm.h
Libreria Mscms.lib
DLL Mscms.dll

Vedi anche