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 ::GetCurrentTexturePalette
IDirect3DDevice9 ::GetPaletteEntries