Houdini 20.5 Nodes Copernicus nodes

File Copernicus node

Loads an image or video from disk.

On this page

This node loads image and video files into your COP network. You can use the Add AOVs from File parameter to automatically import the AOVs and their properties from the source file. These AOVs become the outputs of this node.

Note

Some parameters on this node override the default settings on the enclosing COP Network node or COP Network SOP. See Default COP Network settings for more information.

Parameters

Source

The method used to load your image or video.

File

Load a file from disk.

Clone

Load a clone from the Clone Control Panel.

File Name

When Source is File, this is the path to the image, image sequence, or video file to load.

You can load individual images by providing the path to the image on disk. For image sequences, you can use either $F as a placeholder for the frame number or <F> to use the Video Timing parameter.

Clone Name

When Source is Clone, this is the name of the clone to load in the Clone Control Panel.

Reload Image

Reloads the image.

Video Timing

Defines how to generate the frame number for either image sequences that use the <F> notation or video files.

Start Frame

Start playing back an image sequence or video at a specific frame.

Frame Number

Display the image sequence or video at a specific frame.

Video Start Frame

When Video Timing is Start Frame, this is the frame when the image sequence or video starts playing back.

Video Frame

When Video Timing is Frame Number, this is the frame when the image sequence or video displays. You can use this parameter to write custom frame number expressions.

Border

The method used to handle the border of the raster when the Tile Visualization parameter is on in the enclosing COP Network node or COP Network SOP.

See Border types for more information.

Default

If the Default Border parameter is off in the enclosing COP Network node or SOP, this repeats the raster. If the Default Border parameter is on in the enclosing COP Network node or SOP, this uses the network-level default value.

Constant

Pad the raster by a constant transparent value.

Clamp

Extend the edges of the raster.

Mirror

Alternatively mirror the raster.

Wrap

Repeat the raster.

Missing Data

The method used to handle missing data, such as missing AOVs and missing frames in a sequence.

Report Message

Raise an error for missing frames and a warning for missing AOVs.

Use Color

Replace the missing data with a constant color. For missing frames, the size of the raster is the default context resolution. For missing AOVs, the size of the raster is the size of the image.

Missing Color

When Missing Data is Use Color, this is the constant color that replaces the missing data.

Incoming Colorspace

The method used to interpret AOV color data.

OpenColorIO

Use OpenColorIO rules to determine how to interpret AOV color data.

Raw

Interpret all AOVs as raw color data. This is equivalent to turning on the Raw parameter for each AOV.

Add AOVs from File

Imports each AOV from the specified file or video and sets their properties in the Number of AOVs parameters.

Number of AOVs

The AOVs to load from the Source image or video.

File AOV

The name of the AOV to load from the specified file or video. For images, if C is specified and it doesn’t exist in the file, the first AOV in the file is loaded instead. Video files only support C.

Channel Type

The channel type to use for this AOV.

See Data types for more information.

Mono

Load the AOV as a grayscale (single-component) floating-point raster.

UV

Load the AOV as a UV (two-component) floating-point raster.

RGB

Load the AOV as an RGB (three-component) floating-point raster.

RGBA

Load the AOV as an RGBA (four-component) floating-point raster.

ID

Load the AOV as a single-channel integer raster.

Precision

The precision to use for this AOV, which controls how many bits the channel uses.

Default

Load the AOV with the default precision (32-bit). If the Default Precision parameter is on in the enclosing COP Network node or SOP, this uses the network-level default value.

File

Load the AOV with the same precision that’s used in the specified file.

8-bit

Load the AOV with 8-bit precision.

16-bit

Load the AOV with 16-bit precision.

32-bit

Load the AOV with 32-bit precision.

Raw

Turns off color correction for the AOV.

Outputs

output#

The amount of node outputs and their details are based on the AOVs listed in the Number of AOVs parameter.

See also

Copernicus nodes