D3DXCreateVolumeTextureFromFile (Fungsi D3DXCreateVolumeTextureFromFile)
Membuat tekstur volume dari file.
Sintaks
HRESULT D3DXCreateVolumeTextureFromFile(
_In_ LPDIRECT3DDEVICE9 pDevice,
_In_ LPCTSTR pSrcFile,
_Out_ LPDIRECT3DVOLUMETEXTURE9 *ppVolumeTexture
);
Parameter
-
pDevice [in]
-
Jenis: LPDIRECT3DDEVICE9
Arahkan ke antarmuka IDirect3DDevice9 , yang mewakili perangkat yang akan dikaitkan dengan tekstur 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.
-
ppVolumeTexture [out]
-
Jenis: LPDIRECT3DVOLUMETEXTURE9*
Alamat penunjuk ke antarmuka IDirect3DVolumeTexture9 yang mewakili objek tekstur yang dibuat.
Menampilkan nilai
Jenis: HRESULT
Jika fungsi berhasil, nilai yang dikembalikan adalah D3D_OK. Jika fungsi gagal, nilai yang dikembalikan dapat berupa salah satu hal berikut: D3DERR_NOTAVAILABLE, D3DERR_OUTOFVIDEOMEMORY, D3DERR_INVALIDCALL, D3DXERR_INVALIDDATA, E_OUTOFMEMORY.
Keterangan
Pengaturan kompilator juga menentukan versi fungsi. Jika Unicode ditentukan, panggilan fungsi diselesaikan ke D3DXCreateVolumeTextureFromFileW. Jika tidak, panggilan fungsi menyelesaikan ke D3DXCreateVolumeTextureFromFileA karena string ANSI sedang digunakan.
Fungsi ini setara dengan D3DXCreateVolumeTextureFromFileEx(pDevice, pSrcFile, D3DX_DEFAULT, D3DX_DEFAULT, D3DX_DEFAULT, D3DX_DEFAULT, 0, D3DFMT_UNKNOWN, D3DPOOL_MANAGED, D3DX_DEFAULT, D3DX_DEFAULT, 0, NULL, NULL, ppVolumeTexture).
Fungsi ini mendukung format file berikut: .bmp, .dds, .dib, .hdr, .jpg, .pfm, .png, .ppm, dan .tga. Lihat D3DXIMAGE_FILEFORMAT.
Tekstur mipmapped secara otomatis memiliki setiap tingkat yang diisi dengan tekstur yang dimuat.
Saat memuat gambar ke dalam tekstur mipmapped, beberapa perangkat tidak dapat masuk ke gambar 1x1 dan fungsi ini akan gagal. Jika ini terjadi, maka gambar perlu dimuat secara manual.
Perhatikan bahwa sumber daya yang dibuat dengan fungsi ini ketika dipanggil dari objek IDirect3DDevice9 akan ditempatkan di kelas memori yang ditandai dengan D3DPOOL_MANAGED. Ketika metode ini dipanggil dari objek IDirect3DDevice9Ex, sumber daya akan ditempatkan di kelas memori yang ditandai dengan D3DPOOL_DEFAULT.
Pemfilteran secara otomatis diterapkan ke tekstur yang dibuat menggunakan metode ini. Pemfilteran setara dengan D3DX_FILTER_TRIANGLE | D3DX_FILTER_DITHER di D3DX_FILTER.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Header |
|
| Pustaka |
|
Lihat juga