Fungsi D3DXLoadMeshFromX
Memuat jala dari file DirectX .x.
Sintaks
HRESULT D3DXLoadMeshFromX(
_In_ LPCTSTR pFilename,
_In_ DWORD Options,
_In_ LPDIRECT3DDEVICE9 pD3DDevice,
_Out_ LPD3DXBUFFER *ppAdjacency,
_Out_ LPD3DXBUFFER *ppMaterials,
_Out_ LPD3DXBUFFER *ppEffectInstances,
_Out_ DWORD *pNumMaterials,
_Out_ LPD3DXMESH *ppMesh
);
Parameter
-
pFilename [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.
-
Opsi [in]
-
Jenis: DWORD
Kombinasi satu atau beberapa bendera dari enumerasi D3DXMESH , yang menentukan opsi pembuatan untuk jala.
-
pD3DDevice [in]
-
Jenis: LPDIRECT3DDEVICE9
Penunjuk ke antarmuka IDirect3DDevice9 , objek perangkat yang terkait dengan jala.
-
ppAdjacency [out]
-
Jenis: LPD3DXBUFFER*
Penunjuk ke buffer yang berisi data yang berdekatan. Data yang berdekatan berisi array tiga DWORD per wajah yang menentukan tiga tetangga untuk setiap wajah dalam jala. Untuk informasi selengkapnya tentang mengakses buffer, lihat ID3DXBuffer.
-
ppMaterials [out]
-
Jenis: LPD3DXBUFFER*
Penunjuk ke buffer yang berisi data material. Buffer berisi array struktur D3DXMATERIAL , yang berisi informasi dari file DirectX. Untuk informasi selengkapnya tentang mengakses buffer, lihat ID3DXBuffer.
-
ppEffectInstances [out]
-
Jenis: LPD3DXBUFFER*
Penunjuk ke buffer yang berisi array instans efek, satu per grup atribut dalam jala yang dikembalikan. Instans efek adalah contoh informasi status tertentu yang digunakan untuk menginisialisasi efek. Lihat D3DXEFFECTINSTANCE. Untuk informasi selengkapnya tentang mengakses buffer, lihat ID3DXBuffer.
-
pNumMaterials [out]
-
Jenis: DWORD*
Arahkan ke jumlah struktur D3DXMATERIAL dalam array ppMaterials , saat metode kembali.
-
ppMesh [out]
-
Jenis: LPD3DXMESH*
Alamat penunjuk ke antarmuka ID3DXMesh , mewakili jala yang dimuat.
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, E_OUTOFMEMORY.
Keterangan
Pengaturan pengkompilasi juga menentukan versi fungsi. Jika Unicode ditentukan, panggilan fungsi diselesaikan ke D3DXLoadMeshFromXW. Jika tidak, panggilan fungsi menyelesaikan ke D3DXLoadMeshFromXA karena string ANSI sedang digunakan.
Semua jala dalam file akan diciutkan menjadi satu jala output. Jika file berisi hierarki bingkai, semua transformasi akan diterapkan ke jala.
Untuk file jala yang tidak berisi informasi instans efek, instans efek default akan dihasilkan dari informasi material dalam file .x. Instans efek default akan memiliki nilai default yang sesuai dengan anggota struktur D3DMATERIAL9 .
Nama tekstur default juga diisi, tetapi ditangani secara berbeda. Nama akan Texture0@Name, yang sesuai dengan variabel efek dengan nama "Texture0" dengan anotasi yang disebut "Nama." Ini akan berisi nama file string untuk tekstur.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Header |
|
| Pustaka |
|
Lihat juga