Microsoft DirectX 9.0

IDirect3DDevice9::SetPaletteEntries Method

Sets palette entries.


HRESULT SetPaletteEntries(      

    UINT PaletteNumber,     const PALETTEENTRY *pEntries );


[in] An ordinal value identifying the particular palette upon which the operation is to be performed.
[in] Pointer to a PALETTEENTRY structure, representing the palette entries to set. The number of PALETTEENTRY structures pointed to by pEntries is assumed to be 256. See Remarks.

Return Value

If the method succeeds, the return value is D3D_OK.

If the method fails, the return value can be D3DERR_INVALIDCALL.


For Microsoft?DirectX?9.0 applications, any palette sent to this method must conform to the D3DPTEXTURECAPS_ALPHAPALETTE capability bit of the D3DCAPS9 structure. If D3DPTEXTURECAPS_ALPHAPALETTE is not set, every entry in the palette must have alpha set to 1.0 or this method will fail with D3DERR_INVALIDCALL. If D3DPTEXTURECAPS_ALPHAPALETTE is set, then any set of alpha values are allowed. Note that the debug runtime will print a warning message if all palette entries have alpha set to 0.

A single logical palette is associated with the device, and is shared by all texture stages.

See Also

IDirect3DDevice9::GetCurrentTexturePalette, IDirect3DDevice9::GetPaletteEntries, IDirect3DDevice9::SetCurrentTexturePalette, Texture Palettes

© 2002 Microsoft Corporation. All rights reserved.