Yotsuba Games
Back to Node List

Image To IndexedImage

image_to_indexed_image

Converts an image into palette-number pixels and extracts its palette.

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

Input Ports

NameTypeDescription
画像
image
Image
Required
インデックス画像へ変換する元画像です。

Output Ports

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

Parameters

NameTypeDefaultRangeDescription / Options
最大色数
max_colors
Int
2561–256

通常色として保持する最大色数です。透明は別枠なので、この数には含めません。

透明判定
alpha_threshold
Int
00–255

アルファがこの値以下のピクセルは、通常色ではなく専用の透明スロットになります。

まず何に使う？

  • 画像内の同じ色を、あとからまとめて調整したい時
  • 画像に使われている色表を取り出し、パレットとして編集したい時
  • ドット絵を通常の RGBA 画像ではなく、番号付きの色管理へ変換したい時

透明の扱い

  • 透明は通常パレットには混ぜません。
  • 透明スロットは色数に含めません。
  • 読み込んだ色の並びや、4色単位の制作上の並びを透明色でずらさないためです。

注意

  • v1 は完全一致変換です。
  • 元画像に max_colors を超える色がある場合はエラーになります。
  • アンチエイリアスの多い画像は色数が増えやすいため、先に減色するか Palette Quantize を使ってください。

使用例

  1. Image Load で画像を読み込む
  2. Image To IndexedImage へ接続する
  3. 出力された palette を編集用パレットの元にする
  4. IndexedImage Apply Palette で色表だけ差し替える
  5. IndexedImage Render で通常画像に戻す
Back to Node List
Image To IndexedImage — PixPipeline Node Reference