Contact Support

Read

This node loads images from disk, using the native resolution and the frame range for the sequence. It converts all imported sequences to Nuke’s native 32-bit linear RGB colorspace.

The Read node supports multiple file formats, such as Cineon, TIFF, Alembic, PSD, OpenEXR, HDRI, DPX, REDCODE, ARRIRAW, DNG, and RAW camera data. It uses the file name extension to determine the format.

You can also create a Read node by pressing R on the Node Graph.

See also DeepRead, ReadGeo, AudioRead, and UDIM Import.

Inputs and Controls

Control (UI)

Knob (Scripting)

Default Value

Function

Read Tab

file

file

dependent on file

Sets the file path and name of the file to read. For frame numbers, you can use #### for each digit or the printf-style formatting %04d.

localization policy

localizationPolicy

from auto-localize path

Sets the local file caching behavior. Copies of the files are stored in a specified local folder for faster access times:

On - the files are cached, regardless of location, as long as the limit to (GB) limit is not breached.

Off - the files are never cached, regardless of location.

from auto-localize path - the files are cached if they reside in the auto-localize from directory, as long as the limit to (GB) limit is not breached.

format

format

dependent on file

Sets the size of the file. Typically it is guessed correctly from the file header, but you can change it to set a different pixel aspect ratio if required.

proxy

proxy

none

Sets the file path and name of a relevant proxy image. This proxy image is used if proxy mode is on and the required resolution is less than or equal to the proxy format.

proxy format

proxy_format

1024x778

The file specified in proxy is read if the down-rez of the format is smaller or equal to this value. Typically it is guessed correctly from the file header, but you can change it to set a different pixel aspect ratio if required.

frame range

first

dependent on file

The first frame number of a sequence to display.

before

hold

Sets the behavior of frames before the first frame specified:

hold - select to show a still picture of the first frame of the frame range.

loop - select to start over and keep looping the span of the frame range outside the first frame of the frame range.

bounce - select to play the span of the frame range backwards and forwards between the frame range limits.

black - select to display a black frame outside of the first frame.

last

dependent on file

The last frame number of a sequence to display.

after

hold

Sets the behavior of frames after the last frame specified:

hold - select to show a still picture of the last frame of the frame range.

loop - select to start over and keep looping the span of the frame range outside the last frame of the frame range.

bounce - select to play the span of the frame range backwards and forwards between the frame range limits.

black - select to display a black frame outside of the last frame.

frame

frame_mode

expression

Sets the frame mode:

expression - Lets you enter an expression in the field on the right. The expression changes the relation between the current frame and the frame read in. For example, if your clip begins from image.0500.rgb and you want to place this first frame at frame 1 rather than frame 500, you can use the expression frame+499. This way, 499 frames are added to the current frame to get the number of the frame that’s read in. At frame 1, image.0500.rgb is read in; at frame 2, image.0501.rgb is read in; and so on. Another example of an expression is frame*2. This expression multiplies the current frame by two to get the number of the frame that’s read in. This way, only every other frame in the clip is used. At frame 1, image.0002.rgb is read in; at frame 2, image.0004.rgb is read in; at frame 3, image.0006.rgb is read in; and so on.

startat - Lets you enter a start frame number in the field on the right. This specifies the frame where the first frame in the sequence is read in. In other words, all frames are offset so that the clip starts at the specified frame. For example, if your sequence begins from image.0500.rgb and you enter 1 in the field, image0500.rgb is read in at frame 1. Similarly, if you enter 100 in the field, image0500.rgb is read in at frame 100.

offset - Lets you enter a constant offset in the field on the right. This constant value is added to the current frame to get the number of the frame that’s read in. For example, if your clip begins from image.0500.rgb and you want to place this first frame at frame 1 rather than frame 500, you can use 499 as the constant offset. This way, 499 is added to the current frame to get the frame that’s read in. At frame 1, image.0500.rgb is read in; at frame 2, image.0501 is read in, and so on. You can also use negative values as the constant offset. For example, if you use the value -10, Nuke will subtract ten from the current frame to get the frame that’s read in. At frame 20, image.0010.rgb is read in; at frame 21, image.0011.rgb is read in; and so on.

frame

none

Depending on the frame mode, you can enter a start frame, an offset, or an expression here.

original range

origfirst

dependent on file

Displays the original first frame.

origlast

dependent on file

Displays the original last frame.

missing frames

on_error

error

Sets Nuke’s behavior when there is a problem with frames in the file:

error - display an error in the Viewer.

black - replace suspect frames with a black frame.

checkerboard - replace suspect frames with a checkerboard.

nearestframe - replace suspect frames with the nearest good frame.

reload

reload

N/A

Click to re-read the image from disk.

colorspace

colorspace

dependent on file

Sets the lookup table (LUT) used to convert from this file to the internal values used by Nuke.

default determines the LUT from the size and type of data in the file, and other information from the file header.

premultiplied

premultiplied

disabled

