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 SP2、Windows Vista [桌面应用 |UWP 应用]
最低受支持的服务器 Windows Server 2008 [桌面应用 | UWP 应用]
目标平台 Windows
标头 wincodec.h
Library Windowscodecs.lib
DLL Windowscodecs.dll