Fonction D3DXSaveSurfaceToFile
Enregistre une surface dans un fichier.
Syntaxe
HRESULT D3DXSaveSurfaceToFile(
_In_ LPCTSTR pDestFile,
_In_ D3DXIMAGE_FILEFORMAT DestFormat,
_In_ LPDIRECT3DSURFACE9 pSrcSurface,
_In_ const PALETTEENTRY *pSrcPalette,
_In_ const RECT *pSrcRect
);
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écifier 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).
-
pSrcSurface [in]
-
Type : LPDIRECT3DSURFACE9
Pointeur vers l’interface IDirect3DSurface9 , contenant l’image à enregistrer.
-
pSrcPalette [in]
-
Type : const PALETTEENTRY*
Pointeur vers une structure PALETTEENTRY contenant une palette de 256 couleurs. Ce paramètre peut être NULL.
-
pSrcRect [in]
-
Type : const RECT*
Pointeur vers une structure RECT . Spécifie le rectangle source. Définissez ce paramètre sur NULL pour spécifier l’image entière.
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 D3DXSaveSurfaceToFileW. Sinon, l’appel de fonction est résolu en D3DXSaveSurfaceToFileA, car les chaînes ANSI sont utilisées.
Cette fonction gère la conversion vers et à partir des formats de texture compressés.
Configuration requise
| Condition requise | Valeur |
|---|---|
| En-tête |
|
| Bibliothèque |
|
Voir aussi