When enabled, Nuke corrects the color of the partially transparent pixels produced by most renderers by dividing color data by the alpha channel before converting from the colorspace, and then multiplying by the alpha channel afterwards.

raw data

raw

disabled

When enabled, Nuke does not convert the data.

For most file formats this is the same as linear colorspace but, for some, it may disable other processing such as conversion from YUV.

auto alpha

auto_alpha

disabled

When enabled, if the Read produces RGB but no alpha channel, then assume the alpha should be 1 if it's requested later on.

dng Options (.dng reads only)

color space

dng_colorspace

sRGB

Sets the colorspace used during debayering. The standard Read node colorspace control is changed to match this setting automatically.

Note:  To view the data before debayering, enable the raw data control.

force linear transfer function

dng_force_linear

disabled

When enabled, override the specified color space transfer function to force it to use linear.

For some cases, such as sRGB, this results in slightly faster read times and sets the colorspace on the Read to linear as well.

As a result of forcing linear, all render settings are applied in linear space, rather than the native space, so there may be differences in how the controls respond.

white balance

dng_white_balance

As Shot

Applies preset values to the temperature and tint controls, dending on the setting chosen:

As Shot - attempt to read the temperature and tint values from the source file's metadata.

Daylight to Flash - standard presets in common usage.

Custom - adjusting the temperature and tint controls manually sets white balance to this value.

temperature

dng_temperature

dependent on file

Defines the temperature, in Kelvin, and tint of the image white point:

temperature - in general, runs from blues at low values to yellows at high values.

tint - in general, runs from greens at low values to purples at high values.

tint

dng_tint

exposure

dng_exposure

0

Controls the amount of exposure data available on top of the baseline exposure.

shadows

dng_shadows

0

Controls the amount of low-level image data available at render time.

exr Options (.exr reads only)

offset negative display window

offset_negative_display_window

enabled

The .exr format allows the image’s lower left corner to start at any position, including negative x axis values. Nuke does not support this type of format, but compensates by offsetting the image or reducing the format size on both sides:

enabled - the image is offset so that the .exr image’s left side start at x=0.

disabled - the format is reduced on both sides by the negative x amount, as if that area was overscan.

do not attach prefix

noprefix

disabled

When enabled, metadata keys are read as they are, without attaching a prefix to them.

When disabled, the prefix exr is attached to metadata keys to make them distinct from other metadata in the tree.

edge pixels

edge_pixels

plate detect

Sets how to treat pixels at the edges of the data window, or bounding box in Nuke terms, when reading .exr files:

plate detect - if the bounding box and format match exactly, then repeat all edges. Otherwise, add black at the edges.

edge detect - for each matching edge, repeat the edge pixels. Add black at mismatched edges.

repeat - always repeat the edge pixels outside the bounding box.

black - always add black pixels outside the bounding box.

mov Options (.mov reads only)

decoder

decoder

dependent on the file

Sets the decode library used to read the file:

mov32 - uses the full range of QuickTime codecs, but can be slow to process due to extra complexity during decode.

mov64 - uses its own packing and unpacking and streams decode/encode for extra processing speed, but only supports a sub-set of QuickTime codecs.

Note:  Nuke defaults to the fastest decoder for the codec used in the file - if you're reading in a type supported by the mov64 sub-set, Nuke defaults to that reader. Otherwise, the fallback mov32 reader is used.

ycbcr matrix

mov32_ycbcr_matrix

OR

mov64_ycbcr_matrix

dependent on the file

Sets the way Y’CbCr is converted to RGB. Rec 601 and Rec 709 follow the ITU.BC specifications, whilst Nuke Legacy, Nuke Legacy Mpeg, and Nuke Legacy YUVS are retained for backwards compatibility.

Note:  The following codec and pixel format controls are only displayed when decoder is set to mov32.

codec

mov32_codec

dependent on the file

Sets the codec used to read the file.

The codec dropdown defaults to a codec appropriate for the file in question, where available, and only lists those that declare themselves able to read the file.

pixel format

mov32_pixel_format

dependent on the codec

Sets the pixel format type and layout requested from a list supported by the chosen codec.

Note:  The following controls are only displayed when decoder is set to mov64.

do not attach prefix

mov64_no_prefix

disabled

When enabled, the metadata accompanying the file is saved without the quicktime prefix.

Note:  QuickTime container-specific metadata always carries the prefix.

When disabled, all metadata is prefixed with quicktime for easy identification.

match key format

mov64_match_meta_format

enabled

When enabled, Nuke attempts to clean up meta keys into the standard Nuke metadata format.

When disabled, the metadata is passed down the Node Graph unchanged.

source range

mov64_decode_video_levels

default

Sets the minimum and maximum color range values for decoded DNxHD files. If your source file was encoded with a reduced range (0-240 for 8-bit or 0-960 for 10-bit), set source range to Video Range to decode the full range (0-255 for 8-bit or 0-1023 for 10-bit).

first track only

mov64_first_track_only

enabled

