Функция D3DXSaveMeshHierarchyToFile

Статья
06/13/2023

Создает X-файл и сохраняет в нем иерархию сетки и соответствующие анимации.

Синтаксис

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

Параметры

pFilename [in]

Тип: LPCSTR

Указатель на строку, указывающую имя X-файла, определяющего сохраненную сетку. Если для параметров компилятора требуется Юникод, тип данных 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.

Параметр компилятора также определяет версию функции. Если определен Юникод, вызов функции разрешается в D3DXSaveMeshHierarchyToFileW. В противном случае вызов функции разрешается в D3DXSaveMeshHierarchyToFileA.

Эта функция не сохраняет сжатые наборы анимации.

Требования

Требование	Значение
Заголовок	D3dx9anim.h
Библиотека	D3dx9.lib

См. также раздел

Функции анимации
Справочник по X-файлу