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
Penunjuk ke antarmuka IDirect3DBaseTexture9 , berisi tekstur yang akan disimpan.
-
pSrcPalette [in]
-
Jenis: const PALETTEENTRY*
Penunjuk ke struktur PALETTEENTRY yang berisi palet 256 warna. Parameter ini bisa NULL.
Mengembalikan 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 pengkompilasi juga menentukan versi fungsi. Jika Unicode didefinisikan, panggilan fungsi menyelesaikan ke D3DXSaveTextureToFileW. Jika tidak, panggilan fungsi menyelesaikan 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 nondinamik yang terletak di memori video.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Header |
|
| Pustaka |
|
Lihat juga