On this page | |
Since | 17.5 |
このノードは、コピー先のファイルパス(s)をワークアイテムの結果ファイルとして設定します。
TOP Attributes ¶
|
integer |
|
|
string |
ソース入力のファイルタグ。 |
|
string |
コピーするファイルのファイルパス。 |
|
string |
入力(s)のコピー先のファイルパス。 |
|
string |
ファイルのコピー先のフォルダ。 |
|
string |
コピーしたファイル(s)に使用するファイルタグ。 |
|
integer |
|
|
string |
入力が上流の結果ファイルをソースにしている時にコピーされるファイルのリスト。 |
パラメータ ¶
Node ¶
Copy File(s) During
ファイルをコピーするタイミング:
Generate
ワークアイテム生成ステージの時にファイル(s)がコピーされます。 これが有効な時、ノードが静的なワークアイテムを生成する度(ネットワークがクックを開始した時、または、明示的に静的なワークアイテムを生成するように指示した時)にファイルがコピーされます。 ファイルが事前に存在している場合、または、ノードがワークアイテムを動的に生成するように設定されている場合にのみ、これを有効にしてください。
Cook (In-Process)
クック中に、そのグラフクックプロセス内でファイル(s)がコピーされます。
ファイルサイズが非常に膨大でない限り、通常では、Cook (Out-of-Process)
よりもこの方が望ましいです。
Cook (Out-of-Process)
クック中に、それぞれ自身のプロセス内でファイル(s)がコピーされます。 通常では、このモードは、他のプロセス内で膨大なファイルをコピーすることで残りのネットワークを邪魔しないようにするのに適しています。
File Source
コピーされるファイル(s)のソースを指定します:
Upstream Output File
入力ワークアイテムのoutput
アトリビュートからファイルパス(s)を取得し、 File Tag パラメータに合致したタグを持ったファイルをコピーします。
これによって、同時に複数のファイルをコピーすることができます。
Custom File Path
File Path
パラメータで指定されたファイルをコピーします。
File Tag
File Source が Upstream Result File の時、ここには、コピーしたい結果ファイルのタグを指定します。
File Path
File Source が Custom File Path の時、ここには、そのファイルのファイルパスを指定します。
Copy To
ファイルのコピー先を指定します:
Directory
Directory
パラメータで指定されたディレクトリにファイル(s)がコピーされます。
複数のファイルをコピーする時は、このオプションを使用してください。
File
File Path
パラメータで指定されたディレクトリにファイルがコピーされます。
複数のファイルをコピーする時、または、各ファイルコピーを前のコピーに上書きする時は、このオプションを避けてください。
Directory
ソースファイル(s)をディレクトリにコピーする時のそのディレクトリ。
File Path
ソースファイルをファイルパスにコピーする時のそのファイルパス。
File Tag
このノードは、コピー先のファイルパスをワークアイテムの“ファイル結果”として設定します。
これは、その結果ファイルに使用するファイルタグです。
デフォルトはfile
のみです。 コピーするファイルのタイプに基づいてそのタグをカスタマイズしても構いません(例えば、file/image/exr
またはfile/geo
)。
Schedulers ¶
TOP Scheduler Override
このパラメータは、このノードのTOPスケジューラを上書きします。
Schedule When
有効にすると、このパラメータを使用して、このノードのどのワークアイテムをスケジュールに組むのかを決めるエクスプレッションを指定することができます。 そのエクスプレッションが指定されたワークアイテムに対して0を返すと、そのワークアイテムはスケジューラに組まれずに、即座にクック済みとしてマークされます。 そのエクスプレッションが0以外の値を返すと、そのワークアイテムは従来どおりにスケジュールに組まれます。
Work Item Label
このノードがワークアイテムにどのようにラベルを付けるのかを決めます。 このパラメータによって、固有でないラベル文字列をワークアイテムに割り当てることができ、そのラベルを使用してアトリビュートパネル、タスクバー、スケジューラジョブ名のワークアイテムを区別することができます。
Use Default Label
このノード内のワークアイテムは、TOPネットワークからデフォルトのラベルを使用します。 デフォルトが設定されていない場合は、それらのワークアイテムにはラベルは付きません。
Inherit From Upstream Item
ワークアイテムは親ワークアイテムのラベルを継承します。
Custom Expression
ワークアイテム毎に評価される Label Expression カスタムエクスプレッションをワークアイテムのラベルに設定します。
Node Defines Label
ワークアイテムのラベルをこのノードの内部ロジックで定義します。
Label Expression
有効にすると、このパラメータを使用して、このノードで作成されたワークアイテムに独自のラベルを指定することができます。
このパラメータには、ワークアイテムアトリビュートの参照またはビルトインのプロパティを含めたエクスプレッションを使用することができます。
例えば、$OS: @pdg_frame
は、フレーム値に基づいて各ワークアイテムのラベルを設定します。
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 に設定されている場合にのみ利用可能です。
Examples ¶
example_top_filecopy Example for File Copy TOP node
このサンプルでは、TOP/PDGを使ってファイルをコピーする方法を説明しています。