IDirect3DDevice9::SetPaletteEntries 方法 (d3d9helper.h)
设置调色板条目。
语法
HRESULT SetPaletteEntries(
[in] UINT PaletteNumber,
[in] const PALETTEENTRY *pEntries
);
参数
[in] PaletteNumber
类型: UINT
标识要对其执行操作的特定调色板的序号值。
[in] pEntries
类型: const PALETTEENTRY*
指向 PALETTEENTRY 结构的指针,表示要设置的调色板条目。 假定 pEntries 指向的 PALETTEENTRY 结构数为 256。 请参阅“备注”。
返回值
类型: HRESULT
如果方法成功,则返回值D3D_OK。 如果 方法失败,则可以D3DERR_INVALIDCALL返回值。
备注
对于 Direct3D 9 应用程序,发送到此方法的任何调色板都必须符合 D3DCAPS9 结构的 D3DPTEXTURECAPS_ALPHAPALETTE 功能位。 如果未设置D3DPTEXTURECAPS_ALPHAPALETTE,调色板中的每个条目都必须将 alpha 设置为 1.0,否则此方法将失败并出现D3DERR_INVALIDCALL。 如果设置了D3DPTEXTURECAPS_ALPHAPALETTE,则允许任意一组 alpha 值。 请注意,如果所有调色板条目的 alpha 设置为 0,调试运行时将打印一条警告消息。
单个逻辑调色板与设备相关联,并且由所有纹理阶段共享。
要求
目标平台 | Windows |
标头 | d3d9helper.h (包括 D3D9.h) |
Library | D3D9.lib |
另请参阅
IDirect3DDevice9::GetCurrentTexturePalette
IDirect3DDevice9::GetPaletteEntries
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