Skip to content
ArcBrush ArcBrush Docs

Sprite Sheet

Sprite Sheet
Transform

Packs batch frames into a single sprite sheet image, ready for game engines or further processing.

The Sprite Sheet node repacking a source pixel-art atlas's individual sprites (split out via the Separate node) into a tightly bin-packed atlas, a 4-column grid, and a 2-column grid.
A 3-panel grid showing the same set of pixel-art sprites repacked three ways: a tight MaxRects bin-packed atlas, a uniform 4-column grid, and a uniform 2-column grid with no padding.

Sprite Sheet takes any batch input (Collect, Image Folder, Palette Remap, or any node that outputs multiple frames) and arranges all frames into a grid on a single image. Unlike Export Batch’s sprite sheet mode which writes directly to disk, this node outputs a manipulable image that can be connected to downstream nodes for further processing. Add outlines, resize, composite, or apply effects before exporting.

Choose a Pack Mode: Grid lays frames out in a fixed column count (Auto Fit calculates a roughly square layout), while MaxRects bin-packs mixed-size frames tightly into a near-square sheet instead of wasting space on a uniform grid. Trim transparent borders, extrude edge pixels (1 to 8 px) to prevent texture bleeding, set inter-cell padding and a background color, and constrain the output dimensions to Power of 2, Multiple of 4, or Word Aligned for GPU-friendly sizes.

Parameters

Section titled “Parameters”

Pins

BatchBatch
InputRequired
ImageImage
Output

Layout

Pack ModeChoice
Default: MaxRects
  • GridUniform grid layout with a fixed column count.
  • MaxRectsBin-packing algorithm that fits mixed-size sprites tightly.
ColumnsInteger
Default: 4 Range: 1–32

Number of columns in the grid (Grid mode only)

Packing

Trim TransparencyToggle
Default: true

Remove transparent borders before packing

Trim ThresholdInteger
Default: 1 Range: 0–255

Alpha values at or below this are treated as transparent

Extrude (px)Integer
Default: 1 Range: 0–8

Duplicate edge pixels outward to prevent texture bleeding

Shape Padding (px)Integer
Default: 0 Range: 0–128

Space between sprites in pixels

Border Padding (px)Integer
Default: 0 Range: 0–64

Padding around the sheet perimeter

Output

BackgroundColor (RGBA)
Default: rgba(0, 0, 0, 0)

Sheet background

Size ConstraintsChoice
Default: Any Size
  • Any SizeNo size constraint.
  • Power of 2Expand to next power-of-two dimensions.
  • Multiple of 4Round up to next multiple of 4 for DXT/BC compression.
  • Word AlignedAlign width to a multiple of 2.
Max WidthInteger
Default: 4096 Range: 128–8192

Maximum sheet width in pixels (MaxRects only)

Max HeightInteger
Default: 4096 Range: 128–8192

Maximum sheet height in pixels (MaxRects only)

Display

Show OutlinesToggle
Default: false

Display colored outlines around each sprite in the preview

Usage Tips

Section titled “Usage Tips”
  • Use MaxRects when frames vary in size; it packs them tighter than a uniform grid. Use Grid with Auto Fit for a square-ish layout of same-size frames.
  • Set Size Constraints to Power of 2 (or Multiple of 4 / Word Aligned) for game engine compatibility.
  • Enable Show Outlines to draw colored sprite bounds in the preview while you tune packing.
  • Set a transparent background (default) for sprites, or a solid color for preview/debug purposes.
  • Wire the output into Resize or Sharpen before Export Image for post-processing the entire sheet.
Section titled “Related Nodes”