Cleans up a mask in one fixed-order pass: expand (grow/shrink by whole pixels), fill enclosed holes (all of them, or only those up to max_hole_size), smooth…

A ComfyUI custom node pack by QG: 41 nodes under QG-tools - LoRA Loader (searchable rows, drag strengths, trigger words, templates), a 3-in-1 Checkpoint/UNET + CLIP + VAE loader, Empty Latent Resolution (ratio + megapixels), canvas Image Crop + Rotate + Pad with video timeline, Load Image with a canvas mask editor, Image Compare (slide / A / B / erase), Image Export (JPEG / PNG / WEBP with quality), Canvas Label and Markdown Note (free text, never executed), Workflow Note card, Workflow Switches, Run Timer, Resize, Size, Number Slider (own range), Seed history, Text, Markdown Reader, Translate, Any Switch, Display Any, If/Else, Watermark, Text Overlay, Grid, Mask Colorize, Mask Concat, Mask Refine, Text Concat, Text Replace, Text Split, Size Selector, Math (one expression over variables a-z), Free Memory. All answer to English search aliases.

ComfyUI-QG-Tools

mask

expand

blur

fill_holes

smooth

black_point

white_point

edge_refine

preview

guide_image

max_hole_size

Cleans up a mask in one fixed-order pass: expand (grow/shrink by whole pixels), fill enclosed holes (all of them, or only those up to max_hole_size), smooth (melts staircase jaggies without feathering), feather with a gaussian blur, edge-refine against the optional guide_image (guided filter or alpha matting), then remap levels with black_point / white_point to clear gray haze. Returns the refined mask and its inverse.

QG_MaskRefine

mask_inverted

Mask Refine

Name	Type	Default	Description
mask	MASK		BHW mask; white is the selected area.
expand	INT	0-1024–1024	Pixels to grow (+) or shrink (-) the mask.
blur	FLOAT	0.00–100	Gaussian feather strength in pixels; 0 keeps hard edges.
fill_holes	BOOLEAN	false	Fill fully enclosed gaps inside the mask before feathering. Gaps that touch the frame edge never count as holes.
smooth	INT	00–256	Melts staircase jaggies by this many pixels while keeping a hard edge; 0 is off. Runs before the feather blur.
black_point	FLOAT	0.000–1	Mask values at or below this become fully black; clears faint gray haze outside the subject. Applied last.
white_point	FLOAT	1.000–1	Mask values at or above this become fully white; solidifies the mask core. Applied last.
edge_refine	COMBO	off	Snap the mask edge to the guide_image. 'guided filter' is fast edge-aware filtering (needs opencv-contrib-python); 'matting' solves closed-form alpha matting around the edge (needs pymatting). Both require the guide_image input.
previewopt	BOOLEAN	true	Show the refined mask on the node face. Off skips writing the preview file to ComfyUI's temp folder.
guide_imageopt	IMAGE		RGB frames the mask belongs to; required when edge_refine is 'guided filter' or 'matting'.
max_hole_sizeopt	FLOAT	0.00–100	The biggest hole fill_holes fills, in percent of the picture. 2 fills the gaps a quick brush leaves but keeps a person or pet you left unpainted; 0 fills every hole.

Name	Type	Description
mask	MASK	The refined BHW mask.
mask_inverted	MASK	The refined mask inverted, for operations that target the background.

Mask Refine

Inputs (11)

Outputs (2)