D3DXSaveMeshHierarchyToFile-Funktion
Erstellt eine X-Datei und speichert die Gitterhierarchie 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 können (mithilfe eines logischen OR) mit den D3DXF_FILEFORMAT_BINARY- oder D3DXF_FILEFORMAT_TEXT-Flags kombiniert werden, um die Größe der Ausgabedatei zu verringern.
-
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 ist, wird der Rückgabewert D3D_OK. Wenn die Funktion fehlschlägt, kann der Rückgabewert sein: D3DERR_INVALIDCALL.
Bemerkungen
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 |
|
Siehe auch