Advanced Mask Nodes
A collection of custom nodes for ComfyUI
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 .