On this page | |
Since | 17.5 |
このノードは、独自のアトリビュートを作成/設定できるだけでなく、内部アトリビュート(pdg_index
, pdg_frame
, pdg_priority
, pdg_output
)も変更することができます。
指定した名前とタイプのアトリビュートが既に存在した場合、このノードはそのサイズ/値を上書きします。
TOP Attributes ¶
Check Files When パラメータが Work Item is Cooked に設定されている時、マルチパラメータを使って作成されたアトリビュートに加えて、このノードは、さらにアトリビュートを追加します。 ワークアイテムは、検証が必要なファイルのリストを保存し、それらのエラーや警告を生成するかどうかを決める必要があります。
|
int |
検証されるファイルが検証に失敗した時に警告またはエラーを生成するかどうかを決めるフラグのリスト。
これは、 |
|
string |
ワークアイテムがクックされた時に検証する必要のあるファイルパスのリスト。 |
パラメータ ¶
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 が設定されます。
On Empty Input: #id: emptyinput
Determines how the node should handle a lack of input work items. By default, if no input work items are found the node creates a single work item with the specified attributes.
Create Work Item
Create a single work item.
Ignore
Silently ignore the lack of inputs and create no work items.
Report Warning
Report a warning and create no work items.
Report Error
Report an error and fail the cook.
Create When
このパラメータを有効にすると、ワークアイテム毎に評価されるエクスプレッションを設定することができます。
アトリビュートは、このパラメータのエクスプレッションがゼロ以外の値を返したワークアイテムに対してのみ作成/更新されます。
例えば、index
が5より大きいワークアイテムにのみアトリビュートを設定したいのであれば、このパラメータを有効にして、エクスプレッションに@pdg_index > 5
を設定します。
Copy Inputs to Outputs
このノード内のワークアイテムが入力ファイルを出力ファイルリストにコピーするかどうかを決めます。
Never
入力ファイルを出力ファイルリストにコピーしません。
Always
常に入力ファイルを出力ファイルリストにコピーします。
If Node Doesn’t Add Outputs
Attribute Createノードが新しい出力ファイルを自身のワークアイテムに追加 しない 場合にのみ入力ファイルがコピーされます。 Files マルチパラメータを使用してこのノードに出力ファイルを指定すると、それらのファイルのみが出力ファイルリストに表示されます。
Work Item Priority
このパラメータは、現行スケジューラがこのノード内のワークアイテムの優先度を設定する方法を決めます。
Inherit From Upstream Item
ワークアイテムは、親ワークアイテムの優先度を継承します。ワークアイテムに親ワークアイテムがなければ、その優先度は0に設定されます。
Custom Expression
ワークアイテムの優先度は、 Priority Expression の値に設定されます。
Node Defines Priority
ワークアイテムの優先度は、このノード自身の内部優先度計算に基づいて設定されます。
このオプションは、
Python Processor TOP,
ROP Fetch TOP, ROP Output TOPのノードでのみ利用可能です。
これらのノードは、各自のノードロジックで実装された優先度設定スキームを定義しています。
Priority Expression
このパラメータには、ワークアイテムの優先度を設定するためのエクスプレッションを指定します。 このエクスプレッションは、ノード内のワークアイム毎に評価されます。
このパラメータは、 Work Item Priority が Custom Expression に設定されている場合にのみ利用可能です。
Index
このパラメータを有効にすると、このノードは、指定したエクスプレッションの結果を各ワークアイテムの内部index
アトリビュートに設定します。
例えば、foo
アトリビュートの値から1を引いた値を各ワークアイテムのindex
に設定したいのであれば、 Index を有効にして、エクスプレッションに@foo - 1
を設定します。
Frame
このパラメータを有効にすると、このノードは、指定したエクスプレッションの結果を各ワークアイテムの内部frame
アトリビュートに設定します。
例えば、source_frame
アトリビュートの値を各ワークアイテムのフレーム番号に設定したいのであれば、 Frame を有効にして、エクスプレッションに@source_frame
を設定します。
このセクション内のパラメータを使用することで、色々なタイプのワークアイテムアトリビュートを生成することができます。 IntegerアトリビュートとFloatアトリビュートは1から4までの配列サイズを受け取り、他のアトリビュートタイプはスカラー値のみを受け取ります。
文字列の配列を含んだアトリビュートまたは5つ以上の配列長のアトリビュートを作成する必要がある場合は、代わりに
Python Processorノードまたは
Python Scriptノードを使用することを検討してください。
PDGワークアイテムPython APIを使ってアトリビュートを作成することもできます: pdg.WorkItem.addAttrib。
Strings
Examples ¶
AttributeExpressions Example for Attribute Create TOP node
このサンプルでは、パラメータエクスプレッションを介してワークアイテムアトリビュートの設定とアクセスをする方法を説明しています。
CreateAttributes Example for Attribute Create TOP node
このサンプルでは、ワークアイテム上にアトリビュートを作成する方法を説明しています。
See also |