HIKCharacter を視覚的にキャラクタライズする

MotionBuilder

MotionBuilder と HumanIK は同じコア テクノロジから開発され、ビルトイン生体力学モデルへのスケルトンのマッピングに対して多くの同じ要件を現在も共有しています。MotionBuilder で作成した、動作する Biped または Quadruped のキャラクタライゼーションは HumanIK API で使用したときも同様に動作するはずです。ただし、HumanIK API を使用してロードできるファイルに MotionBuilder キャラクタライゼーションを書き出すには、まず使用しているバージョンの MotionBuilder 用の HumanIK プラグインをビルドしてインストールする必要があります。

「MotionBuilder HumanIK ソルバ プラグイン」を参照してください。

Maya 2012 以降

2012 リリース以降の Maya には、キャラクタ スケルトン用の HumanIK キャラクタライゼーションの作成、HumanIK コントロール リグを使用したキャラクタのアニメート、HumanIK SDK で使用可能なバイナリ ファイルへのキャラクタライゼーションの書き出しに使用することができるツールが含まれています。

HumanIK Characterization Tool

組織内でサポートされているバージョンの MotionBuilder または Maya を使用していない場合でも、HumanIK SDK に付属の Characterization Tool を使用して HumanIK キャラクタライゼーションを視覚的に作成することができます。

Characterization Tool は次のような形で提供されています。

• Maya 2011 のプラグイン。
• Softimage 2011 のプラグイン。
• FBX ファイルのコンテンツからキャラクタライゼーションを作成するスタンドアロン バージョン。

これらのバージョンの Characterization Tool は、Windows プラットフォームに対応した HumanIK パッケージの tools フォルダ内のサブフォルダに含まれています。各バージョンにはインストールと使用方法について説明するドキュメントが付属しています。このドキュメントはまた Characterization Tool のインタフェースからも開くことができます。

アーティストは、パイプラインに最適なバージョンを選択できます。

.hik ファイル(MotionBuilder から)

HIKLoadCharacter() 関数を呼び出して、.hik ファイルに含まれているデータから新しい HIKCharacter を作成します。この関数には次の引数が必要です。

• キャラクタを含む .hik ファイルのパスおよびファイル名

• HumanIK の評価バージョンを使用している場合は、Autodesk, Inc.によって発行されたライセンス キー。「HumanIK のライセンス キーを設定する」で推奨されるように、ソース コード ファイルに autodeskmwkey.h ファイルをインクルードした場合は、定義済みの値 AutodeskCustomerString を使用できます。HumanIKのフル ライセンス バージョンを使用している場合は、null 値を渡すことができます。

• HIKCharacter にメモリを割り当てるために呼び出されるコールバック関数へのポインタ。標準の malloc 関数、または malloc と同じ種類の定義を満たす任意のカスタム メモリ割り当て方法を指定できます。「 HumanIK オブジェクトとメモリ管理」を参照してください。

例:

HIKCharacter * MyChar = HIKLoadCharacter(
                                   "C:\data\hero.hik",
                                   AutodeskCustomerString,
                                   &malloc);

または、次のセクションで概説されている手順を代わりに使用して、キャラクタ データをバイナリ ファイルのコンテンツから読み込むことができます。

.hikc ファイル(Maya または Characterization Tool から)または .hik ファイル(MotionBuilder から)

1. プロジェクトで使用しているファイル管理インタフェースを使用して、キャラクタ用に作成された .hikc ファイルをメモリにロードします。
2. HIKCharacterDefinition クラスの新しいオブジェクトを作成します。例:

   HIKCharacterDefinition MyDef;

3. HIKReadFromStream() 関数を呼び出して、.hikc ファイルに含まれているデータから新しい HIKCharacter を作成します。この関数には次の引数が必要です。
   • 上記で作成した HIKCharacterDefinition オブジェクトへのポインタ。このオブジェクトは新しいキャラクタで使用されるノードと、Degrees of Freedom （DOF）およびペアレント オフセットを持つノードで示されます。

   • 書き出されたファイルから読み込まれたコンテンツの、メモリ内での場所を示すポインタ。

   • ファイル ストリームのバイト単位のサイズ。

   • HIKCharacter にメモリを割り当てるために呼び出されるコールバック関数へのポインタ。標準の malloc 関数、または malloc と同じ種類の定義を満たす任意のカスタム メモリ割り当て方法を指定できます。「 HumanIK オブジェクトとメモリ管理」を参照してください。

   • メモリを割り当て解除するために呼び出されるコールバック関数へのポインタ。標準の free 関数、または free と同じ種類の定義を満たす任意のカスタム メモリ割り当て解除方法を指定できます。「 HumanIK オブジェクトとメモリ管理」を参照してください。

   • HumanIK の評価バージョンを使用している場合は、Autodesk, Inc.によって発行されたライセンス キー。「HumanIK のライセンス キーを設定する」で推奨されるように、ソース コード ファイルに autodeskmwkey.h ファイルをインクルードした場合は、定義済みの値 AutodeskCustomerString を使用できます。HumanIKのフル ライセンス バージョンを使用している場合は、null 値を渡すことができます。

   例:

   HIKCharacter * MyChar = HIKReadFromStream(
                                      def,
                                      stream, 
                                      streamSize,
                                      &malloc,
                                      &free,
                                      AutodeskCustomerString, 
                                      );

4. 手順 1 で開いたファイル ストリームを閉じます。