Importブロック は、内容を“インライン(埋め込み)”で表示するタイプのフォルダです(つまり、このブロックで囲まれた“フォルダ”は不可視になります)。

ローレベルアセットから構築されたハイレベルアセットを使った複雑なアセットを開発している時、そのローレベルアセットからパラメータのブロックまるごとあなたが作成しているハイレベルアセット上にプロモートさせたいことがあります。 しかし、ローレベルのパラメータの編集を継続できるようにしつつ、毎回それらのパラメータを再度プロモートさせたくありません。

Importブロックは、パラメータのブロックをプロモートさせて、そのプロモート先の場所を覚えさせることができるので、オリジナルのパラメータを変更するとプロモートしたパラメータを自動的に更新させることができます。

“タグ”は、任意のキー/値のデータをパラメータテンプレートに追加することができます。 hou.ParmTemplate.tagsを使用することで、このデータにアクセスすることができます。 パラメータタイプによって認識されて使用されるタグが異なります。 タグを使用することで、パラメータ単位で非表示データを保存することもできます。

パラメータをOpenGL値として扱いたい場合、タグをそのパラメータに追加すると、3Dビューアがそのタグを使用するようになります。 例えば、“OpenGL → Diffuse”タグをマテリアルノード上のパラメータに追加すると、3Dビューアがそのサーフェスを表示する時にそのパラメータの値をディフューズカラーとして扱うようになります。

• マテリアルノードの Edit Parameter Interface ペインの中央にある“Existing Parameters”サブペインからパラメータを選択すると、右側にある“Parameter Description”サブペイン内のテーブルにタグがリストされています。

• そのタグテーブル下にある Built-in Tags ボタンをクリックすると、OpenGL系タグを含むHoudiniで認識される色々なタグのツリーからタグを選択することができます。

• 一部のパラメータには、そのパラメータのルックと挙動のオプションが含まれた内部タグが追加されています。 これらの内部タグは、タグリストでは編集不可です。

• タグ名は、各パラメータ内で必ず固有でなければなりません。

• Key-Value Dictionaryパラメータタイプを使用することで、あなた独自のデジタルアセットにタグのような編集インターフェースを追加することができます。

“折り畳み式”フォルダタイプ(パラメータエディタでは折り畳み式ヘッダで表示されます)には、もっとコンパクトに収めてパラメータインターフェースをすっきりさせることができるオプションがいくつか用意されています。

このサブタブは、このパラメータに関連したアニメーション可能な チャンネル を表示します。

デフォルトでは、Houdiniは、パラメータ値の各コンポーネントに対してアニメーションチャンネルを作成します(例えば、 Translate ベクトルパラメータは、ベクトルのコンポーネントに1チャンネルなので3つのチャンネルが用意されます)。 しかし、パラメータに対してそれよりも多く計算または少なくチャンネルを生成することができます。

• チャンネルの Auto-addアイコンを有効にすることで、そのチャンネルをキー可能、且つ、このパラメータを含んだノードが選択された時にチャンネルリストに自動的に追加させることができます。

  よく使用するアニメーション値すべてに対してこれを有効にすると良いでしょう。

• このパラメータをプロモートすると、“Linked Channels”コラムには、アセットの中のノードからプロモートされたこのパラメータのチャンネルが表示されます。真ん中にある Linkボタンをオンにすると、そのチャンネルは、リンクされたチャンネルから値を取得するようになります。

このタブ上のコントロールでは、このパラメータに対してユーザが選択可能な値のメニューをセットアップすることができます。 他にも( Parameter サブタブの) Callback Script を使うことで、ユーザのメニュー選択に基づいたアクションをスクリプト化することもできます。

各メニュー項目には、 トークン と ラベル があります。このラベルは、パラメータエディタ内のポップアップメニューに表示される値に相当する人が解読可能なラベルです。

• Stringパラメータに関しては、ユーザがメニュー項目を選択すると、そのパラメータには該当する文字列トークンが設定されます。

• Integerパラメータに関しては、デフォルトではユーザがメニュー項目を選択すると、そのパラメータには、その項目の インデックス (例えば、1番目の項目が0、2番目の項目が1など)が設定されます。 Use Token as Value を有効にすると、代わりにそのパラメータには該当する整数トークンが設定されます。

• _separator_トークンを持ったメニュー項目はメニュー分割線に置換されます。

事前にメニューに表示させたい項目が分かっているのであれば、 Menu Items テーブルを使ってそれらの項目を定義することができます。 スクリプトを使ってメニューの内容を動的に計算させたいのであれば、代わりに Menu Script をクリックします。

