Funzione D3DX11SaveTextureToFile

Articolo
06/12/2023

Nota

La libreria di utilità D3DX (D3DX 9, D3DX 10 e D3DX 11) è deprecata per Windows 8 e non è supportata per le app di Windows Store.

Nota

Invece di usare questa funzione, è consigliabile usare la libreria DirectXTex , CaptureTexture e quindi SaveToXXXFile (dove XXX è WIC, DDS o TGA; WIC non supporta DDS e TGA; TGA supportata da D3DX 9 come formato di origine grafica comune per i giochi. Per lo scenario semplificato di creazione di uno screenshot da una trama di destinazione di rendering, è consigliabile usare la libreria DirectXTK , SaveDDSTextureToFile o SaveWICTextureToFile.

Salvare una trama in un file.

Sintassi

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

Parametri

pContext

Tipo: ID3D11DeviceContext*

Puntatore a un oggetto ID3D11DeviceContext .

pSrcTexture [in]

Tipo: ID3D11Resource*

Puntatore alla trama da salvare. Vedere ID3D11Resource.

DestFormat [in]

Tipo: D3DX11_IMAGE_FILE_FORMAT

Il formato della trama verrà salvato come (vedere D3DX11_IMAGE_FILE_FORMAT). D3DX11_IFF_DDS è il formato preferito perché è l'unica opzione che supporta tutti i formati in DXGI_FORMAT.

pDestFile [in]

Tipo: LPCTSTR

Nome del file di output di destinazione in cui verrà salvata la trama. Se le impostazioni del compilatore richiedono Unicode, il tipo di dati LPCTSTR viene risolto in LPCWSTR. In caso contrario, il tipo di dati viene risolto in LPCSTR.

Valore restituito

Tipo: HRESULT

Il valore restituito è uno dei valori elencati in Codici restituiti Direct3D 11; usare il valore restituito per verificare se DestFormat è supportato.

Commenti

D3DX11SaveTextureToFile scrive la struttura di DDS_HEADER_DXT10 aggiuntiva per la trama di input solo se necessario (ad esempio, perché la trama di input è in formato RGB (sRGB) standard. Se D3DX11SaveTextureToFile scrive la struttura DDS_HEADER_DXT10 , imposta il membro dwFourCC della struttura DDS_PIXELFORMAT per la trama su DX10 per indicare il prescense dell'intestazione estesa DDS_HEADER_DXT10 .

Requisiti

Requisito	Valore
Intestazione	D3DX11tex.h
Libreria	D3DX11.lib

Vedi anche

Funzioni D3DX

Share via