Função D3DXSaveTextureToFile
Salva uma textura em um arquivo.
Sintaxe
HRESULT D3DXSaveTextureToFile(
_In_ LPCTSTR pDestFile,
_In_ D3DXIMAGE_FILEFORMAT DestFormat,
_In_ LPDIRECT3DBASETEXTURE9 pSrcTexture,
_In_ const PALETTEENTRY *pSrcPalette
);
Parâmetros
-
pDestFile [in]
-
Tipo: LPCTSTR
Ponteiro para uma cadeia de caracteres que especifica o nome do arquivo da imagem de destino. Se as configurações do compilador exigirem Unicode, o tipo de dados LPCTSTR será resolvido para LPCWSTR. Caso contrário, o tipo de dados de cadeia de caracteres será resolvido para LPCSTR. Consulte Observações.
-
DestFormat [in]
-
Tipo: D3DXIMAGE_FILEFORMAT
D3DXIMAGE_FILEFORMAT especificando o formato de arquivo a ser usado ao salvar. Essa função dá suporte ao salvamento em todos os formatos de D3DXIMAGE_FILEFORMAT , exceto Pixmap Portátil (.ppm) e Adaptador gráfico Targa/Truevision (.tga).
-
pSrcTexture [in]
-
Tipo: LPDIRECT3DBASETEXTURE9
Ponteiro para a interface IDirect3DBaseTexture9 , contendo a textura a ser salva.
-
pSrcPalette [in]
-
Tipo: const PALETTEENTRY*
Ponteiro para uma estrutura PALETTEENTRY que contém uma paleta de 256 cores. Este parâmetro pode ser NULL.
Valor retornado
Tipo: HRESULT
Se a função for bem-sucedida, o valor retornado será D3D_OK. Se a função falhar, o valor retornado poderá ser o seguinte: D3DERR_INVALIDCALL
Comentários
A configuração do compilador também determina a versão da função. Se Unicode for definido, a chamada de função será resolvida para D3DXSaveTextureToFileW. Caso contrário, a chamada de função será resolvida para D3DXSaveTextureToFileA porque cadeias de caracteres ANSI estão sendo usadas.
Essa função manipula a conversão de e para formatos de textura compactadas.
Se o volume for nãodinâmico (devido a um parâmetro de uso definido como 0 na criação) e localizado na memória de vídeo (o pool de memória definido como D3DPOOL_DEFAULT), D3DXSaveTextureToFile falhará porque o D3DX não pode bloquear volumes nãodinâmicos localizados na memória de vídeo.
Requisitos
| Requisito | Valor |
|---|---|
| parâmetro |
|
| Biblioteca |
|
Confira também