Funzione D3DX11SaveTextureToFile
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 |
|
| Libreria |
|