Houdini 18.0 ノード TOPノード

Attribute Create TOP node

入力のワークアイテムすべてに対してアトリビュートを作成または設定します。

On this page

このノードは、独自のアトリビュートを作成/設定できるだけでなく、内部アトリビュート(pdg_index, pdg_frame, pdg_priority, pdg_output)も変更することができます。 指定した名前とタイプのアトリビュートが既に存在した場合、このノードはそのサイズ/値を上書きします。

TOP Attributes

In addition to the attributes created using the multiparms, this node will also add additional attributes when the Check Files When parameter is set to Work Item is Cooked. The work item needs to store the list of files that need to be validate, and whether those should produce errors or warnings.

validateerrors

int

The list of flags indicating whether the files being validated should produce a warning or error when validation fails. This is the same size as the validatefiles attribute.

validatefiles

string

The list of file paths that should be validated when the work item cooks

パラメータ

Create

Work Item Generation

このノードが静的または動的なワークアイテムのどちらを生成するかどうか。 このノードのワークアイテムが静的に計算可能かどうか、もしくは、動的に生成させる必要があるかどうか分からないのであれば、通常では、これを"Automatic"のままに設定してください。

Dynamic

このノードが常に動的なワークアイテムを生成します。つまり、上流のワークアイテムが判明するまで待機し、その上流のワークアイテムから新しいワークアイテムを生成します。

Static

このノードが常に静的なワークアイテムを生成します。つまり、ネットワークを実行する前にパラメータ(と上流の静的なワークアイテム)に基づいて必要だと思われるだけの数のワークアイテムを生成します。

Automatic

入力が静的(静的なプロセッサ、静的な入力のみを使ったパーティショナー、マッパー)な場合、このノードは静的なワークアイテムを生成し、そうでない場合、動的なワークアイテムを生成します。

Create When

このパラメータを有効にすると、このノードは、指定したエクスプレッションがゼロ以外の値に評価したワークアイテムに対してのみアトリビュート(s)を作成/設定します。 例えば、indexが5より大きいワークアイテムにのみアトリビュートを設定したいのであれば、 Create When を有効にして、エクスプレッションに@pdg_index > 5を設定します。

Work Item

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 PriorityCustom Expression に設定されている時にのみ利用可能です。

このパラメータには、ワークアイテムの優先度を設定するためのエクスプレッションを指定します。 このエクスプレッションは、ノード内のワークアイム毎に評価されます。

Index

このパラメータを有効にすると、このノードは、指定したエクスプレッションの結果を各ワークアイテムの内部indexアトリビュートに設定します。 例えば、fooアトリビュートの値から1を引いた値を各ワークアイテムのindexに設定したいのであれば、 Index を有効にして、エクスプレッションに@foo - 1を設定します。

Frame

このパラメータを有効にすると、このノードは、指定したエクスプレッションの結果を各ワークアイテムの内部frameアトリビュートに設定します。 例えば、source_frameアトリビュートの値を各ワークアイテムのフレーム番号に設定したいのであれば、 Frame を有効にして、エクスプレッションに@source_frameを設定します。

Attributes

You can use the parameters in this section to create work item attributes of various types. Integer and Float attributes take an array size between 1 and 4, and other attribute types only take scalar values.

If you need to create attributes that contain an array of strings or have a longer array length, please consider using a Python Processor or Python Script node instead.

You can also create attributes using the PDG work item Python API: pdg.WorkItem.addAttrib.

Strings

Integer Arrays

Integers

1つ以上の整数アトリビュートを追加/設定することができるマルチパラメータ。

Name

追加/設定する整数アトリビュートの名前。

Existing Name

Determines how to handle a conflict when an existing attribute with the same name is found.

Replace Existing Attribute

The node deletes the old attribute and adds the one described by this multiparm entry.

Update Existing Attribute Value

The node attempts to update the value if the attribute type matches, otherwise it issues a warning.

Generate Warning on Type Mis-match

The node issues a warning if the attribute type doesn’t match.

Generate Error on Type Mis-match

The node issues an error if the attribute type doesn’t match.

Tip

If you set this parameter to Update Existing Attribute Value and specify a Size value that is less than the size of an existing attribute array, only the first Size component will be updated. For example, you can use this to update the first three values in a four-component vector without affecting the fourth component.

Size

整数アトリビュートのベクトルサイズ(1-4)。 単一スカラー値には1を、3Dベクトルには3を使用します。

