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

ヒストグラムスキャン

histogram_scan

しきい値の位置とフチの柔らかさを指定して、白黒マスクを切り出します

確認済み
解説あり

入力ポート

名前型説明
画像
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 より単純な白黒変換に近い結果が欲しい時に使います。
位置
position
Float
0.50–1 / step 0.01

切り出しの中心値です。これより上の値が白になります

柔らかさ
softness
Float
0.250–1 / step 0.01

0でくっきりした境界、上げるほどフチが広いグラデーションになります

反転
invert
Bool
false—

白と黒を入れ替えます

マスクを透明度にする
alpha_from_mask
Bool
false—

マスクを透明度にも使います。黒い部分は透明、白い部分は表示されます

概要

しきい値(Threshold)の上位版です。Thresholdが「白か黒か」の2値なのに対し、 Histogram Scanは境界にグラデーションを持たせられます。ノイズからのマスク切り出しの定番ノードです。

使い方のポイント

  • ノイズ→マスクの黄金コンビ: noise_generate → histogram_scan で 「高いところだけ」を島・雲・汚れマスクとして切り出す。position が 面積、softness がフチの柔らかさ
  • position を📌入力ピン化して時間駆動すると「にじみ広がる」演出になる (reveal に近いがマスク生成側でやる版)
  • ドット絵ではソフトなフチはそのまま使わず、後段の dither や threshold 的な段階化と組むことも多い

関連ノード

  • threshold — 2値で足りる場合
  • noise_generate — 定番の上流
  • mask / blend — マスクの使い先
  • remap — 切り出し前の値調整

技術詳細

  • position ± softness/2 の範囲を smoothstep で補間します
  • softness = 0 のときは Threshold と同じハードな2値になります
  • position を入力ピン化して Time Source をつなぐと、「マスクが広がっていく」演出が作れます

使用例

  1. ノイズから地形マスク: Noise(Perlin) → Histogram Scan で「高いところだけ」を島マスクとして切り出す
  2. 柔らかい汚れマスク: softness: 0.5 で切り出したマスクを Blend(Multiply) の不透明度に使う
  3. ワイプ演出: Gradient → Histogram Scan の position をアニメして画面ワイプを作る

関連ノード

しきい値thresholdノイズnoise_generateマスクmaskリマップremap
ノード一覧に戻る
ヒストグラムスキャン — PixPipeline ノード解説