Houdini 20.5 Nodes TOP nodes

File Copy TOP node

Copies a file from one location to another, either at runtime or whenever the node generates.

On this page
Since 17.5

The node sets the destination file path(s) as the result file of this node’s work item.

TOP Attributes

filesource

integer

The selected menu item of the File Source parameter.

filetag

string

The file tag of source inputs.

filepath

string

The file path of the file to copy.

destfile

string

The file path that the input(s) will be copied to.

destfolder

string

The destination folder where files will be copied to.

resultdatatag

string

The file tag to use for the copied file(s).

copyto

integer

The selected menu item of the Copy To parameter

filestocopy

string

The list of files that will be copied when the inputs are sourced from upstream result files.

Parameters

Node

Copy File(s) During

When to copy the files:

Generate

The file(s) will be copied during the work item generation stage. When this is on, the file is copied whenever the node generates static items (when the network starts cooking, or when you explicitly ask to generate static items). Only turn this on if the file exists ahead of time or the node is set to dynamic work item generation.

Cook (In-Process)

The file(s) will be copied during the cook and within the graph cooking process. This will usually be preferred to cooking out of process unless the file size is very large.

Cook (Out-of-Process)

The file(s) will be copied during the cook and within their own process. This mode is usually best for copying large files in another process so that it doesn’t hold up cooking the rest of the network.

Source

File Source

Specifies the source for the file(s) to be copied:

Upstream Output File

Get the file path(s) from the incoming work item’s output attribute and copy any files that have a tag matching the File Tag parameter. This allows multiple files to be copied at once.

Custom File Path

Copy the file specified by the File Path parameter.

File Tag

When the file source is upstream result files, this specifies the tag of the result files that should be copied.

File Path

When the file source is a custom file path, this specifies the filepath of that file.

Destination

Copy To

Specifies where the files will be copied to:

Directory

The file(s) will be copied to the directory specified by the Directory parameter. This option should be used when copying multiple files.

File

The file will be copied to the directory specified by the File Path parameter. This option should be avoided when copying multiple files, or each file copy will overwrite the previous copy.

Directory

The directory that the source file(s) will be copied to when copying to a directory.

File Path

The filepath that the source file will be copied to when copying to a file path.

File Tag

This node sets the destination path as the “file result” of its work item. The file tag to use for the result. The default is just file. You may want to specialize the tag based on the type of file being copied (for example, file/image/exr or file/geo).

Schedulers

TOP Scheduler Override

This parameter overrides the TOP scheduler for this node.

Schedule When

When enabled, this parameter can be used to specify an expression that determines which work items from the node should be scheduled. If the expression returns zero for a given work item, that work item will immediately be marked as cooked instead of being queued with a scheduler. If the expression returns a non-zero value, the work item is scheduled normally.

Work Item Label

Determines how the node should label its work items. This parameter allows you to assign non-unique label strings to your work items which are then used to identify the work items in the attribute panel, task bar, and scheduler job names.

Use Default Label

The work items in this node will use the default label from the TOP network, or have no label if the default is unset.

Inherit From Upstream Item

The work items inherit their labels from their parent work items.

Custom Expression

The work item label is set to the Label Expression custom expression which is evaluated for each item.

Node Defines Label

The work item label is defined in the node’s internal logic.

Label Expression

When on, this parameter specifies a custom label for work items created by this node. The parameter can be an expression that includes references to work item attributes or built-in properties. For example, $OS: @pdg_frame will set the label of each work item based on its frame value.

Work Item Priority

This parameter determines how the current scheduler prioritizes the work items in this node.

Inherit From Upstream Item

The work items inherit their priority from their parent items. If a work item has no parent, its priority is set to 0.

Custom Expression

The work item priority is set to the value of Priority Expression.

Node Defines Priority

The work item priority is set based on the node’s own internal priority calculations.

This option is only available on the Python Processor TOP, ROP Fetch TOP, and ROP Output TOP nodes. These nodes define their own prioritization schemes that are implemented in their node logic.

Priority Expression

This parameter specifies an expression for work item priority. The expression is evaluated for each work item in the node.

This parameter is only available when Work Item Priority is set to Custom Expression.

Examples

example_top_filecopy Example for File Copy TOP node

This example demonstrates how to copy files using TOPs / PDG.

input1 Example for File Copy TOP node

This is the first input for the PDG copyfile node test.

TOP nodes