Microsoft DirectX 8.0 (C++)

IDirect3DDevice8::SetPaletteEntries

Sets palette entries.

HRESULT SetPaletteEntries(
  UINT PaletteNumber,
  CONST PALETTEENTRY* pEntries
);

Parameters

PaletteNumber
[in] An ordinal value identifying the particular palette upon which the operation is to be performed.
pEntries
[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 Values

If the method succeeds, the return value is D3D_OK.

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

Remarks

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

For more information on PALETTEENTRY see the Microsoft® Platform Software Development Kit (SDK). Note that as of Microsoft DirectX® 8.0, the peFlags member of the PALETTEENTRY structure does not work as it is documented in the Platform SDK. The peFlags member is now the alpha channel for 8-bit palletized formats.

Requirements

  Header: Declared in D3d8.h.
  Import Library: Use D3d8.lib.

See Also

IDirect3DDevice8::GetCurrentTexturePalette, IDirect3DDevice8::GetPaletteEntries, IDirect3DDevice8::SetCurrentTexturePalette, Texture Palettes