IDirect3DDevice9::SetPaletteEntries 方法 (d3d9.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
标头 d3d9.h (包括 D3D9.h)
Library D3D9.lib

另请参阅

IDirect3DDevice9

IDirect3DDevice9::GetCurrentTexturePalette

IDirect3DDevice9::GetPaletteEntries

IDirect3DDevice9::SetCurrentTexturePalette

Direct3D 9) (纹理调色板