Compartilhar via

Função CMCheckColors (icm.h)

  • Artigo

Determina se determinadas cores estão dentro da gama de saída de uma transformação especificada.

Sintaxe

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

Parâmetros

hcmTransform

Manipule para a transformação de cor a ser usada.

lpaInputColors

Ponteiro para uma matriz de estruturas COLOR para marcar na gama de saída.

nColors

Especifica o número de elementos na matriz.

ctInput

Especifica o tipo de cor de entrada.

lpaResult

Ponteiro para um buffer no qual colocar uma matriz de bytes contendo os resultados do teste. Cada byte no buffer corresponde a uma estrutura COLOR e, na saída, foi definido como um valor não assinado entre 0 e 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. Esses valores geralmente são gerados a partir da gamutTag no perfil ICC.

Valor retornado

Se essa função for bem-sucedida, o valor retornado será TRUE.

Se essa função falhar, o valor retornado será FALSE. Se a função não for bem-sucedida, o CMM deverá chamar SetLastError para definir o último erro como um valor de erro válido definido em Winerror.h.

Comentários

Cada CMM é necessário para exportar essa função.

Se o tipo de cor de entrada não for compatível com a transformação de cor CMCheckColors falhará.

Requisitos

   
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]
Cabeçalho icm.h

Confira também