Palette Edit

What is it for?

• When you want to make small adjustments to a palette extracted by Image To IndexedImage while watching the preview
• When you want to recolor all pixels sharing the same color index
• When you want to fine-tune only selected colors while preserving the order of the source palette
• When you want to register the adjusted palette as a project common palette or tool common palette

Overview

Visually edits a palette in a dedicated editor. Only edited indices are overridden; untouched colors continue to follow upstream changes. It is an interactive tool for fine-tuning a few colors in an extracted palette.

Usage tips

• The go-to flow is: palette from image_to_indexed_image → Palette Edit (fix only the colors that need it) → indexed_image_apply_palette. You can recolor while watching the preview.
• Its useful property is that unedited colors follow the input. Even when the upstream extraction changes, only colors you edited remain fixed.
• Use palette_set for mechanical replacement by index, or palette_adjust_oklch for whole-palette color adjustment. Edit is for tuning individual colors by eye.

Related nodes

• palette_set — node-based replacement by index

• palette_adjust_oklch / palette_adjust_hsv — adjust the whole palette

• image_to_indexed_image / indexed_image_apply_palette — standard upstream and downstream nodes

• common_palette_ref — use the edited result as a common palette

• Editor: PaletteEditEditor

How it works

• The input palette is the base.
• Colors that you have not edited follow the upstream input palette.
• Only edited colors are stored in edit_data and override the colors at those indices.
• If the upstream palette order changes, overrides are still applied to the same indices.

How to use

1. Connect the palette output of Image To IndexedImage to Palette Edit.
2. Press the edit button on Palette Edit.
3. Select a color chip and adjust it with the color picker.
4. Connect the palette output of Palette Edit to the replacement palette input of IndexedImage Apply Palette.
5. Adjust only the necessary colors while watching the preview.

Writing back to common palettes

Use Write Back to Common Palette in the editor to register the current edited result as a common palette.

Choose Project Common or Tool Common as the destination.

• Project Common is saved in the current .ppl project file.
• Tool Common is saved in user settings and is available in other projects.
• Choose Swatches or Indexed Colors as the kind.

This write-back never runs automatically during node evaluation. It changes a common palette only when the user presses the button.

Notes

• This node edits the palette colors themselves. It does not change pixel indices in the image.
• Reset This Color removes only the override at that index.
• Reset All returns the output to the input palette as-is.
• Overwriting an existing common palette also changes the results of any Common Palette Ref or indexed-color references that use it after reevaluation.