Share via

Função GetPS2ColorSpaceArray (icm.h)

  • Artigo

Recupera a matriz de espaço de cor Nível 2 do PostScript de um perfil de cor ICC.

Sintaxe

BOOL GetPS2ColorSpaceArray(
  HPROFILE hProfile,
  DWORD    dwIntent,
  DWORD    dwCSAType,
  PBYTE    pPS2ColorSpaceArray,
  PDWORD   pcbPS2ColorSpaceArray,
  PBOOL    pbBinary
);

Parâmetros

hProfile

Especifica um identificador para o perfil ICC do qual recuperar a matriz de espaço de cores de Nível 2 do PostScript.

dwIntent

Especifica a intenção de renderização desejada para a matriz de espaço de cor. Esse campo pode ter 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.

dwCSAType

Especifica o tipo de matriz de espaço de cor. Confira Identificadores de tipo de espaço de cor.

pPS2ColorSpaceArray

Ponteiro para um buffer no qual a matriz de espaço de cor deve ser colocada. Se o ponteiro pBuffer estiver definido como NULL, a função retornará o tamanho necessário do buffer no local de memória apontado por pcbSize.

pcbPS2ColorSpaceArray

Ponteiro para uma variável que contém o tamanho do buffer em bytes. No retorno, ele contém o número de bytes copiados para o buffer.

pbBinary

Ponteiro para uma variável booliana. Se definido como TRUE, os dados copiados poderão ser binários. Se definido como FALSE, os dados deverão ser codificados como ASCII85. No retorno, o local de memória apontado por pbBinary indica se os dados retornados realmente são binários (TRUE) ou ASCII85 (FALSE).

Valor retornado

Se essa função for bem-sucedida, o valor retornado será TRUE. Ele também retornará TRUE se o parâmetro pBuffer for NULL e o tamanho necessário para o buffer for copiado para pcbSize.

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

Comentários

Se a matriz de espaço de cores não estiver disponível no perfil, a função GetPS2ColorSpaceArray criará uma matriz de espaço de cor de Nível 2 do PostScript usando o conteúdo do perfil. Essa matriz pode ser usada como o operando para o operador setcolorspace PostScript Level2.

Esse método não dá suporte a perfis WCS.

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
Biblioteca Mscms.lib
DLL Mscms.dll

Confira também