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を (論理 OR を使用して) 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 に解決されます。

この関数では、圧縮されたアニメーション セットは保存されません。

要件

要件	値
ヘッダー	D3dx9anim.h
ライブラリ	D3dx9.lib

関連項目

アニメーション関数

X ファイル リファレンス