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 without scaling it.

  • Add Padding adds pixels to each side (Uniform, on by default, locks all four to one value).
  • Absolute Size sets the final canvas size, never smaller than the source, and places the source with the Anchor grid.

With Size Ref connected, the reference image sets the output size, the padding sliders are disabled, and the anchor grid places the source.

Texture sets

Section titled “Texture sets”

Pad places every map of a texture set at the same spot in the larger canvas; the Normal is unchanged. Fill Color reaches Base Color and Emissive only. Every other map takes its own neutral value in the margin and the set’s Opacity there is zero, so a padded set is still a stamp with a real cutout, not a filled rectangle. Mask Fill is not used over a set.

Parameters

Section titled “Parameters”

Pins

ImagePixels or Texture
InputRequired
Size RefSize Reference
InputOptional
ImagePixels or Texture
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–16384 px / 0–100%

Padding to the left of the source image

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

Padding to the right of the source image

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

Padding above the source image

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

Padding below the source image

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

Output canvas width in pixels

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

Output canvas height in pixels

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

Fill ColorColor (RGBA)
Default: rgba(0, 0, 0, 0)

Fill color for padded image regions

Mask FillChoice
Default: Black (0)

Fill value for padded regions when the input is a mask.

Not used over a texture set.

  • 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 so every frame has the same dimensions.
  • The default fill is fully transparent, standard for game sprites. Give it alpha for a solid border.
  • Absolute Size with the Center anchor places icons on a standard canvas.
  • Turn off Uniform for different padding on each side, such as extra space at the bottom for a label.
  • On a single-channel input, Mask Fill decides whether the margin is excluded (Black) or included (White).
Section titled “Related Nodes”