Value

整数アトリビュートの値。 ここには、入力のワークアイテム毎に評価されるエクスプレッションを指定することができます。

Note

When Value is an expression, then you must place the expression inside backticks (`).

Float Arrays

Floats

1つ以上のfloatアトリビュートを追加/設定することができるマルチパラメータ。

Name

追加/設定するfloatアトリビュートの名前。

Existing Name

Determines how to handle a conflict when an existing attribute with the same name is found.

Replace Existing Attribute

The node deletes the old attribute and add the one described by this multiparm entry.

Update Existing Attribute Value

The node attempts to update the value if the attribute type matches, otherwise it issues a warning.

Generate Warning on Type Mis-match

The node issues a warning if the attribute type doesn’t match.

Generate Error on Type Mis-match

The node issues an error if the attribute type doesn’t match.

Tip

If you set this parameter to Update Existing Attribute Value and specify a Size value that is less than the size of an existing attribute array, only the first Size component will be updated. For example, you can use this to update the first three values in a four-component vector without affecting the fourth component.

Size

floatアトリビュートのベクトルサイズ(1-4)。 単一スカラー値には1を、3Dベクトルには3を使用します。

Value

floatアトリビュートの値。 ここには、入力のワークアイテム毎に評価されるエクスプレッションを指定することができます。

Note

When Value is an expression, then you must place the expression inside backticks (`).

Python Objects

PyObjects

A multiparm that allows you to add/set one or more PyObject attributes.

Name

The name of the PyObject attribute to add/set.

Existing Name

Determines how to handle a conflict when an existing attribute with the same name is found.

Replace Existing Attribute

The node deletes the old attribute and adds the one described by this multiparm entry.

Update Existing Attribute Value

The node attempts to update the value if the attribute type matches, otherwise it issues a warning.

Generate Warning on Type Mis-match

The node issues a warning if the attribute type doesn’t match.

Generate Error on Type Mis-match

The node issues an error if the attribute type doesn’t match.

Expression

The Python expression for the new PyObject attribute. This can be an expression that is evaluated for each incoming work item.

Files

Files

1つ以上の出力ファイルパスを追加/設定することができるマルチパラメータ。 TOPsはワークアイテム毎に、そのワークアイテムが生成したファイルのファイルパスを追跡します。ワークアイテムのワークスクリプトは頻繁にこの情報を自動的に更新しますが、このノードを使って 手動で その情報を設定することもできます。

Create As

Output File

The file is added to the work item’s output file list.

File Attribute

The file is added to the work item as an attribute with the file type.

Attribute Name

When Create As is set to Attribute, choose the name of the created attribute.

Existing Name

This parameter is only used when Create As is set to Attribute.

Determines how to handle a conflict when an existing attribute with the same name is found.

Replace Existing Attribute

The node deletes the old attribute and adds the one described by this multiparm entry.

Update Existing Attribute Value

The node attempts to update the value if the attribute type matches, otherwise it issues a warning.

Generate Warning on Type Mis-match

The node issues a warning if the attribute type doesn’t match.

Generate Error on Type Mis-match

The node issues an error if the attribute type doesn’t match.

File Path

各ワークアイテムのファイル出力のリストに追加するファイルパス。 ここには、入力のワークアイテム毎に評価されるエクスプレッションを指定することができます。

File Tag

File Path に適用するファイルタグ。 例えば、file/geoまたはfile/picです。 ここには、入力のワークアイテム毎に評価されるエクスプレッションを指定することができます。

Note

