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 |
|
| Bibliothèque |
|