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

Define o IWICPalette para formatos de pixel indexados.

Sintaxe

HRESULT SetPalette(
  [in] IWICPalette *pIPalette
);

Parâmetros

[in] pIPalette

Tipo: IWICPalette*

O IWICPalette a ser usado para formatos de pixel indexados.

O codificador pode alterar a paleta para refletir os formatos de pixel aos quais o codificador dá suporte.

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

Esse método não falhará se for chamado em um quadro cujo formato de pixel está definido como um formato de pixel não indexado. Se o formato de pixel de destino for um formato não indexado, a paleta será ignorada.

Se você já chamou IWICBitmapEncoder::SetPalette para definir uma paleta global, esse método substitui essa paleta para o quadro atual.

A paleta deve ser especificada antes da primeira chamada para WritePixels/WriteSource. Isso fará com que WriteSource use a paleta especificada ao converter a imagem de origem no formato de pixel do codificador. Se nenhuma paleta for especificada, uma paleta será gerada na primeira chamada para WriteSource.

Requisitos