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”

Pins

ImageImage
InputOptional
AlphaMask
InputOptional
Size RefSize Reference
InputOptional
ImageImage
Output
AlphaMask
Output

Padding

ModeChoice
Default: Add Padding

Add Padding: fixed pixel amounts around the source. Absolute Size

  • 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
Add Padding mode only

Lock all four sides to the same value

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

Padding to the left of the source image

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

Padding to the right of the source image

TopInteger · px/%
Default: 0 Range: 0–8192 px / 0–100%

Padding above the source image

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

Padding below the source image

Width (px)Integer
Default: 512 Range: 1–8192
Absolute Size mode only

Output canvas width

Height (px)Integer
Default: 512 Range: 1–8192
Absolute Size mode only

Output canvas height

AnchorChoice
Default: Center

Where the source image is placed within the output canvas. Rendered as a 3x3 grid widget

  • Top-Left
  • Top
  • Top-Right
  • Left
  • CenterPlace the source in the center of the canvas.
  • Right
  • Bot-Left
  • Bot
  • Bot-Right

Color

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

Fill colorfor padded image regions

Mask FillChoice
Default: Black (0)

Fill value for padded regions when the input is a mask

  • Black (0)Padded mask regions filled with black (0) — excluded from mask.
  • White (255)Padded mask regions filled with white (255) — included in mask.

Usage Tips

Section titled “Usage Tips”
  • Use Pad before Export Batch to ensure all frames 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).
  • Use the Mask Fill parameter (Black/White) to control what value fills padded regions when the input is a mask.
Section titled “Related Nodes”