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 文件参考