Compartilhar via


Função CheckColorsInGamut (wingdi.h)

A função CheckColorsInGamut determina se um conjunto especificado de triplos RGB está na gama de saída de um dispositivo especificado. Os triplos RGB são interpretados no espaço de cor lógica de entrada.

Sintaxe

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

Parâmetros

hdc

Manipule para o contexto do dispositivo cuja gama de saída deve ser verificada.

lpRGBTriple

Ponteiro para uma matriz de RGB triplica para marcar.

dlpBuffer

Ponteiro para o buffer no qual os resultados devem ser colocados. Esse buffer deve ser pelo menos tão grande quanto nCount bytes.

nCount

O número de elementos na matriz de triplos.

Retornar valor

Se essa função for bem-sucedida, o valor retornado será um valor diferente de zero.

Se essa função falhar, o valor retornado será zero.

Comentários

A função coloca os resultados do teste no buffer apontado por lpBuffer. Cada byte no buffer corresponde a um RGB triplo e tem um valor sem sinal entre CM_IN_GAMUT (= 0) e CM_OUT_OF_GAMUT (= 255). O valor 0 indica que a cor está em gama, enquanto um valor diferente de zero indica que ela está fora de gama. Para qualquer número inteiro n , de modo que 0 <n< 255, um valor de resultado de n + 1 indica que a cor correspondente está pelo menos tão distante da gama quanto seria indicado por um valor de resultado de n, conforme especificado pela Especificação de Formato de Perfil ICC. Para obter mais informações sobre a Especificação de Formato de Perfil ICC, consulte as fontes listadas em Mais informações .

Observe que, para que essa função tenha êxito, o WCS deve ser habilitado para o identificador de contexto do dispositivo que é passado por meio do parâmetro hDC . O WCS pode ser habilitado para um identificador de contexto de dispositivo chamando a função SetICMMode .

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho wingdi.h
Biblioteca Gdi32.lib
DLL Gdi32.dll

Confira também