Fonction D3DXCreateCubeTexture

Article
06/13/2023

Crée une texture de cube vide, en ajustant les paramètres appelants 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 [in]

Type : LPDIRECT3DDEVICE9

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

Taille [in]

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 [in]

Type : UINT

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

Utilisation [in]

Type : DWORD

0, D3DUSAGE_RENDERTARGET ou D3DUSAGE_DYNAMIC. Le fait de définir cet indicateur sur D3DUSAGE_RENDERTARGET indique que la surface doit être utilisée comme cible de rendu. La ressource peut ensuite être passée au paramètre pNewRenderTarget de la méthode SetRenderTarget . Si D3DUSAGE_RENDERTARGET est spécifié, l’application doit case activée que l’appareil prend en charge cette opération en appelant CheckDeviceFormat. Pour plus d’informations sur l’utilisation de textures dynamiques, consultez Utilisation de textures dynamiques.

Format [in]

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 Format. Les applications doivent case activée le format de la texture de cube retournée.

Pool [in]

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 [out]

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 réussit, 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.

Notes

Les textures de cube diffèrent des autres surfaces en ce qu’il s’agit de collections de surfaces.

En interne, D3DXCreateCubeTexture utilise D3DXCheckCubeTextureRequirements pour ajuster les paramètres appelants. Par conséquent, les appels à D3DXCreateCubeTexture réussissent souvent là où les appels à CreateCubeTexture échouent.

Spécifications

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

Voir aussi

Fonctions de texture dans D3DX 9

Partager via