Metode IDirect3DDevice9::CreateVolumeTexture (d3d9helper.h)

Artikel
02/28/2024

Membuat sumber daya tekstur volume.

Sintaks

HRESULT CreateVolumeTexture(
  [in]          UINT                    Width,
  [in]          UINT                    Height,
  [in]          UINT                    Depth,
  [in]          UINT                    Levels,
  [in]          DWORD                   Usage,
  [in]          D3DFORMAT               Format,
  [in]          D3DPOOL                 Pool,
  [out, retval] IDirect3DVolumeTexture9 **ppVolumeTexture,
  [in]          HANDLE                  *pSharedHandle
);

Parameter

[in] Width

Jenis: UINT

Lebar tingkat atas tekstur volume, dalam piksel. Nilai ini harus memiliki kekuatan dua jika anggota D3DPTEXTURECAPS_VOLUMEMAP_POW2 D3DCAPS9 ditetapkan. Dimensi piksel dari tingkat berikutnya akan menjadi nilai terpotong dari setengah dari dimensi piksel tingkat sebelumnya (secara independen). Setiap dimensi menjepit pada ukuran 1 piksel. Dengan demikian, jika pembagian dengan dua menghasilkan 0 (nol), 1 akan diambil sebagai gantinya. Dimensi maksimum yang didukung driver (untuk lebar, tinggi, dan kedalaman) dapat ditemukan di MaxVolumeExtent di D3DCAPS9.

[in] Height

Jenis: UINT

Tinggi tingkat atas tekstur volume, dalam piksel. Nilai ini harus memiliki kekuatan dua jika anggota D3DPTEXTURECAPS_VOLUMEMAP_POW2 D3DCAPS9 ditetapkan. Dimensi piksel dari tingkat berikutnya akan menjadi nilai terpotong dari setengah dari dimensi piksel tingkat sebelumnya (secara independen). Setiap dimensi menjepit pada ukuran 1 piksel. Dengan demikian, jika pembagian dengan 2 menghasilkan 0 (nol), 1 akan diambil sebagai gantinya. Dimensi maksimum yang didukung driver (untuk lebar, tinggi, dan kedalaman) dapat ditemukan di MaxVolumeExtent di D3DCAPS9.

[in] Depth

Jenis: UINT

Kedalaman tingkat atas tekstur volume, dalam piksel. Nilai ini harus memiliki kekuatan dua jika anggota D3DPTEXTURECAPS_VOLUMEMAP_POW2 D3DCAPS9 ditetapkan. Dimensi piksel dari tingkat berikutnya akan menjadi nilai terpotong dari setengah dari dimensi piksel tingkat sebelumnya (secara independen). Setiap dimensi menjepit pada ukuran 1 piksel. Dengan demikian, jika pembagian dengan 2 menghasilkan 0 (nol), 1 akan diambil sebagai gantinya. Dimensi maksimum yang didukung driver (untuk lebar, tinggi, dan kedalaman) dapat ditemukan di MaxVolumeExtent di D3DCAPS9.

[in] Levels

Jenis: UINT

Jumlah tingkat dalam tekstur. Jika ini nol, Direct3D akan menghasilkan semua sublevel tekstur hingga 1x1 piksel untuk perangkat keras yang mendukung tekstur volume mipmapped. Panggil IDirect3DBaseTexture9::GetLevelCount untuk melihat jumlah tingkat yang dihasilkan.

[in] Usage

Jenis: DWORD

Penggunaan bisa 0, yang menunjukkan tidak ada nilai penggunaan. Jika penggunaan diinginkan, gunakan D3DUSAGE_DYNAMIC atau D3DUSAGE_SOFTWAREPROCESSING. Untuk informasi selengkapnya, lihat D3DUSAGE.

[in] Format

Jenis: D3DFORMAT

Anggota jenis D3DFORMAT yang dijumlahkan, menjelaskan format semua tingkat dalam tekstur volume.

[in] Pool

Jenis: D3DPOOL

Anggota jenis D3DPOOL yang dijumlahkan, menjelaskan kelas memori tempat tekstur volume harus ditempatkan.

[out, retval] ppVolumeTexture

Jenis: IDirect3DVolumeTexture9**

Alamat penunjuk ke antarmuka IDirect3DVolumeTexture9 , mewakili sumber daya tekstur volume yang dibuat.

[in] pSharedHandle

Jenis: HANDEL*

Dicadangkan. Atur parameter ini ke NULL. Parameter ini dapat digunakan di Direct3D 9 untuk Windows Vista untuk berbagi sumber daya.

Mengembalikan nilai

Jenis: HRESULT

Jika metode berhasil, nilai yang dikembalikan D3D_OK. Jika metode gagal, nilai yang dikembalikan dapat berupa salah satu hal berikut: D3DERR_INVALIDCALL, D3DERR_OUTOFVIDEOMEMORY, E_OUTOFMEMORY.