For Each

For-Eachループブロックの終了ノード。

On this page

概要
How to
ループ変数
- エクスプレッション内
- Python内
Tips
入力
パラメータ

概要

このノードは、Begin Context Options Blockノードをこのノードの3番目の入力に接続してブロックを形成します。このノードは、開始ノードからこのノードの3番目の入力の間に接続されているノードをループさせて、 Iteration Method に基づいてそれらのノードを何回もクックします。

(For-Eachブロックはコンテキストオプション変数を使って反復回数を保持することから、この開始ノードがコンテキストオプションノードになります。)

このノードの用途をいくつか挙げると:

特定の数だけPrims、アトリビュート、編集、他に必要な何かを自動的に生成します。
一連の変更をたくさんのPrimsに適用します。
一連の変更をたくさんのPrims上のすべてのバリアントセットまたはすべてのバリアントに適用します。

How to

LOPネットワーク内で⇥ Tabを押してFor Eachを選択します。

これは、Begin Context Options Blockノードから始まってこのノードで終わるブロックを配置します。
入力となるノードチェーンをforeach_endノードの 1番目の入力 に接続します。

ステージに追加するだけであれば(例えば、新しいPrimsを作成するなど)、foreach_beginには何も接続する必要はありません。しかし、既存のPrimsを修正する場合には、入力となるノードチェーンがループ内で利用できるように、さらにそのノードチェーンをforeach_beginノードの入力に接続してください。
このブロックの最後にあるFor Eachノード(foreach_end)を選択します。
このノードのパラメータエディタで、 Iteration Method を選択します。
foreach_beginノードからforeach_endノードの 3番目の入力 の間で、ループさせたいLOPノードを接続します。

For Eachノードは、( Iteration Method に応じて)ブロックを0回以上クックします。その結果は平坦化され、このノードの1番目の入力のステージ上にサブレイヤーとして追加されます。

ループ変数

ブロック内のノード上では、現行の反復数(ITERATION)と反復総数(NUMITERATIONS)を含んだコンテキストオプションにアクセスすることができます。

他にも、一部の Iteration Method はITERATIONVALUE変数を設定します。この変数の内容は、その Iteration Method によって異なります。例えば、Primsに対する反復の場合、このITERATIONVALUEには、現行Primのシーングラフパスが格納されます。以下の Iteration Method パラメータのヘルプを参照してください。

Tip

For Eachノードのパラメータを使ってループ変数の名前を変更することができます(以下参照)。 For-Eachループを入れ子化 している場合、ループレベル毎に異なる変数名になるように変数の名前を変更してください。そうすることで、それらのループ変数を分けることができます。

例えば、"For-Eachバリアントセット"ループがあって、そのループの中に"For-Eachバリアント"ループがあるとします。外側ループの変数の名前をVARSET_ITERATION、NUM_VARSETSに変更し、内側ループの変数の名前をVARIANT_ITERATION、NUM_VARIANTSに変更することができます。

エクスプレッション内

ループ内でのエクスプレッション内でコンテキストオプションの値を取得するには、@nameを使用します。例:

@ITERATION

またはcontextoptionエクスプレッション関数を使用します:

contextoption("ITERATION")

例えば、/lights Prim内に名前が/lights/light_0から/lights/light_99までの100個のライトを作成したいのであれば、ループブロック内にLightノードを配置して、その Primitive Path パラメータに以下のエクスプレッションを設定します:

/lights/light_`@ITERATION`

(文字列パラメータでは、エクスプレッションコードをバッククォートで閉じる必要があることを忘れないでください。)

Python内

ループ内でのPython内でコンテキストオプションの値を取得するには、hou.contextOption()関数を使用します。

ITERATIONVALUEから情報を引き出すのは、Python拡張ライブラリのstring系関数とパス操作系関数を使用するのが便利だと思うかもしれません。 hou.setContextOption()を使用することで、新しいコンテキストオプションを作成することができます。

例えば、"For Each Primitive"ループの頭に、Python Script LOPを挿入することで、フルPrimパスから抽出された親パスとPrim名を含んだ新しいコンテキストオプション変数を作成することができます。

