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

Establece IWICPalette para formatos de píxeles indizado.

Sintaxis

HRESULT SetPalette(
  [in] IWICPalette *pIPalette
);

Parámetros

[in] pIPalette

Tipo: IWICPalette*

IWICPalette que se va a usar para formatos de píxeles indizado.

El codificador puede cambiar la paleta para reflejar los formatos de píxel que admite el codificador.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Este método no produce un error si se llama a en un marco cuyo formato de píxel está establecido en un formato de píxel no indexado. Si el formato de píxel de destino es un formato no indexado, se omitirá la paleta.

Si ya ha llamado a IWICBitmapEncoder::SetPalette para establecer una paleta global, este método invalida esa paleta para el fotograma actual.

La paleta debe especificarse antes de la primera llamada a WritePixels/WriteSource. Si lo hace, WriteSource usará la paleta especificada al convertir la imagen de origen al formato de píxel del codificador. Si no se especifica ninguna paleta, se generará una paleta en la primera llamada a WriteSource.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP con SP2, Windows Vista [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2008 [aplicaciones de escritorio | aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	wincodec.h
Library	Windowscodecs.lib
Archivo DLL	Windowscodecs.dll