Morphology

morphology

Expands, shrinks, cleans, or fills mask shapes by a chosen pixel radius.

Reviewed

Guide available

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

Input Ports

Name	Type	Description
画像 input	Image Required	形を太らせたり細らせたりしたいマスクまたは画像です。
制御マップ control	Image	接続すると、選ばれた画素だけで膨張・収縮などの変化を許可します。

Output Ports

Name	Type	Description
画像 output	Image	マスクの形を太らせる、細らせる、点を消す、穴を埋める処理をした結果です。

Parameters

Name	Type	Default	Range	Description / Options
処理 operation	Enum	Dilate	—	太らせる、細らせる、小さい点を消す、小さい穴を埋める、のどれを行うかです。膨張`Dilate` 白い部分や不透明な部分を外側へ太らせます。アウトラインや当たり判定を少し広げたい時に使います。収縮`Erode` 白い部分や不透明な部分を内側へ細らせます。マスクを少し小さくしたい時に使います。オープン`Open` 小さい点やノイズを消します。大きな形はなるべく残します。クローズ`Close` 形の中にある小さい穴を埋めます。外側の大きさはなるべく保ちます。
基準 source	Enum	Alpha	—	最小値・最大値によるグレースケール形態処理の対象成分です。値は二値化されません。透明度なら Alpha、白黒画像なら Luminance を使います。 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 より単純な白黒変換に近い結果が欲しい時に使います。
半径 radius	Int	1	1–16	何ピクセル分太らせる/細らせるかです。値を上げるほど変化が大きくなります。
形状 shape	Enum	Square	—	周囲を見る形です。四角は角まで広がりやすく、ひし形は斜め方向が控えめになります。四角`Square` ひし形`Diamond`
出力 output_mode	Enum	Mask	—	白黒マスクとして出すか、元画像の透明度だけを更新するかを選びます。マスク`Mask` 白黒マスクとして出力します。後続の Mask 系ノードに渡しやすい形です。アルファ更新`Alpha` 元の色は残して、透明度だけを太らせたり細らせたりします。
出力範囲 output_region	Enum	Full	—	処理後全体、増えた部分だけ、減った部分だけのどれを出すか選びます。処理後全体`Full` 処理後の形全体を出力します。増えた部分`Added` 処理によって増えた部分だけを出力します。減った部分`Removed` 処理によって減った部分だけを出力します。
元の形を残す preserve_original	Bool	false	—	Closeで穴を埋める時に、元から選ばれていた画素を必ず残します。
制御マップの基準 control_source	Enum	Auto	—	任意の制御マップをどの成分で判定するか選びます。自動`Auto` 透明度があればアルファを使い、全面不透明なら輝度を使います。 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 より単純な白黒変換に近い結果が欲しい時に使います。
制御しきい値 control_threshold	Float	0.5	0–1 / step 0.01	制御マップがこの値以上の場所だけで形を変化させます。
制御を反転 control_invert	Bool	false	—	しきい値で判定する前に制御マップを反転します。
左右ループ wrap_x	Bool	false	—	左右の端がつながっているものとしてマスクを太らせたり細らせたりします。タイル素材向けです。
上下ループ wrap_y	Bool	false	—	上下の端がつながっているものとしてマスクを太らせたり細らせたりします。タイル素材向けです。

Overview

Expands or contracts white areas in a mask and cleans up small specks or holes. Use it to grow a selection slightly, remove thin noise, or adjust the edge of a transparent region.

The component selected by source is processed as continuous grayscale values with min/max morphology; it is not binarized. Gray or translucent mask values therefore remain meaningful in the result.

Usage tips

Remember the four operations this way: Dilate = expand, Erode = contract, Open = remove white specks (contract, then restore), and Close = fill holes (expand, then restore).
With wrapping off, Close does not treat pixels outside the canvas as holes, so it preserves source shapes that touch a canvas edge.
Preserve Original is shown and applied only for Close. If an older file retains it for another operation, that value is ignored and a warning is shown.
Combinations that are necessarily empty, such as Dilate + Removed, return an empty result and show a warning on Output Region.
A go-to mask preprocessing step is to clean an automatically generated mask (from edge_detect or a threshold node) once with Open / Close before using it.
Choose between this and pixel_cleanup by scope: Pixel Cleanup for conservative, 1px-only cleanup; Morphology for full shaping with a specified radius.

Related nodes

pixel_cleanup — lightweight, 1px-only cleanup
mask / mask_boolean — destinations for the cleaned mask
distance_field — another shaping approach based on distance from the boundary
outline — a dedicated outline instead of one produced by expansion

Examples

Use Dilate to expand a character mask by 1px as the basis for an outline.
Use Erode to contract a mask slightly and remove bleeding along the edge.
Use Open to remove small white noise dots.
Use Close to fill small holes in a filled area.
When processing a tile mask, enable wrap_x / wrap_y so edge shapes connect to the opposite side.

Back to Node List