Compartilhar via


Função CMCreateMultiProfileTransform (icm.h)

Aceita uma matriz de perfis ou um único perfil de link de dispositivo e cria uma transformação de cor. Essa transformação é um mapeamento do espaço de cores especificado pelo primeiro perfil para o do segundo perfil e assim por diante para 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 Intenções de renderização.

nIntents

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

dwFlags

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

Valor retornado

Se essa função for bem-sucedida, o valor retornado será uma transformação de cor no intervalo de 256 a 65.535. Como apenas o WORD baixo da transformação é retido, 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.

Comentários

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

A matriz de intenções especifica como os perfis devem ser combinados. A intenção né usada para combinar o 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 cor podem ser fechados após a conclusão da chamada para CMCreateMultiProfileTransform .

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