Fungsi D3DXSaveMeshToX

Artikel
06/13/2023

Menyimpan jala ke file .x.

Sintaks

HRESULT D3DXSaveMeshToX(
  _In_       LPCTSTR            pFilename,
  _In_       LPD3DXMESH         pMesh,
  _In_ const DWORD              *pAdjacency,
  _In_ const D3DXMATERIAL       *pMaterials,
  _In_ const D3DXEFFECTINSTANCE *pEffectInstances,
  _In_       DWORD              NumMaterials,
  _In_       DWORD              Format
);

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.

pMesh [in]

Jenis: LPD3DXMESH

Penunjuk ke antarmuka ID3DXMesh , mewakili jala untuk disimpan ke file .x.

pAdjacency [in]

Jenis: const DWORD*

Penunjuk ke array tiga DWORD per wajah yang menentukan tiga tetangga untuk setiap wajah dalam jala. Parameter ini mungkin NULL.

pMaterials [in]

Jenis: const D3DXMATERIAL*

Penunjuk ke array struktur D3DXMATERIAL , berisi informasi material yang akan disimpan dalam file .x.

pEffectInstances [in]

Jenis: const D3DXEFFECTINSTANCE*

Penunjuk ke array instans efek, satu per grup atribut dalam jala. Parameter ini mungkin NULL. Instans efek adalah contoh informasi status tertentu yang digunakan untuk menginisialisasi efek. Untuk informasi selengkapnya, lihat D3DXEFFECTINSTANCE.

NumMaterials [in]

Jenis: DWORD

Jumlah struktur D3DXMATERIAL dalam array pMaterials .

Format [in]

Jenis: DWORD

Kombinasi format file dan opsi simpan saat menyimpan file .x. Lihat Konstanta File D3DX X.

Menampilkan nilai

Jenis: HRESULT

Jika fungsi berhasil, nilai yang dikembalikan adalah D3D_OK. Jika fungsi gagal, nilai yang dikembalikan bisa menjadi salah satu dari yang berikut: D3DERR_INVALIDCALL.

Keterangan

Pengaturan pengkompilasi juga menentukan versi fungsi. Jika Unicode ditentukan, panggilan fungsi diselesaikan ke D3DXSaveMeshToXW. Jika tidak, panggilan fungsi menyelesaikan ke D3DXSaveMeshToXA karena string ANSI sedang digunakan.

Format file default adalah biner; namun, jika file ditentukan sebagai biner dan file teks, file tersebut akan disimpan sebagai file teks. Terlepas dari format file, Anda juga dapat menggunakan format terkompresi untuk mengurangi ukuran file.

Berikut ini adalah contoh kode umum tentang cara menggunakan fungsi ini.

ID3DXMesh*    m_pMesh;           // Mesh object to be saved to a .x file
D3DXMATERIAL* m_pMaterials;      // Array of material structs in the mesh
DWORD         m_dwNumMaterials;  // Number of material structs in the mesh
    
DWORD dwFormat = D3DXF_FILEFORMAT_BINARY;  // Binary-format .x file (default)
// DWORD dwFormat = D3DXF_FILEFORMAT_TEXT; // Text-format .x file
    
// Load mesh into m_pMesh and determine values of m_pMaterials and 
// m_dwNumMaterials with calls to D3DXLoadMeshxxx or other D3DX functions
    
// ...
        
D3DXSaveMeshToX(
    L"outputxfilename.x",
    m_pMesh,
    NULL,
    m_pMaterials,
    NULL,
    m_dwNumMaterials,
    dwFormat );

Persyaratan

Persyaratan	Nilai
Header	D3DX9Mesh.h
Pustaka	D3dx9.lib

Lihat juga

Fungsi Jala
D3DXEFFECTDEFAULT
D3DXEFFECTINSTANCE

Bagikan melalui