Nodes/Comfyui-PixNodes/Image Splitter (Pix)
ComfyUI Node

Image Splitter (Pix)

Chop one image into a grid of tiles and get a batch back

By pixixai·Created 8 months ago·Updated 6 months ago· 24
Image Splitter (Pix)
  • image
  • IMAGE_BATCH
horizontal3
vertical3

Sometimes you don't want to generate one big image - you want to work on it in pieces. Image Splitter takes a single image and chops it into an evenly-spaced grid, dumping all the tiles into one batch so you can run a detail pass, a face-fix, or a per-tile upscale over them.

It's the blunt instrument of tiling: horizontal × vertical gives you the grid, and out the other end comes a batch of horizontal * vertical tiles, all the same size, ready for whatever batch-capable node you point at them.

How the cutting works

The math is honest and simple: tile_h = height // vertical and tile_w = width // horizontal, then it slices the tensor in row-major order. Integer division means the tiles are exact multiples - which also means any remainder pixels at the right or bottom edge are simply dropped. A 1024×1024 image with 3×3 gives you nine ~341×341 tiles; the leftover sliver at the edge never makes it into the batch.

It also handles a batch on the input side: give it a stack of images and it splits each one, concatenating every tile into a single output batch. So folder-of-images → Image List to Batch → Image Splitter → per-tile processing is a legit pipeline.

The inputs

  • image (IMAGE) - the source.
  • horizontal (INT, 1–64, default 3) - columns.
  • vertical (INT, 1–64, default 3) - rows.

Single output, IMAGE_BATCH, containing all the tiles.

Use cases that actually make sense

The classic one is tiled upscaling workflows where a batch of tiles goes through a face-detail or enhancement pass and then gets stitched back. Comic and storyboard splitting is another - a two-page spread becomes two clean panels. And it's handy for generating a training grid or a sprite sheet's worth of crops in one run. Since the tiles come back as a batch, you can preview them all at once with a Preview Image.

Install

Part of the Comfyui-PixNodes pack. ComfyUI Manager → search "PixNodes" → install → restart, or:

cd ComfyUI/custom_nodes
git clone https://github.com/pixixai/Comfyui-PixNodes

then restart. (The README's manual-install line references the wrong repo, ComfyUI-AlignLayout - use the URL above.) Nothing to download, no heavy dependencies.

Where it stops being enough

There's no overlap option, and no seam awareness. If your image doesn't divide evenly, you lose a strip of pixels and, more importantly, a naive grid has hard edges - a detail pass on adjacent tiles can produce visible seams when you stitch them back. For high-stakes seamless tiled upscaling you want a dedicated tiler with overlap and blending (there are several; this pack isn't that). But for quick, deterministic grid splitting - and for the "I need 9 tiles, now" moment - the two integer inputs here are all you need to touch.

CategoryPixNodes

Inputs (3)

NameTypeDefaultDescription
imageIMAGE
horizontalINT31–64
verticalINT31–64

Outputs (1)

NameTypeDescription
IMAGE_BATCHIMAGE