インスタンス化されたStatic Meshコンポーネントを含むアクターを選択すると、Houdiniにインスタンサーをインポートすることができます。 インスタンス化されたメッシュは、パックプリミティブとしてインポートされ、インスタンス化されたポイントにそれぞれコピーされます。

インスタンスに使用される各マテリアルには、それに呼応したunreal_materialINDEXというアトリビュートがあります。 INDEXはそれ呼応するマテリアルのスロットのインデックスです。値は、そのマテリアルへのUnrealパスになります。

フォリッジインスタンスも同じようにインポートすることができ、unreal_foliage attributeセットが含まれます。

または、 Import as reference チェックボックスをオンにすると、スタティックメッシュを単一のアトリビュートインスタンスとしてインポートすることもできます。

プラグインは、パックプリミティブ、オブジェクトインスタンサー、アトリビュートインスタンサーを使用して、アセットからインスタンスを出力することをサポートしています。

Unrealのインスタンス化されたジオメトリは、デフォルトではInstancedStaticMeshComponents(デフォルト)、インスタンス化されたジオメトリに複数のLODがある場合はHierarchicalInstancedStaticMeshComponentsです。 LODがない場合であっても強制的にHierarchicalInstancedStaticMeshComponentsを作成したい場合は、unreal_hierarchical_instancerを追加して、値を1に設定します。

インスタンス化されたジオメトリまたはuassetsは、Detailsパネルの Houdini Outputs セクションに、以下のようにインスタンサーとして表示されます。

Pointアトリビュートを追加して、インスタンス化されたメッシュにマテリアルオーバーライドを指定することができます。 unreal_materialINDEXという名前のアトリビュートを作成します。 INDEXは、上書きするマテリアルスロットインデックスを表します。値は、使用されるマテリアルへのUnrealパスにする必要があります。

インスタンス化した各出力のジオメトリは、Unreal内で置換することができます。 Detailsパネルのそれに呼応するコントロールを使用することで、そのジオメトリに位置、回転、スケールオフセットを適用することができます。

インスタンサーの出力を複数のコンポーネントに分割したい場合もあるでしょう。 例えば、インスタンサー毎に異なるマテリアルを割り当て、ベイク時に生成されるアクターをより細かく制御したいような場合です。

これを行なうには、unreal_split_attr文字列アトリビュートを使用します。 このアトリビュートの値は、別のアトリビュートの名前に設定する必要があり、その値を使用して分割を制御します (そのアトリビュートの値ごとに、個別のインスタンサーコンポーネントが作成されます)。

例えば、unreal_split_attrアトリビュートにunreal_materialアトリビュートを使用すると(unreal_split_attr = unreal_material)、2つ目のアトリビュートの各マテリアルについて、インスタンサーコンポーネントが作成されます。 3つの異なるマテリアルが使用されていれば、インスタンサーは3つの異なるインスタンサーコンポーネントに分割されます。

Houdini20.5では、unreal_split_instancesアトリビュートを使用して個別のStaticMeshComponentsを作成する方法が廃止され、今後のバージョンで削除されます。 代わりにunreal_split_attrアトリビュートを使用することを推奨します。

以下のコードは、unreal_split_instancesアトリビュートと同様の挙動にすることができます:

i@id = @ptnum;
s@unreal_split_attr = "id";

インスタンス化されたジオメトリは、サムネイルピッカーに表示されます。 それを上書きするには、ドロップダウンアセット選択を押してリストからアセットを選択するか、アセットをコンテンツブラウザからサムネールにドラッグアンドドロップします。

インスタンサー出力で使用されるジオメトリがスタティックメッシュ以外のもので上書きされる場合や、その逆の場合は、呼応するコンポーネントが適宜変更されます。 例えば、ParticleSystemアセットを選択すると、結果としてAEmitterオブジェクトがインスタンスポイントに生成されます。同様に、Blueprintアセットを選択すると、そのBlueprintのアクターインスタンスが生成されます。

