D3DX11SaveTextureToFile-Funktion

Artikel
06/12/2023

Hinweis

Die Hilfsprogrammbibliothek D3DX (D3DX 9, D3DX 10 und D3DX 11) ist für Windows 8 veraltet und wird für Windows Store-Apps nicht unterstützt.

Hinweis

Anstelle dieser Funktion wird empfohlen, die DirectXTex-BibliothekCaptureTexture und dann SaveToXXXFile (wobei XXX FÜR WIC, DDS oder TGA steht; WIC unterstützt DDS und TGA nicht. D3DX 9 unterstützte TGA als gängiges Kunstquellenformat für Spiele). Für das vereinfachte Szenario zum Erstellen eines Screenshots aus einer Renderzieltextur empfiehlt es sich, die DirectXTK-Bibliothek, SaveDDSTextureToFile oder SaveWICTextureToFile zu verwenden.

Speichern Sie eine Textur in einer Datei.

Syntax

HRESULT D3DX11SaveTextureToFile(
       ID3D11DeviceContext      *pContext,
  _In_ ID3D11Resource           *pSrcTexture,
  _In_ D3DX11_IMAGE_FILE_FORMAT DestFormat,
  _In_ LPCTSTR                  pDestFile
);

Parameter

pContext

Typ: ID3D11DeviceContext*

Ein Zeiger auf ein ID3D11DeviceContext-Objekt .

pSrcTexture [in]

Typ: ID3D11Resource*

Zeiger auf die zu speichernde Textur. Siehe ID3D11Resource.

DestFormat [in]

Typ: D3DX11_IMAGE_FILE_FORMAT

Das Format, in dem die Textur gespeichert wird (siehe D3DX11_IMAGE_FILE_FORMAT). D3DX11_IFF_DDS ist das bevorzugte Format, da es die einzige Option ist, die alle Formate in DXGI_FORMAT unterstützt.

pDestFile [in]

Typ: LPCTSTR

Name der Zielausgabedatei, in der die Textur gespeichert wird. Wenn die Compilereinstellungen Unicode erfordern, wird der Datentyp LPCTSTR in LPCWSTR aufgelöst. Andernfalls wird der Datentyp in LPCSTR aufgelöst.

Rückgabewert

Typ: HRESULT

Der Rückgabewert ist einer der In Direct3D 11-Rückgabecodes aufgeführten Werte. Verwenden Sie den Rückgabewert, um festzustellen, ob destFormat unterstützt wird.

Bemerkungen

D3DX11SaveTextureToFile schreibt die zusätzliche DDS_HEADER_DXT10-Struktur für die Eingabetextur nur bei Bedarf aus (z. B. weil die Eingabetextur im RGB-Standardformat (sRGB) vorliegt). Wenn D3DX11SaveTextureToFile die DDS_HEADER_DXT10-Struktur ausschreibt, legt es den dwFourCC-Member der DDS_PIXELFORMAT-Struktur für die Textur auf DX10 fest, um die Präscense des erweiterten DDS_HEADER_DXT10-Headers anzugeben.

Anforderungen

Anforderung	Wert
Header	D3DX11tex.h
Bibliothek	D3DX11.lib

Siehe auch

D3DX-Funktionen

Freigeben über