D3DXSaveTextureToFile, fonction

Article
06/13/2023

Enregistre une texture dans un fichier.

Syntaxe

HRESULT D3DXSaveTextureToFile(
  _In_       LPCTSTR                pDestFile,
  _In_       D3DXIMAGE_FILEFORMAT   DestFormat,
  _In_       LPDIRECT3DBASETEXTURE9 pSrcTexture,
  _In_ const PALETTEENTRY           *pSrcPalette
);

Paramètres

pDestFile [in]

Type : LPCTSTR

Pointeur vers une chaîne qui spécifie le nom de fichier de l’image de destination. 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.

DestFormat [in]

Type : D3DXIMAGE_FILEFORMAT

D3DXIMAGE_FILEFORMAT spécifiant le format de fichier à utiliser lors de l’enregistrement. Cette fonction prend en charge l’enregistrement dans tous les formats D3DXIMAGE_FILEFORMAT , à l’exception de Portable Pixmap (.ppm) et de l’adaptateur graphique Targa/Truevision (.tga).

pSrcTexture [in]

Type : LPDIRECT3DBASETEXTURE9

Pointeur vers l’interface IDirect3DBaseTexture9 , contenant la texture à enregistrer.

pSrcPalette [in]

Type : const PALETTEENTRY*

Pointeur vers une structure PALETTEENTRY contenant une palette de 256 couleurs. Ce paramètre peut être NULL.

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 la suivante : D3DERR_INVALIDCALL

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 D3DXSaveTextureToFileW. Sinon, l’appel de fonction est résolu en D3DXSaveTextureToFileA, car les chaînes ANSI sont utilisées.

Cette fonction gère la conversion vers et depuis les formats de texture compressés.

Si le volume est non dynamique (en raison d’un paramètre d’utilisation défini sur 0 lors de la création) et situé dans la mémoire vidéo (le pool de mémoires est défini sur D3DPOOL_DEFAULT), D3DXSaveTextureToFile échoue, car D3DX ne peut pas verrouiller les volumes non dynamiques situés dans la mémoire vidéo.

Spécifications

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

Voir aussi

Fonctions de texture dans D3DX 9
D3DXSaveSurfaceToFile
D3DXSaveVolumeToFile

Partager via