File Path または File Tag がエクスプレッションの場合、そのエクスプレッションを バッククォート (`)で閉じてください。

Check File Path

Determines if the node should verify that the file path exists and is readable before adding it to your work items.

No File Path Validation

The node does not perform file validation.

Error on Missing File

The node issues an error when the specified File Path does not exist.

Warning on Missing File

The node issues a warning when the specified File Path does not exist.

Check File When

Determines if the file paths should be validated during work item generation or when the work items cook. Validating files during the cook is useful if you expect the files to be created when something upstream cooks, as opposed to referring to a existing path already on disk.

Examples

example_top_attributecreate Example for Attribute Create TOP node

このサンプルでは、TOPノードのワークアイテムに対してアトリビュートを作成する方法について説明しています。

See also

TOPノード

  • Attribute Copy

    あるブランチのワークアイテムのアトリビュートを他のブランチのワークアイテムにコピーします。

  • Attribute Create

    入力のワークアイテムすべてに対してアトリビュートを作成または設定します。

  • Attribute Delete

    ワークアイテムからアトリビュートを削除します。

  • Attribute from String

    ファイル名などの文字列からアトリビュート値を解析します。

  • Block Begin Feedback

    For-Loop with Feedbackブロックを開始します。このブロック内のTOPノードは直列で実行され、オプションで入力のワークアイテム毎にループさせることができます。

  • Block End Feedback

    For-Loop with Feedbackブロックを終了します。このブロック内のTOPノードは直列で実行され、オプションで入力のワークアイテム毎にループさせることができます。

  • CSV Input

    CSVファイルのデータをワークアイテムのアトリビュートにコピーします。

  • CSV Output

    ワークアイテムのアトリビュートをCSVファイルに書き出します。

  • Command Send

    実行させたいコードを共有サーバーに送信します。

  • Command Server End

    サーバーブロックを終了します。

  • Deadline Scheduler

    Thinkbox社のDeadlineソフトウェア用PDGスケジューラ。

  • Download File

    1つ以上のURLの内容をファイルにダウンロードします。

  • Environment Edit

    ワークアイテムのコマンドラインが実行する環境下で設定する変数を編集します。

  • Error

    条件を満たした時に警告またはエラーを生成します。

  • Error Handler

    失敗したワークアイテムのエラーハンドル。

  • FFmpeg Encode Video

    静止画像シーケンスを動画に変換します。

  • FFmpeg Extract Images

    動画ファイルから静止画像シーケンスを抽出します。

  • File Compress

    ファイルをアーカイブに圧縮します。

  • File Copy

    実行時またはノードがファイルを生成した時に、ファイルをある場所から別の場所にコピーします。

  • File Decompress

    入力のワークアイテムで指定されたアーカイブファイルを個々のファイルに解凍します。

  • File Pattern

    特定のパターンに合致したファイルに基づいてワークアイテムを生成します。

  • File Range

    特定のファイルパターンに基づいたフレーム範囲からワークアイテムを生成します。

  • File Remove

    指定したパスのファイルを削除します。

  • File Rename

    ファイルを名前変更または移動させます。

  • Filter by Expression

    上流のワークアイテムを条件付きでフィルタリングします。

  • Filter by Range

    指定したフレーム内またはアトリビュート範囲内にある上流のワークアイテムを絞り込みます。

  • Generic Generator

    アトリビュートなしでコマンドラインを実行するワークアイテムを生成します。

  • Geometry Import

    SOPまたはファイルジオメトリのポイントまたはプリミティブをワークアイテムアトリビュートまたは一時ファイルに読み込みます。

  • HDA Processor

    デジタルアセットをクックするワークアイテムを生成します。

  • HQueue Scheduler

    HQueueを使用してワークアイテムのスケジュールを組みます。

  • Houdini Server Begin

    持続型Houdiniコマンドサーバーを起動します。

  • ImageMagick

    一括で画像変換、サイズ変更、画像モザイクなどのImageMagickの機能に簡単にアクセスすることができます。

  • In Process Scheduler

    In-Processワークアイテムのスケジューリングを制御します。

  • Invoke

    入力ジオメトリに対してコンパイルブロックを呼び出します。

  • Json Input

    JSONファイルからデータを抽出してアトリビュートを作成します。

  • Json Output

    JSON出力を生成する色々なオペレーションを実行します。

  • Local Scheduler

    ローカルマシン上でワークアイテムのスケジュールを組みます。

  • Make Directory

    ディレクトリを作成します。

  • Map All

    上流のすべてのワークアイテムを下流のワークアイテムにマップします。

  • Map by Expression

    エクスプレッションを使って、上流のワークアイテムを下流のワークアイテムにマップします。

  • Map by Index

    上流のワークアイテムをインデックスに基づいて下流のワークアイテムにマップします。

  • Map by Range

    範囲を使って上流のワークアイテムを下流のワークアイテムにマップします。

  • Maya Server Begin

    持続型Mayaコマンドサーバーを起動します。

  • Merge

    上流のすべてのワークアイテムを結合します。

  • Nuke Server Begin

    持続型Nukeコマンドサーバーを開始します。

  • Null

    何もしません。

  • OP Notify

    何かしらのTOPワークが完了したことを通知します。

  • Output

    サブネット出力。

  • Partition by Attribute

    アトリビュートに基づいてワークアイテムを区分けします。

  • Partition by Bounds

    境界アイテムを使って、ソースアイテムを空間的に区分けします。

  • Partition by Combination

    ワークアイテムを2個毎、3個毎などに区分けします。

  • Partition by Comparison

    既存の比較を使ってワークアイテムを区分けします。

  • Partition by Expression

    エクスプレッションに基づいてワークアイテムを区分けします。

  • Partition by Frame

    フレームに基づいてワークアイテムを区分けします。

  • Partition by Index

    インデックスに基づいてワークアイテムを区分けします。

  • Partition by Node

    ノードに基づいてワークアイテムを区分けします。

  • Partition by Range

    範囲に基づいてワークアイテムを区分けします。

  • Partition by Tile

    軸に平行な境界ボックスを使ってワークアイテムを空間的に区分けします。

  • Perforce

    PDG経由でPerforceコマンドを実行します。

  • Python Mapper

    Pythonスクリプトを使ってワークアイテムをマップします。

  • Python Partitioner

    Pythonスクリプトを使ってワークアイテムを区分けします。

  • Python Processor

    Pythonスクリプトを使ってワークアイテムを生成します。

  • Python Scheduler

    Pythonベースでプログラミング可能なPDG用スケジューラ。

  • Python Script

    スクリプトを実行するワークアイテムを生成します。

  • Python Server Begin

    Pythonコマンドサーバーを起動します。

  • ROP Alembic Output

    埋め込まれたROP Alembic ROPノードをクックするワークアイテムを生成します。

  • ROP Composite Output

    埋め込まれたComposite ROPノードをクックするワークアイテムを生成します。

  • ROP Fetch

    ROPノードまたはROPネットワークをクックするワークアイテムを生成します。

  • ROP Geometry Output

    埋め込まれたGeometry ROPノードをクックするワークアイテムを生成します。

  • ROP Mantra Render

    埋め込まれたMantra ROPノードをクックするワークアイテムを生成します。

  • ROP USD Output

    組み込まれたUSD ROPノードをクックするワークアイテムを作成します。

  • Range Generate

    指定した範囲のワークアイテムを生成します。

  • Render IFD

    Mantraを使ってIFDファイルをレンダリングするワークアイテムを生成します。

  • SQL Input

    SQLクエリの作成と行毎にワークアイテムを生成する入力ノードです。

  • SQL Output

    SQL INSERTクエリを生成する出力ノードです。

  • Send Email

    電子メールを送信します。

  • Shotgun Create

    Shotgunエンティティを作成します。

  • Shotgun Delete

    Shotgunからエンティティを削除します。

  • Shotgun Download

    ShotgunからAttachmentをダウンロードします。

  • Shotgun Find

    Shotgunエンティティを検索します。

  • Shotgun Server Begin

    持続型Shotgunコマンドサーバーを起動します。

  • Shotgun Update

    Shotgunエンティティを更新します。

  • Shotgun Upload

    Shotgunにファイルをアップロードします。

  • Sort

    アトリビュートのリストからワークアイテムを並べ替えます。

  • Split

    上流のワークアイテムを2つのグループに分けます。

  • Subnetwork

    TOPノード用コンテナ。

  • Switch

    ネットワーク分岐を切り替えます。

  • TOP Fetch

    他のTOPネットワークをクックします。

  • TOP Fetch Input

    TOP Fetchで取得したネットワークの入力。

  • Text Output

    テキストを新しいファイルに書き出したり、既存ファイルに追加します。

  • Tractor Scheduler

    PixarのTractorを使ってワークアイテムのスケジュールを組みます。

  • USD Import

    USDステージで見つかったPrimsからワークアイテムを生成します。

  • USD Import Files

    USDステージで見つかったファイル参照からワークアイテムを作成します。

  • USD Render

    USDファイルを書き出すワークアイテムを作成します。

  • Wait for All

    上流のワークアイテムすべてが完了するのを待ちます。

  • Wedge

    アトリビュート値を色々と変えながらワークアイテムを生成します。

  • Work Item Expand

    ファイルリストまたはパーティションを複数のワークアイテムに展開します。

  • Xml Input

    XMLファイルからデータをワークアイテムアトリビュートに抽出します。