Back to Node List

Silhouette Cleanup

silhouette_cleanup

Cleans L-shaped corners on an image alpha silhouette

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
シルエット補正したい画像
補正許可範囲
permission_mask
Image
変更してよい角だけを指定する任意マスクです。白い所だけ補正し、黒または透明な所は入力を保護します。角の判定ではシルエット全体を参照します。

Output Ports

NameTypeDescription
画像
output
Image
補正後の画像

Parameters

NameTypeDefaultRangeDescription / Options
補正する側
editable_area
Enum
Inside

接続したマスクのどちら側を変更してよいか選びます。手足や装飾の一部だけ直すなら「白い範囲内」、顔など繊細な形を白く塗って守るなら「白い範囲外」が目安です。マスク未接続時は結果に影響しません。

  • 白い範囲内Inside
    補正許可範囲マスクが白く不透明な所の角だけを変更します
  • 白い範囲外Outside
    白い範囲を保護し、その外側の角だけを変更します
アルファしきい値
threshold
Float
0.50–1 / step 0.01

シルエットに含めるアルファ値の境目です。まず0.5を使い、薄い縁も形に含めたい時は下げ、淡い画素が不要な角を作る時は上げます。

補正モード
cleanup_side
Enum
OpaqueSide

塗り側の角を削るか、透明側の角欠けを埋めるかを選びます

  • 塗り側OpaqueSide
    画像の塗り側にある L 字コーナーを削って整えます
  • 透明側TransparentSide
    画像の透明側にある L 字の欠けを埋めて整えます

Overview

Cleans up L-shaped steps in a silhouette—the protrusions and chips that appear on diagonal lines and corners. It is a finishing node that makes pixel-art outlines look closer to carefully hand-placed pixels.

Usage tips

  • It affects only the alpha shape, not color steps inside the artwork. Fix those by hand or with color-reduction tools.
  • Start with OpaqueSide (remove protrusions). If the shape becomes too thin, switch to TransparentSide (fill chips).
  • Place it before outline to reduce irregularities in the outline.
  • Split responsibilities with pixel_cleanup (isolated pixels and holes): that node handles dots; this one handles corners.

Related nodes

  • pixel_cleanup — clean up isolated 1px artifacts
  • outline — add an outline after cleanup
  • path_stroke — for path-derived shapes, start with pixel-perfect rendering

When to use it

  • When you want to clean up L-shaped steps in an alpha silhouette at 1px diagonal lines and corners
  • When you want to remove or fill small parts of a silhouette in an image that did not come from a path
  • When you want to clean the source-image silhouette itself rather than choose the inside or outside of a band such as Outline

Notes

  • This is not exact pixel-perfect correction derived from vector paths.
  • It binarizes image alpha and applies raster correction to that silhouette.
  • It is therefore not a substitute for "true pixel perfect" processing on general images.
  • In other words, changing only the colors inside does nothing. It takes effect only when the alpha silhouette changes.
  • It is normal for a perfect square or rectangle with no L-shaped corners to remain unchanged.
  • Correction Mode = Opaque Side removes L shapes protruding from the filled silhouette.
  • Correction Mode = Transparent Side fills corner chips on the transparent side with neighboring colors.
  • This organizes shapes based strictly on the alpha silhouette, not color boundaries.

Examples

  1. Clean up L-shaped noise that appears only at the corners of a pixel-art character.
  2. Clean the source image before Outline to reduce broken outlines.
  3. Make diagonal lines and rounded 1px silhouettes look more like pixel art.
Back to Node List
Silhouette Cleanup — PixPipeline Node Reference