Houdini20.5では、インスタンスを上書きするためのUIがデフォルトで無効になっていますが、Unrealプラグイン設定の“Enable Deprecated Instance Variations”でそれを再び有効にすることができます。

Unrealからのインスタンスバリエーションの制御は、Houdini20.5で廃止され、正体のバージョンで削除される予定です。

この機能を使用しているプロジェクトは、hdaバリエーションの処理が削除される次のリリースまでにバリエーションロジックをHoudiniに移行してください。

Houdini20.5では、インスタンスバリエーションを制御するためのUIがデフォルトで無効になっています。 Unrealプラグイン設定の Enable Deprecated Instance Variations でそれを有効にすることができます。

インスタンス毎のカスタムデータを使用すると、カスタムデータをインスタンスバッファに追加して、その後、インスタンサーのマテリアルの頂点シェーダによって読み込むことができます。

HDAでは、インスタンスにおけるインスタンス毎のカスタムデータを、アトリビュートを通して指定することができます:

インスタンス毎のカスタム浮動小数点の数は、unreal_num_custom_floatsアトリビュートを介して設定できます。 カスタムデータ自体は、unreal_per_instance_custom_dataXアトリビュートを介してインスタンスで設定できます(Xは、カスタム浮動小数点データのゼロベースのインデックス)。

例として、インスタンスにカスタムRGB float値を指定することができます。

以下を追加する必要があります:

i@unreal_num_custom_floats = 3;   (各インスタンスが3つのカスタム浮動小数点を持つことを示すために)
f@unreal_per_instance_custom_data0 = XXX; (赤の値)
f@unreal_per_instance_custom_data1 = YYY; (緑の値)
f@unreal_per_instance_custom_data2 = ZZZ; (青の値)  

HDAを使用してフォリッジインスタンスを出力するには、値を1に設定したunreal_foliageアトリビュートをインスタンスに追加してください。 UE5ではUnrealレベル内にフォリッジインスタンスを作成するには、コンテンツフォルダに格納されたフォリッジタイプアセットが必要です。

HDAのインスタンスタイプがUnrealスタティックメッシュを参照するように設定されている場合、プラグインはクック時およびベイク時に、必要なフォリッジタイプアセットを自動的に作成します。

インスタンスタイプが既存のUnreal フォリッジ Type に設定されている場合、フォリッジインスタンスはそのフォリッジタイプにベイクできます。 クック中、一時的なフォリッジタイプが作成されます(これは、HDAで指定されたユーザ定義のフォリッジタイプのコピーです)。 これにより、クック後に、フォリッジエディタで既存のフォリッジまたはHDA生成のフォリッジのいずれかを選択することができます。 ベイク時のみ、インスタンスはターゲットのフォリッジタイプを使用してレベルにベイクされます。

unreal_foliage_attachment_typeアトリビュートは、Unrealレベル内でフォリッジインスタンスを別のオブジェクトにアタッチします。以下の値を使用できます:

• 0 - インスタンスはアタッチされません(デフォルト)。

• 1 - インスタンスはすべてのコリジョンコンポーネントにアタッチすることができます。

• 2 - インスタンスはランドスケープコリジョンコンポーネントにのみアタッチすることができます。

アタッチする正確なコンポーネントは、unreal_foliage_attachment_distanceの距離だけ、インスタンスの位置の上方から上下に垂直にレイトレーシングすることで決定されます。

レベルのインスタンス化はUnreal5.1以降でサポートされており、ソースレベルまたはPacked Levelブループリントを参照するようにunreal_instanceを設定します。

Unrealでは、レベルのインスタンス化はコンポーネントレベルではなく、アクターレベルで実行されます。 そのため、クックおよびベイクの両方で、コンポーネントではなくアクターが生成されます。

このテーブルには、HDA内で設定する特殊なアトリビュートを載せており、このプラグインは、HoudiniデータをUnreal出力に変換する時にそれらのアトリビュートを認識します。 アセット上にこれらのアトリビュートをセットアップすることで、生成されるUnreal出力の一部のプロパティと挙動を制御およびオーバーライドすることができます。 詳細は、アトリビュートとグループを参照してください。