Skip to content
ArcBrush ArcBrush Docs

Arrange

Arrange
Transform

Places any number of images side by side or stacked for quick comparisons, contact sheets, or layout composition.

Arrange uses a variable-count input pin array: connecting the trailing empty pin grows the row, disconnecting a middle pin shrinks the array and closes the gap, and there is always exactly one trailing empty pin ready for the next wire. Images are placed in a horizontal row, a vertical stack, or a grid in pin order.

The Direction setting picks the layout: Horizontal places images side by side, Vertical stacks them, and Grid packs them into a fixed number of Columns, wrapping to new rows left-to-right and top-to-bottom for contact sheets and sprite layouts.

When images have different sizes, the Alignment setting controls cross-axis positioning (start, center, or end). The Fit mode determines how size differences are handled: None pads smaller images with the fill color, Stretch distorts to match, and Fit scales proportionally.

Parameters

Section titled “Parameters”

Pins

Image 1, Image 2, ...Image
InputOptionalVariable count
ImageImage
Output

Layout

DirectionChoice
Default: Horizontal
  • HorizontalPlace images side by side, left to right.
  • VerticalStack images top to bottom.
  • GridPack images into a fixed-column lattice, wrapping to new rows left-to-right, top-to-bottom.
ColumnsInteger
Default: 3 Range: 1–64

Grid mode: number of columns. Rows fill left-to-right, top-to-bottom

AlignmentChoice
Default: Center

How smaller items align on the cross axis

  • StartAlign to the top (horizontal) or left (vertical) edge.
  • CenterCenter images along the cross-axis.
  • EndAlign to the bottom (horizontal) or right (vertical) edge.
Gap (px)Integer
Default: 0 Range: 0–1000

Pixel spacing between items

FitChoice
Default: None
  • NoneKeep original sizes, padding smaller images with the fill color.
  • StretchResize all images to match the largest cross-axis dimension. May distort aspect ratio.
  • FitScale proportionally to match the largest cross-axis dimension.

Color

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

Background fill color

Notes
  • Places any number of images side by side (Horizontal) or stacked (Vertical). A fresh Arrange shows a single empty Image 1 pin. Connecting the trailing empty pin auto-grows the array so another empty pin appears at the end. Disconnecting a middle pin renumbers the rest down so the array stays compact with exactly one trailing empty pin. Images render in pin order (Image 1 first).
  • Alignment controls positioning in the cross-axis when images have different sizes. Fit = None keeps original sizes and pads smaller images with the fill color. Fit = Stretch resizes all images to match the largest cross-axis dimension (may distort aspect ratio). Fit = Fit scales proportionally to match the largest cross-axis dimension.

Usage Tips

Section titled “Usage Tips”
  • Use Arrange to compare before/after results side by side by wiring the original and processed images into two inputs.
  • Set Gap to add pixel spacing between images for cleaner layouts.
  • Set the fill color alpha to 0 for transparent gaps between images.
  • Combine with Export Image to save comparison strips or contact sheets.
  • The trailing empty pin always sits at the bottom of the input list; wire into it to add another image to the row or column.
Section titled “Related Nodes”