On this page |
このノードは、ディレクトリ(とオプションですべてのサブディレクトリ)内のパターンに合致したファイル名毎に(またはディレクトリ名毎に)ワークアイテムを生成します。
このパターンフィールドには、合致させたいパターンだけでなく、検索を開始するパスを指定することもできます。
例えば、$PDG_DIR/geo/*.bgeo
は、プロジェクト作業ディレクトリ内のgeo
ディレクトリ内にある.bgeo
で終わるすべてのファイルを検索します。
Note
このパターンは、レンダーファーム上のリモートホストではなくて、そのネットワークをクックしたマシン上で常に展開されます。 展開されたファイル名は、必ず共有ネットワークファイルシステム内の作業ディレクトリ下になければなりません。 このノードは、合致したローカルのファイルパスを自動的に作業ディレクトリを基準としたパスに変換します。
パターン構文の説明は、パターンパラメータを参照してください。
このノードには、ワークアイテムを生成するのに2つのモードがあります:
-
Split Files into Separate Items が有効(デフォルト)な時、合致した名前毎に、アトリビュートにそのファイル名のデータが入った別々のワークアイテムを生成します。
-
Split Files into Separate Items が無効な時、合致したファイルパス群をワークアイテムの出力結果として設定された 1個 のワークアイテムを生成します。
これは、このノードの接続先のノードがResult Dataを操作する場合で役立ちます。
このノードがワークアイテムを生成するように指示される度に(このノードをクックした時、このノードから静的ワークアイテムを事前に生成した時)、 このノードは、そのパターンが最後のクックの時とは別のファイルに合致するかどうか、さらにファイル変更時間が変わっているかどうかをチェックします。 もしそうであれば、変更のあったワークアイテムを更新してDirtyとしてマークします。 そのため、ディレクトリの内容が変わると、通常ではその変更されたワークアイテムのみを再クックする必要があります。
TOP Attributes
Split Files into Separate Items を有効にすると、このノードは、ワークアイテム毎に以下のアトリビュートを設定します。
|
string |
ワークアイテムに関連付けられたファイルからファイル名と拡張子を除いたディレクトリ。 |
|
string |
ワークアイテムに関連付けられたファイルの拡張子。 File Types を Directories Only に設定した場合、または、パターン定義のパスがディレクトリの時は、設定されません。 |
|
string |
Include Extension in Filename が有効な場合は、拡張子を含んだファイル名。 File Types を Directories Only に設定した場合、または、パターン定義のパスがディレクトリの時は、設定されません。 |
パラメータ
Work Item Generation
このノードが静的または動的なワークアイテムのどちらを生成するかどうか。 このノードのワークアイテムが静的に計算可能かどうか、もしくは、動的に生成させる必要があるかどうか分からないのであれば、通常では、これを"Automatic"のままに設定してください。
Dynamic
このノードが常に動的なワークアイテムを生成します。つまり、上流のワークアイテムが判明するまで待機し、その上流のワークアイテムから新しいワークアイテムを生成します。
Static
このノードが常に静的なワークアイテムを生成します。つまり、ネットワークを実行する前にパラメータ(と上流の静的なワークアイテム)に基づいて必要だと思われるだけの数のワークアイテムを生成します。
Automatic
入力が静的(静的なプロセッサ、静的な入力のみを使ったパーティショナー、マッパー)な場合、このノードは静的なワークアイテムを生成し、そうでない場合、動的なワークアイテムを生成します。
File Types
合致させるタイプ。 Files Only, Directories Only, All (ファイルとディレクトリの両方)を指定することができます。
Pattern
ファイルパスのマッチングに使用するパターン。
このパターンには、ファイルを検索する場所(例えば、$PDG_DIR/geo/*.bego
)を指定します。
パターンには?
(どれかの文字に合致),*
(任意の文字列に合致),[abc]
(大括弧内の文字のどれかに合致)などのワイルドカードを使用することができます。
例えば、*.png
は.png
で終わるすべてのファイルに合致します。
Recursive
Glob Patternパラメータで指定したパスのサブディレクトリに対してもファイル名のマッチングを行ないます。
Output File Tag
これを有効にして、 Split Files into Separate Items を無効にすると、その出力ファイルパスには、このファイルタグが割り当てられます。 これを無効にすると、このノードは、ファイル名の拡張子に基づいて適切なファイルタグを推測します。
Split Files into Separate Items
これを有効(デフォルト)にすると、このノードは、合致した名前毎に、アトリビュートにそのファイル名のデータが入った別々のワークアイテムを生成します。 これを無効にすると、このノードは、合致したファイルパス群をワークアイテムの出力結果として設定された 1個 のワークアイテムを生成します。 これを無効にすれば、このノードの接続先のノードがResult Dataを操作する場合で役立ちます。
No Match Behavior
何も合致しなかった場合のこのノードの挙動。
No Match Behavior
何も合致しなかった場合のこのノードの挙動。
Attribute Name
ファイルが見つかったかどうかを示した各ワークアイテム上に作成するアトリビュートの名前。
Include Extension in Filename
filename
アトリビュートにファイル拡張子を含めます。
Examples
example_top_filepattern Example for File Pattern TOP node
このサンプルでは、File Patternノードでパターンマッチ表現を使ってファイルを読み込む方法について説明しています。