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.

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

Grid: uniform grid layout. MaxRects: bin-packing algorithm for mixed sizes

  • 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 Size: no constraint. Power of 2: round up to next POT. Multiple of 4: for DXT/BC compression. Word Aligned

  • 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”