よつばゲームズ
ノード一覧に戻る

プロシージャルパレット参照

procedural_palette_ref

ツール共通またはプロジェクト共通のプロシージャルパレットを参照し、計算後の Palette として出力します。

確認済み
解説あり

出力ポート

名前型説明
パレット
palette
Palette
参照レシピから計算された実際のパレットです。
レシピ
recipe
ProceduralPaletteRecipe
参照したプロシージャルパレットのレシピ定義です。

パラメータ

名前型既定値範囲説明・選択肢
スコープ
scope
Enum
Project—

ツール共通プロシージャルパレットを参照するか、プロジェクト共通プロシージャルパレットを参照するかを選びます。

  • ツール共通Tool
    ツール全体のユーザー設定に保存されているプロシージャルパレットを参照します。
  • プロジェクト共通Project
    現在のプロジェクトファイル内に保存されているプロシージャルパレットを参照します。
パレット
palette_id
Text
——

参照する共通プロシージャルパレットです。空欄の場合は、現在の既定パレットを使います。

レシピデータ
recipe_data
CustomData
{"version":1,"variables":[{"id":"shadow_l_1","name":"Shadow L 1","comment":"影色を少し暗くします。","kind":"oklch_l","paramId":"variable_1","value":-12.0,"min":-50.0,"max":50.0,"step":0.1,"distribution":null},{"id":"shadow_l_2","name":"Shadow L 2","comment":"さらに暗い影色を作ります。","kind":"oklch_l","paramId":"variable_2","value":-24.0,"min":-50.0,"max":50.0,"step":0.1,"distribution":null}],"slots":[{"kind":"empty","index":0,"name":"Empty"},{"kind":"manual","index":1,"name":"Base Red","color":[0.9,0.18,0.28,1.0],"lightness_expression":"","chroma_expression":"","hue_expression":"","alpha_expression":"","variable_links":[]},{"kind":"oklchAdjust","index":2,"name":"Red Shadow 1","source":1,"lightness":0.0,"chroma":0.0,"hue":0.0,"alpha":0.0,"lightness_expression":"","chroma_expression":"","hue_expression":"","alpha_expression":"","variable_links":["shadow_l_1"]},{"kind":"oklchAdjust","index":3,"name":"Red Shadow 2","source":1,"lightness":0.0,"chroma":0.0,"hue":0.0,"alpha":0.0,"lightness_expression":"","chroma_expression":"","hue_expression":"","alpha_expression":"","variable_links":["shadow_l_2"]},{"kind":"manual","index":4,"name":"Base Blue","color":[0.2,0.38,0.95,1.0],"lightness_expression":"","chroma_expression":"","hue_expression":"","alpha_expression":"","variable_links":[]},{"kind":"oklchAdjust","index":5,"name":"Blue Shadow 1","source":4,"lightness":0.0,"chroma":0.0,"hue":0.0,"alpha":0.0,"lightness_expression":"","chroma_expression":"","hue_expression":"","alpha_expression":"","variable_links":["shadow_l_1"]},{"kind":"oklchAdjust","index":6,"name":"Blue Shadow 2","source":4,"lightness":0.0,"chroma":0.0,"hue":0.0,"alpha":0.0,"lightness_expression":"","chroma_expression":"","hue_expression":"","alpha_expression":"","variable_links":["shadow_l_2"]}],"slotOrder":[]}—

フロントエンドが共通資産から差し込む内部用のレシピデータです。

参照名
resolved_name
Text
——

フロントエンドが差し込む、実際に参照したプロシージャルパレット名です。

変数 1
variable_1
Float
-12-100–100 / step 0.01

参照レシピで使う変数の上書き値です。入力ピン化すると、共通パレットの影色量などを外部から動かせます。

変数 2
variable_2
Float
-24-100–100 / step 0.01

参照レシピで使う変数の上書き値です。入力ピン化すると、共通パレットの影色量などを外部から動かせます。

変数 3
variable_3
Float
0-100–100 / step 0.01

参照レシピで使う変数の上書き値です。入力ピン化すると、共通パレットの影色量などを外部から動かせます。

変数 4
variable_4
Float
0-100–100 / step 0.01

参照レシピで使う変数の上書き値です。入力ピン化すると、共通パレットの影色量などを外部から動かせます。

変数 5
variable_5
Float
0-100–100 / step 0.01

参照レシピで使う変数の上書き値です。入力ピン化すると、共通パレットの影色量などを外部から動かせます。

変数 6
variable_6
Float
0-100–100 / step 0.01

参照レシピで使う変数の上書き値です。入力ピン化すると、共通パレットの影色量などを外部から動かせます。

変数 7
variable_7
Float
0-100–100 / step 0.01

参照レシピで使う変数の上書き値です。入力ピン化すると、共通パレットの影色量などを外部から動かせます。

変数 8
variable_8
Float
0-100–100 / step 0.01

参照レシピで使う変数の上書き値です。入力ピン化すると、共通パレットの影色量などを外部から動かせます。

  • type_id: procedural_palette_ref
  • category: Palette/Reference
  • purpose: ツール共通 / プロジェクト共通に保存したプロシージャルパレットを参照し、計算後の通常 Palette として出力します。

概要

共通資産として保存したプロシージャルパレットのレシピを参照するノードです。 計算済みの通常 Palette を出力するので、複数プロジェクト・複数グラフで 同じ配色設計を共有し、元レシピの変更を全部に波及させられます。

使い方のポイント

  • 使い分け: 色配列の共有=common_palette_ref、 「関係式ごと」の共有=こちら。キャラの標準配色などはレシピごと 共有しておくとベース色変更が全素材に効く
  • 出力は解決済みの Palette なので、受け側は普通のパレットと同じ扱いでよい

関連ノード

  • procedural_palette — レシピの作成元
  • common_palette_ref — 色配列版の共通参照
  • indexed_image_apply_palette — 代表的な適用先

何をするノードか

Procedural Palette で作ったレシピを、共通パレット資産として再利用するための参照ノードです。

通常の Common Palette Ref が色配列を参照するのに対して、このノードは「手動色、変数、派生色ルール」を含むプロシージャルパレットレシピを参照します。出力される Palette は解決済みの色表なので、IndexedImage Render やパレット補正系ノードへそのまま接続できます。

使い方

  1. Procedural Palette を開き、レシピを作る
  2. エディタ上の「プロジェクト共通へ追加」または「ツール共通へ追加」で共通資産へ保存する
  3. Procedural Palette Ref を追加する
  4. scope と palette_id を選ぶ
  5. palette 出力を、インデックス画像描画やパレット補正ノードへ接続する

参照先の共通プロシージャルパレットが変更されると、このノードも再評価されます。

今後の拡張予定

  • 左パネルから共通プロシージャルパレットを直接編集する
  • Pixel Canvas のインデックスカラーモードで共通プロシージャルパレットを選べるようにする
  • 同期参照とコピー取り込みをユーザーが選べるようにする

関連ノード

プロシージャルパレットprocedural_palette共通パレット参照common_palette_refインデックス画像にパレット適用indexed_image_apply_palette
ノード一覧に戻る
プロシージャルパレット参照 — PixPipeline ノード解説