IDirect3DDevice9：：SetPaletteEntries 方法 (d3d9.h)

项目
02/26/2024

设置调色板条目。

语法

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，调试运行时将打印一条警告消息。

单个逻辑调色板与设备相关联，并且由所有纹理阶段共享。