Partager via


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

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.

Remarques

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.

Configuration requise

Condition requise Valeur
Plateforme cible Windows
En-tête d3d9.h (inclure D3D9.h)
Bibliothèque D3D9.lib

Voir aussi

IDirect3DDevice9

IDirect3DDevice9 ::GetCurrentTexturePalette

IDirect3DDevice9 ::GetPaletteEntries

IDirect3DDevice9 ::SetCurrentTexturePalette

Palettes de textures (Direct3D 9)