Função D3DXSaveTextureToFile

  • Artigo

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
D3dx9tex.h
Biblioteca
D3dx9.lib

Confira também

Funções de textura no D3DX 9

D3DXSaveSurfaceToFile

D3DXSaveVolumeToFile