# コンテキストオプションから現行Primのパスを取得します。
full_prim_path = hou.contextOption("ITERATIONVALUE")
# パス文字列内の最後のスラッシュのインデックスを見つけます。
last_slash = full_prim_path.rfind("/")
# 最後のスラッシュまでのすべての文字列を含んだ新しい"PARENTPATH"コンテキストオプションを作成します。
hou.setContextOption("PARENTPATH", full_prim_path[:last_slash])
# 最後のスラッシュ以降のすべての文字列を含んだ新しい"PRIMNAME"コンテキストオプションを作成します。
hou.setContextOption("PRIMNAME", full_prim_path[last_slash + 1:])

すると、ループ内の他のノードのエクスプレッションで@PARENTPATHと@PRIMNAMEを使用することができます。

Tips

ループブロックの頭にあるBegin Context Options Blockノードの Perform Layer Break パラメータのチェックをオンのままにします。

このオプションを無効にすると、Begin Context Options Blockノードより上流のすべてのノードが各ループに含まれるようになって、反復の度に無駄に結合されてしまいます(クックの度にこのデータは同じになるので無駄です)。
このブロックは、コンテキストオプションを使って反復系の変数を保持しているので、他のネットワークタイプのFor-Eachループとはまったく別に動作します。
選択したPrims上の特定のバリアントセット内のすべてのバリアントを編集するには:
- Primsに対する外側"For Each Prim"ループを作成します。編集したいPrimsを選択するために、 Primitives パラメータを設定します。このループのITERATIONVALUE変数の名前をPRIMPATHに変更します。
- 内側"For Each Variant"ループを作成します。このループのITERATIONVALUE変数の名前をVARIANTNAMEに変更します。
- こうすることで、内側ループ内のノードにおいて、現行Primのシーングラフパスを@PRIMPATH、現行バリアントの名前を@VARIANTNAMEとして指定してバリアントを編集できるようになります。

入力

First Input

この入力には、入力ステージを接続します。このノードは、3番目の入力に接続されたノードをループさせた結果を平坦化してから、出力内でそれをこのステージ上の新しいレイヤーとしてオーバーレイします。

Second Input

Iteration Method には、1番目の入力からではなく、この入力からのPrims/バリアントセット/バリアントに対してループさせるオプションがあります。これによって、修正されるステージとは別のステージを使って反復を駆動させることができます。

この入力内のデータは、 このノードの出力には決して含まれません 。 Iteration Method 設定に応じて反復を駆動させるために使用します。

Third Input

この入力は、反復毎に再クックされます。このノードは、反復毎に生成されたレイヤーをまとめて平坦化し、その平坦化された結果を1番目の入力のステージ上に合成します。

パラメータ

Iteration Method

このノードによるループの方法/何に対してループさせるか。

For Number of Iterations

設定した回数だけループさせます。 Iterations パラメータにエクスプレッションを使用することで反復回数を動的に駆動させることができます。

このメソッドは、ITERATION(0から始まる現行ループカウント)と同じ値をITERATIONVALUEに設定します。

For Each Primitive in First Input

(1番目の入力から) Primitives パラメータ内のプリミティブパターンで選択されたPrim毎にループさせます。

このメソッドは、現行PrimのフルパスをITERATIONVALUEに設定します。

このオプションは、一連のPrimsに対して編集を行なうのに役立ちます。

For Each Variant Set in First Input

特定のPrim(またはPrims)上のバリアントセット毎にループさせます。 Primitives パラメータ内のプリミティブパターンは、(1番目の入力から)バリアントセットを保持しているPrim(s)を選択します。

このメソッドは、現行バリアントセットの名前をITERATIONVALUEに設定します。

これを使うことで、バリアントセットにバリアントを追加または削除することができます。 "For Each Variant in First Input"を使って他のFor-Eachループを内側に入れ子化することで、各バリアントセット内のバリアント毎にループをさせることもできます。

For Each Variant in First Input

特定のPrim(またはPrims)上の指定した名前のバリアントセット内のバリアント毎にループさせます。 Primitives パラメータ内のプリミティブパターンは、(1番目の入力から)バリアントセットを保持しているPrim(s)を選択します。

このメソッドは、現行バリアントの名前をITERATIONVALUEに設定します。

このメソッドは、バリアント選択を変更しません。

