Skip to content

Split

Split
Utility

Decomposes a batch back into individual images or sub-batches.

Split takes a batch input and breaks it apart. Four modes cover different use cases: Individual outputs one image per frame, Chunks divides the batch into N equal sub-batches, Slice extracts a contiguous range of frames, and Filter routes frames by glob pattern matching on their names.

Output pins rebuild dynamically based on the mode and the incoming batch, so the node adapts its shape to the result. This is the inverse of Collect and Image Folder, letting you selectively extract or partition batch contents for per-frame or per-group processing downstream.

Each output row says what it actually carries rather than a generic port name. In Individual mode a row reads its frame’s name next to the input position it came from (1 hero_idle, 2 hero_run), so picking the right output does not mean counting rows. Chunks, Slice, and Filter rows read Frames 1-3, Selected, Rest, Match, and Reject.

Hovering a row shows the full name, the frame’s position or its range or role, the port name the wiring still uses, and, in Individual mode, the source file. Long names are shortened in the middle so a row never widens the node.

The labels are display only. The port names behind them are unchanged, so connections in a saved project are unaffected.

Pins

BatchBatch
InputRequired

Split

ModeChoice
Default: Individual
  • IndividualOne output pin per frame, up to 64 outputs.
  • ChunksSplit into N equal sub-batches.
  • SliceExtract a contiguous range of frames by start index and count.
  • FilterRoute frames to outputs by glob pattern matching on frame names.

Individual

OutputsInteger
Default: 0 Range: 0–64

0 = auto (one output per frame, up to 64)

Start FrameInteger
Default: 0 Range: 0–9999
Individual mode, when Outputs is set above 0

First frame index to output

Chunks

ChunksInteger
Default: 4 Range: 2–16

Number of sub-batches to split into

Slice

StartInteger
Default: 0 Range: -10000–10000

0 = first frame. Negative = from end

CountInteger
Default: 0 Range: 0–10000

0 = all from start

Filter

PatternText
Default: *

Case-insensitive glob (supports * and ?)

  • Use Individual mode to pull out specific frames for per-image processing.
  • Chunks mode is useful for splitting a large batch across parallel export pipelines.
  • Use Slice to extract a range of frames by index for partial batch processing.
  • Filter mode routes frames by name glob - e.g. hero_* to extract only frames whose names match.