トーンカーブ

名前	型	説明
画像 input	Image 必須	補正する画像です

名前	型	説明
画像 output	Image	補正後の画像です

パラメータ

名前型既定値範囲説明・選択肢

名前	型	既定値	範囲	説明・選択肢
対象チャンネル channel	Enum	RGB	—	カーブを適用するチャンネルです RGB（全体）`RGB` R・G・Bにまとめてカーブを適用します。通常の明暗・コントラスト補正です赤`Red` 赤チャンネルだけに適用します緑`Green` 緑チャンネルだけに適用します青`Blue` 青チャンネルだけに適用しますアルファ`Alpha` 透明度だけに適用します。フェードの調整などに使えます
カーブ制御点 curve_points	CustomData	{"version":1,"points":[{"t":0,"value":0},{"t":1,"value":1}]}	—	インスペクタのカーブエディタで編集する制御点です。破損時はLinearプリセットで初期状態へ戻せます

対象チャンネル

channel

Enum

RGB

—

カーブを適用するチャンネルです

カーブ制御点

curve_points

CustomData

{"version":1,"points":[{"t":0,"value":0},{"t":1,"value":1}]}

—

インスペクタのカーブエディタで編集する制御点です。破損時はLinearプリセットで初期状態へ戻せます

ペイントツールでおなじみの「トーンカーブ」です。明暗の対応関係を自由な曲線で描き換えることで、コントラスト・ガンマ・フェードを1ノードで細かく制御できます。 brightness 系で足りない「暗部だけ持ち上げたい」ような非線形の補正はこれの出番です。

ノードを選択すると、インスペクタにカーブエディタが表示されます。ダブルクリックで制御点を追加、右クリックで削除、ドラッグで移動できます。

何も変化しない: 既定のカーブ((0,0)-(1,1)の直線)はパススルー。制御点を追加・移動して初めて効果が出る
階調が反転して不自然: カーブが途中で下がっている(右下がり区間)。意図がなければ制御点を整理して単調増加に戻す
カーブデータ破損のエラーが出る: 壊れたJSONや制御点が2個未満のデータを、無言で直線カーブとして処理することはありません。インスペクタのカーブエディタで Linear プリセットを選ぶと、既定の直線へ安全に戻せます。
ドット絵の色数が増えた: カーブは連続的な変換なので中間色が生まれる。パレット厳守の素材では後段に palette_quantize を置くか、palette_adjust_* 系でパレット側を調整する