Partager via


Fonction D3DXCreateVolumeTextureFromFile

Crée une texture de volume à partir d’un fichier.

Syntaxe

HRESULT D3DXCreateVolumeTextureFromFile(
  _In_  LPDIRECT3DDEVICE9        pDevice,
  _In_  LPCTSTR                  pSrcFile,
  _Out_ LPDIRECT3DVOLUMETEXTURE9 *ppVolumeTexture
);

Paramètres

pDevice [in]

Type : LPDIRECT3DDEVICE9

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

pSrcFile [in]

Type : LPCTSTR

Pointeur vers une chaîne qui spécifie le nom de fichier. Si les paramètres du compilateur nécessitent Unicode, le type de données LPCTSTR est résolu en LPCWSTR. Sinon, le type de données de chaîne est résolu en LPCSTR. Consultez la section Notes.

ppVolumeTexture [out]

Type : LPDIRECT3DVOLUMETEXTURE9*

Adresse d’un pointeur vers une interface IDirect3DVolumeTexture9 représentant l’objet de texture 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_NOTAVAILABLE, D3DERR_OUTOFVIDEOMEMORY, D3DERR_INVALIDCALL, D3DXERR_INVALIDDATA, E_OUTOFMEMORY.

Notes

Le paramètre du compilateur détermine également la version de la fonction. Si Unicode est défini, l’appel de fonction est résolu en D3DXCreateVolumeTextureFromFileW. Sinon, l’appel de fonction est résolu en D3DXCreateVolumeTextureFromFileA, car les chaînes ANSI sont utilisées.

La fonction équivaut à D3DXCreateVolumeTextureFromFileEx(pDevice, pSrcFile, D3DX_DEFAULT, D3DX_DEFAULT, D3DX_DEFAULT, D3DX_DEFAULT, 0, D3DFMT_UNKNOWN, D3DPOOL_MANAGED, D3DX_DEFAULT, D3DX_DEFAULT, 0, NULL, NULL, ppVolumeTexture).

Cette fonction prend en charge les formats de fichiers suivants : .bmp, .dds, .dib, .hdr, .jpg, .pfm, .png, .ppm et .tga. Voir D3DXIMAGE_FILEFORMAT.

Les textures mipmappées ont automatiquement chaque niveau rempli avec la texture chargée.

Lors du chargement d’images dans des textures mipmapped, certains appareils ne peuvent pas accéder à une image 1x1 et cette fonction échoue. Si cela se produit, les images doivent être chargées manuellement.

Notez qu’une ressource créée avec cette fonction lorsqu’elle est appelée à partir d’un objet IDirect3DDevice9 est placée dans la classe de mémoire désignée par D3DPOOL_MANAGED. Lorsque cette méthode est appelée à partir d’un objet IDirect3DDevice9Ex, la ressource est placée dans la classe de mémoire désignée par D3DPOOL_DEFAULT.

Le filtrage est automatiquement appliqué à une texture créée à l’aide de cette méthode. Le filtrage équivaut à D3DX_FILTER_TRIANGLE | D3DX_FILTER_DITHER dans D3DX_FILTER.

Spécifications

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

Voir aussi

D3DXCreateVolumeTextureFromFileEx

D3DXCreateVolumeTextureFromFileInMemory

D3DXCreateVolumeTextureFromFileInMemoryEx

D3DXCreateVolumeTextureFromResource

D3DXCreateVolumeTextureFromResourceEx

Fonctions de texture dans D3DX 9