On this page | |
Since | 17.5 |
このノードは、上流のワークアイテム毎にエクスプレッションを評価して、そのワークアイテムをフィルタリングするかどうかを決定します。 Operation パラメータを Keep Matched Items に設定することで、合致したワークアイテムが維持されるようにフィルターを反転させることもできます。
パラメータ
Generate When
このノードがワークアイテムを生成するタイミングを決めます。 このノードがどの生成モードを必須にしているのか、もしくは、ワークアイテムを動的に生成させる必要があるのかどうか分からないのであれば、通常では、これを"Automatic"のままに設定してください。
All Upstream Items are Generated
このノードは、すべての入力ノードが自身のワークアイテムを生成した時にワークアイテムを生成します。
All Upstream Items are Cooked
このノードは、すべての入力ノードが自身のワークアイテムをクックした時にワークアイテムを生成します。
Each Upstream Item is Cooked
このノードは、入力ノード内のワークアイテムがクックされる度にワークアイテムを生成します。
Automatic
入力ノードの生成モードに基づいて生成モードが選択されます。 入力ノードのどれかがその入力のクック時にワークアイテムが生成されている場合、このノードには Each Upstream Item is Cooked が設定されます。 そうでない場合、 All Upstream Items are Generated が設定されます。
Operation
このノードが Filter Expression に合致したワークアイテムを削除するのか、または、そのフィルターに合致したワークアイテムを維持するのかを決めます。
Filter Expression
指定したエクスプレッションが上流のワークアイテム毎に評価されます。 その結果が1/trueの場合は、その上流のワークアイテムがフィルタリングされ、それ以外の場合は、このノードによってそのワークアイテムがコピーされます。
Include Output Files
有効にすると、コピーされたワークアイテムには、上流のワークアイテムの出力ファイルが含まれるようになります。
Examples
FilterStringAttrib Example for Filter by Expression TOP node
このサンプルでは、Filter by Expression TOPノードでstrcmp HScriptエクスプレッションを使用する方法を説明しています。
FilterWorkItems Example for Filter by Expression TOP node
このサンプルでは、もっと処理やデバッグをしたいワークアイテムを選び出せるように上流ワークアイテムをフィルタリングする方法を説明しています。
See also |