Função D3DX11SaveTextureToFile
Observação
A biblioteca de utilitários D3DX (D3DX 9, D3DX 10 e D3DX 11) foi preterida para Windows 8 e não tem suporte para aplicativos da Windows Store.
Observação
Em vez de usar essa função, recomendamos que você use a biblioteca DirectXTex , CaptureTexture e SaveToXXXFile (em que XXX é WIC, DDS ou TGA; O WIC não dá suporte a DDS e TGA; O D3DX 9 dá suporte à TGA como um formato de fonte de arte comum para jogos). Para o cenário simplificado de criação de uma captura de tela de uma textura de destino de renderização, recomendamos que você use a biblioteca DirectXTK , SaveDDSTextureToFile ou SaveWICTextureToFile.
Salve uma textura em um arquivo.
Sintaxe
HRESULT D3DX11SaveTextureToFile(
ID3D11DeviceContext *pContext,
_In_ ID3D11Resource *pSrcTexture,
_In_ D3DX11_IMAGE_FILE_FORMAT DestFormat,
_In_ LPCTSTR pDestFile
);
Parâmetros
-
pContext
-
Tipo: ID3D11DeviceContext*
Um ponteiro para um objeto ID3D11DeviceContext .
-
pSrcTexture [in]
-
Tipo: ID3D11Resource*
Ponteiro para a textura a ser salva. Consulte ID3D11Resource.
-
DestFormat [in]
-
Tipo: D3DX11_IMAGE_FILE_FORMAT
O formato da textura será salvo como (consulte D3DX11_IMAGE_FILE_FORMAT). D3DX11_IFF_DDS é o formato preferencial, pois é a única opção que dá suporte a todos os formatos em DXGI_FORMAT.
-
pDestFile [in]
-
Tipo: LPCTSTR
Nome do arquivo de saída de destino em que a textura será salva. Se as configurações do compilador exigirem Unicode, o tipo de dados LPCTSTR será resolvido para LPCWSTR. Caso contrário, o tipo de dados será resolvido para LPCSTR.
Valor retornado
Tipo: HRESULT
O valor retornado é um dos valores listados em Códigos de Retorno do Direct3D 11; use o valor retornado para ver se o DestFormat tem suporte.
Comentários
D3DX11SaveTextureToFile grava a estrutura de DDS_HEADER_DXT10 extra para a textura de entrada somente se necessário (por exemplo, porque a textura de entrada está no formato RGB padrão (sRGB). Se D3DX11SaveTextureToFile gravar a estrutura DDS_HEADER_DXT10 , ele definirá o membro dwFourCC da estrutura DDS_PIXELFORMAT para a textura como DX10 para indicar o prescense do DDS_HEADER_DXT10 cabeçalho estendido.
Requisitos
| Requisito | Valor |
|---|---|
| parâmetro |
|
| Biblioteca |
|