D3DXSaveMeshHierarchyToFile 函数

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

语法

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

参数

pFilename [in]

类型: LPCSTR

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

XFormat [in]

类型: DWORD

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

pFrameRoot [in]

类型: const D3DXFRAME*

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

pAnimController [in]

类型: LPD3DXANIMATIONCONTROLLER

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

pUserDataSaver [in]

类型: LPD3DXSAVEUSERDATA

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

返回值

类型: HRESULT

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

注解

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

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

要求

要求 Value
标头
D3dx9anim.h

D3dx9.lib

另请参阅

动画函数

X 文件参考