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

自動レベル補正

auto_levels

画像の一番暗い部分と明るい部分を調べ、値域いっぱいに自動で引き伸ばします

下書き
解説あり

入力ポート

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

出力ポート

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

パラメータ

名前型既定値範囲説明・選択肢
判定基準
source
Enum
OKLCH-L—

どの値を引き伸ばすかです

  • OKLCH 明度OKLCH-L
    見た目の明るさで判定します。影やハイライトなど、目で見た明暗に合わせたい時に使います。
  • OKLCH 彩度OKLCH-C
    色の鮮やかさで判定します。くすんだ色と鮮やかな色を分けたい時に使います。
  • HSV 彩度HSV-S
    HSV の鮮やかさで判定します。一般的な色相・彩度・明度の感覚で選びたい時に使います。
  • HSV 明度HSV-V
    RGB の一番明るいチャンネルを基準にします。光った色や原色の強さを見たい時に使います。
  • RGB 赤RGB-R
    赤の強さで判定します。赤みだけを抜き出したい時に使います。
  • RGB 緑RGB-G
    緑の強さで判定します。緑成分だけを抜き出したい時に使います。
  • RGB 青RGB-B
    青の強さで判定します。青成分だけを抜き出したい時に使います。
  • アルファAlpha
    透明度で判定します。不透明な形だけをマスクにしたい時に使います。
  • 輝度Luminance
    RGB から計算した明るさで判定します。OKLCH より単純な白黒変換に近い結果が欲しい時に使います。
外れ値カット %
clip_percent
Float
10–10 / step 0.1

引き伸ばす前に、上下それぞれこの割合の極端なピクセルを無視します

強さ
strength
Float
10–1 / step 0.01

0で元のまま、1で完全に引き伸ばした結果になります

概要

ノイズや高さマップが「グレーの中間だけ」に寄っているとき、1ノードで全体をパリッとさせる補正です。 手動で範囲を決めたい場合は レベル補正（Levels）を使ってください。

技術詳細

  • 完全に透明なピクセルは範囲の計算からも補正からも除外されます
  • 全ピクセルが同じ値（範囲ゼロ）の場合はパススルーします
  • clip_percent は少数の白飛び・黒つぶれピクセルに引っ張られないための外れ値対策です

使用例

  1. ノイズの正規化: Noise → Auto Levels で中間に寄ったノイズをフルレンジ化し、Gradient Map へ渡す
  2. 高さマップの調整: Height From Image の出力を正規化して、Quick Shade の陰影を強くする
ノード一覧に戻る
自動レベル補正 — PixPipeline ノード解説