Metodo IDirect3DDevice9::SetPaletteEntries (d3d9helper.h)

Articolo
08/23/2023

Imposta le voci del tavolozza.

Sintassi

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

Parametri

[in] PaletteNumber

Tipo: UINT

Valore ordinale che identifica la tavolozza specifica su cui eseguire l'operazione.

[in] pEntries

Tipo: const PALETTEENTRY*

Puntatore a una struttura PALETTEENTRY , che rappresenta le voci della tavolozza da impostare. Si presuppone che il numero di strutture PALETTEENTRY puntate da pEntries sia pari a 256. Vedere la sezione Osservazioni.

Valore restituito

Tipo: HRESULT

Se il metodo ha esito positivo, il valore restituito è D3D_OK. Se il metodo ha esito negativo, il valore restituito può essere D3DERR_INVALIDCALL.

Commenti

Per le applicazioni Direct3D 9, qualsiasi tavolozza inviata a questo metodo deve essere conforme al bit di funzionalità D3DPTEXTURECAPS_ALPHAPALETTE della struttura D3DCAPS9 . Se D3DPTEXTURECAPS_ALPHAPALETTE non è impostato, ogni voce nella tavolozza deve avere alfa impostata su 1.0 o questo metodo avrà esito negativo con D3DERR_INVALIDCALL. Se D3DPTEXTURECAPS_ALPHAPALETTE è impostato, è consentito qualsiasi set di valori alfa. Si noti che il runtime di debug stampa un messaggio di avviso se tutte le voci del tavolozza sono impostate su 0.

Una singola tavolozza logica è associata al dispositivo ed è condivisa da tutte le fasi della trama.