Compartilhar via

Função CheckColors (icm.h)

  • Artigo

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

Sintaxe

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

Parâmetros

hColorTransform

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

paInputColors

Ponteiro para uma matriz de estruturas nColorsCOLOR a serem convertidas.

nColors

Contém o número de elementos nas matrizes apontadas por paInputColors e paResult.

ctInput

Especifica o tipo de cor de entrada.

paResult

Ponteiro para uma matriz de bytes nColors que recebe os resultados do teste.

Retornar valor

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

Se essa função falhar, o valor retornado será FALSE. Para obter informações de erro estendidas, chame GetLastError.

Comentários

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

A função coloca os resultados dos testes na matriz apontada por paResult. Cada byte na matriz corresponde a um elemento COLOR na matriz apontada por paInputColors e tem um valor sem sinal 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 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.

As informações fora de gama nas marcas de gama criadas no WCS usam a distância de cor perceptiva em CIECAM02, que é a raiz quadrada média em CIECAM02 espaço Jab. A distância nas marcas de gama de perfil ICC herdadas é a raiz quadrada média no espaço CIELAB. Recomendamos que você use o espaço CIECAM02 quando ele estiver disponível porque ele fornece métricas de distância mais percepticamente precisas.

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]
Cabeçalho icm.h
Biblioteca Mscms.lib
DLL Mscms.dll

Confira também