Fungsi D3DXSaveTextureToFile

Menyimpan tekstur ke file.

Sintaks

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

Parameter

pDestFile [in]

Jenis: LPCTSTR

Penunjuk ke string yang menentukan nama file gambar tujuan. Jika pengaturan pengkompilasi memerlukan Unicode, jenis data LPCTSTR diselesaikan ke LPCWSTR. Jika tidak, jenis data string diselesaikan ke LPCSTR. Lihat Keterangan.

DestFormat [in]

Jenis: D3DXIMAGE_FILEFORMAT

D3DXIMAGE_FILEFORMAT menentukan format file yang akan digunakan saat menyimpan. Fungsi ini mendukung penyimpanan ke semua format D3DXIMAGE_FILEFORMAT kecuali Portable Pixmap (.ppm) dan Targa/Truevision Graphics Adapter (.tga).

pSrcTexture [in]

Jenis: LPDIRECT3DBASETEXTURE9

Arahkan ke antarmuka IDirect3DBaseTexture9 , yang berisi tekstur yang akan disimpan.

pSrcPalette [in]

Jenis: const PALETTEENTRY*

Pointer ke struktur PALETTEENTRY yang berisi palet 256 warna. Parameter ini bisa NULL.

Menampilkan nilai

Jenis: HRESULT

Jika fungsi berhasil, nilai yang dikembalikan adalah D3D_OK. Jika fungsi gagal, nilai yang dikembalikan bisa menjadi berikut: D3DERR_INVALIDCALL

Keterangan

Pengaturan kompilator juga menentukan versi fungsi. Jika Unicode ditentukan, panggilan fungsi diselesaikan ke D3DXSaveTextureToFileW. Jika tidak, panggilan fungsi diselesaikan ke D3DXSaveTextureToFileA karena string ANSI sedang digunakan.

Fungsi ini menangani konversi ke dan dari format tekstur terkompresi.

Jika volume nondinamis (karena parameter penggunaan yang diatur ke 0 pada pembuatan) dan terletak di memori video (kumpulan memori diatur ke D3DPOOL_DEFAULT), D3DXSaveTextureToFile akan gagal karena D3DX tidak dapat mengunci volume nondinamika yang terletak di memori video.

Persyaratan

Persyaratan	Nilai
Header	D3dx9tex.h
Pustaka	D3dx9.lib

Lihat juga

Fungsi Tekstur di D3DX 9

D3DXSaveSurfaceToFile

D3DXSaveVolumeToFile