Méthode IDirect3DDevice9::SetPaletteEntries (d3d9helper.h)

Article
08/23/2023

Définit les entrées de palette.

Syntaxe

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

Paramètres

[in] PaletteNumber

Type : UINT

Valeur ordinale identifiant la palette particulière sur laquelle l’opération doit être effectuée.

[in] pEntries

Type : const PALETTEENTRY*

Pointeur vers une structure PALETTEENTRY , représentant les entrées de palette à définir. Le nombre de structures PALETTEENTRY pointées par pEntries est supposé être de 256. Consultez la section Notes.

Valeur de retour

Type : HRESULT

Si la méthode réussit, la valeur de retour est D3D_OK. Si la méthode échoue, la valeur de retour peut être D3DERR_INVALIDCALL.

Notes

Pour les applications Direct3D 9, toute palette envoyée à cette méthode doit être conforme au bit de capacité D3DPTEXTURECAPS_ALPHAPALETTE de la structure D3DCAPS9 . Si D3DPTEXTURECAPS_ALPHAPALETTE n’est pas défini, chaque entrée de la palette doit avoir alpha définie sur 1.0, sinon cette méthode échoue avec D3DERR_INVALIDCALL. Si D3DPTEXTURECAPS_ALPHAPALETTE est défini, tous les ensembles de valeurs alpha sont autorisés. Notez que le runtime de débogage affiche un message d’avertissement si toutes les entrées de palette ont la valeur alpha 0.

Une palette logique unique est associée à l’appareil et est partagée par toutes les étapes de texture.