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 |
|
| Libreria |
|
Vedi anche