Funzione CheckColorsInGamut (wingdi.h)

La funzione CheckColorsInGamut determina se un set specificato di triple RGB si trova nell'intervallo di output di un dispositivo specificato. I triple RGB vengono interpretati nello spazio dei colori logici di input.

Sintassi

BOOL CheckColorsInGamut(
  HDC         hdc,
  LPRGBTRIPLE lpRGBTriple,
  LPVOID      dlpBuffer,
  DWORD       nCount
);

Parametri

hdc

Gestire il contesto del dispositivo il cui gamut di output da controllare.

lpRGBTriple

Puntatore a una matrice di triple RGB da controllare.

dlpBuffer

Puntatore al buffer in cui devono essere inseriti i risultati. Questo buffer deve essere almeno pari a nCount byte.

nCount

Numero di elementi nella matrice di triple.

Valore restituito

Se questa funzione ha esito positivo, il valore restituito è un valore diverso da zero.

Se questa funzione ha esito negativo, il valore restituito è zero.

Commenti

La funzione inserisce i risultati del test nel buffer a cui punta lpBuffer. Ogni byte nel buffer corrisponde a un triplo RGB e ha un valore senza segno tra CM_IN_GAMUT (= 0) e CM_OUT_OF_GAMUT (= 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 al di fuori del gamut come sarebbe indicato da un valore di risultato di n, come specificato dalla specifica del formato del profilo ICC. Per altre informazioni sulla specifica del formato del profilo ICC, vedere le origini elencate in Altre informazioni .

Si noti che per la riuscita di questa funzione, WCS deve essere abilitato per l'handle del contesto del dispositivo passato tramite il parametro hDC . WCS può essere abilitato per un handle di contesto del dispositivo chiamando la funzione SetICMMode .

Requisiti

Vedi anche

• Concetti di base sulla gestione dei colori
• Funzioni
• SetICMMode