Skip to content
ArcBrush ArcBrush Docs

Pad

Node icon
Transform

Adds border padding around an image, either by pixel amount or to an exact canvas size.

Pad expands the canvas around your image. In Add Padding mode, you specify how many pixels to add on each side. The Uniform checkbox (on by default) locks all four sides to a single value for quick equal padding. In Absolute Size mode, you set the final canvas size and choose where the source image sits using the anchor grid. Width and Height default to the input image dimensions and are clamped so you can’t set a size smaller than the source.

When a size_ref pin is connected, the output dimensions are determined by the reference image. The padding sliders are disabled and a 9-way anchor grid appears, letting you control where the source image is placed within the padded output (top-left, center, bottom-right, etc.).

This is essential for creating consistent sizing across multiple assets, especially before batch export.

Parameters

Section titled “Parameters”

Padding

ModeChoice
Default: Add Padding

Add Padding (fixed px) or Absolute Size (exact dims)

  • Add PaddingAdd a fixed number of pixels to each edge.
  • Absolute SizeSet the final canvas size and choose where the source image sits.
UniformToggle
Default: true

Lock all four sides to the same value (Add Padding only)

Top / All SidesInteger · px/%
Default: 0 Range: 0–8192

Pixels to add above the source; drives all sides when uniform

BottomInteger · px/%
Default: 0 Range: 0–8192

Pixels to add below the source

LeftInteger · px/%
Default: 0 Range: 0–8192

Pixels to add to the left

RightInteger · px/%
Default: 0 Range: 0–8192

Pixels to add to the right

WidthInteger
Default: 512 Range: src_w–8192

Output canvas width (min clamped to source width)

HeightInteger
Default: 512 Range: src_h–8192

Output canvas height (min clamped to source height)

AnchorChoice
Default: Center

Source placement

  • Top LeftPlace the source in the top-left corner.
  • Top CenterPlace the source centered at the top edge.
  • Top RightPlace the source in the top-right corner.
  • Middle LeftPlace the source centered on the left edge.
  • CenterPlace the source in the center of the canvas.
  • Middle RightPlace the source centered on the right edge.
  • Bottom LeftPlace the source in the bottom-left corner.
  • Bottom CenterPlace the source centered at the bottom edge.
  • Bottom RightPlace the source in the bottom-right corner.

Color

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

Padded region fill color

Mask FillChoice
Default: Black

Mask pad value

  • BlackPadded mask regions filled with black (0) — excluded from mask.
  • WhitePadded mask regions filled with white (255) — included in mask.
Notes

Add Padding mode shows Uniform + Pad * (uniform on: single "All Sides" slider; off: four individual sliders). Absolute Size mode shows Width/Height/Anchor; slider minimums are clamped to the source image dimensions.

Usage Tips

Section titled “Usage Tips”
  • Use Pad before Export Batch to ensure all variants have the same dimensions.
  • Set the fill color alpha to 0 for transparent padding, which is standard for game sprites.
  • Absolute Size mode with a centered anchor is great for placing icons on a standard canvas.
  • Connect a size_ref input to match another image’s dimensions automatically, then use the anchor grid to control placement.
  • Turn off Uniform when you need different padding on each side (e.g., extra space at the bottom for a label).
Section titled “Related Nodes”