Freigeben über


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
D3dx9anim.h
Bibliothek
D3dx9.lib

Siehe auch

Animationsfunktionen

X-Dateireferenz