Fungsi D3DXCreateCubeTexture
Membuat tekstur kubus kosong, menyesuaikan parameter panggilan sesuai kebutuhan.
Sintaks
HRESULT D3DXCreateCubeTexture(
_In_ LPDIRECT3DDEVICE9 pDevice,
_In_ UINT Size,
_In_ UINT MipLevels,
_In_ DWORD Usage,
_In_ D3DFORMAT Format,
_In_ D3DPOOL Pool,
_Out_ LPDIRECT3DCUBETEXTURE9 *ppCubeTexture
);
Parameter
-
pDevice [in]
-
Jenis: LPDIRECT3DDEVICE9
Arahkan ke antarmuka IDirect3DDevice9 , yang mewakili perangkat yang akan dikaitkan dengan tekstur.
-
Ukuran [in]
-
Jenis: UINT
Lebar dan tinggi tekstur kubus, dalam piksel. Misalnya, jika tekstur kubus adalah kubus 8 piksel dengan 8 piksel, nilai untuk parameter ini harus 8.
-
MipLevels [in]
-
Jenis: UINT
Jumlah tingkat mip yang diminta. Jika nilai ini nol atau D3DX_DEFAULT, rantai mipmap lengkap akan dibuat.
-
Penggunaan [in]
-
Jenis: DWORD
0, D3DUSAGE_RENDERTARGET, atau D3DUSAGE_DYNAMIC. Mengatur bendera ini ke D3DUSAGE_RENDERTARGET menunjukkan bahwa permukaan akan digunakan sebagai target render. Sumber daya kemudian dapat diteruskan ke parameter pNewRenderTarget dari metode SetRenderTarget . Jika D3DUSAGE_RENDERTARGET ditentukan, aplikasi harus memeriksa apakah perangkat mendukung operasi ini dengan memanggil CheckDeviceFormat. Untuk informasi selengkapnya tentang menggunakan tekstur dinamis, lihat Menggunakan Tekstur Dinamis.
-
Format [in]
-
Jenis: D3DFORMAT
Anggota jenis enumerasi D3DFORMAT , menjelaskan format piksel yang diminta untuk tekstur kubus. Tekstur kubus yang dikembalikan mungkin memiliki format yang berbeda dari yang ditentukan oleh Format. Aplikasi harus memeriksa format tekstur kubus yang dikembalikan.
-
Pool [in]
-
Jenis: D3DPOOL
Anggota jenis D3DPOOL yang dijumlahkan, menjelaskan kelas memori tempat tekstur kubus harus ditempatkan.
-
ppCubeTexture [out]
-
Jenis: LPDIRECT3DCUBETEXTURE9*
Alamat penunjuk ke antarmuka IDirect3DCubeTexture9 , mewakili objek tekstur kubus 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_INVALIDCALL, D3DERR_NOTAVAILABLE, D3DERR_OUTOFVIDEOMEMORY, E_OUTOFMEMORY.
Keterangan
Tekstur kubus berbeda dari permukaan lain karena merupakan koleksi permukaan.
Secara internal, D3DXCreateCubeTexture menggunakan D3DXCheckCubeTextureRequirements untuk menyesuaikan parameter panggilan. Oleh karena itu, panggilan ke D3DXCreateCubeTexture akan sering berhasil di mana panggilan ke CreateCubeTexture akan gagal.
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