Nodes/Comfyui-ergouzi-Nodes/2🐕Mask Blurred white edges
ComfyUI Node

2🐕Mask Blurred white edges

Gaussian-blur mask feathering with grow/shrink built in

By 11dogzi·Created 2 years ago·Updated 2 years ago· 102
2🐕Mask Blurred white edges
  • mask
  • mask
kernel_size50
sigma15.0
shrink_pixels0
expand_pixels0

Mask feathering has more than one right answer depending on what you're masking, and the ergouzi pack ships three variants for exactly that reason. EG_ZZ_BSYH ("Mask Blurred white edges") is the more configurable of the two Gaussian-blur feathering nodes - where its cousin EG_ZZ_BYYH gives you a single weight-and-blur pair, this one gives you a proper Gaussian kernel plus independent grow/shrink control before the blur even runs.

How it works

You feed it a mask, and it applies a Gaussian blur to soften the edge, with two extra steps most feathering nodes bolt on separately: shrink_pixels contracts the mask inward before blurring, and expand_pixels grows it outward - so you can pad a tight mask, then feather the padded result, in one node instead of two. The "white edges" naming (as opposed to its sibling EG_ZZ_HSYH, "Blurred Black edges") points at how the blur treats the boundary outside the mask - the two nodes share an identical parameter set and differ in that edge-padding behavior, so which one to use comes down to testing both on your actual mask and keeping whichever gives the cleaner transition for your case.

The inputs and outputs that matter

  • mask (MASK, required) - the mask to feather.
  • kernel_size (INT, default 50, range 3–200, optional) - the Gaussian blur kernel's size; bigger means a wider, softer transition.
  • sigma (FLOAT, default 15, range 0.1–200, optional) - the blur's spread; higher sigma spreads the same kernel further.
  • shrink_pixels (INT, default 0, range 0–50, optional) - contract the mask before blurring.
  • expand_pixels (INT, default 0, range 0–50, optional) - grow the mask before blurring.

Both defaults (kernel_size 50, sigma 15) sit well above the 4–12px range typical for a light inpaint-seam feather - expect a noticeably soft edge out of the box, and pull both down if you want a tighter transition. Output is a single mask (MASK).

How to install it

Search Comfyui-ergouzi-Nodes in ComfyUI Manager, or manually:

cd ComfyUI/custom_nodes
git clone https://github.com/11dogzi/Comfyui-ergouzi-Nodes.git

Restart ComfyUI. The pack's README notes this English repo is no longer updated, with the author's active development happening in a Chinese-named sibling pack instead.

Common issues & troubleshooting

Too much blur bleeds the mask into pixels you didn't want touched. This is the standard feathering trade-off: push kernel_size and sigma too high relative to your mask's size and the soft edge extends into areas that should've stayed untouched. Scale both down for small or tightly-cropped masks.

Shrink and expand feel like they're fighting the blur. shrink_pixels/expand_pixels run before the blur, not after - so a shrink followed by a wide blur can end up covering roughly the original area again, just softer. If your final coverage looks unchanged despite setting a shrink, that interaction is why; adjust kernel size down to actually see the shrink's effect.

Not sure whether to use this or EG_ZZ_HSYH. They share identical parameters and differ only in edge-padding behavior. There's no documented rule for which is "correct" for a given case - the practical approach is to try both on your actual mask and keep whichever produces the cleaner transition.

Category2🐕/⛱️Mask/🪶Fuzzy feathering

Inputs (5)

NameTypeDefaultDescription
maskMASK
kernel_sizeoptINT503–200
sigmaoptFLOAT15.00.1–200
shrink_pixelsoptINT00–50
expand_pixelsoptINT00–50

Outputs (1)

NameTypeDescription
maskMASK