Houdiniは、Importブロックを更新する時に使用するパラメータのプロモート元に関する情報をここに記録しています。 意図的に処理したい場合を除いて、この情報を編集しないでください。

一部のパラメータでは、パラメータエディタのこのフィールドの右側に任意のスクリプトを実行する小さなボタンを表示させることができます。

Houdiniの他のパーツとは違い、これにはアクションボタンの表示を制御するチェックボックスがありません。 代わりに、このタブのスクリプトエディタが空っぽならアクションボタンが表示されず、何か記述されていれば、アクションボタンが表示されます。

このスクリプトが1行なら、Pythonエクスプレッションと見なされて評価されます。2行以上なら、関数のボディとして扱われます。

このスクリプトは、以下のキーを含んだグローバルのkwargs辞書変数を持った環境で実行されます:

Operator Pathパラメータに対する以下のアクションボタンスクリプトは、選択ダイアログを開いて、ユーザがオブジェクトノードを選択するまで待ち、そして、そのノードのパスをパラメータに格納します。 ユーザがアクションボタンをShiftクリックすると、選択ダイアログは、カメラのみを、Ctrlクリックすると、ライトのみを選択するように制限されます。

# 現行パラメータの参照を取得します。
parm = kwargs["parmtuple"]

# 選択ダイアログのデフォルトとして使用するパラメータの現行値を取得します。
# このメソッドはタプルを返すので、そのタプル内の1番目の項目(のみ)を取得しています。
path = parm.evalAsStrings()[0]
node = hou.node(path)

# 修飾キーをチェックして、フィルターを設定します。
if kwargs["shift"]:
    nodetype = hou.nodeTypeFilter.ObjCamera
elif kwargs["ctrl"]:
    nodetype = hou.nodeTypeFilter.ObjLight
else:
    nodetype = hou.nodeTypeFilter.Obj

# ユーザにノードを選択させます。
newpath = hou.ui.selectNode(initial_node=node, node_type_filter=nodetype)

# パラメータ値を設定します(これもParmTupleなので、1個の項目をタプルとして設定する必要があります)。
parm.set( (newpath, ) )

他のパラメータの値に基づいてパラメータを動的に表示または有効にしたいことが多々あります。 例えば、いくつかの機能を有効にするチェックボックスを持たせた場合、そのチェックボックスが有効な時にその機能に関係するパラメータだけを編集できるようにしたいです。

パラメータの Disable When と Hide When の設定では、パラメータの無効または非表示のタイミングをセットアップすることができます。 この値は、以下に示す構文を使ったコードであり、他のパラメータ値に基づいて無効/非表示を制御することができます。

一般的な構文:

{ parm_name [operator] value ...} ...

• 波括弧内に1つ以上の比較。

• 波括弧内には、パラメータ名、比較演算子、値を使った1つ以上の比較を入れます。

• 次の比較演算子が利用可能です: ==, !=, <, >, >=, <=, =~ (パターンに合致), !~ (パターンに合致しない)。

  { type == 1 count > 10 } { tolerance < 0.1 }
  

  Note

  比較演算子の前後には必ずスペースが 必要 です。そうしないと、Houdiniはそのルールを受け入れません。

• 比較演算子を省略することができます。その場合には、省略した比較演算子は==と見なされます。しかし可読性を考慮すれば、常に演算子を明示的に指定することを推奨します。

  { geotype 1 } { geotype 2 }
  

• 波括弧内に複数の比較があった場合、 すべての 比較がTrueでないと、その条件がTrueになりません。

  例えば、以下の条件では、enablefeatureチェックボックスパラメータが有効 且つ countパラメータが10より大きい時に、このパラメータが無効/非表示になります:

  { enablefeature == 1 count > 10 }
  

• (波括弧のセットで)複数の条件を指定した場合、それらの条件の どれか がTrueになると、このパラメータが無効/非表示になります。

  例えば、以下の条件では、enablefeatureチェックボックスパラメータが有効 または countパラメータが10より大きい時に、このパラメータが無効/非表示になります:

  { type == 1 } { count > 10 }
  

• ルールの文字列にエクスプレッション関数を使用することはできません。しかし、回避策は、必要な処理を計算するエクスプレッションを含んだ不可視パラメータを作成して、それを比較で参照することです。

