ワークアイテムは、HoudiniジオメトリのPointアトリビュートと同様に何かしらの情報を含んだ アトリビュート を持っています。 ワークアイテムに関連付けられているスクリプトまたは実行ファイルにそのアトリビュートを読み込ませることで、そのワークの処理を制御することができます。 アトリビュートは、"親"ワークアイテムから生成されたワークアイテムに渡されるので、このアトリビュートを使用することで、ワークアイテムの結果を子ワークアイテムの処理に影響を与えたり、 ワークアイテムをまとめてグループ化したり、ネットワークを通じて情報を渡すことができます。

カスタムコードにアトリビュートを読み込ませることでワークアイテムの生成を制御することができますが、 アトリビュートを最もよく使うのは、 TOPノードのパラメータ、もしくは、TOPネットワークが参照するHoudiniのネットワークとノードのパラメータからそのアトリビュートを参照する 時です。

• 例えば、異なるレンダー品質を試行錯誤したいとしましょう。Wedge TOPを使用してpixelsamplesアトリビュートに異なる値を設定したワークアイテムを生成することができます。すると、ROP Mantra Render TOPの Pixel Samples パラメータでそのアトリビュートを参照できるように@pixelsamplesを設定することができます。

• 他にも、TOPネットワークからコールされた外部のアセット/ネットワークのワークアイテムアトリビュートを参照することができます。例えば、HDA Processorはワークアイテム毎にHoudiniアセットをクックすることができます。そのアセットのパラメータに@attribute参照を使用することで、そのワークアイテムから値を引き出すことができます。

@attribute.componentを使ってベクトルのコンポーネントを参照することができます。componentは0から始まる数値またはx, y, z(それぞれ0, 1, 2に該当)です。例えば、@pos.xまたは@pdg_output.0です。

ワークアイテムは、Houdiniジオメトリとほぼ同様に基本的な文字列配列アトリビュート、浮動小数点配列アトリビュート、整数配列のアトリビュートに対応しています。 どのプリミティブアトリビュートタイプも配列で、その配列長は任意の長さにすることができます。 ワークアイテムにもFileアトリビュートタイプがあります。これは文字列配列と同様ですが、ファイルタグやファイルの更新時刻などのメタデータが格納されています。 Fileアトリビュートは、ワークアイテムInfoパネル内でクリック可能なリンクとして表示され、TOPsのパスハンドリングの仕組みで使用することで、ローカルマシンでもファームマシンでもそのパスを利用可能にすることができます。

複雑に構造化されたデータを必要とするユースケースのために、ワークアイテム上に作成可能なアトリビュートの追加タイプが2つあります。 1つ目のタイプが Python Objectアトリビュート タイプです。 このアトリビュートには単一PyObject値を割り当てることができます。 TOPsは、このPython Objectの文字列表現を使ってアトリビュートの内容に関する基本的な情報を表示することしかできず、ほとんどのノードはそのタイプのアトリビュートに格納されているデータを直接操作することができません。 PDG Python APIを介するか、または、Shotgun系ノードなどのPython Objectアトリビュートを明示的に利用するようなTOPノードでは、このオブジェクトにフルアクセスすることができます。 Python Objectが入れ子配列と辞書オブジェクトで構成されていれば、HScriptで@オペレータを使ってそのオブジェクト内の値にアクセスすることができます。 例えば、@obj.key.subkey.2.valueはPythonコードのwork_item['obj'].object['key']['subkey][2]['value]と等価です。 @objは常にPython Objectの標準文字列表現を評価します。 これは、Pythonのrepr(work_item['obj'].object)と等価です。

2つ目のタイプが Geometryアトリビュート タイプです。 このアトリビュートにはネイティブHoudiniジオメトリデータを格納することができます。 このGeometryアトリビュートタイプは、主にGeometry ImportやInvokeのTOPノードで使用し、現行Houdiniプロセスで直接ジオメトリを操作することができます。 Python Objectタイプと同様に、ほとんどのノードはそのアトリビュートに直接アクセスすることも利用することもできませんが、 ワークアイテムを生成するノードがジオメトリを使用できなくてもそのアトリビュートの内容をワークアイテム間で継承させることができます。 SOPネットワーク内のTOP Geometryノードは、出力ワークアイテム上のジオメトリアトリビュートをSOPsに戻すことができます。

ワークアイテムアトリビュートには色々なフラグを設定することができます。 これらのフラグによって、それらのアトリビュートのアクセス方法や他のTOPネットワークでの表現方法が決まります。 よく使用するフラグには、アトリビュートを下流のワークアイテムにコピーしないことを示した No Copy 、プロセス外でクックされた時にアトリビュート値を環境変数としてエクスポートする Env Export があります。 対応しているフラグの全リストは、pdg.attribFlagドキュメントに載っています。

Wedge TOPを使ってパラメータ値を色々と変更させる時に、他のノードにTOP固有のエクスプレッションを使用したくない場合(例えば、レンダリングしたいROPが他のパイプラインと共有されている場合や手動で使用したい場合)、 実行時にWedgeノードのパラメータ値をWedgeアトリビュートに置換することができます。

レンダリング時にパラメータをオーバーライドする方法は、Wedge TOPのヘルプを参照してください。

Attribute DeleteやAttribute Copyのようなノードを使用する時、パターンを使用してアトリビュートのリストを指定した方が便利な事が多いです。 PDGには特別なアトリビュートパターン構文が用意されています。 この構文を使用することで、複数アトリビュートに対して動作可能なノード内でマッチさせるアトリビュートを指定することができます。 このパターンは、左から右に向かって適用され、以下に載せている記号を使用してマッチ条件をスペースで区切ったシーケンスで構成します。

Python Scriptまたはカスタムノード内でパターンマッチング機能を使用することもできます。 文字列からpdg.AttributePatternオブジェクトを構築し、そのオブジェクトをpdg.WorkItem.attribMatch関数に使用することで、ワークアイテム上のアトリビュートにそのパターンを適用することができます。 別の方法として、直接pdg.AttributePattern.contains関数をコールすることで、指定したアトリビュート名とタイプでマッチングをすることもできます。

値パターンを使用することで、標準構文で値のシーケンスを指定することができます。 例えば、Attribute Array TOPノードでパターンを使用することで、文字列配列または数値配列を作成することができます。

パターン内の値は左から右に向かって処理されます。 パターンの間にスペースを入れることで、パターンまたは定数を複数指定することができます。 文字列値に特殊文字を入れたい場合は、その文字列値をダブルクォーテーションで閉じるか、または、その特殊文字の前に\エスケープ文字を使用することで可能です。 例えば、regular "quoted string" escaped\ stringといったパターンは、['regular', 'quoted string', 'escaped string']の文字列配列を生成します。

Python Script TOPノードやカスタムノードでも、この値パターン機能を使用することができます。 文字列からpdg.ValuePatternオブジェクトを構築して、そのオブジェクトのpdg.ValuePattern.contains関数を使用することで、値がそのパターンに含まれているかどうかをテストすることができます。 パターンにマッチした値の配列全体がpdg.ValuePattern.floatArray、pdg.ValuePattern.intArray、pdg.ValuePattern.stringArrayの関数で利用可能です。

値の範囲は、開始値と終了値が数値の場合、または、接尾辞が数字の文字列値である場合にのみ使用することができます。 文字列の接頭辞は必ずどちらも同じでなければなりません。 例えば、node1-node10は有効なパターンですがnode1-other10は無効です。 値の範囲のステップサイズは、文字列ではなくて必ず純粋な数値でなければなりません。