IDirect3DDevice9::SetPaletteEntries-Methode (d3d9.h)

Artikel
02/26/2024

Legt Paletteneinträge fest.

Syntax

HRESULT SetPaletteEntries(
  [in] UINT               PaletteNumber,
  [in] const PALETTEENTRY *pEntries
);

Parameter

[in] PaletteNumber

Typ: UINT

Ein Ordnungswert, der die bestimmte Palette angibt, auf der der Vorgang ausgeführt werden soll.

[in] pEntries

Typ: const PALETTEENTRY*

Zeiger auf eine PALETTEENTRY-Struktur , die die festzulegenden Paletteneinträge darstellt. Die Anzahl der PALETTEENTRY-Strukturen , auf die von pEntries verwiesen wird, wird als 256 angenommen. Siehe Hinweise.

Rückgabewert

Typ: HRESULT

Wenn die Methode erfolgreich ist, wird der Rückgabewert D3D_OK. Wenn die Methode fehlschlägt, kann der Rückgabewert D3DERR_INVALIDCALL werden.

Hinweise

Bei Direct3D 9-Anwendungen muss jede Palette, die an diese Methode gesendet wird, dem D3DPTEXTURECAPS_ALPHAPALETTE-Funktionsbit der D3DCAPS9-Struktur entsprechen. Wenn D3DPTEXTURECAPS_ALPHAPALETTE nicht festgelegt ist, muss für jeden Eintrag in der Palette alpha auf 1.0 festgelegt sein, andernfalls schlägt diese Methode mit D3DERR_INVALIDCALL fehl. Wenn D3DPTEXTURECAPS_ALPHAPALETTE festgelegt ist, sind alle Alphawerte zulässig. Beachten Sie, dass die Debuglaufzeit eine Warnmeldung ausgibt, wenn für alle Paletteneinträge alpha auf 0 festgelegt ist.

Dem Gerät ist eine einzelne logische Palette zugeordnet, die von allen Texturphasen gemeinsam genutzt wird.