D3DXSaveMeshHierarchyToFile 函数

创建 .x 文件,并在其中保存网格层次结构和相应的动画。

语法

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

parameters

pFilename [in]

类型: LPCSTR

指向字符串的指针,该字符串指定标识已保存网格的 .x 文件的名称。 如果编译器设置需要 Unicode,则数据类型 LPCTSTR 解析为 LPCWSTR。 否则,字符串数据类型解析为 LPCSTR。 请参阅“备注”。

XFormat [in]

类型: DWORD

.x 文件的格式 (文本或二进制文件、压缩或未) 。 请参阅D3DXF_FILEFORMAT。 可以使用逻辑 OR) 与D3DXF_FILEFORMAT_BINARY或D3DXF_FILEFORMAT_TEXT标志结合使用 (D3DXF_FILEFORMAT_COMPRESSED,以减少输出文件大小。

pFrameRoot [in]

类型: const D3DXFRAME*

要保存的层次结构的根节点。 请参阅 D3DXFRAME

pAnimController [in]

类型: LPD3DXANIMATIONCONTROLLER

具有要存储的动画集的动画控制器。 请参阅 ID3DXAnimationController

pUserDataSaver [in]

类型: LPD3DXSAVEUSERDATA

应用程序提供的接口,允许保存用户数据。 请参阅 ID3DXSaveUserData

返回值

类型: HRESULT

如果函数成功,则返回值D3D_OK。 如果函数失败,则返回值可以是:D3DERR_INVALIDCALL。

备注

编译器设置还确定函数版本。 如果定义了 Unicode,则函数调用将解析为 D3DXSaveMeshHierarchyToFileW。 否则,函数调用将解析为 D3DXSaveMeshHierarchyToFileA。

此函数不保存压缩的动画集。

要求

要求
标头
D3dx9anim.h

D3dx9.lib

另请参阅

动画函数

X 文件参考