Skip to content
ArcBrush ArcBrush Docs

Transform

Node icon
Transform

Translates, rotates, and scales an image with interpolation control and optional background compositing.

The Transform node moves, rotates, and scales an image within its canvas. All three transformations happen in a single pass to minimize quality loss. Rotation and scaling pivot around the Pivot X/Y anchor (default center, 50/50). Set the pivot to any percentage of the foreground width and height to orbit, swing, or scale around a corner or edge. At identity rotation/scale the pivot drops out of the math, so changing it never moves the image, which lets you reposition the anchor before dialing in a transform. The on-canvas manipulator’s center handle and rotation ring follow the pivot.

Choose from Nearest (for pixel art), Bilinear (general use), or Lanczos (highest quality downscaling) interpolation. Enable Proportional to lock Scale X and Y together for uniform scaling.

An optional Background input pin lets you composite the transformed image over a background in a single node, eliminating the need for separate Pad + Transform + Composite chains. Use the Output Mode switch to choose between Composite (over background) or Transformed Only; in Composite mode, Blend Mode and Opacity controls govern how the transformed image mixes with the background.

Parameters

Section titled “Parameters”

Pins

ImageImage
InputOptional
AlphaMask
InputOptional
BackgroundImage
InputOptional
ImageImage
Output
AlphaMask
Output

Pivot

Pivot X (%)Number
Default: 50.0 Range: 0.0–100.0

Horizontal pivot point for rotation/scaling (0 = left, 100 = right)

Pivot Y (%)Number
Default: 50.0 Range: 0.0–100.0

Vertical pivot point for rotation/scaling (0 = top, 100 = bottom)

Transform

Translate XNumber · px/%
Default: 0 Range: -8192–8192 px / -100–100%

Horizontal offset (positive = right)

Translate YNumber · px/%
Default: 0 Range: -8192–8192 px / -100–100%

Vertical offset (positive = down)

RotateNumber
Default: 0.0 Range: -360.0–360.0

Clockwise rotation in degrees around the pivot point

ProportionalToggle
Default: false

Lock Scale X and Y together for proportional scaling

Scale X (%)Number
Default: 100.00 Range: -1000.00–1000.00

Horizontal scale factor (negative = flip)

Scale Y (%)Number
Default: 100.00 Range: -1000.00–1000.00

Vertical scale factor (negative = flip)

FilterChoice
Default: Bilinear

Resampling filter used during warpAffine

  • NearestNo interpolation — preserves hard pixel edges. Best for pixel art.
  • BilinearSmooth blending between pixels — good general-purpose quality.
  • LanczosHighest quality with sharp detail preservation — best for final output.
BackgroundColor (RGBA)
Default: rgba(0, 0, 0, 0)

Background fill color

Output

Output ModeChoice
Default: 1 Range: Transformed Only / Composite
When background input is connected

Composite: transformed FG over BG. Transformed Only: just the transformed FG at background dimensions

Blend ModeChoice
Default: 0 Range: Normal / Multiply / Screen / Overlay / Linear Dodge (Add) / Subtract / Difference / Hard Light / Soft Light / Darken / Lighten / Color Dodge / Color Burn / Exclusion / Hue / Saturation / Color / Luminosity
Composite mode only

Blend mode when compositing onto background

OpacityNumber
Default: 1.00 Range: 0.00–1.00
Composite mode only

Composite opacity (0 = invisible, 1 = fully opaque)

Notes

In Grid mode, pick from 9 standard positions on a visual 3×3 grid. In Custom mode, Pivot X and Pivot Y sliders appear to set exact coordinates in pixels or percent. Coordinates are zero-centered so (0, 0) is the image center.

Usage Tips

Section titled “Usage Tips”
  • Use Nearest interpolation when working with pixel art to preserve sharp edges.
  • Negative scale values flip the image. Set Scale X to -100% for a horizontal mirror with repositioning.
  • Percentage sliders show two decimal places for pixel-level precision on large images.
  • Set Pivot X/Y to a corner (0/0, 100/0, 0/100, 100/100) to orbit the foreground around an edge or corner instead of its center.
  • Connect a Background input to composite the transformed image over another image in one step, with no separate Composite node needed.
  • Enable Proportional to keep width and height scaling locked together.
Section titled “Related Nodes”