D3DXSaveMeshToX-Funktion

Speichert ein Gitternetz in einer X-Datei.

Syntax

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]

Typ: LPCTSTR

Zeiger auf eine Zeichenfolge, die den Dateinamen angibt. Wenn die Compilereinstellungen Unicode erfordern, wird der Datentyp LPCTSTR in LPCWSTR aufgelöst. Andernfalls wird der Zeichenfolgendatentyp in LPCSTR aufgelöst. Siehe Hinweise.

pMesh [in]

Typ: LPD3DXMESH

Zeiger auf eine ID3DXMesh-Schnittstelle , die das Gitter darstellt, das in einer X-Datei gespeichert werden soll.

pAdjacency [in]

Typ: const DWORD*

Zeiger auf ein Array von drei DWORDs pro Gesicht, die die drei Nachbarn für jedes Gesicht im Gitter angeben. Dieser Parameter kann NULL sein.

pMaterials [in]

Typ: const D3DXMATERIAL*

Zeiger auf ein Array von D3DXMATERIAL-Strukturen , das Materialinformationen enthält, die in der X-Datei gespeichert werden sollen.

pEffectInstances [in]

Typ: const D3DXEFFECTINSTANCE*

Zeiger auf ein Array von Effektinstanzen, eine pro Attributgruppe im Gitter. Dieser Parameter kann NULL sein. Ein Effekt instance ist ein bestimmter instance von Zustandsinformationen, die zum Initialisieren eines Effekts verwendet werden. Weitere Informationen finden Sie unter D3DXEFFECTINSTANCE.

NumMaterials [in]

Typ: DWORD

Anzahl der D3DXMATERIAL-Strukturen im pMaterials-Array .

Formatieren [in]

Typ: DWORD

Eine Kombination aus Dateiformat und Speicheroptionen beim Speichern einer X-Datei. Siehe D3DX X-Dateikonstanten.

Rückgabewert

Typ: HRESULT

Wenn die Funktion erfolgreich ist, wird der Rückgabewert D3D_OK. Wenn die Funktion fehlschlägt, kann der Rückgabewert einer der folgenden sein: D3DERR_INVALIDCALL.

Bemerkungen

Die Compilereinstellung bestimmt auch die Funktionsversion. Wenn Unicode definiert ist, wird der Funktionsaufruf in D3DXSaveMeshToXW aufgelöst. Andernfalls wird der Funktionsaufruf in D3DXSaveMeshToXA aufgelöst, da ANSI-Zeichenfolgen verwendet werden.

Das Standarddateiformat ist Binärdatei. Wenn eine Datei jedoch sowohl als Binärdatei als auch als Textdatei angegeben wird, wird sie als Textdatei gespeichert. Unabhängig vom Dateiformat können Sie auch das komprimierte Format verwenden, um die Dateigröße zu reduzieren.

Im Folgenden finden Sie ein typisches Codebeispiel für die Verwendung dieser Funktion.

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

Anforderungen

Anforderung	Wert
Header	D3DX9Mesh.h
Bibliothek	D3dx9.lib

Siehe auch

Gitterfunktionen

D3DXEFFECTDEFAULT

D3DXEFFECTINSTANCE