Houdini 21.0 Nodes TOP nodes

Preflight TOP node

Copies a list of files into the scheduler’s working directory

On this page
Since 21.0

This node can be used to copy a specified list of files into the working directory of a scheduler node, using the standard file transfer mechanism. Files are only copied if the destination path in the working directory doesn’t already exist, or if the destination has an older modification time than the local copy of the file.

The Preflight Scene button can be used to analyze the current scene for dependent files and auto fill the File Paths multiparm.

TOP Attributes

transfer

file

The list of file paths that were copied, if Output Attribute is enabled. The name of this attribute can be changed.

Parameters

Work Items

TOP Scheduler Override

This parameter overrides the TOP scheduler for this node.

Generate When

Determines when this node will generate work items. You should generally leave this set to “Automatic” unless you know the node requires a specific generation mode, or that the work items need to be generated dynamically.

All Upstream Items are Generated

This node will generate work items once all of the input nodes have generated their work items.

All Upstream Items are Cooked

This node will generate work items once all of the input nodes have cooked their work items.

Each Upstream Item is Cooked

This node will generate work items each time a work item in an input node is cooked.

Automatic

The generation mode is selected based on the generation mode of the input nodes. If any of the input nodes are generating work items when their inputs cook, this node will be set to Each Upstream Item is Cooked. Otherwise, it will be set to All Upstream Items are Generated.

Transfer During

Determines whether files should be transfer immediately during the work item generation step, or if the transfer should happen when the work item(s) in this node cook.

Root Directory

The root path for all files that will be transfered. This path is needed if Preserve Intermediate Directories is enabled for each transfer path entry, to determine which part of the full path should actually be preserved.

Inputs

File Paths

The list of file paths to transfer to the working directory.

File Source

Determines how the files for this file path entry are specified.

File Tag

When File Source set set to Upstream Output File(s), this parameter determines the file tag to use for filtering upstream outputs.

File Path

When File Source is set to Custom File Path, this parameter defines the path to the local file to transfer.

File Attribute

When File Source is set to File Attribute, this parameter determines the name of the File or String attribute that contains the source file paths.

Destination

The destination for the transfered file.

Preserve Intermediate Directories

When this toggle is enabled, intermediate directories in the File Path are preserved when transfering the file, up to the Root Directory. For example, if Root Directory is set to $HIP/files and File Path is set to $HIP/files/images/example.png, then the path images/example.png will be copied into the Destination. If this toggle is disabled, then example.png will be copied into the Destination without the sub directory component.

Outputs

Output Attribute

When this parameter is enabled, the list of files copied by the node is written to the specified File attribute.

Add Files to Work Item Outputs

When this parameter is enabled, the list of files copied by the node are added as work item outputs.

TOP nodes