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

自動レベル補正

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個挟む。 gradient_map や threshold の前処理として効きが安定する
  • strength で効果をブレンドできる(0.5で半分だけ引き伸ばし)。全開で不自然なら下げる
  • clip_percent(既定1%)は少数の極端なピクセルを無視する保険。ハイライトの点が 1つあるだけで全体が伸びない、を防ぐ

よくある失敗

  • バリアントごとに明るさが揺れる: 自動補正は入力の分布に依存するため、 シード違いの量産では基準が毎回変わる。量産系では手動の levels で固定値にする方が 結果が安定する
  • 何も変化しない: すでにフルレンジ、または全ピクセル同値(パススルー仕様)。 変化させたいなら tone_curve などの手動調整へ

使用例

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

関連ノード

  • levels — 手動で範囲を決める版(量産では安定)
  • histogram_scan — 分布そのものを調べたい場合
  • gradient_map / threshold — 正規化後の定番の行き先

関連ノード

レベル補正levelsヒストグラムスキャンhistogram_scanグラデーションマップgradient_map
ノード一覧に戻る
自動レベル補正 — PixPipeline ノード解説