• 比較の左側のパラメータ名の箇所で使用可能な特別な関数がいくつかあります(これらの関数は、比較の右側の 値 に使用することは できません )。

  ninputs()

  接続されている一番大きい入力番号。これは、中央の入力が接続されていない場合には、接続数より大きくなることがあります。また、親ノードに接続してくてもよいサブネット入力を数えます。

  hasinput(n)

  指定した入力番号が接続されていれば1、接続されていなければ0を返します。これは、サブネット入力に親ノードが接続されていない場合でも、そのサブネット入力に接続された入力を数えません。

  isparm(parmname)

  このパラメータの名前がparmnameなら1を返します。これは、Multiparmを使用するためにあります。

  例えば、このルールをblendという名前のMultiparm内の1番目の項目に適用し、2番目(blend1)、3番目(blend2)などに適用したくない場合です:

  { isparm(blend0) == 1 }
  

• このタブには2つのテーブルエディタがあり、1つが入力用、もう1つが出力用です。

• Create/Update Inputs From Parameters をクリックすると、ノードのパラメータに基づいて入力が自動的に作成されます。これは、ユーザが入力を接続することでパラメータ値を上書きすることができます。

  このボタンは、同じ名前とラベルで入力を作成し、入力タイプはパラメータタイプから推測されます。 もし入力がパラメータと同じ名前で既に存在していれば、このボタンはラベルのみを更新するので、入力タイプへの変更は上書きされません。

  パラメータに基づいた入力は、テーブル内で編集することはできません。 これらの入力は、 Infoアイコンでマークされます。

  パラメータと同じ名前の入力を手動で作成すると、それらの入力が自動的にパラメータとリンクされます。

• 入力または出力を追加するには、テーブルの上部にある New Input または New Output メニューからタイプを選択します。

• テーブル内の既存の入力/出力の名前またはラベルをクリックすると、それを編集することができます。

• 行内の1番目のセルを選択してから、それを上下にドラッグすると、テーブル内での行の位置を変えることができます。

  各行の1番目のセルをShiftクリックまたはCtrlクリックで行を複数選択してから、ドラッグすることで一度に複数の行を動かすことができます。

  コラムのヘッダをドラッグすることで、シグネチャの順番を変更することができます。

• 入力/出力を削除するには、行内の Deleteアイコンをクリックします。

• いくつかのセルは、編集または削除することができません。例えば、パラメータに相当する入力、エクスポートパラメータに相当する出力、VOPネットワークの出力がそれです。

• VOPには複数の シグネチャ (つまり、入力タイプと出力タイプのセット)を持たせることができます。例えば、Sine VOPには、VEX sin関数の異なる使用方法に該当する異なるシグネチャ(float->float、vector->vector)を持っています。

• 各シグネチャは、入力テーブルでは1個のコラムで表現され、出力テーブルでは 3個 のコラムで表現されています。 Signature Name (シグネチャコラムの1番目のセル)によってそれらのシグネチャを一致させることができます。初期段階では、VOPノードはdefaultという名前の1個のシグネチャを持っています。

• New Signature ボタンを使用することで、新しいシグネチャ(つまり、異なるタイプの引数と異なる出力のセットで大元のVEXコードをコールする新しい方法)を追加することができます。これは、上部の入力テーブルに新しい1個のコラムを、下部の出力テーブルに新しい 3個 のコラムを追加します。

• シグネチャコラム内の1番目のセルはシグネチャ名です。2番目のセルはそのシグネチャに対する人が解読可能なラベルです。3番目のセルはそのシグネチャのシェーダ関数名ですが、そのシグネチャ用の特別な関数がない場合には空っぽのままにすることができます。これらのセルは、入力テーブル内のシグネチャコラムと出力テーブル内のそれに該当する1番目のシグネチャのコラムの両方で表示されます。テーブル内の名前またはラベルを編集すると、自動的にもう片方のテーブルが更新されます。

• シグネチャシェーダ行には、VOPがそのシグネチャを持っている時に使用する特別なシェーダ関数名をオプションで指定することができます。一部のシェーダ言語はシェーダ関数名のオーバーロードが可能で(つまり、同じ名前の関数が異なるパラメータタイプを持つことができる)、その場合には、通常では、この行は空っぽのままにします。しかし、同じ名前の関数を許可しないシェーダ言語の場合、この行には、VOPのシグネチャ毎に別々のシェーダ関数名を指定することができます。

• 入力テーブルでは、シグネチャコラムの(NameとLabelとShaderの行の後の)行には、 そのシグネチャがアクティブになった時の 各入力のタイプが含まれています(ユーザは、ノードのパラメータインターフェースの上部にあるポップアップメニューからアクティブなシグネチャを選択します)。セルをクリックすれば、ポップアップメニューからタイプを選択することができます。

  出力テーブルでは、1番目のシグネチャコラムの(NameとLabelの行の後の)行には、出力のタイプが含まれています。

