ComfyUI Node
📥 NL Read
A ComfyUI node in NOLABEL/IO with 25 inputs and 6 outputs.
📥 NL Read
- image
- mask
- inverted_mask
- frame_count
- resolved_path
- image_info_json
◄source►
◄exr_source►
◄batch_size1►
◄every_nth1►
◄skip_first0►
◄preframes0►
◄postframes0►
◄range_mode▾►
◄range_start-1►
◄range_end-1►
◄maskfrom alpha►
◄reverse_sequencefalse►
◄force_resize▾►
◄resize_mode▾►
◄resize_width0►
◄resize_height0►
◄force_proportionsoff►
◄manual_mask_source►
◄preview_modecolor►
◄ocio_config_path►
◄input_colorspace►
◄output_colorspaceACEScg►
◄preview_colorspaceOutput - Rec.709►
◄color_roleauto►
◄input_policyauto►
CategoryNOLABEL/IO
Inputs (25)
| Name | Type | Default | Description |
|---|---|---|---|
| source | STRING | Path or pattern to load. | |
| exr_source | STRING | Selected MultiEXR source. Empty keeps the automatic choice. | |
| batch_size | INT | 11–4096 | Repeat still images to this batch size. |
| every_nth | INT | 11–1000 | Sample every Nth frame for sequences and videos. |
| skip_first | INT | 00–1000000 | Trim this many frames from the start of the range (videos only). |
| preframes | INT | 00–1000000 | Duplicate the first frame this many times. |
| postframes | INT | 00–1000000 | Duplicate the last frame this many times. |
| range_mode | COMBO | Frame range source for sequences and videos. Context uses workflow start_frame/end_frame. For videos, the first video frame is treated as start_frame. | |
| range_start | INT | -1-1–1000000 | Custom start_frame when range_mode is custom. |
| range_end | INT | -1-1–1000000 | Custom end_frame when range_mode is custom. |
| mask | COMBO | from alpha | Mask source mode: alpha, solid white, RGB luminance, or custom mask file. |
| reverse_sequence | BOOLEAN | false | Read frames in reverse order (sequences and videos). |
| force_resize | COMBO | Resize to context resolution or custom size. | |
| resize_mode | COMBO | Resize strategy when resizing is enabled. | |
| resize_width | INT | 00–16384 | Custom resize width (used when force_resize is custom). |
| resize_height | INT | 00–16384 | Custom resize height (used when force_resize is custom). |
| force_proportions | COMBO | off | Force aspect ratio in custom resize mode. Height is calculated from width. |
| manual_mask_source | STRING | Custom mask image path (used when mask is custom). | |
| preview_mode | COMBO | color | Choose which preview(s) to show. |
| ocio_config_path | STRING | Optional per-node OCIO config override. | |
| input_colorspace | STRING | Source colorspace used for this read. Auto-seeded from the chosen source. | |
| output_colorspace | STRING | ACEScg | Working/output colorspace used for the emitted image tensor. |
| preview_colorspace | COMBO | Output - Rec.709 | OCIO View used only for NL Read preview rendering. |
| color_role | COMBO | auto | Treat the source as color imagery or data. |
| input_policy | COMBO | auto | Legacy colorspace assignment policy retained for old workflows. |
Outputs (6)
| Name | Type | Description |
|---|---|---|
| image | IMAGE | — |
| mask | MASK | — |
| inverted_mask | MASK | — |
| frame_count | INT | — |
| resolved_path | STRING | — |
| image_info_json | STRING | — |