ノード一覧に戻る

ピクセル補正

pixel_cleanup

孤立した 1px ノイズや 1px の小穴を、保守的に整えます

確認済み
解説あり

入力ポート

名前説明
画像
input
Image
必須
補正したい画像

出力ポート

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

パラメータ

名前既定値範囲説明・選択肢
アルファしきい値
threshold
Float
0.50–1 / step 0.01

この値以上の透明度を塗られたピクセルとして扱います

孤立ピクセルを消す
remove_single_pixels
Bool
true

周囲に塗りがない孤立 1px ドットを消します

1px の穴を埋める
fill_single_holes
Bool
true

上下左右で囲まれた 1px の穴を埋めます

アルファを二値化
binarize_alpha
Bool
false

アルファしきい値を境に、透明度を完全不透明か完全透明へ揃えます

反復回数
passes
Int
11–8

補正処理を何回繰り返すかです

概要

孤立した1pxのゴミと1pxの穴だけを整える、保守的な掃除ノードです。 自動生成・変換系の処理(文字ラスタライズ、マスク合成、ディザ)の後に挟んで、 ドット絵として気になる「ポツポツ」を消します。

使い方のポイント

  • 仕上げ直前の定位置ノード: 「最終出力の1つ手前」に置いておくと 上流をいじってもゴミが出にくい
  • 効きが弱ければ passes を増やす。それでも残る大きめのノイズは morphology の Open/Close の仕事
  • 消したくない意図的な1pxドット(星・ハイライト)がある絵では オフにするか、該当パーツを後から重ねる
  • 半透明を完全透明/完全不透明へ揃えたい場合だけ binarize_alpha をONにする。 「孤立ピクセルを消す」「1pxの穴を埋める」「アルファを二値化」をすべてOFFにすると、 入力画像を画素データごと変更せず返す

関連ノード

  • morphology — 半径指定の本格的な整形
  • silhouette_cleanup — L字段差の整理(相補的な仕上げ)
  • text_rasterize / dither — ゴミが出やすい上流の例

注意

  • 本ノードは保守的な 1px 補正に絞っています。大きな穴埋めやメディアンフィルタではありません。
  • 新しく埋めたピクセルの色は、元の近傍色から平均して補完します。
  • アルファだけで形を判定するので、色が違っても透明度が同程度なら同じ塗り領域として扱います。
  • binarize_alpha がOFFなら、掃除で形が変わらなかったピクセルの元の透明度を保持します。

使用例

  1. Text Rasterize の小さなノイズを整える
  2. Mask Boolean 後の 1px 欠けを埋める
  3. NoiseDither 後の散った 1px を間引く
ノード一覧に戻る
ピクセル補正 — PixPipeline ノード解説