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.

Fit Mode decides how the source maps onto the target dimensions in Exact Size mode. Stretch, Fit (letterbox), and Fill (crop) work against both typed dimensions. Width (keep aspect) and Height (keep aspect) size the one axis you care about and let the other follow the source proportions, with no stretching, letterboxing, or cropping; the field for the derived axis hides, and the panel reports the size it produced. These are the same options Image In offers under Custom Size.

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

ImagePixels
InputRequired
Size RefSize Reference
InputOptional
ImagePixels
Output

Transform

ModeChoice
Default: Percentage
No size_ref connected
  • 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, except Fit Mode = Height (keep aspect)

Target output width in pixels

Height (px)Integer
Default: 1024 Range: 1–8192
Exact Size mode, except Fit Mode = Width (keep aspect)

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. The two keep-aspect modes apply in Exact Size mode; with a size_ref connected, Match owns single-axis sizing

  • StretchIgnore aspect ratio and 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.
  • Width (keep aspect)Size to the target width and let the height follow the source aspect ratio. No distortion, letterboxing, or cropping.
  • Height (keep aspect)Size to the target height and let the width follow the source aspect ratio. No distortion, letterboxing, or cropping.
MatchChoice
Default: Both Axes 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

  • 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.
  • Use a keep-aspect Fit Mode when only one dimension matters, such as sizing every asset to a fixed width for the web.
  • With a size_ref connected, Match owns single-axis sizing; the keep-aspect Fit Modes apply to typed dimensions.
Section titled “Related Nodes”