Método IWICBitmapFrameEncode::SetColorContexts (wincodec.h)

Define um determinado número de perfis IWICColorContext como o quadro.

Sintaxe

HRESULT SetColorContexts(
  [in] UINT             cCount,
  [in] IWICColorContext **ppIColorContext
);

Parâmetros

[in] cCount

Tipo: UINT

O número de perfis IWICColorContext a serem definidos.

[in] ppIColorContext

Tipo: IWICColorContext**

Um ponteiro para um ponteiro IWICColorContext que contém os perfis de contextos de cor a serem definidos como o quadro.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

• BMPNão há suporte para a configuração de contextos de cor. Essa função retornará WINCODEC_ERR_UNSUPPORTEDOPERATION.
• PNGHá suporte para a configuração de no máximo um contexto de cor e contextos de cor adicionais serão ignorados. Esse contexto deve ser um WICColorContextProfile e é usado para codificar as partes iCCP, gAMA e cHRM no arquivo PNG.
• JPEG, TIFF, JPEG-XRHá suporte para a configuração de até um WICColorContextProfile e um WICColorContextExifColorSpace . Os usuários não devem fornecer mais de um de cada tipo de contexto de cor, pois todos, exceto o último contexto de cada tipo, serão ignorados. No JPEG, o WICColorContextProfile é codificado para o bloco de metadados JPEG APP2 ICC.

  Em TIFF e JPEG-XR, o WICColorContextProfile é codificado para o bloco de metadados de perfil IFD ICC (marca IFD 0x8773). Nos três formatos, o WICColorContextExifColorSpace é codificado para o bloco de metadados de colorspace EXIF (marca EXIF 0xA001).

Requisitos