Funzione D3DXSaveMeshToX

Salva una mesh in un file con estensione x.

Sintassi

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
);

Parametri

pFilename [in]

Tipo: LPCTSTR

Puntatore a una stringa che specifica il nome file. Se le impostazioni del compilatore richiedono Unicode, il tipo di dati LPCTSTR viene risolto in LPCWSTR. In caso contrario, il tipo di dati stringa viene risolto in LPCSTR. Vedere la sezione Osservazioni.

pMesh [in]

Tipo: LPD3DXMESH

Puntatore a un'interfaccia ID3DXMesh che rappresenta la mesh da salvare in un file con estensione x.

pAdjacency [in]

Tipo: const DWORD*

Puntatore a una matrice di tre DWORD per viso che specificano i tre vicini per ogni viso nella mesh. Questo parametro può essere NULL.

pMaterials [in]

Tipo: const D3DXMATERIAL*

Puntatore a una matrice di strutture D3DXMATERIAL , contenente le informazioni sui materiali da salvare nel file con estensione x.

pEffectInstances [in]

Tipo: const D3DXEFFECTINSTANCE*

Puntatore a una matrice di istanze dell'effetto, una per ogni gruppo di attributi nella mesh. Questo parametro può essere NULL. Un'istanza dell'effetto è una particolare istanza delle informazioni sullo stato utilizzate per inizializzare un effetto. Per altre informazioni, vedere D3DXEFFECTINSTANCE.

NumMaterials [in]

Tipo: DWORD

Numero di strutture D3DXMATERIAL nella matrice pMaterials .

Formato [in]

Tipo: DWORD

Combinazione di opzioni di formato di file e salvataggio durante il salvataggio di un file con estensione x. Vedere Costanti di file D3DX X.

Valore restituito

Tipo: HRESULT

Se la funzione ha esito positivo, il valore restituito viene D3D_OK. Se la funzione ha esito negativo, il valore restituito può essere uno dei seguenti: D3DERR_INVALIDCALL.

Commenti

L'impostazione del compilatore determina anche la versione della funzione. Se è definito Unicode, la chiamata di funzione viene risolta in D3DXSaveMeshToXW. In caso contrario, la chiamata di funzione viene risolta in D3DXSaveMeshToXA perché vengono usate stringhe ANSI.

Il formato di file predefinito è binario; tuttavia, se un file viene specificato sia come file binario che come file di testo, verrà salvato come file di testo. Indipendentemente dal formato di file, è anche possibile usare il formato compresso per ridurre le dimensioni del file.

Di seguito è riportato un esempio di codice tipico di come usare questa funzione.

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 );

Requisiti

Requisito	Valore
Intestazione	D3DX9Mesh.h
Libreria	D3dx9.lib

Vedi anche

Funzioni mesh

D3DXEFFECTDEFAULT

D3DXEFFECTINSTANCE