D3DXCreateTextureFromFile, fonction

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

Syntaxe

HRESULT D3DXCreateTextureFromFile(
  _In_  LPDIRECT3DDEVICE9  pDevice,
  _In_  LPCTSTR            pSrcFile,
  _Out_ LPDIRECT3DTEXTURE9 *ppTexture
);

Paramètres

pDevice [in]

Type : LPDIRECT3DDEVICE9

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

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.

ppTexture [out]

Type : LPDIRECT3DTEXTURE9*

Adresse d’un pointeur vers une interface IDirect3DTexture9 , 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 D3DXCreateTextureFromFileW. Sinon, l’appel de fonction est résolu en D3DXCreateTextureFromFileA, car les chaînes ANSI sont utilisées.

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

La fonction est équivalente à D3DXCreateTextureFromFileEx(pDevice, pSrcFile, D3DX_DEFAULT, D3DX_DEFAULT, D3DX_DEFAULT, 0, D3DFMT_UNKNOWN, D3DPOOL_MANAGED, D3DX_DEFAULT, D3DX_DEFAULT, 0, NULL, NULL, ppTexture).

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

Lors du chargement d’images dans des textures mipmappées, 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 est placée dans la classe de mémoire désignée par D3DPOOL_MANAGED.

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.

Pour des performances optimales lors de l’utilisation de D3DXCreateTextureFromFile :

1. La mise à l’échelle et la conversion de format d’image au moment du chargement peuvent être lentes. Stockez les images au format et à la résolution qu’elles seront utilisées. Si le matériel cible nécessite une alimentation de deux dimensions, créez et stockez des images à l’aide de la puissance de deux dimensions.
2. Envisagez d’utiliser des fichiers de surface DirectDraw (DDS). Étant donné que les fichiers DDS peuvent être utilisés pour représenter n’importe quel format de texture Direct3D 9, ils sont très faciles à lire pour D3DX. En outre, ils peuvent stocker des mipmaps, de sorte que tous les algorithmes de génération de mipmap peuvent être utilisés pour créer les images.

Spécifications

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

Voir aussi

D3DXCreateTextureFromFileEx

Fonctions de texture dans D3DX 9