Função D3DXSaveVolumeToFile

  • Artigo

Salva um volume em um arquivo no disco.

Sintaxe

HRESULT D3DXSaveVolumeToFile(
  _In_       LPCTSTR              pDestFile,
  _In_       D3DXIMAGE_FILEFORMAT DestFormat,
  _In_       LPDIRECT3DVOLUME9    pSrcVolume,
  _In_ const PALETTEENTRY         *pSrcPalette,
  _In_ const D3DBOX               *pSrcBox
);

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).

pSrcVolume [in]

Tipo: LPDIRECT3DVOLUME9

Ponteiro para a interface IDirect3DVolume9 que contém a imagem 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.

pSrcBox [in]

Tipo: const D3DBOX*

Ponteiro para uma estrutura D3DBOX . Especifica a caixa de origem. Defina esse parâmetro como NULL para especificar todo o volume.

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 D3DXSaveVolumeToFileW. Caso contrário, a chamada de função será resolvida para >D3DXSaveVolumeToFileA porque as 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

D3DXSaveTextureToFile

D3DXSaveVolumeToFileInMemory