Yotsuba Games
Back to Node List

Pixel Cleanup

pixel_cleanup

Removes isolated 1px noise and fills tiny 1px holes

Reviewed
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
ã‚ĸãƒĢãƒ•ã‚Ąã—ãã„å€¤
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

čŖœæ­Ŗå‡Ļį†ã‚’äŊ•å›žįš°ã‚Ščŋ”すかです

Overview

A conservative cleanup node that fixes only isolated 1px specks and 1px holes. Insert it after automatic generation or conversion (text rasterization, mask compositing, dithering) to remove distracting dots from pixel art.

Usage tips

  • Its regular position is just before finishing: place it one node before the final output so upstream edits are less likely to leave specks.
  • Increase passes when the effect is too weak. Larger noise that still remains is a job for Open / Close in morphology.
  • Disable it for artwork containing intentional 1px dots such as stars or highlights, or composite those parts afterward.
  • Enable binarize_alpha only when semitransparent alpha should be forced to fully transparent or fully opaque. With isolated-pixel removal, hole filling, and alpha binarization all OFF, the input pixel data is returned unchanged.

Related nodes

  • morphology — full shaping with a specified radius
  • silhouette_cleanup — clean up L-shaped steps (a complementary finishing step)
  • text_rasterize / dither — examples of upstream nodes that may produce specks

Notes

  • This node is limited to conservative 1px correction. It is not a large hole filler or median filter.
  • Newly filled pixels are assigned the average of their original neighboring colors.
  • Shape decisions use only alpha, so colors with similar opacity are treated as the same filled region even when their RGB values differ.
  • When binarize_alpha is OFF, pixels whose shape classification did not change keep their original alpha.

Examples

  1. Clean up small noise from Text Rasterize.
  2. Fill 1px chips after Mask Boolean.
  3. Thin scattered 1px dots after Noise or Dither.
Back to Node List
Pixel Cleanup — PixPipeline Node Reference