D3DXSaveTextureToFile (funzione)

Salva una trama in un file.

Sintassi

HRESULT D3DXSaveTextureToFile(
  _In_       LPCTSTR                pDestFile,
  _In_       D3DXIMAGE_FILEFORMAT   DestFormat,
  _In_       LPDIRECT3DBASETEXTURE9 pSrcTexture,
  _In_ const PALETTEENTRY           *pSrcPalette
);

Parametri

pDestFile [ in]

Tipo: LPCTSTR

Puntatore a una stringa che specifica il nome del file dell'immagine di destinazione. Se le impostazioni del compilatore richiedono Unicode, il tipo di dati LPCTSTR viene risolto in LPCWSTR. In caso contrario, il tipo di dati String viene risolto in LPCSTR. Vedere la sezione Osservazioni.

DestFormat [ in]

Tipo: D3DXIMAGE _ FileFormat

D3DXIMAGE _ FileFormat che specifica il formato di file da utilizzare per il salvataggio. Questa funzione supporta il salvataggio in tutti i formati D3DXIMAGE _ FileFormat ad eccezione di Portable Pixmap (. ppm) e targa/Truevision Graphics Adapter (. tga).

pSrcTexture [ in]

Tipo: LPDIRECT3DBASETEXTURE9

Puntatore all'interfaccia IDirect3DBaseTexture9 contenente la trama da salvare.

pSrcPalette [ in]

Tipo: const PaletteEntry *

Puntatore a una struttura PaletteEntry contenente una tavolozza di colori 256. Questo parametro può essere NULL.

Valore restituito

Tipo: HRESULT

Se la funzione ha esito positivo, il valore restituito è D3D _ OK. Se la funzione ha esito negativo, il valore restituito può essere il seguente: D3DERR _ INVALIDCALL

Commenti

L'impostazione del compilatore determina anche la versione della funzione. Se è definito Unicode, la chiamata di funzione viene risolta in D3DXSaveTextureToFileW. In caso contrario, la chiamata di funzione viene risolta in D3DXSaveTextureToFileA perché vengono utilizzate le stringhe ANSI.

Questa funzione gestisce la conversione da e verso formati di trama compressi.

Se il volume è non dinamico (a causa di un parametro Usage impostato su 0 alla creazione) e situato nella memoria video (il pool di memoria impostato su D3DPOOL _ default), D3DXSaveTextureToFile avrà esito negativo perché D3DX non può bloccare i volumi non dinamici presenti nella memoria video.

Requisiti

Requisito Valore
Intestazione
D3dx9tex. h
Libreria
D3dx9. lib

Vedi anche

Funzioni di trama in D3DX 9

D3DXSaveSurfaceToFile

D3DXSaveVolumeToFile