ComfyUI Node
Nukomfy Read
Read an image or sequence from disk. Mirror of Nuke Read for the common case. Supports every format that OpenImageIO can decode: EXR, JPEG, PNG, TIFF, DPX, HDR, TGA, BMP, and more. Outputs the image as a 3-channel RGB tensor, the source alpha as a separate 1-channel mask (zeros if the file has no alpha), and any extra EXR layers as a multilayer bundle for the Nukomfy Multilayer Unpack (empty bundle for non-EXR or EXR without extra layers).
Nukomfy Read
- rgb
- alpha
- extra_layers
◄file_path►
◄read_modeInput Range►
◄first_frame1►
◄last_frame1►
◄missing_frameserror►
◄apply_color_transformfalse►
◄input_transformLinear Rec.709 (sRGB)►
CategoryNukomfy/Image
Inputs (7)
| Name | Type | Default | Description |
|---|---|---|---|
| file_path | STRING | File to read. Any format supported by OpenImageIO is accepted (EXR, JPEG, PNG, TIFF, DPX, HDR, TGA, BMP, …). Examples: • image.####.exr or image.%04d.jpg : sequence • image.0008.png or image.tif : single frame • /path/folder/ : auto-detect in folder | |
| read_mode | COMBO | Input Range | How to decide which frames to read. • Input Range: read every frame that matches the File pattern on disk. First Frame, Last Frame and Missing Frames are ignored. • Custom Range: read the frames between First Frame and Last Frame. Any gaps inside that range are filled per the Missing Frames policy. |
| first_frame | INT | 1-999999–999999 | First frame number of the sequence to read. Used only in Custom Range mode. When First Frame is greater than Last Frame, the sequence is read in reverse. |
| last_frame | INT | 1-999999–999999 | Last frame number of the sequence to read. Used only in Custom Range mode. |
| missing_frames | COMBO | error | How to handle missing frames inside the requested range. • error: stop with a message listing the missing frames. • black: return a black frame for each gap. • checkerboard: return a magenta and black pattern for each gap. • nearest: return the closest existing frame on disk. |
| apply_color_transform | BOOLEAN | false | When enabled, the file pixels are converted from Input Transform to linear Rec.709. When disabled, the file pixels pass through unchanged and Input Transform is ignored. |
| input_transform | COMBO | Linear Rec.709 (sRGB) | Colorspace the file is in. When Apply Color Transform is enabled, pixels are converted from this colorspace to linear Rec.709. Entries are the full OCIO colorspace list from the active config. |
Outputs (3)
| Name | Type | Description |
|---|---|---|
| rgb | IMAGE | RGB image (3 channels). Source alpha, if any, is dropped here and exposed separately on the alpha output. |
| alpha | MASK | Source alpha as a 1-channel mask. When the file has no alpha (JPEG, HDR, RGB-only PNG, EXR 3-channel, grayscale), this is filled with zeros. Use a Combine Image With Alpha node (or similar) upstream of Nukomfy Write if you need to round-trip the source alpha into a 4-channel output file. |
| extra_layers | NUKOMFY_MULTILAYER | Bundle of extra EXR layers (depth, normal, position, motion, …) detected by parsing the file's channel names. Empty for non-EXR files and EXR files without extra layers. Connect to Nukomfy Multilayer Unpack to extract individual layers by name. |