• plugin.C

これは、通常のプラグイン操作(プラグインのロード/アンロード、ノードおよびコマンドの登録/登録解除)を処理します。 また、Engine側のプラグインのロードも処理します。

• Engineセッションの管理(HARSプロセス)

• optionVarの管理(これらの大部分はセッションや環境を参照するため)

• Engineとやり取りする、時間単位での処理の管理

プラグインがロードされると、HARSセッションを作成するか(自動起動がオンの場合)、指定したパイプやソケットを介して既存のHARSサーバーに接続します。 プラグインをアンロードする時は、セッションを終了し、必要に応じてサーバーも終了します。 Houdini17.0以降はプロセス内のセッションをサポートしていませんが、プロセス内セッションコードは現在もプラグイン内に存在します。 プラグインをロードするとEngineセッションが開始されますが、アセットがロードされたり、ノードが作成された場合にのみ、ライセンスが取得されることに注意してください。

Mayaノード:

• 入力ノードおよびマージノード: ジオメトリデータをHDAに取り込みます。

• assetNode: パラメータ値とアニメーションを取り込み、HDAをクックし、出力ジオメトリをMayaデータに変換します。

Mayaプラグインコマンド:

• Engineセッションステートにアクセスし、アセット定義をロードします。

• アセットノードを作成し、アセットのパラメータに対応するMayaのアトリビュートを追加します。

• 出力アトリビュートのデータに基づいて、Mayaの出力ノードを作成します。

Maya MELコード:

• 入力ノードを作成し、それをアセットノードに接続します。

• (他のすべてのUIについても当然可能ですが、驚くには当たりません)

MayaにはメインのHoudiniアセットノードが1つあり、そのアセットノードに、MayaジオメトリをHoudiniに取り込むための様々な変換ノードを接続します。 入力MayaノードがEngineに入力ジオメトリオブジェクトを作成し、HoudiniのノードIDを出力します。 AssetNodeはノードIDを使用して、Engine側でアセットの入力に接続します。

入力ノードタイプ毎に1つのクラスが用意されています。

• houdiniInputGeometry (InputGeometryNode.C)は、メッシュパーティクルと単一のカーブ入力を処理します。

• houdiniInputCurve (InputCurveNode.C) - 複数の入力カーブ

• houdiniInputTransform (InputTransformNode.C) - トランスフォームアトリビュートでパーティクルに変換された複数のトランスフォーム(UIが現在サポートしているのはロケータのみですが、トランスフォームは機能します)

• inputMergeNode (InputMergeNode.C) - Houdiniでマージノードを作成し、Engine側でその入力を接続します。

入力ノードにはそれぞれ入力オブジェクトがあり、これが呼応するHoudiniジオメトリノードを実際に作成する作業を行ないます。 入力オブジェクトにはcompute()メソッドもあるため、派生したMayaクラスまたはHoudiniのユーティリティオブジェクトのどちらが対象かについて把握しておく必要があります。 入力オブジェクトの階層は以下の通りです:

• Input.C

  • InputCurve.C (単一のカーブ入力 - 廃止)

  • InputMesh.C

  • InputParticle.C

• houdiniAsset (AssetNode.C) - Mayaノード関連、アトリビュートを定義します。

• Asset.C - assetNodeはアセットオブジェクトを保持し、MayaとEngine間のインターフェースを管理し、Houdiniオブジェクトから出力データを作成します。compute()メソッドもあり、ノード計算で行なわれることをそれとなく示しています。

これ以降のセクションは、コードを見て、それらがどう組み合わされるかに関心がある方なら楽めるでしょう(それでも退屈に感じる人がいるかもしれません)。

AssetNode.Cを見ると、その約3分の2は出力アトリビュートの構築であることが分かります。 出力アトリビュートは、可能な限りの出力ジオメトリを網羅することを目的としているため、多くなっています。 完全なリストは、Houdiniアセットのノードに関する説明を参照してください。

次に、通常のノードメソッドを必要に応じてオーバーライドします。以下に、面白いHoudini関連のこと、少し奇妙なMaya関連のことが起こる例を示します。

• アセットノードがサーバー側で作成/削除されるようにします。

  • nodeAdded()、nodeRemoved()、postConstructor()、createAsset()、destroyAsset()

• シーンのロード時にアセットをセットアップします。

• パラメータの更新と同期のタイミングを計算します。

  • setSependentsDirty() - サーバー側でパラメータ値を設定し、特別な場合(およびDirtyな伝播の場合)は強制的に同期します。

  • setInternalValue() パラメータアトリビュートおよびアセット名/パスは、internalSetです。名前とパスが実際に保存されるのはノード内部で、パラメータはデータをHoudiniに渡すためだけに存在します。setDependents Dirtyと一部重複しています。EM/DGモードの違いにより、片方が呼び出されるのか、または両方が呼び出されるのかは分かりません。場合によっては、追加でパラメータが更新される可能性もありますが、少なくともパラメータが欠落することはありません。

  • preEvaluation() 評価マネージャ(EM)向けのDirty化 - 残念なことに、EMは親コンパウンドのみを見るため、Dirty化できるのはトップレベルのパラメータのみです。それらはすべて、houdiniAssetParmsの下に作成されているからです。

