ノード一覧に戻る

パレット抽出

palette_extract

画像に使われている色を集めるか、近い色をまとめて代表色パレットを作ります

確認済み
解説あり

入力ポート

名前説明
画像
input
Image
必須
色を調べたい画像です

出力ポート

名前説明
パレット
palette
Palette
画像から取り出した色の一覧です
元画像の色数
source_color_count
Int
代表色への統合や最大色数での切り詰め前に、元画像で数えた異なる色の数です

パラメータ

名前既定値範囲説明・選択肢
抽出モード
extract_mode
Enum
Exact

実際の使用色をそのまま取るか、近い色をまとめて代表色化するかを選びます

  • 実色抽出Exact
    画像で実際に使われている色を、そのまま頻度順で残します。
  • 代表色抽出Representative
    近い色をまとめて代表色にし、減色向けのパレットを作ります。
残す最大色数
max_colors
Int
161–256

抽出結果のパレットに残す最大色数です。代表色抽出では、この数を目安に近い色をまとめます。

透明も含める
include_transparent
Bool
false

完全に透明なピクセルも色として数えます

まず何に使う?

  • 既存画像の色をそのまま再利用したい時
  • 何色使っているか確認したい時
  • Palette Swap の元パレットを自動で作りたい時
  • 近い色をまとめて、減色向けの代表色パレットを作りたい時

概要

画像から色を回収してパレットにするノードです。既存ドット絵の配色の再利用、 色数チェック、palette_swap の元パレット作り——「画像→パレット」方向の変換は すべてここが担当します(逆方向の「パレット→画像」は quantize / gradient_map)。

使い方のポイント

  • モードの使い分け: 完成済みドット絵から色を取る→Exact(実色・頻度順)、 写真や複雑な画像を要約する→Representative(代表色)
  • 参考画像から配色だけ借りるテクニック: 好きな画像 → Representative(4〜8色) → そのパレットで自分の素材を gradient_map / quantize
  • 色数の検査にも使える: source_color_count は統合・切り詰め前の元画像の実色数、 _count は実際に出力したパレット色数です。両方を見ると max_colors で色が 省略されたか判断できます

よくある失敗

  • 順番が明暗順でない: 抽出順は頻度順(Exact)。gradient_map のランプに使うには 暗→明の並びが必要なので、palette_edit 等で並べ替えるか palette_create で組み直す
  • 微妙な色違いで色数が膨れる: アンチエイリアスや半透明の縁が原因。 max_colors を絞るか Representative でまとめる

注意

  • 抽出順は決定論的です。同じ画像なら毎回同じ結果になります。
  • 実色抽出 は元画像に存在した色だけを返します。
  • 代表色抽出 は近い色をまとめるため、元画像にそのまま存在しない代表色が出ることがあります。
  • include_transparent = false の時、完全透明ピクセルは無視されます。
  • _count は実際に出力されたパレットの色数です。max_colors 以下になり、代表色抽出では 統合後の色数を示します。
  • source_color_count は、透明色を含める設定を適用した後、代表色への統合や max_colors での切り詰めを行う前に数えた異なる色の数です。

使用例

  1. 既存のドット絵からパレットを取り出す
  2. Palette Extract -> Palette Swap で別配色に差し替える準備をする
  3. source_color_count で素材画像の実色数が 16 色以内か確認する
  4. 透明色も含めて UI 素材の色構成を調べる
  5. 代表色抽出 で、写真や複雑な画像を少数色のパレットへ要約する

関連ノード

  • palette_swap — 抽出したパレットを起点に配色を差し替える
  • palette_quantize / dither — 抽出と減色を同時に行う場合
  • palette_edit — 抽出結果の並べ替え・調整
  • palette_save — 抽出したパレットのファイル保存
ノード一覧に戻る
パレット抽出 — PixPipeline ノード解説