D3DXSaveTextureToFile-Funktion
Speichert eine Textur in einer Datei.
Syntax
HRESULT D3DXSaveTextureToFile(
_In_ LPCTSTR pDestFile,
_In_ D3DXIMAGE_FILEFORMAT DestFormat,
_In_ LPDIRECT3DBASETEXTURE9 pSrcTexture,
_In_ const PALETTEENTRY *pSrcPalette
);
Parameter
-
pDestFile [ In]
-
Typ: LPCTSTR
Zeiger auf eine Zeichenfolge, die den Dateinamen des Zielimages angibt. Wenn die Compilereinstellungen Unicode erfordern, wird der Datentyp LPCTSTR in LPCWSTR aufgelöst. Andernfalls wird der Zeichenfolgendatentyp in LPCSTR aufgelöst. Siehe Hinweise.
-
DestFormat [ In]
-
D3DXIMAGE _ FILEFORMAT, das das beim Speichern zu verwendende Dateiformat angibt. Diese Funktion unterstützt das Speichern in allen D3DXIMAGE _ FILEFORMAT-Formaten mit Ausnahme von Portable Pixmap (.ppm) und Targa/Truevision Graphics Adapter (.tga).
-
pSrcTexture [ In]
-
Zeiger auf die IDirect3DBaseTexture9-Schnittstelle, die die zu speichernde Textur enthält.
-
pSrcPalette [ In]
-
Typ: const PALETTEENTRY *
Zeiger auf eine PALETTEENTRY-Struktur, die eine Palette von 256 Farben enthält. Dieser Parameter kann NULL sein.
Rückgabewert
Typ: HRESULT
Wenn die Funktion erfolgreich ausgeführt wird, lautet der Rückgabewert D3D _ OK. Wenn die Funktion fehlschlägt, kann der Rückgabewert wie folgt sein: D3DERR _ INVALIDCALL
Hinweise
Die Compilereinstellung bestimmt auch die Funktionsversion. Wenn Unicode definiert ist, wird der Funktionsaufruf in D3DXSaveTextureToFileW aufgelöst. Andernfalls wird der Funktionsaufruf in D3DXSaveTextureToFileA aufgelöst, da ANSI-Zeichenfolgen verwendet werden.
Diese Funktion verarbeitet die Konvertierung in und aus komprimierten Texturformaten.
Wenn das Volume nicht dynamisch ist (aufgrund eines Verwendungsparameters, der bei der Erstellung auf 0 festgelegt wurde) und sich im Videospeicher befindet (der Speicherpool ist auf _ D3DPOOL DEFAULT festgelegt), schlägt D3DXSaveTextureToFile fehl, da D3DX nicht dynamische Volumes im Videospeicher sperren kann.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header |
|
| Bibliothek |
|