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

Siehe auch

Animationsfunktionen

X-Dateiverweis