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 |
|
| Bibliothek |
|
Siehe auch