Метод IWICBitmapFrameEncode::SetPalette (wincodec.h)

Задает IWICPalette для индексированных форматов пикселей.

Синтаксис

HRESULT SetPalette(
  [in] IWICPalette *pIPalette
);

Параметры

[in] pIPalette

Тип: IWICPalette*

IWICPalette, используемый для индексированных форматов пикселей.

Кодировщик может изменить палитру в соответствии с форматами пикселей, поддерживаемыми кодировщиком.

Возвращаемое значение

Тип: HRESULT

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

Этот метод не завершается ошибкой, если он вызывается для кадра, формат пикселей которого имеет формат неиндексированного пикселя. Если целевой формат пикселей не индексирован, палитра будет игнорироваться.

Если вы уже вызывали IWICBitmapEncoder::SetPalette для задания глобальной палитры, этот метод переопределяет эту палитру для текущего кадра.

Палитра должна быть указана перед первым вызовом WritePixels/WriteSource. Это приведет к тому, что WriteSource будет использовать указанную палитру при преобразовании исходного изображения в формат пикселей кодировщика. Если палитра не указана, она будет создана при первом вызове WriteSource.

Требования

Требование	Значение
Минимальная версия клиента	Windows XP с пакетом обновления 2 (SP2), Windows Vista [классические приложения | Приложения UWP]
Минимальная версия сервера	Windows Server 2008 [классические приложения | Приложения UWP]
Целевая платформа	Windows
Header	wincodec.h
Библиотека	Windowscodecs.lib
DLL	Windowscodecs.dll