Fonction D3DXCreateCubeTextureFromResource
Crée une texture de cube à partir d’une ressource.
Syntaxe
HRESULT D3DXCreateCubeTextureFromResource(
_In_ LPDIRECT3DDEVICE9 pDevice,
_In_ HMODULE hSrcModule,
_In_ LPCTSTR pSrcResource,
_Out_ LPDIRECT3DCUBETEXTURE9 *ppCubeTexture
);
Paramètres
-
pDevice [in]
-
Type : LPDIRECT3DDEVICE9
Pointeur vers une interface IDirect3DDevice9 , représentant l’appareil à associer à la texture du cube.
-
hSrcModule [in]
-
Type : HMODULE
Gérez le module où se trouve la ressource ou NULL pour le module associé à l’image utilisée par le système d’exploitation pour créer le processus actuel.
-
pSrcResource [in]
-
Type : LPCTSTR
Pointeur vers une chaîne qui spécifie le nom de la ressource. 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.
-
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 valeurs suivantes : D3DERR_INVALIDCALL, D3DERR_NOTAVAILABLE, D3DERR_OUTOFVIDEOMEMORY, D3DXERR_INVALIDDATA, E_OUTOFMEMORY.
Notes
Le paramètre du compilateur détermine la version de la fonction. Si Unicode est défini, l’appel de fonction est résolu en D3DXCreateCubeTextureFromResourceW. Sinon, l’appel de fonction est résolu en D3DXCreateCubeTextureFromResourceA , car les chaînes ANSI sont utilisées.
La fonction équivaut à D3DXCreateCubeTextureFromResourceEx(pDevice, hSrcModule, pSrcResource, D3DX_DEFAULT, D3DX_DEFAULT, 0, D3DFMT_UNKNOWN, D3DPOOL_MANAGED, D3DX_DEFAULT, D3DX_DEFAULT, 0, NULL, NULL, ppCubeTexture).
Cette fonction prend en charge les formats de fichiers suivants : .bmp, .dds, .dib, .hdr, .jpg, .pfm, .png, .ppm et .tga. Voir D3DXIMAGE_FILEFORMAT.
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.
D3DXCreateCubeTextureFromResource utilise le format de fichier surface DirectDraw (DDS). 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 Dxtex.exe et en savoir plus à 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 |
|
| Bibliothèque |
|
Voir aussi