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 [ no]

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 String será resolvido para LPCSTR. Consulte Observações.

DestFormat [ no]

Tipo: D3DXIMAGE _ FileFormat

D3DXIMAGE _ Fileformate especificando o formato de arquivo a ser usado ao salvar. Essa função dá suporte ao salvamento em todos os formatos de _ FileFormat do D3DXIMAGE , exceto no pixmap portátil (. ppm) e no adaptador gráfico Targa/Truevision (. tga).

pSrcTexture [ no]

Tipo: LPDIRECT3DBASETEXTURE9

Ponteiro para a interface IDirect3DBaseTexture9 , que contém a textura a ser salva.

pSrcPalette [ no]

Tipo: const PaletteEntry *

Ponteiro para uma estrutura PaletteEntry que contém uma paleta de 256 cores. Este parâmetro pode ser NULL.

Retornar valor

Tipo: HRESULT

Se a função for bem sucedido, o valor de retorno será D3D _ OK. Se a função falhar, o valor de retorno poderá ser o seguinte: D3DERR _ INVALIDCALL

Comentários

A configuração do compilador também determina a versão da função. Se o Unicode for definido, a chamada de função será resolvida como D3DXSaveTextureToFileW. Caso contrário, a chamada de função é resolvida como D3DXSaveTextureToFileA porque as cadeias de caracteres ANSI estão sendo usadas.

Essa função manipula a conversão de e para formatos de textura compactados.

Se o volume for não dinâ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 _ padrão), D3DXSaveTextureToFile falhará porque o D3DX não pode bloquear volumes não dinâ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