Yotsuba Games
Back to Node List

Auto Levels

auto_levels

Automatically stretches the value range so the darkest and brightest areas reach full range

Draft
Guide available
The node name and summary are available in English. Port, parameter, and article details are currently shown in Japanese.

Input Ports

NameTypeDescription
画像
input
Image
Required
補正する画像です

Output Ports

NameTypeDescription
画像
output
Image
補正後の画像です

Parameters

NameTypeDefaultRangeDescription / Options
判定基準
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 の陰影を強くする
Back to Node List
Auto Levels — PixPipeline Node Reference