Partager via


Fonction D3DXSaveMeshHierarchyToFile

Crée un fichier .x et enregistre la hiérarchie de maillage et les animations correspondantes dans celui-ci.

Syntaxe

HRESULT D3DXSaveMeshHierarchyToFile(
  _In_       LPCSTR                    pFilename,
  _In_       DWORD                     XFormat,
  _In_ const D3DXFRAME                 *pFrameRoot,
  _In_       LPD3DXANIMATIONCONTROLLER pAnimController,
  _In_       LPD3DXSAVEUSERDATA        pUserDataSaver
);

Paramètres

pFilename [in]

Type : LPCSTR

Pointeur vers une chaîne qui spécifie le nom du fichier .x identifiant le maillage enregistré. Si les paramètres du compilateur nécessitent Unicode, le type de données LPCTSTR est résolu en LPCWSTR. Sinon, le type de données de chaîne est résolu en LPCSTR. Consultez la section Notes.

XFormat [in]

Type : DWORD

Format du fichier .x (texte ou binaire, compressé ou non). Voir D3DXF_FILEFORMAT. D3DXF_FILEFORMAT_COMPRESSED peuvent être combinés (à l’aide d’un OR logique) avec les indicateurs D3DXF_FILEFORMAT_BINARY ou D3DXF_FILEFORMAT_TEXT pour réduire la taille du fichier de sortie.

pFrameRoot [in]

Type : const D3DXFRAME*

Nœud racine de la hiérarchie à enregistrer. Consultez D3DXFRAME.

pAnimController [in]

Type : LPD3DXANIMATIONCONTROLLER

Contrôleur d’animation qui a des jeux d’animation à stocker. Consultez ID3DXAnimationController.

pUserDataSaver [in]

Type : LPD3DXSAVEUSERDATA

Interface fournie par l’application qui permet l’enregistrement des données utilisateur. Consultez ID3DXSaveUserData.

Valeur retournée

Type : HRESULT

Si la fonction réussit, la valeur de retour est D3D_OK. Si la fonction échoue, la valeur de retour peut être : D3DERR_INVALIDCALL.

Notes

Le paramètre du compilateur détermine également la version de la fonction. Si Unicode est défini, l’appel de fonction est résolu en D3DXSaveMeshHierarchyToFileW. Sinon, l’appel de fonction est résolu en D3DXSaveMeshHierarchyToFileA.

Cette fonction n’enregistre pas les jeux d’animations compressés.

Spécifications

Condition requise Valeur
En-tête
D3dx9anim.h
Bibliothèque
D3dx9.lib

Voir aussi

Fonctions d’animation

Référence de fichier X