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 |