On this page | |
Since | 17.5 |
このノードは、ディレクトリまたはすべてのサブディレクトリ内のパターンに合致したファイル名毎またはディレクトリ名毎にワークアイテムを生成します。 他にも、このノードにはワークアイテムを生成するためのモードが2つあり、使用されるモードはSplit Files into Separate Itemsパラメータで決まります。
このノードがワークアイテムを生成するように指示される度に(このノードをクックした時、このノードから静的ワークアイテムを事前に生成した時)、 このノードは、そのパターンが最後のクックの時とは別のファイルに合致するかどうか、さらにファイル変更時間が変わっているかどうかをチェックします。 もしそうであれば、変更のあったワークアイテムを更新してDirtyとしてマークします。 そのため、ディレクトリの内容が変わると、通常ではその変更されたワークアイテムのみを再クックする必要があります。
TOP Attributes ¶
Split Files into Separate Items パラメータを有効にすると、このノードは、ワークアイテム毎に以下のアトリビュートを設定します。
|
string |
ワークアイテムに関連付けられたファイルからファイル名と拡張子を除いたディレクトリ。 |
|
string |
ワークアイテムに関連付けられたファイルの拡張子。 File Typesを Directories Only に設定した場合、または、マッチしたパスがディレクトリの時は、このアトリビュートは設定 されません 。 |
|
string |
ファイルの名前。 File Typesを Directories Only に設定した場合、または、マッチしたパスがディレクトリの時は、このアトリビュートは設定 されません 。 |
パラメータ ¶
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 が設定されます。
File Types
パターンマッチさせるファイルタイプ。
Files Only
ファイルのみに合致します。
Directories Only
ディレクトリのみに合致します。
All
ファイルとディレクトリの両方に合致します。
Pattern
検索を開始するパスと、さらに合致させるパターンを指定します。
例えば、$PDG_DIR/geo/*.bgeo
は、プロジェクト作業ディレクトリ内のgeo
ディレクトリを見て、.bgeo
で終わるファイルをすべて検索します。
Pattern には?
(どれかの文字に合致),*
(任意の文字列に合致),[abc]
(大括弧内の文字のどれかに合致)などのワイルドカードを使用することができます。
例えば、*.png
は.png
で終わるすべてのファイルに合致します。
Pattern は、レンダーファーム上のリモートホストではなく、ネットワークをクックするマシン上で常に展開されます。 展開されたファイル名は、共有ネットワークファイルシステム内の作業ディレクトリ下に存在している必要があります。 このノードは、合致したローカルファイルパスを作業ディレクトリを基準とした相対パスに自動的に変換します。
Note
$F
は期待通りに 動作しません 。
このパターンエクスプレッションは、特定のフレーム値を持ったワークアイテムのコンテキスト内で評価されます。
代わりにFile Range TOPノードを使用してください。
Recursive
有効にすると、 Pattern パラメータで指定されたパスのサブディレクトリに対してもファイル名のマッチングを行ないます。
Follow Symlinks
Recursive が有効な時、このパラメータは、このノードがシンボリックリンクの指すディレクトリを再帰するかどうかを決めます。
No Match Behavior
ファイルパターンが失敗してどのファイルにも合致しなかった場合の挙動を決めます。
Ignore
見つからなかったファイルに対してワークアイテムを生成しません。
Set Node Error
ノードにエラーを設定します。
Create Work Items
ワークアイテムを作成し、ファイルが見つからなかったことを示したアトリビュートを設定します。
File Exists Attribute
各ワークアイテム上に作成される、ファイルが見つかったどうかを示したアトリビュートの名前を指定します。
Include Extensions in Filename Attribute
このトグルを有効にすると、拡張子を含んだフルファイル名がワークアイテム上のアトリビュートに格納されます。 このトグルを無効にすると、拡張子を含まないベースファイル名のみがアトリビュートに格納されます。
Split Files into Separate Items
有効にすると、このノードは、合致した名前毎に別々のワークアイテムを生成し、そのファイル名データをアトリビュートに格納します。 このパラメータはデフォルトで 有効 になっています。 無効にすると、このノードは、合致したファイルパス群をワークアイテムの出力結果として設定された 1個 のワークアイテムを生成します。 無効にすれば、このノードの接続先のノードがResult Dataを操作する場合で役立ちます。
Inherit Upstream Work Item Index
Split Files into Separate Items とこのパラメータを有効にすると、生成されるワークアイテムは上流のワークアイテムのインデックスを継承します。 このパラメータを無効にし、 Split Files into Separate Items を有効にすると、ワークアイテムのインデックスは、見つかったファイルのリスト内でのそのファイルの位置に基づきます。
Output Attribute
デフォルトでは、 Pattern に合致したファイルは、ワークアイテムの出力として格納されます。 このパラメータを有効にすると、代わりにそれらのファイルは、指定した名前のファイルアトリビュートに格納されます。
Output File Tag
有効にすると、このファイルタグが出力ファイルパスに割り当てられます。 無効にすると、このノードはファイル名の拡張子に基づいて適切なファイルタグを推測します。
Copy File(s) to Working Directory
このワークアイテムがクックされる時に、パターンに合致したファイルをソースロケーションからスケジューラの作業ディレクトリにコピーするかどうかを指定します。
このトグルを有効にすると、ワークアイテムの出力ファイルリストにpdg.attribFlag.Transferアトリビュートフラグが設定されます。
Examples ¶
FindFiles Example for File Pattern TOP node
このサンプルでは、File Patternノードで色々なマッチング動作を使ってファイルを読み込む方法を説明しています。
See also |