Metode IDirect3DDevice9::CreateCubeTexture (d3d9helper.h)

Artikel
08/23/2023

Membuat sumber daya tekstur kubus.

Sintaks

HRESULT CreateCubeTexture(
  [in]          UINT                  EdgeLength,
  [in]          UINT                  Levels,
  [in]          DWORD                 Usage,
  [in]          D3DFORMAT             Format,
  [in]          D3DPOOL               Pool,
  [out, retval] IDirect3DCubeTexture9 **ppCubeTexture,
  [in]          HANDLE                *pSharedHandle
);

Parameter

[in] EdgeLength

Jenis: UINT

Ukuran tepi semua wajah tingkat atas tekstur kubus. Dimensi piksel dari tingkat berikutnya dari setiap wajah 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.

[in] Levels

Jenis: UINT

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

[in] Usage

Jenis: DWORD

Penggunaan bisa 0, yang menunjukkan tidak ada nilai penggunaan. Namun, jika penggunaan diinginkan, gunakan kombinasi satu atau beberapa konstanta D3DUSAGE . Adalah praktik yang baik untuk mencocokkan parameter penggunaan di CreateCubeTexture dengan bendera perilaku di IDirect3D9::CreateDevice. Untuk informasi selengkapnya, lihat Keterangan.

[in] Format

Jenis: D3DFORMAT

Anggota jenis enumerasi D3DFORMAT , yang menjelaskan format semua tingkatan di semua wajah tekstur kubus.

[in] Pool

Jenis: D3DPOOL

Anggota jenis enumerasi D3DPOOL , yang menjelaskan kelas memori tempat tekstur kubus harus ditempatkan.

[out, retval] ppCubeTexture

Jenis: IDirect3DCubeTexture9**

Alamat penunjuk ke antarmuka IDirect3DCubeTexture9 , mewakili sumber daya tekstur kubus 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 adalah D3D_OK. Jika metode gagal, nilai yang dikembalikan dapat menjadi salah satu dari yang berikut: D3DERR_INVALIDCALL, D3DERR_OUTOFVIDEOMEMORY, E_OUTOFMEMORY.

Keterangan

Mipmap (tekstur) adalah kumpulan permukaan yang berturut-turut downsampled (mipmapped). Di sisi lain, tekstur kubus (dibuat oleh IDirect3DDevice9::CreateCubeTexture) adalah koleksi enam tekstur (mipmap), satu untuk setiap wajah. Semua wajah harus ada dalam tekstur kubus. Selain itu, permukaan peta kubus harus berukuran piksel yang sama di ketiga dimensi (x, y, dan z).

Aplikasi dapat menemukan dukungan untuk Generasi Otomatis Mipmaps (Direct3D 9) dalam format tertentu dengan memanggil IDirect3D9::CheckDeviceFormat dengan D3DUSAGE_AUTOGENMIPMAP. Jika IDirect3D9::CheckDeviceFormat mengembalikan D3DOK_NOAUTOGEN, IDirect3DDevice9::CreateCubeTexture akan berhasil tetapi akan mengembalikan tekstur satu tingkat.