D3DXCreateCubeTexture fonction)

Crée une texture de cube vide, en ajustant les paramètres d’appel en fonction des besoins.

Syntaxe

HRESULT D3DXCreateCubeTexture(
  _In_  LPDIRECT3DDEVICE9      pDevice,
  _In_  UINT                   Size,
  _In_  UINT                   MipLevels,
  _In_  DWORD                  Usage,
  _In_  D3DFORMAT              Format,
  _In_  D3DPOOL                Pool,
  _Out_ LPDIRECT3DCUBETEXTURE9 *ppCubeTexture
);

Paramètres

pDevice [ dans]

Type : LPDIRECT3DDEVICE9

Pointeur vers une interface IDirect3DDevice9 , représentant l’appareil à associer à la texture.

Taille [ dans]

Type : uint

Largeur et hauteur de la texture du cube, en pixels. Par exemple, si la texture du cube est un cube de 8 pixels par 8 pixels, la valeur de ce paramètre doit être 8.

Miplevels a [ dans]

Type : uint

Nombre de niveaux MIP demandés. Si cette valeur est égale à zéro ou à D3DX _ default, une chaîne mipmap complète est créée.

Utilisation [ dans]

Type : DWORD

0, D3DUSAGE _ RENDERTARGET ou D3DUSAGE _ dynamique. L’affectation de la valeur D3DUSAGE RENDERTARGET à cet indicateur _ indique que la surface doit être utilisée comme cible de rendu. La ressource peut ensuite être transmise au paramètre pNewRenderTarget de la méthode SetRenderTarget . Si D3DUSAGE _ RENDERTARGET est spécifié, l’application doit vérifier que l’appareil prend en charge cette opération en appelant CheckDeviceFormat. Pour plus d’informations sur l’utilisation des textures dynamiques, consultez utilisation de textures dynamiques.

Format [ dans]

Type : D3DFORMAT

Membre du type énuméré D3DFORMAT , décrivant le format de pixel demandé pour la texture du cube. La texture de cube retournée peut avoir un format différent de celui spécifié par le format. Les applications doivent vérifier le format de la texture de cube retournée.

Pool [ dans]

Type : D3DPOOL

Membre du type énuméré D3DPOOL , décrivant la classe de mémoire dans laquelle la texture de cube doit être placée.

ppCubeTexture [ à]

Type : LPDIRECT3DCUBETEXTURE9*

Adresse d’un pointeur vers une interface IDirect3DCubeTexture9 , représentant l’objet de texture de cube créé.

Valeur retournée

Type : HRESULT

Si la fonction est réussie, la valeur de retour est D3D _ OK. Si la fonction échoue, la valeur de retour peut être l’une des suivantes : D3DERR _ INVALIDCALL, D3DERR _ NOTAVAILABLE, D3DERR _ OUTOFVIDEOMEMORY, E _ OUTOFMEMORY.

Remarques

Les textures de cube diffèrent des autres surfaces dans le fait qu’il s’agit de collections de surfaces.

En interne, D3DXCreateCubeTexture utilise D3DXCheckCubeTextureRequirements pour ajuster les paramètres d’appel. Par conséquent, les appels à D3DXCreateCubeTexture aboutissent souvent lorsque les appels à CreateCubeTexture échouent.

Configuration requise

Condition requise Valeur
En-tête
D3dx9tex. h
Bibliothèque
D3dx9. lib

Voir aussi

Fonctions de texture dans D3DX 9