• パラメータ値とアトリビュート値の間で変換します。

  • setParmValues() - アトリビュートを取得し、パラメータを設定します(Asset.cでのパラメータイテレータ向けラッパー)。

  • getParmValues() - パラメータ値からアトリビュートを設定します(Asset.cでのパラメータイテレータ向けラッパー)。

  • マネージャ関連を評価します。

• compute() パラメータを更新し、Asset::compute()を実行します - 興味深いさまざまなことが、ここで起こります。

• shouldSave() 一部の値がデフォルトである、複数の数値を保存するために、Mayaの最適化のバグを回避するために必要です。入力でノードIDが強制保存されます。

• connectionBroken() 接続解除の挙動が複数コンパウンドの要素に対して機能していないように見える、Mayaのバグを回避するのに必要です。

Maya出力データを実際に構築するOutputObjectsには、階層があります。Houdini出力オブジェクトノードをウォークし、これらのOutputObjectsを構築してから、OutputObjectsをウォークして、それらに実際の作業を行なわせます:

• OutputObject.C

  • OutputGeometryObject.C

    • OutputGeometry.C

    • OutputGeometryPart.C

    • FluidGridConvert.C

  • OutputInstancerObject.C

• OutputMaterial.C

Asset::compute:

• クックします。

• 出力/表示ノードとしたいノードで、ノードリストを更新します。

  • SOPアセット - ノードIDのみ

  • オブジェクトアセット - 場合によってはgetComposedChildListが必要

• ノード向けにOutputObject(s)を作成します(例えば、OutputObjectクラスがその子クラスの1つのオブジェクトをインスタンス化します - OutputGeometryObjectまたはOutputInstancerObject)。

  • これらのOutputObjectsは、実際の出力データを構築するのに使用されます。

• アセットのトランスフォームを計算します。

  • (関係があるのはサブネット付きのオブジェクトアセットのみ)

• computeInstancerObjects()

  • すべてのoutputObjectsをウォークし、それぞれのOutputInstancerObjectsについて出力データを計算します。

• computeGeometryObjects()

  • すべてのoutputObjectsをウォークし、OutputGeometryObjectsを取得して出力データを計算します。

• computeMaterial()

  • これは一種の逆行です(詳細を思い出すには、コードをもう少し見る必要があります)。

  • 出力ジオメトリに実際に割り当てられているマテリアルについて、出力マテリアルパスが同期入力されていることが前提です(これは確実ではない部分です。後日コードを再度確認します)

  • 既存の出力数分のOutputMaterialオブジェクトを作成し、それらをイテレートします。

    • マテリアルが変更されたり、クックの回数が遅れた場合には…

    • アセットのVOP/SHOPノードで、マテリアルパスと一致するマテリアルを検索します。

    • 一致するマテリアルが見つかったら、すべてのマテリアル情報を抽出し、データを更新して、出力テクスチャをベイクします(非常に時間がかかる可能性があるので、must bakeオプションがオフの場合は、可能な限り既存のテクスチャファイルを再利用します)

出力データが既に出力シェイプに接続されている場合は、次の描画または他の評価で選択されます。どの出力にも接続されていない場合は、次の同期で、出力されたすべてのデータの出力シェイプが作成されます。

主に2つのプラグインコマンドがあります。

• EngineCommand.C: Engineセッションとやり取りするためのコマンド(セッションの照会、hipファイルの保存)

• AssetCommand.C: 特定のアセットとやり取りするためのコマンド(HDAのロード、アセットからのMayaノードとアトリビュートの更新)

どちらのコマンドにも複数のフラグがあり、対応するサブコマンドオブジェクトを作成し、それを使用してdoIt()やundoIt()などを実行することで実装されます。分かりやすくなるよう、メソッドの命名をまたMayaメソッドに合わせています。 すべてのコマンドオプションについては、プラグインのコマンドを参照してください。

その他のユーティリティメソッドは以下になります:

• util.C

  • パラメータ名およびノード名を有効なMaya名に変換

  • 進捗バーのハンドリング/ステータスのチェック

  • パラメータイテレータ

  • DG操作向けの便利なメソッド

  • エラー処理

• AssetNodeOptions.C - ノード固有のオプションにはNodeOptionsクラスが1つありますが、現在これを利用しているのはアセットノードのみです。

これらについては説明不要でしょうが、注意点をいくつか記しておきます。

• グローバルプロシージャ名はスクリプトファイル名と一致しないため、大量のソーシングが行なわれています。

• 新しいバージョンのHoudiniをインストールする際には、シェルフを再構築する必要があります(シェルフコマンドの更新があるのはそのためです)。ツールシェルフはシェルフアイテム内にツールの場所を埋め込んでいるため、ツールの新しい場所を参照するように更新する必要があります。シェルフを削除して置き換えるため、デフォルトのMayaの確認ボックスが表示されます。また、削除したシェルフは明示的に置き換える必要があります。そうしないと、Mayaが以前削除したシェルフを記憶していて、それを更新します。確かに、きれいなコードとは言えません。ご不便についてはお詫びしますが、こうするしかありませんでした。

• 私たちはMayaの主な新機能を賢く利用しながら、Houdiniのリリースで一新されたHoudiniプラグインの主な機能を利用できるようにしているわけです。