Função CMCreateMultiProfileTransform (icm.h)

Aceita uma matriz de perfis ou um único perfil de link de dispositivo e cria uma transformação de cores. Essa transformação é um mapeamento do espaço de cores especificado pelo primeiro perfil para o do segundo perfil e assim por diante até o último.

Sintaxe

HCMTRANSFORM CMCreateMultiProfileTransform(
  PHPROFILE pahProfiles,
  DWORD     nProfiles,
  PDWORD    padwIntents,
  DWORD     nIntents,
  DWORD     dwFlags
);

Parâmetros

pahProfiles

Aponta para uma matriz de identificadores de perfil.

nProfiles

Especifica o número de perfis na matriz.

padwIntents

Aponta para uma matriz de intenções de renderização. Cada intenção de renderização é representada por um dos seguintes valores:

INTENT_PERCEPTUAL
INTENT_SATURATION
INTENT_RELATIVE_COLORIMETRIC
INTENT_ABSOLUTE_COLORIMETRIC

Para obter mais informações, consulte As intenções de renderização.

nIntents

Especifica o número de intenções na matriz de intenções. Pode ser 1 ou o mesmo valor que nProfiles.

dwFlags

Especifica sinalizadores para usar a criação do controle da transformação. Para obter detalhes, consulte Sinalizadores de Criação de Transformação do CMM.

Valor de retorno

Se essa função for bem-sucedida, o valor retornado será uma transformação de cores no intervalo de 256 a 65.535. Como somente o WORD baixo da transformação é mantido, as transformações válidas não podem exceder esse intervalo.

Se essa função falhar, o valor retornado será um código de erro com um valor menor que 256. Quando o valor retornado for menor que 256, sinalizando um erro, o CMM deverá usar SetLastError para definir o último erro como um valor de erro válido, conforme definido em Winerror.h.

Observações

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

A matriz de intenções especifica como os perfis devem ser combinados. A intenção nth é usada para combinar o nth perfil na matriz. Se apenas uma intenção for especificada, ela será usada para o primeiro perfil e todos os outros perfis serão combinados usando a intenção Match.

Os identificadores de perfil usados para criar a transformação de cores podem ser fechados após a conclusão da chamada para CMCreateMultiProfileTransform .

Requirements

Consulte também

• Conceitos básicos de gerenciamento de cores
• Funções