Fungsi D3DXLoadVolumeFromFile
Memuat volume dari file.
Sintaks
HRESULT D3DXLoadVolumeFromFile(
_In_ LPDIRECT3DVOLUME9 pDestVolume,
_In_ const PALETTEENTRY *pDestPalette,
_In_ const D3DBOX *pDestBox,
_In_ LPCTSTR pSrcFile,
_In_ const D3DBOX *pSrcBox,
_In_ DWORD Filter,
_In_ D3DCOLOR ColorKey,
_In_ D3DXIMAGE_INFO *pSrcInfo
);
Parameter
-
pDestVolume [in]
-
Jenis: LPDIRECT3DVOLUME9
Arahkan ke antarmuka IDirect3DVolume9 . Menentukan volume tujuan.
-
pDestPalette [in]
-
Jenis: const PALETTEENTRY*
Pointer ke struktur PALETTEENTRY , palet tujuan 256 warna atau NULL.
-
pDestBox [in]
-
Jenis: const D3DBOX*
Penunjuk ke struktur D3DBOX . Menentukan kotak tujuan. Atur parameter ini ke NULL untuk menentukan seluruh volume.
-
pSrcFile [in]
-
Jenis: LPCTSTR
Penunjuk ke string yang menentukan nama file. Jika pengaturan pengkompilasi memerlukan Unicode, jenis data LPCTSTR diselesaikan ke LPCWSTR. Jika tidak, jenis data string diselesaikan ke LPCSTR. Lihat Keterangan.
-
pSrcBox [in]
-
Jenis: const D3DBOX*
Penunjuk ke struktur D3DBOX . Menentukan kotak sumber. Atur parameter ini ke NULL untuk menentukan seluruh volume.
-
Filter [in]
-
Jenis: DWORD
Kombinasi satu atau beberapa D3DX_FILTER, mengontrol bagaimana gambar difilter. Menentukan D3DX_DEFAULT untuk parameter ini setara dengan menentukan D3DX_FILTER_TRIANGLE | D3DX_FILTER_DITHER.
-
ColorKey [in]
-
Jenis: D3DCOLOR
Nilai D3DCOLOR untuk diganti dengan hitam transparan, atau 0 untuk menonaktifkan colorkey. Ini selalu merupakan warna ARGB 32-bit, terlepas dari format gambar sumber. Alpha signifikan dan biasanya harus diatur ke FF untuk kunci warna buram. Dengan demikian, untuk hitam buram, nilainya akan sama dengan 0xFF000000.
-
pSrcInfo [in]
-
Jenis: D3DXIMAGE_INFO*
Arahkan ke struktur D3DXIMAGE_INFO untuk diisi dengan deskripsi data dalam file gambar sumber, atau NULL.
Menampilkan nilai
Jenis: HRESULT
Jika fungsi berhasil, nilai yang dikembalikan adalah D3D_OK. Jika fungsi gagal, nilai yang dikembalikan bisa menjadi salah satu nilai berikut: D3DERR_INVALIDCALL, D3DXERR_INVALIDDATA.
Keterangan
Pengaturan kompilator juga menentukan versi fungsi. Jika Unicode ditentukan, panggilan fungsi diselesaikan ke D3DXLoadVolumeFromFileW. Jika tidak, panggilan fungsi menyelesaikan ke D3DXLoadVolumeFromFileA karena string ANSI sedang digunakan.
Fungsi ini menangani konversi ke dan dari format tekstur terkompresi dan mendukung format file berikut: .bmp, .dds, .dib, .hdr, .jpg, .pfm, .png, .ppm, dan .tga. Lihat D3DXIMAGE_FILEFORMAT.
Menulis ke permukaan non-level-nol tekstur volume tidak akan menyebabkan persegi panjang kotor diperbarui. Jika D3DXLoadVolumeFromFile dipanggil dan teksturnya belum kotor (ini tidak mungkin dalam skenario penggunaan normal), aplikasi perlu secara eksplisit memanggil IDirect3DVolumeTexture9::AddDirtyBox pada tekstur volume.
Persyaratan
Persyaratan | Nilai |
---|---|
Header |
|
Pustaka |
|
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk