Fungsi D3DXLoadVolumeFromResource
Memuat volume dari sumber daya.
Sintaks
HRESULT D3DXLoadVolumeFromResource(
_In_ LPDIRECT3DVOLUME9 pDestVolume,
_In_ const PALETTEENTRY *pDestPalette,
_In_ const D3DBOX *pDestBox,
_In_ HMODULE hSrcModule,
_In_ LPCSTR pSrcResource,
_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.
-
hSrcModule [in]
-
Jenis: HMODULE
Tangani ke modul tempat sumber daya berada, atau NULL untuk modul yang terkait dengan gambar yang digunakan sistem operasi untuk membuat proses saat ini.
-
pSrcResource [in]
-
Jenis: LPCSTR
Penunjuk ke string yang menentukan nama file gambar sumber. Jika UNICODE atau _UNICODE ditentukan, jenis parameter ini adalah LPCWSTR, jika tidak, jenisnya adalah LPCSTR.
-
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
Sumber daya yang dimuat harus berupa sumber daya bitmap (RT_BITMAP).
Fungsi ini menangani konversi ke dan dari format tekstur terkompresi.
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.
Fungsi ini mendukung string Unicode dan ANSI.
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