Skip to content
ArcBrush ArcBrush Docs

Palette Remap

Node icon
Color

The variant generator. Remaps a source color to every color in a connected palette, producing one output per slot.

Palette Remap is ArcBrush’s signature node. It takes an image and a palette, identifies pixels near a source color, and generates one variant for each palette slot. Every variant has the source color replaced with the slot’s color while preserving all luminance, highlights, and shadows.

An optional mask input limits the remap effect to specific regions. White areas receive the full color replacement while black areas keep the original color. This is useful when you want to recolor part of an image (e.g., a character’s shirt) without affecting the rest.

The output is a Batch pin that carries all generated images simultaneously. Wire it into Export Batch, and every variant exports as a separate named file automatically.

Parameters

Section titled “Parameters”

Pins

ImageImage
InputRequired
PalettePalette
InputRequired
MaskMask
InputOptional
BatchBatch
Output

Color

SourceColor (RGB)
Default: rgb(200, 50, 50)

Source color; each palette slot remaps to its hue

Matching

Hue ToleranceNumber
Default: 30 Range: 1–90

Hue distance (degrees) around the source color

Min SaturationNumber
Default: 20 Range: 0–50

Minimum saturation for a pixel to be remapped

FeatherNumber
Default: 0.20 Range: 0.00–1.00

Soft falloff at the tolerance boundary

Preserve LuminanceToggle
Default: true

Restore original luminance after the palette swap

Mask

Mask FitChoice
Default: None (native size)
Mask connected

How the mask is sized when it doesn't match the image. None: center at native size, no scaling. Stretch: scale to exactly match image dimensions. Fit: scale to fit inside image, preserving aspect ratio. Fill: scale to fill image, cropping overflow

  • None (native size)Center the mask at its native size — no resizing. Unmasked regions are unaffected.
  • StretchStretch the mask to exactly match the image dimensions. May distort the mask shape.
  • Fit (letterbox)Scale the mask to fit inside the image, preserving aspect ratio. Letterboxes where needed.
  • Fill (crop)Scale the mask to fill the image, preserving aspect ratio. Crops edges if aspect ratios differ.

Usage Tips

Section titled “Usage Tips”
  • Pick the most prominent/saturated color as the source for best results.
  • Raise Min Saturation to protect neutral/gray areas from being remapped.
  • Wire a Palette From Image node to automatically extract colors from a reference.
  • The entire pipeline downstream of Palette Remap processes all variants simultaneously.
  • Connect a mask to limit recoloring to a specific region, useful for multi-colored assets where only one area should change.
Section titled “Related Nodes”