When enabled, only the first view present in the file is displayed, regardless of how many views the file contains.

When disabled, and there is more than one view set up in the project settings, you can switch between views using the buttons above the Viewer.

psd Options (.psd reads only)

Breakout Layers

breakout

N/A

Breaks out the .psd file into separate layers and recombines them with a number of PSDmerge nodes. The blend modes/operations in the merge nodes are approximated and do no match Photoshop® exactly.

It’s recommended that all masks and adjustment layers are rasterized in Photoshop® before they’re imported into Nuke.

r3d Options (.r3d reads only)

Load Settings

Metadata

N/A

Click to reload control values from the .r3d file metadata.

use rocket if available

r3d_rocket

disabled

When enabled, an installed Red Rocket card is used for decoding if available.

use cuda if available

r3d_cuda

disabled

When enabled, a CUDA GPU is used for decoding if available.

HDRx blend algorithm

hdr_blend_algorithm

No Blend

Sets how the high and low exposure tracks are blended for HDR clips:

No Blend - disables blending and enables the HDRx track selection control. This option allows you to create your own blend of high and low exposure.

Simple Blend - enables the HDRx blend bias control allowing you to blend of high and low exposure according to the bias.

Magic Motion - a more sophisticated automatic blend mode, but you can still us the HDRx blend bias to make adjustments.

Note:  The bias control has no effect on Magic Motion blending when gamma space is set to Half Float Linear.

HDRx blend bias

hdr_bias

0

Controls the bias between high and low exposure values, depending on the blend algorithm in use:

Simple Blend - the bias controls the amount of each track blended, where -1 is fully low exposure and +1 is fully high exposure.

Magic Motion - the bias controls the amount of rolloff in the blended image, where -1 is full highlight rolloff and +1 is no highlight rolloff.

Note:  The bias control has no effect on Magic Motion blending when gamma space is set to Half Float Linear.

HDRx track selection

r3d_track

High Exposure

Sets which track is displayed when HDRx blend algorithm is set to No Blend. You can display either the High Exposure or Low Exposure track.

decode resolution

r3d_decode_resolution

Full High

Sets the output resolution decoded from the source file. High quality takes longer to decode.

rocket custom resolution

r3d_rocket_custom_scale

dependent on file format

Sets custom resolution values if you're using a Red Rocket card for decoding. The default values are equal to the source image.

color space

r3d_colorspace

REDcolor3

Sets the colorspace used to convert from raw data into RGB in the Viewer.

Note:  Colorspaces listed in brackets are deprecated in the current R3D SDK and may be removed in subsequent releases.

gamma space

r3d_gamma_curve

Half Float Linear

Sets the gamma curve applied to the raw image data from the .r3d file.

Half Float Linear is recommended for compositing work, but you may find REDgamma and REDlog useful for matching the output from other applications.

OCIO Tab

Context

key1

key1

none

OCIO Contexts allow you to apply specific LUTs to individual shots.

See Changing the Viewer Color Space for more information.

value1

value1

none

key2

key2

none

value2

value2

none

key3

key3

none

value3

value3

none

key4

key4

none

value4

value4

none

Sequence Tab

import sequence

import sequence

N/A

Click to display a browser to locate an import sequence script which builds a frame sequence list from the contents of an EDL file.

These are not standard EDL files, such as CMX. Each line in the file simply defines a separate image sequence to import in the form:

imagesequence.%04d.ext in out head tail

Where in and out are the start/end frame numbers of the clip and head/tail are the number of frames to trim from the start and end.

Each sequence in the list is expanded into the sequence control so that each line contains the name of the file to read for that frame:

line 1 = frame 1, line 10 = frame 10.

Finally, the script replaces the Read > file text with:

[lindex [knob sequence] [frame]]

This looks up the file name from the sequence control and sets the first frame to 1 through to the last frame in the expanded list.

frame sequence

sequence

none

Most easily used in conjunction with the import sequence button. Each line contains the name of the file to read for that frame:

line 1 = frame 1, line 10 = frame 10.

Set the Read > file control to [lindex [knob sequence] [frame]] to look up the file name from this control. This allows you to use a single Read to access multiple sequences of files where the naming does not follow any set numeric sequence, rather than using multiple Read nodes with a single file sequence per Read.

Metadata Tab

metadata viewer

shownmetadata

N/A

Displays the metadata of any file read in using a Read node. Once you know which keys exist in the file, you can reference them in expressions.

The metadata displayed depends on the file type. For example, a .jpg might only contain input/ keys, whereas QuickTimes contain input/ and quicktime/ keys.

search metadata for

metadatafilter

N/A

Filter the metadata by entering text in this field. By default, only metadata containing the keys and values entered are displayed. You can change this behavior using the within control.

within

metadatafiltermode

keys and values

Defines how to filter the search metadata for control. You can search keys and values, keys only, or values only.

Step-by-Step Guides

Loading Image Sequences

Video Tutorials

Related Topics Link IconRelated Topics