ワークアイテムは、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です。 pdgattribvalsを使用することで、アトリビュート配列のすべてのコンポーネントをスペース区切りの文字列として参照することができます。

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

複雑に構造化されたデータを必要とするユースケースのために、ワークアイテム上に作成可能なアトリビュートの追加タイプが2つあります。 1つ目のタイプが Python Objectアトリビュート タイプです。 このアトリビュートには単一PyObject値を割り当てることができます。 TOPsは、このPython Objectの文字列表現を使ってアトリビュートの内容に関する基本的な情報を表示することしかできず、ほとんどのノードはそのタイプのアトリビュートに格納されているデータを直接操作することができません。 PDG Python APIを介するか、または、ShotGrid系ノードなどの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ドキュメントに載っています。

デフォルトでは、アトリビュートを操作するノードは、自身のワークアイテム上に直接そのアトリビュートを作成します。 このようなアトリビュートのことを ワークアイテムアトリビュート と呼びます。 とはいえども、アトリビュートデータを グローバルに TOPグラフ(/topnet)自体に格納することで、アトリビュートがそのTOPグラフ内のすべてのノードにアクセスできるようにすることもできます。 このようなアトリビュートのことを グローバルアトリビュート と呼びます。

グローバルアトリビュートは、Attribute Create TOPノードを使用したり、Python Script TOPノードまたはPython Processor TOPノードでPDG Python APIを使用することで作成することができます。

シーン内に同じ名前のワークアイテムアトリビュートが存在しない場合に限っては@アトリビュート名構文を使うことで、または、PDG Python APIでアトリビュートデータの生成/照会するどれかのメソッド(例えば、pdg.AttributeOwnerのpdg.Graphサブクラス)を使うことで、グローバルアトリビュートにアクセスすることができます。

グローバルアトリビュートはワークアイテムに バインド することができます。 つまり、ワークアイテムを削除すると、そのワークアイテムにバインドされているすべてのグローバルアトリビュートもグラフから削除されます。 これは、特定のワークアイテムで実行される処理がグローバルアトリビュートを生成する場面で役立ちます。 例えば、ワークアイテムが設定ファイルを読み込んで、そのファイルで見つかったフィールドに基づいてグローバルアトリビュートを設定する時がそうです。

`

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

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

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

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

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

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

デフォルトでは、範囲構文は最初のエレメントを含みますが、その範囲構文の最後のエレメントを含みません。 例えば、1-5のパターンは1, 2, 3, 4の値の数列を意味します。 値の範囲は、開始値と終了値が数値の場合、または、接尾辞が数字の文字列値である場合にのみ使用することができます。 文字列の接頭辞は必ずどちらも同じでなければなりません。 例えば、node1-node10は有効なパターンですがnode1-other10は無効です。 値の範囲のステップサイズは、文字列ではなくて必ず純粋な数値でなければなりません。

接頭辞の後に数値の範囲を括弧で閉じた[..]を付けることでも範囲指定が可能です。 これは、共通する文字列の接頭辞の後に範囲の値の接尾辞が追加された文字列リストを指定するのに役立ちます。 例えば、prefix[1-3]のパターンは、prefix1, prefix2, prefix3の文字列リストを生成します。

Range Generateなどの一部のノードは、範囲構文の最後のエレメントを含むようになっています。 これによって、値パターンを開始値、終了値、ステップ値を受け入れる他のフレーム範囲パラメータと同様の挙動をさせることができます。 Pythonコードで独自のpdg.ValuePatternインスタンスを作成すれば、値範囲内の最後のエレメントの挙動も設定することができます。

パターンの頭に^排他文字を置くことで、1個以上の値を含めないようにすることができます。 その排他パターンにマッチした部分は、パターン内のそれ以前に定義されたパターン部分から無視されるのに対して、それ以降に定義されたパターン部分には適用されません。 排他パターンは範囲構文として定義することもできます。 例えば、1-10 ^4-6のパターンは1, 2, 3, 6, 7, 8, 9の値の数列を生成します。 排他パターンの後に別のパターンを追加しても、その排他パターンはその後のパターンには適用されません。 例えば、1-10 ^4-8 5 6のパターンは1, 2, 3, 5, 6, 7, 9の値の数列を生成します。

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

The filter syntax is an extended form of the value pattern syntax that allows you to specify the name of an attribute and a pattern to match with the attribute, and apply that pattern to a work item using the pdg.FilterPattern class. A filter pattern consists of a space-separated set of rules. Each rule begins with the name of an attribute, a comparison operator like > or =, and a value pattern to compare against the attribute. The attribute name can also include an optional array index suffix, specified using either a letter or number. For example, @pdg_id>5 and @scale.x <= 2.0f @scale.z <= 3.0 @array[5]=10 are two examples of valid filter patterns.

The name can be any valid work item attribute name, or one of the following built-ins: @pdg_id, @pdg_index, @pdg_frame, @pdg_loopdepth, @pdg_name, @pdg_label, @pdg_output.

The = and != operator can be compared with arbitrary value patterns that include ranges of values, for example @name=task[2-10] compares the name attribute against a list of possible string values. The >, >=, <, and <= operators are only valid if the pattern on the right hand side produces a single scalar value – they cannot be used with ranges. For example, @scale.z>5 is valid, but @scale.z>1-5 is not.

Entries in the pattern can be turned into exclusions by prepending them with the ^ token. For example, the pattern @width>5 ^@height<4 will match all work items with a width attribute that’s larger than five, except for ones that also have a height less than 4.