Split
Decomposes a batch back into individual images or sub-batches.
Split is the inverse of Collect and Image Folder: it breaks a batch apart so frames or groups of frames can be processed separately downstream.
- Individual gives one output per frame.
- Chunks divides the batch into N even sub-batches (for example to split a large batch across several export pipelines).
- Slice takes a contiguous range of frames.
- Filter routes frames by a name pattern such as
hero_*. - Pick lists the incoming frames by name with a checkbox each: every ticked frame gets its own output, carrying that one image or set on its own, and the frames you leave unticked leave together through Rest.
The output pins rebuild to match the mode and the incoming batch. A batch of texture sets splits the same way; to take one set apart into its maps, use Split Texture.
Every mode keeps each frame’s swatch color, its tags, and its place on a Trim Sheet, so {color} in an export file name and Arrange’s Original Positions still read them downstream. A single output wired into an Export Batch or a Sprite Sheet keeps the frame’s name for {name}.
Pick: one frame on its own branch
Section titled “Pick: one frame on its own branch”Pick is how one trim of a Trim Sheet gets a branch of its own while the rest stay together. A pick follows its frame, not its position: rename, reorder, recolor, or resize a trim and its output, and the wire on it, stay with that trim, and two trims with the same name stay two picks. Frames without a trim are picked by name.
- A removed trim keeps its output, labeled (removed), so its wire is never handed to a neighbor. A node fed by it says
Trim 'Oak' was removed from the sheet.; an Arrange in Original Positions skips that row and keeps cooking, with the sentence as its note. Untick it or unwire it to clear the note. - An unwired pick is noted in the panel: that trim leaves the sheet until its output is connected.
- A new trim on the sheet leaves through Rest, and a note names it (
New on the sheet: Pine. It leaves through Rest.) until you tick something or click Got It.
You rarely build this by hand: right-click a trim on the Trim Sheet’s canvas, or a frame tab in the Preview, and Edit This Trim on Its Own or Edit This Frame on Its Own ticks it in a Pick Split and wires it in one undo step.
Reading the output rows
Section titled “Reading the output rows”Each output row names what it carries instead of a generic port name. In Individual mode a row reads its frame’s name next to its input position (1 hero_idle, 2 hero_run), so you never count rows to find an output. Chunks, Slice, and Filter rows read Frames 1-3, Selected, Rest, Match, and Reject. A Pick row reads its frame’s current name, and Rest.
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.
Parameters
Section titled “Parameters”Pins
Split
How the batch is split
Individual
Number of output pins, one frame each. 0 = auto, one output per input frame (up to 64)
Index of the first frame to output. The frames after it fill the remaining outputs in order
Chunks
Divides the batch into N sub-batches. Frames are distributed as evenly as possible
Slice
First frame of the slice. 0 = first frame. Negative values count from the end (-1 is the last frame)
Number of frames to select. 0 = all remaining frames.
Filter
Case-insensitive glob (supports * and ?)
Pick
Tick a frame to give it its own output. Every other frame leaves through Rest