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 Variants 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”

Color

Source ColorColor (RGB)
Default: rgb(200, 50, 50)

Color to replace; matching hue remapped to each palette slot

Matching

Hue ToleranceNumber
Default: 30.0 Range: 1.0–90.0

Angular range around source hue to remap

Min SaturationNumber
Default: 20.0 Range: 0.0–50.0

Below this saturation pixels are never remapped

FeatherNumber
Default: 0.2 Range: 0.0–1.0

Soft falloff at hue range edge

Preserve LuminanceToggle
Default: true

Keep original brightness per variant

Mask

Mask FitChoice
Default: None

Mask sizing

  • NoneCenter 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.
  • FitScale the mask to fit inside the image, preserving aspect ratio. Letterboxes where needed.
  • FillScale the mask to fill the image, preserving aspect ratio. Crops edges if aspect ratios differ.
Notes

Mask Fit only visible when mask is connected.

Pins: image (required), palette (required), mask (optional). When mask is connected, the remap effect is blended with the original per variant using the mask (white = full effect, black = original).

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”