Função D3DXSaveSurfaceToFile
Salva uma superfície em um arquivo.
Sintaxe
HRESULT D3DXSaveSurfaceToFile(
_In_ LPCTSTR pDestFile,
_In_ D3DXIMAGE_FILEFORMAT DestFormat,
_In_ LPDIRECT3DSURFACE9 pSrcSurface,
_In_ const PALETTEENTRY *pSrcPalette,
_In_ const RECT *pSrcRect
);
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 é 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).
-
pSrcSurface [in]
-
Tipo: LPDIRECT3DSURFACE9
Ponteiro para a interface IDirect3DSurface9 , contendo 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.
-
pSrcRect [in]
-
Tipo: const RECT*
Ponteiro para uma estrutura RECT . Especifica o retângulo de origem. Defina esse parâmetro como NULL para especificar a imagem inteira.
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 D3DXSaveSurfaceToFileW. Caso contrário, a chamada de função será resolvida para D3DXSaveSurfaceToFileA porque as cadeias de caracteres ANSI estão sendo usadas.
Essa função manipula a conversão de e para formatos de textura compactados.
Requisitos
| Requisito | Valor |
|---|---|
| parâmetro |
|
| Biblioteca |
|
Confira também