Méthode IDirect3DDevice9::CreateCubeTexture (d3d9.h)

Article
08/23/2023

Crée une ressource de texture de cube.

Syntaxe

HRESULT CreateCubeTexture(
  [in]          UINT                  EdgeLength,
  [in]          UINT                  Levels,
  [in]          DWORD                 Usage,
  [in]          D3DFORMAT             Format,
  [in]          D3DPOOL               Pool,
  [out, retval] IDirect3DCubeTexture9 **ppCubeTexture,
  [in]          HANDLE                *pSharedHandle
);

Paramètres

[in] EdgeLength

Type : UINT

Taille des bords de tous les visages de niveau supérieur de la texture du cube. Les dimensions de pixel des niveaux suivants de chaque visage seront la valeur tronquée de la moitié de la dimension de pixel du niveau précédent (indépendamment). Chaque dimension se serre à une taille de 1 pixel. Ainsi, si la division par 2 aboutit à 0 (zéro), 1 sera pris à la place.

[in] Levels

Type : UINT

Nombre de niveaux dans chaque face de la texture du cube. Si cette valeur est nulle, Direct3D génère tous les sous-niveaux de texture de cube jusqu’à 1 x 1 pixels pour chaque visage pour le matériel qui prend en charge les textures de cube mipmapped. Appelez IDirect3DBaseTexture9::GetLevelCount pour voir le nombre de niveaux générés.

[in] Usage

Type : DWORD

L’utilisation peut être 0, ce qui indique aucune valeur d’utilisation. Toutefois, si l’utilisation est souhaitée, utilisez une combinaison d’une ou plusieurs constantes D3DUSAGE . Il est recommandé de faire correspondre le paramètre d’utilisation dans CreateCubeTexture avec les indicateurs de comportement dans IDirect3D9::CreateDevice. Pour plus d'informations, consultez la section Notes.

[in] Format

Type : D3DFORMAT

Membre du type énuméré D3DFORMAT , décrivant le format de tous les niveaux dans toutes les faces de la texture du cube.

[in] Pool

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.

[out, retval] ppCubeTexture

Type : IDirect3DCubeTexture9**

Adresse d’un pointeur vers une interface IDirect3DCubeTexture9 , représentant la ressource de texture de cube créée.

[in] pSharedHandle

Type : HANDLE*

Réservé. Définissez ce paramètre sur NULL. Ce paramètre peut être utilisé dans Direct3D 9 pour Windows Vista pour partager des ressources.

Valeur retournée

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 l’une des suivantes : D3DERR_INVALIDCALL, D3DERR_OUTOFVIDEOMEMORY, E_OUTOFMEMORY.

Notes

Un mipmap (texture) est une collection de surfaces sous-échantillonnée (mipmapped) successivement. D’autre part, une texture de cube (créée par IDirect3DDevice9::CreateCubeTexture) est une collection de six textures (mipmaps), une pour chaque visage. Tous les visages doivent être présents dans la texture du cube. En outre, une surface de carte de cube doit avoir la même taille de pixels dans les trois dimensions (x, y et z).

Une application peut découvrir la prise en charge de la génération automatique de Mipmaps (Direct3D 9) dans un format particulier en appelant IDirect3D9::CheckDeviceFormat avec D3DUSAGE_AUTOGENMIPMAP. Si IDirect3D9::CheckDeviceFormat retourne D3DOK_NOAUTOGEN, IDirect3DDevice9::CreateCubeTexture réussit, mais il retourne une texture à un niveau.