• 特定のシグネチャに使用するデフォルトのパラメータを用意するには、入力と同じ名前の後にアンダースコアー(_)とシグネチャの名前を付けてパラメータを作成します。

  例えば、2つの入力としてcolorとmultiplierがあり、データタイプがvector4とfloatを持っていると仮定します。 2つのパラメータを作成して、名前をcolorとmultiplierにします。最初のパラメータがColorパラメータで、次が単一のFloatパラメータです。 multiplierをvector4に設定します。新しくシグネチャを作成して、名前をv4にします。 そのシグネチャーのmultiplierのデータタイプをvector4に変更します。新しいパラメータの名前は、multiplier_v4で、これは4つのfloatです。 これらのオペレータのどれかを作成する時、シグネチャをv4に設定すれば、VEX Builderはcolorとmultiplier_v4パラメータを使ってデフォルト値を用意します。

このタブを使用することで、このアセットに関連付けれているPython Viewerステートスクリプトを作成、編集、保存することができます。 アセットがロードされると、Houdiniは、Viewerステートを利用できるようにそのステートを登録します。 同様に、アセットがアンロードされると、そのViewerステートがHoudiniから登録解除されて、利用できなくなります。

def createViewerStateTemplate():
    state_typename = kwargs["type"].definition().sections()['DefaultState'].contents()

このタブでは、このアセットに関係するシェルフツールを作成することができます。アセットが読み込まれると、このタブで定義したツールをユーザがシェルフに追加でき、ビューアタブに表示されます。

アセットを作成する時、Houdiniは自動的にツールをこのタブに追加します。つまり、アセットのインスタンスを作成する汎用スクリプトを呼び出します。このツールのスクリプトを編集したり、またはシェルフツールを追加してアセットをインスタンス化する別の方法を設定することができます。 Create New をクリックして Tool を選択すれば、新しいツールが設定されます。

シェルフツールの作り方を参照してください。

このタブ上のコントロールは、 ハンドル (3Dビューア内に表示される3Dユーザインターフェース)を作成し、そのハンドルの編集可能な部分をアセットのパラメータに紐付けることができます。 これによって、ユーザがアセットをビューア内でインタラクティブに制御することができます。 このアセットのインスタンスがアクティブになると、Handlesツールでこのハンドルが表示されます。

このペイン内のコントロールは、Persistent Handle Editor(持続ハンドルエディタ)と同じです。

このタブでは、ノードを作成した時に、そのノードの適用先(オブジェクト/ジオメトリ)をユーザが選択できるように、(複数手順を含む)選択の工程をセットアップすることができます。 例えば、オブジェクトレベルのアセットの取り付け先にオブジェクトを選択するようにユーザに促すことができます。

Type フィールドは編集不可で、セレクターの基本タイプを反映します。 Name フィールドは英語名で、このセレクターをオペレータタイプに関して固有に定義するべきです。 Prompt フィールドは選択中に表示される文字列です。 Multiple Selection チェックボックスは、現在のセレクターで複数オブジェクト選択を許可するかどうか設定します。編集可能なテキストフィールドでは、オブジェクト選択がバインドされた時にユーザ定義スクリプトを実行することができます。入力オブジェクトは変数$argcと$arg0, $arg1,..., $arg($argc-1)によってアクセスします。$argcは入力の数で、残りの変数は個々の入力オブジェクトを意味します。

現行ノードのパスを保持する変数はありません。しかし、pwdHScriptコマンドを使えば現行ノードを取得することができます。

例えば、次のコードを実行することで、最初に選択した入力を現在のノードに接続することができます:

set curNode = `run("pwd")`
opwire -n $arg0 -1 $curNode

このタブを使用して、アセットと関連付けられたPythonビューアハンドルスクリプトを作成、編集、保存することができます。 そのアセットがロードされると、Houdiniは、そのビューアハンドルを登録して、Pythonビューアステートでそのハンドルを利用できるようにします。 同様に、そのアセットがアンロードされると、そのビューアハンドルはHoudiniから登録解除され、利用できなくなります。

def createViewerHandleTemplate():
    handle_type = kwargs["type"].definition().sections()["ViewerHandleName"].contents()
    handle_label = "My Handle Label"
    handle_cat = [hou.sopNodeTypeCategory()]

    template = hou.ViewerHandleTemplate(handle_type, handle_label, handle_cat)