Função ColorMatchToTarget (wingdi.h)

  • Artigo

A função ColorMatchToTarget permite que você visualize as cores como elas apareceriam no dispositivo de destino.

Sintaxe

BOOL ColorMatchToTarget(
  HDC   hdc,
  HDC   hdcTarget,
  DWORD action
);

Parâmetros

hdc

Especifica o contexto do dispositivo para visualização, geralmente a tela.

hdcTarget

Especifica o contexto do dispositivo de destino, geralmente uma impressora.

action

Uma constante que pode ter um dos valores a seguir.

 

Valor Significado
CS_ENABLE
 Mapeie as cores para a gama de cores do dispositivo de destino. Isso habilita a revisão de cores. Todos os comandos de desenho subsequentes para o DC renderizarão as cores como apareceriam no dispositivo de destino.
CS_DISABLE
 Desabilitar a revisão de cores.
CS_DELETE_TRANSFORM
 Se o gerenciamento de cores estiver habilitado para o perfil de destino, desabilite-o e exclua a transformação concatenada.

Retornar valor

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

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

Comentários

ColorMatchToTarget pode ser usado para comprovar as cores de um dispositivo de saída de cor em outro dispositivo de saída de cor. Definir o parâmetro uiAction como CS_ENABLE faz com que todos os comandos de desenho subsequentes para o DC renderizem as cores, pois elas apareceriam no dispositivo de destino. Se uiAction estiver definido como CS_DISABLE, a revisão de texto será desativada. No entanto, a transformação de cor atual não é excluída do DC. É apenas inativo.

Quando ColorMatchToTarget é chamado, a transformação de cores para o dispositivo de destino é executada primeiro e, em seguida, a transformação no dispositivo de visualização é aplicada aos resultados da primeira transformação. Isso é usado principalmente para verificar as condições de mapeamento de gama. Antes de usar essa função, você deve habilitar o WCS para ambos os contextos de dispositivo.

Essa função não pode ser colocada em cascata. Embora o mapeamento de cores para o destino seja habilitado definindo uiAction como CS_ENABLE, as alterações de aplicativo no espaço de cor ou no método de mapeamento de gama são ignoradas. Essas alterações entrarão em vigor quando o mapeamento de cores para o destino estiver desabilitado.

Nota Uma perda de memória não ocorrerá se um aplicativo não excluir uma transformação usando CS_DELETE_TRANSFORM. A transformação será excluída quando o DC (contexto do dispositivo) for fechado ou quando o espaço de cor do aplicativo for excluído. No entanto, se a transformação não for usada novamente ou se o aplicativo não estiver executando mais nenhuma correspondência de cores no DC, ele deverá excluir explicitamente a transformação para liberar a memória que ocupa.
 
O parâmetro uiAction só deve ser definido como CS_DELETE_TRANSFORM se o gerenciamento de cores estiver habilitado antes que a função ColorMatchToTarget seja chamada.

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