For Each String in Parameter

Iterate Over Strings パラメータで指定された文字列毎にループさせます。反復回数は、そのパラメータで指定された別々の文字列の数によって決まります。

このメソッドは、そのパラメータから現行文字列をITERATIONVALUEに設定します。

1番目の入力ではなく、2番目の入力のデータを使って反復を駆動するように選択することもできます。何かしらの理由でループさせたいものが他のノードチェーン内にある場合は、そのノードチェーンを2番目の入力に接続することで、これらのオプションを使用することができます。 2番目の入力のデータは、このノードの出力には決して含まれません。 このデータは、"in Second Input"系のオプションのどれかを選択した場合に、反復を駆動させるためだけに使用されます。

Iterations

Iteration Method が"For Number of Iterations"の時、ここにはループの回数を指定します(このパラメータにエクスプレッションを使用することで、他の何かに基づいてループの回数を駆動させることができます)。

Primitives

Iteration Method が"For Each Primitive", "For Each Variant Set", "For Each Variant"の時、検索するPrimsを指定します。 Scene Graph TreeペインからPrimsをこのテキストボックス内にドラッグすることで、それらのパスを追加することができます。または、テキストボックスの隣にある選択ボタンをクリックすることで、ビューア内でPrimsを選択することができます。プリミティブパターンを使って高度なマッチングを行なうこともできて、(/path/to/prim.collection:nameを使うことで)コレクション内のすべてのPrimsにマッチングさせることもできます。

Variant Set

Iteration Method が"For Each Variant"の時、ループさせるバリアントセットの名前を指定します。

Iterate Over Strings

Iteration Method が"For Each String in Parameter"の時、ループさせる文字列のリストを指定します。個々の文字列はスペースで区切ります。文字列を引用符で閉じることで、スペースをその値に含めることができます。

Flatten Iterations Into First Input Layer

これが無効な時(デフォルト)、ループ内で作成された編集は、1番目の入力に新しいサブレイヤーとして追加されます。これが有効な時、ループ内で作成された編集は、1番目の入力のアクティブレイヤー上に平坦化されます(新しいレイヤーを作成しません)。

Iteration Option Name

(0から始まる)現行ループ番号を格納するために、このノードが作成するコンテキストオプション変数の名前。便宜的にこの名前を変更することで、入れ子ループが固有の名前を使用するようにすることができます。

Iteration Count Option Name

ループ回数を格納するために、このノードが作成するコンテキストオプション変数の名前。便宜的にこの名前を変更することで、入れ子ループが固有の名前を使用するようにすることができます。

Value Option Name

Iteration Method 特有の情報("For Number of Iterations"なら現行反復番号、"For Each Primitive"なら現行Primパス、"For Each Variant Set"ならバリアントセット名、"For Each Variant"ならバリアント名)を格納するために、このノードが作成するコンテキストオプション変数の名前。便宜的にこの名前を変更することで、入れ子ループが固有の名前を使用するようにすることができます。

Iteration Range

これは、オプションでノードが普段実行する反復回数を特定の範囲内の開始から終了までに制限することができます。これは、結果全体の"スライス"だけの効果を確認する時のデバッグで役に立ちます。

All Iterations

利用可能なすべての反復を実行します(これがデフォルトで、普段のオペレーションです)。

Single Iteration

First Iteration パラメータで指定されたループ番号のみを実行します。ループ番号は0から始まります。

Range of Iterations

First Iteration 以上 Last Iteration 以下の範囲のみで反復を実行します。例えば、 Iteration Method を"For Number of Iterations"、 Iterations を5に設定すると、0, 1, 2, 3, 4の反復番号が得られます。 Iteration Range を"Range"、 First Iteration を1、 Last Iteration を3に設定すると、1, 2, 3の反復番号のみが得られます。

First Iteration

Iteration Range が"Single"の時、この反復番号のみを実行します。 Iteration Range が"Range"の時、この番号から始まる反復のサブセットのみが実行されます。 1番目の反復の番号が0になります。

Last Iteration

Iteration Range が"Range"の時、 First Iteration 以上でこの Last Iteration 以下の反復のサブセットのみが実行されます。 1番目の反復の番号が0になります。

概要