Read

I/Ov2core

Overview

The doorway. Everything a comp does starts with a file being turned into scene-linear pixels, and this is where that happens: the colorspace knob linearizes the file, and only the layers actually asked for downstream are decoded.

How to

Point file at a still, a #### sequence, or a video.
Set colorspace to what the file IS, not what you want it to be.
Bound the sequence with first / last and decide before / after behaviour.

Outputs

Output	Type
out	Image

Parameters

Parameter	Type	Default	What it does
file	Text		The file on disk — use #### for frame numbers in a sequence.
format_width	Int	1920	Width in pixels.
format_height	Int	1080	Height in pixels.
pixel_aspect	Float	1.0	Pixel width ÷ height. 1 = square; 2 = anamorphic 2× squeeze. The viewer and every filter honour it, so a squeezed plate looks right and resamples right.
channels	Text	rgba	Which layers to read. rgba, or a list — everything else in the file is skipped, which is how a heavy multilayer EXR reads fast.
data_channels	Text	auto	Which layers are DATA (depth, normals, motion, crypto) rather than colour — never colour-managed, never filtered as colour. auto tags them by name.
colorspace	Choice	auto	How the file is encoded. 'auto' guesses from the file type (EXR = linear, 8-bit = sRGB); 'raw' passes the numbers through untouched; override if the plate was tagged wrong. `autorawlinearsRGBRec.709`
raw	Bool	false	No color conversion at all — the file's numbers pass straight through (Read) or land in the file untouched (Write). Overrides the colorspace. Same as Nuke: for mattes, AOVs and data passes.
first	Int	0	The clip's frame range on disk.
last	Int	0	The clip's frame range on disk.
before	Choice	black	What plays outside the range: hold the end frame, loop, bounce, or black. `holdloopbounceblack`
after	Choice	black	What plays outside the range: hold the end frame, loop, bounce, or black. `holdloopbounceblack`
frame_mode	Choice	none	How the clip's own frame numbers land on the timeline: none = as numbered; start_at = the clip's first frame plays at start_at; offset = every frame shifted by frame_offset. `nonestart_atoffset`
start_at	Int	1	With frame_mode = start_at: the timeline frame the clip's first frame plays on. A 0-based .mov lands on the shot's numbering this way.
frame_offset	Int	0	With frame_mode = offset: frames added to every source frame number.
on_error	Choice	nearest	A frame missing from a sequence: nearest holds the closest frame on disk (reviews keep playing), black shows nothing, checkerboard flags it loudly, error shows black and reports it on the node. `nearesterrorblackcheckerboard`
disabled	Bool	false	Bypass: the node passes its first input through untouched (D in the graph). The knobs keep their values for when it comes back.
label	Text		A note shown under the node in the graph — what this node is FOR. Never affects the render or the cache.

Known edges

A missing frame is reported by name; it does not silently hold the previous one.