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.

The Pad node applied to a source image: original (left) and result (right).
Side-by-side comparison: the original image on the left and the same image after the Pad node on the right.

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

ImagePixels
InputRequired
Size RefSize Reference
InputOptional
ImagePixels
Output

Padding

ModeChoice
Default: Add Padding
  • 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-LeftPlace the source in the top-left corner.
  • TopPlace the source centered at the top edge.
  • Top-RightPlace the source in the top-right corner.
  • LeftPlace the source centered on the left edge.
  • CenterPlace the source in the center of the canvas.
  • RightPlace the source centered on the right edge.
  • Bot-LeftPlace the source in the bottom-left corner.
  • BotPlace the source centered at the bottom edge.
  • Bot-RightPlace the source in the bottom-right corner.

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”