Skip to content
ArcBrush ArcBrush Docs

Resize

Node icon
Transform

Scales an image to exact pixel dimensions or by percentage, with aspect ratio control.

Resize changes the image dimensions either to exact pixel values or by a percentage of the original size. The default mode is Percentage (100% × 100%), so new Resize nodes pass through input dimensions unchanged until you adjust them. Three fit modes handle aspect ratio: Stretch, Fit (letterbox), and Fill (crop).

Connect a size_ref image to size the output from another image instead of typed values. The Match control then picks which reference dimensions to adopt: both axes (output is exactly the reference size), width only, or height only. Matching a single axis derives the other from the source aspect ratio, so there is no distortion or padding.

Use Resize for standardizing asset sizes in your pipeline or for creating multiple size variants from a single source.

Parameters

Section titled “Parameters”

Pins

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

Transform

ModeChoice
Default: Percentage
No size_ref connected

Exact Size: specify output dimensions in pixels. Percentage

  • Exact SizeResize to specific pixel dimensions (width x height).
  • PercentageScale by a percentage of the original size.
Width (px)Integer
Default: 1024 Range: 1–8192
Exact Size mode only

Target output width in pixels

Height (px)Integer
Default: 1024 Range: 1–8192
Exact Size mode only

Target output height in pixels

Fit ModeChoice
Default: Stretch
Exact Size mode, or size_ref with Match = Both Axes

How to handle aspect ratio mismatch

  • StretchIgnore aspect ratio — force to exact dimensions. May distort.
  • Fit (letterbox)Scale to fit inside the target, preserving aspect ratio. May leave empty space.
  • Fill (crop)Scale to fill the target, preserving aspect ratio. May crop edges.
MatchChoice
Default: 0 Range: Both Axes / Width Only / Height Only
size_ref connected only

Which size_ref dimensions to adopt. Both Axes: output is exactly the reference size. Width Only / Height Only: match that axis and derive the other from the source aspect ratio (no distortion, no padding)

Scale X (%)Number
Default: 100.00 Range: 1.00–800.00
Percentage mode only

Horizontal scale factor as a percentage of the input width

Scale Y (%)Number
Default: 100.00 Range: 1.00–800.00
Percentage mode only

Vertical scale factor (tracks X when Lock Aspect is on)

Lock AspectToggle
Default: true
Percentage mode only

When checked, Y scale tracks X scale to preserve aspect ratio

FilterChoice
Default: Bilinear

Resampling filter used when scaling. Nearest: sharp pixels (pixel art). Bilinear: smooth, fast. Lanczos

  • NearestPixel-perfect — ideal for pixel art scaling.
  • BilinearSmooth interpolation — good for general use.
  • LanczosSharpest quality — best for downscaling photographs.

Usage Tips

Section titled “Usage Tips”
  • Use Lanczos filtering for the best quality when downscaling photographs.
  • Use Nearest filtering when resizing pixel art to keep crisp edges without blurring.
  • Lock Aspect in percentage mode to scale uniformly.
  • Percentage sliders show two decimal places for pixel-level precision.
Section titled “Related Nodes”