Compartilhar via

Função CMTranslateColors (icm.h)

  • Artigo

Converte uma matriz de cores de um espaço de cor de origem para um espaço de cor de destino usando uma transformação de cor.

Sintaxe

BOOL CMTranslateColors(
  HCMTRANSFORM hcmTransform,
  LPCOLOR      lpaInputColors,
  DWORD        nColors,
  COLORTYPE    ctInput,
  LPCOLOR      lpaOutputColors,
  COLORTYPE    ctOutput
);

Parâmetros

hcmTransform

Especifica a transformação de cor a ser usada.

lpaInputColors

Aponta para uma matriz de estruturas COLOR a serem convertidas.

nColors

Especifica o número de elementos na matriz.

ctInput

Especifica o tipo de cor da entrada.

lpaOutputColors

Aponta para um buffer no qual uma matriz de estruturas COLOR traduzidas deve ser colocada.

ctOutput

Especifica o tipo de cor de saída.

Retornar valor

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

Se essa função falhar, o valor retornado será FALSE. O CMM deve 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 os tipos de cor de entrada e saída não forem compatíveis com a transformação de cor, essa função deverá falhar.

Observe que essa função deve dar suporte à tradução in-loco. Ou seja, sempre que o volume de memória da saída for menor ou igual ao volume de memória da entrada, essa função deverá ser capaz de traduzir as cores de bitmap mesmo que os buffers de origem e de destino sejam os mesmos.

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

Confira também