D3DXCreateCubeTextureFromFileInMemory, fonction

Article
06/13/2023

Crée une texture de cube à partir d’un fichier en mémoire.

Syntaxe

HRESULT D3DXCreateCubeTextureFromFileInMemory(
  _In_  LPDIRECT3DDEVICE9      pDevice,
  _In_  LPCVOID                pSrcData,
  _In_  UINT                   SrcDataSize,
  _Out_ LPDIRECT3DCUBETEXTURE9 *ppCubeTexture
);

Paramètres

pDevice [in]

Type : LPDIRECT3DDEVICE9

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

pSrcData [in]

Type : LPCVOID

Pointeur vers le fichier en mémoire à partir duquel créer le cubemap. Consultez la section Notes.

SrcDataSize [in]

Type : UINT

Taille du fichier en mémoire, en octets.

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, D3DXERR_INVALIDDATA, E_OUTOFMEMORY.

Notes

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 à D3DXCreateCubeTextureFromFileInMemoryEx(pDevice, pSrcData, SrcDataSize, D3DX_DEFAULT, D3DX_DEFAULT, 0, D3DFMT_UNKNOWN, D3DPOOL_MANAGED, D3DX_DEFAULT, D3DX_DEFAULT, 0, NULL, NULL, ppCubeTexture).

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 indiquée par D3DPOOL_MANAGED. Lorsque cette méthode est appelée à partir d’un objet IDirect3DDevice9Ex, la ressource est placée dans la classe mémoire désignée par D3DPOOL_DEFAULT.

Cette méthode est conçue pour être utilisée pour charger des fichiers image stockés en tant que RT_RCDATA, qui est une ressource définie par l’application (données brutes). Sinon, cette méthode échoue.

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.

D3DXCreateCubeTextureFromFileInMemory utilise le format de fichier DDS (DirectDraw surface). L’éditeur de texture DirectX (Dxtex.exe) vous permet de générer un mappage de cube à partir d’autres formats de fichiers et de l’enregistrer au format de fichier DDS. Vous pouvez obtenir des Dxtex.exe et en savoir plus à ce sujet à partir du Kit de développement logiciel (SDK) DirectX. Pour plus d’informations sur le Kit de développement logiciel (SDK) DirectX, consultez Où se trouve le Kit de développement logiciel (SDK) DirectX ?.

Spécifications

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

Voir aussi

Fonctions de texture dans D3DX 9

Partager via