Méthode IDirectDraw7 ::CreatePalette (ddraw.h)
Crée un objet DirectDrawPalette pour cet objet DirectDraw.
Syntaxe
HRESULT CreatePalette(
[in] DWORD unnamedParam1,
[in] LPPALETTEENTRY unnamedParam2,
[out] LPDIRECTDRAWPALETTE *unnamedParam3,
[in] IUnknown *unnamedParam4
);
Paramètres
[in] unnamedParam1
Cette valeur se compose d’un ou plusieurs des indicateurs suivants :
DDPCAPS_1BIT
L’index est 1 bit. Il existe deux entrées dans la table de couleurs.
DDPCAPS_2BIT
L’index est de 2 bits. Il existe quatre entrées dans le tableau de couleurs.
DDPCAPS_4BIT
L’index est de 4 bits. La table de couleurs contient 16 entrées.
DDPCAPS_8BIT
L’index est de 8 bits. Le tableau de couleurs contient 256 entrées.
DDPCAPS_8BITENTRIES
L’index fait référence à un index de couleur 8 bits. Cet indicateur est valide uniquement lorsqu’il est utilisé avec l’indicateur DDPCAPS_1BIT, DDPCAPS_2BIT ou DDPCAPS_4BIT et lorsque la surface cible est de 8 bpp. Chaque entrée de couleur mesure 1 octet et est un index de la palette de 8 bpp d’une surface de destination.
DDPCAPS_ALPHA
Le membre peFlags de la structure PALETTEENTRY associée doit être interprété comme une seule valeur alpha 8 bits (en plus des membres peRed, peGreen et peBlue ). Une palette créée à l’aide de cet indicateur ne peut être attachée qu’à une texture : une surface créée avec l’indicateur de fonctionnalité DDSCAPS_TEXTURE.
DDPCAPS_ALLOW256
Cette palette peut avoir les 256 entrées définies.
DDPCAPS_INITIALIZE
Obsolète. DirectDraw initialise toujours cette palette avec les couleurs du tableau de couleurs passées à lpDDColorArray.
DDPCAPS_PRIMARYSURFACE
Cette palette est attachée à la surface primaire. La modification de la table de couleurs de cette palette affecte immédiatement l’affichage, sauf si DDPSETPAL_VSYNC est spécifié et pris en charge.
DDPCAPS_PRIMARYSURFACELEFT
Cette palette est celle qui est attachée à la surface primaire de l’œil gauche. La modification de la table de couleurs de cette palette affecte immédiatement l’affichage de l’œil gauche, sauf si DDPSETPAL_VSYNC est spécifié et pris en charge.
DDPCAPS_VSYNC
Les modifications de cette palette peuvent être synchronisées avec la fréquence d’actualisation du moniteur.
[in] unnamedParam2
Adresse d’un tableau de 2, 4, 16 ou 256 structures PALETTEENTRY pour initialiser l’objet DirectDrawPalette.
[out] unnamedParam3
Adresse d’une variable à définir sur un pointeur d’interface IDirectDrawPalette valide si l’appel réussit.
[in] unnamedParam4
Permet une compatibilité future avec les fonctionnalités d’agrégation COM. Actuellement, cette méthode retourne une erreur si ce paramètre n’a pas la valeur NULL.
Valeur retournée
Si la méthode réussit, la valeur de retour est DD_OK.
En cas d’échec, la méthode peut retourner l’une des valeurs d’erreur suivantes :
- DDERR_INVALIDOBJECT
- DDERR_INVALIDPARAMS
- DDERR_NOCOOPERATIVELEVELSET
- DDERR_OUTOFMEMORY
- DDERR_UNSUPPORTED
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Windows |
| En-tête | ddraw.h |
| Bibliothèque | Ddraw.lib |
| DLL | Ddraw.dll |