D3DXCreateCubeTextureFromFile (Fungsi D3DXCreateCubeTextureFromFile)
Membuat tekstur kubus dari file.
Sintaks
HRESULT D3DXCreateCubeTextureFromFile(
_In_ LPDIRECT3DDEVICE9 pDevice,
_In_ LPCTSTR pSrcFile,
_Out_ LPDIRECT3DCUBETEXTURE9 *ppCubeTexture
);
Parameter
-
pDevice [in]
-
Jenis: LPDIRECT3DDEVICE9
Penunjuk ke antarmuka IDirect3DDevice9 , mewakili perangkat yang akan dikaitkan dengan tekstur kubus.
-
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.
-
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 bisa menjadi salah satu nilai berikut: D3DERR_INVALIDCALL, D3DERR_NOTAVAILABLE, D3DERR_OUTOFVIDEOMEMORY, D3DXERR_INVALIDDATA, E_OUTOFMEMORY.
Keterangan
Pengaturan pengkompilasi juga menentukan versi fungsi. Jika Unicode ditentukan, panggilan fungsi menyelesaikan ke D3DXCreateCubeTextureFromFileW. Jika tidak, panggilan fungsi menyelesaikan ke D3DXCreateCubeTextureFromFileA karena string ANSI sedang digunakan.
Fungsi ini setara dengan D3DXCreateCubeTextureFromFileEx(pDevice, pSrcFile, D3DX_DEFAULT, D3DX_DEFAULT, 0, D3DFMT_UNKNOWN, D3DPOOL_MANAGED, D3DX_DEFAULT, D3DX_DEFAULT, 0, NULL, NULL, ppCubeTexture).
Fungsi ini mendukung format file berikut: .bmp, .dds, .dib, .hdr, .jpg, .pfm, .png, .ppm, dan .tga. Lihat D3DXIMAGE_FILEFORMAT.
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.
D3DXCreateCubeTextureFromFile menggunakan format file permukaan DirectDraw (DDS). Editor Tekstur DirectX (Dxtex.exe) memungkinkan Anda membuat peta kubus dari format file lain dan menyimpannya dalam format file DDS. Anda bisa mendapatkan Dxtex.exe dan mempelajarinya dari DirectX SDK. Untuk informasi tentang DirectX SDK, lihat Di mana DirectX SDK?.
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