D3DXSaveMeshHierarchyToFile-Funktion
Erstellt eine X-Datei und speichert die Gitternetzhierarchie und die entsprechenden Animationen darin.
Syntax
HRESULT D3DXSaveMeshHierarchyToFile(
_In_ LPCSTR pFilename,
_In_ DWORD XFormat,
_In_ const D3DXFRAME *pFrameRoot,
_In_ LPD3DXANIMATIONCONTROLLER pAnimController,
_In_ LPD3DXSAVEUSERDATA pUserDataSaver
);
Parameter
-
pFilename [ In]
-
Typ: LPCSTR
Zeiger auf eine Zeichenfolge, die den Namen der X-Datei angibt, die das gespeicherte Gitternetz identifiziert. Wenn die Compilereinstellungen Unicode erfordern, wird der Datentyp LPCTSTR in LPCWSTR aufgelöst. Andernfalls wird der Zeichenfolgendatentyp in LPCSTR aufgelöst. Siehe Hinweise.
-
XFormat [ In]
-
Typ: DWORD
Format der X-Datei (Text oder Binärdatei, komprimiert oder nicht) Siehe D3DXF _ FILEFORMAT. D3DXF _ FILEFORMAT _ COMPRESSED kann (mithilfe eines logischen OR) entweder mit den D3DXF _ FILEFORMAT _ BINARY- oder D3DXF _ FILEFORMAT _ TEXT-Flags kombiniert werden, um die Größe der Ausgabedatei zu reduzieren.
-
pFrameRoot [ In]
-
Typ: const D3DXFRAME *
Stammknoten der zu speichernden Hierarchie. Siehe D3DXFRAME.
-
pAnimController [ In]
-
Typ: LPD3DXANIMATIONCONTROLLER
Animationscontroller, der über zu speichernde Animationssätze verfügt. Siehe ID3DXAnimationController.
-
pUserDataSaver [ In]
-
Typ: LPD3DXSAVEUSERDATA
Von der Anwendung bereitgestellte Schnittstelle, die das Speichern von Benutzerdaten ermöglicht. Siehe ID3DXSaveUserData.
Rückgabewert
Typ: HRESULT
Wenn die Funktion erfolgreich ausgeführt wird, lautet der Rückgabewert D3D _ OK. Wenn die Funktion fehlschlägt, kann der Rückgabewert D3DERR _ INVALIDCALL sein.
Hinweise
Die Compilereinstellung bestimmt auch die Funktionsversion. Wenn Unicode definiert ist, wird der Funktionsaufruf in D3DXSaveMeshHierarchyToFileW aufgelöst. Andernfalls wird der Funktionsaufruf in D3DXSaveMeshHierarchyToFileA aufgelöst.
Diese Funktion speichert keine komprimierten Animationssätze.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header |
|
| Bibliothek |
|