Advanced Mask Nodes
Custom nodes for ComfyUI that provide advanced mask manipulation operations.
Nodes
Average Overlapping Masks
Averages two masks in regions where they overlap.
- Overlap regions — output is the element-wise average of both masks
- Single-mask regions — output equals that mask's value
- Empty regions — output is zero
| Parameter | Description |
|---|---|
mask_a / mask_b |
Input masks (2D or batched 3D) |
presence_threshold |
Minimum value to consider a pixel "present" (default 0.01). Raise to ignore soft edges; set to 0 for strict non-zero behavior. |
blend_threshold |
Minimum value for a pixel to participate in averaging (default 0.01). Pixels between presence_threshold and blend_threshold are present but passed through without blending. |
Directional Mask Blur
Computes a full omnidirectional Gaussian blur (identical to MaskGrow), then blends between the blurred result and the original mask using a per-pixel directional weight. The side of the mask facing angle_deg receives full blur while the opposite side stays sharp.
| Parameter | Description |
|---|---|
mask |
Input mask (2D or batched 3D) |
angle_deg |
Blur direction in degrees (compass-style: 0° = up, 90° = right, clockwise) |
radius |
Blur radius in pixels (sigma for the Gaussian kernel) |
blend_mode |
How the directional weight map is computed: bbox (fast, bounding-box based) or sdf (precise, signed-distance field based) |
falloff |
Controls the steepness of the directional gradient (default 1.0). Values < 1 spread blur further toward the trailing edge; values > 1 concentrate it near the leading edge. |
single_pass |
When enabled, uses a single large kernel instead of multi-pass |
edge_padding |
Padding mode for convolution edges: replicate, reflect, or zero |
sdf_iterations |
Number of propagation iterations for SDF mode (default 30). Higher = more precise for large or irregular masks. |
Smooth Mask
Iterative Laplacian smoothing for masks. Each iteration, every pixel moves toward the average of its neighbours. Sharp steps get softened while already-smooth gradients are barely affected.
| Parameter | Description |
|---|---|
mask |
Input mask (2D or batched 3D) |
iterations |
Number of smoothing passes (default 5). More iterations = smoother result. |
only_increase |
When enabled, smoothing can only increase pixel values — dips get filled in but peaks are never lowered. Useful for filling gaps without losing coverage. |
Installation
Clone into your ComfyUI custom nodes directory:
cd ComfyUI/custom_nodes
git clone https://github.com/evanscho/advanced_mask_nodes
Or install via ComfyUI Manager.
Development
# Install dev dependencies
pip install -e ".[dev]"
# Run tests
pytest
# Lint
ruff check .