Back to Node List

IndexedImage Apply Palette

indexed_image_apply_palette

Keeps indexed pixels and replaces only the palette colors.

Reviewed
Guide available
The node name and summary are available in English. Port, parameter, and article details are currently shown in Japanese.

Input Ports

NameTypeDescription
インデックス画像
indexed_image
IndexedImage
Required
ピクセルごとの番号を保ったまま色表を変えたい画像です。
差し替えパレット
palette
Palette
Required
差し替える色表です。1番目、2番目...という並び順で同じ番号の色を置き換えます。

Output Ports

NameTypeDescription
インデックス画像
indexed_image
IndexedImage
各ピクセルが「パレットの何番か」を持つ画像です。色表を変えると同じ番号の場所がまとめて変わります。
パレット
palette
Palette
このインデックス画像が参照している通常色の一覧です。
画像
image
Image
現在のパレットで通常画像に戻したプレビューです。
色数
color_count
Int
通常色の数です。専用の透明スロットは色数に含めません。
概要
summary
Text
インデックス画像のサイズや色数の短い説明です。

What is it for?

  • Recoloring every pixel with the same index at once
  • Changing only the color scheme while preserving pixel-art shading and regions
  • Adjusting an extracted palette and applying it to the entire image

Overview

Replaces only the color table of an indexed image. Pixel indices—and therefore the artwork and shading structure—remain unchanged; only the colors referenced by those indices change. This makes the node a core building block for pixel-art color variants.

Usage tips

  • The complete recoloring pattern combines the indexed_image from image_to_indexed_image with a processed palette from palette_adjust_hsv, palette_edit, or palette_set, then feeds both into this node. This lets you batch-produce multiple color schemes for the same artwork.
  • Connect palette_cycle to create classic palette-cycling animation.
  • Remember that palette order defines the indices. Any index without a corresponding palette color becomes transparent.

Related nodes

  • image_to_indexed_image — upstream conversion to indices
  • palette_adjust_hsv / palette_adjust_oklch / palette_set — process the replacement palette
  • palette_cycle — animation use
  • indexed_image_render — use when you want a temporary color-table override

How it works

  • Every image pixel has an index such as 0, 1, or 2.
  • This node preserves those indices and replaces only the colors they reference.
  • For example, if index 0 is red and index 1 is black, supplying a palette where index 0 is blue and index 1 is white changes every red area to blue and every black area to white.

Notes

  • Palette order defines the indices.
  • An index missing from the input palette is rendered transparent.
  • Transparent slots are normally handled separately from the palette array.

Examples

  1. Connect indexed_image from Image To IndexedImage.
  2. Connect the adjusted Palette to palette.
  3. Review the recolored result from the image output.
  4. If needed, pass indexed_image farther downstream.
Back to Node List
IndexedImage Apply Palette — PixPipeline Node Reference