D3DX10SaveTextureToFile-Funktion

Speichern Sie eine Textur in einer Datei.

Syntax

HRESULT D3DX10SaveTextureToFile(
  _In_ ID3D10Resource           *pSrcTexture,
  _In_ D3DX10_IMAGE_FILE_FORMAT DestFormat,
  _In_ LPCTSTR                  pDestFile
);

Parameter

pSrcTexture [in]

Typ: ID3D10Resource*

Zeiger auf die zu speichernde Textur. Siehe ID3D10Resource-Schnittstelle.

DestFormat [in]

Typ: D3DX10_IMAGE_FILE_FORMAT

Das Format, in dem die Textur gespeichert wird (siehe D3DX10_IMAGE_FILE_FORMAT). D3DX10_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 10-Rückgabecodes aufgeführten Werte. Verwenden Sie den Rückgabewert, um festzustellen, ob destFormat unterstützt wird.

Bemerkungen

D3DX10SaveTextureToFile 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 D3DX10SaveTextureToFile die DDS_HEADER_DXT10-Struktur schreibt, legt es das dwFourCC-Element 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	D3DX10Tex.h
Bibliothek	D3DX10.lib

Siehe auch

Texturfunktionen in D3DX 10

Universell-Funktionen