Overview
Converts closed paths into a white + alpha mask image. It turns a free-form
shape drawn in a path editor into something usable for a cutout (mask) or a
scatter area (mask_scatter). It bridges "draw the shape as a path" and
"determine its use as a mask."
Usage tips
- The go-to flow is
multi_path_editor ā path_mask ā mask(clip an image), orā mask_scatter(scatter within the area). - For a shape with a hole, use
fill_rule = EvenOdd: draw an outer and inner boundary to create a doughnut or frame mask. - Enable
pixel_perfectwhen the line frompath_strokeand the silhouette must match exactly. - Standard PP cleanup uses
pp_mode. For a closed path withpp_closed_crossenabled,pp_closed_sideis used instead. - Use
path_fillwhen you need a colored fill image instead of white.
Related nodes
mask/mask_booleanā use or further combine the maskmask_scatterā use it as an areapath_fillā when you need a colored fillpath_reverseā control holes under NonZero
Fill rules
| Mode | Description |
|---|---|
| Union / Fill all | Fills a point if it is inside any closed path. This is the basic mode for simply overlapping shapes. |
| EvenOdd / Cut out the inside | Alternates fill and cutout on every overlap. Suited to hollow centers such as doughnuts or frames. |
| NonZero / Determine holes by direction | Uses path direction to determine whether an area is filled or cut out. An advanced mode for drawing outer boundaries and holes explicitly. |
Pixel perfect
- Off: builds the mask from the normal outline.
- On: builds the mask from the same PP-corrected outline as
Path Stroke.
Enable it when the appearance of Path Stroke must match the filled silhouette.
Algorithm
- For closed subpaths only, obtain the outline pixel sequence with
rasterize_subpath. - Treat all subpaths as one face and test the center of every pixel with
fill_ruleto determine inside/outside. - Draw white (
1,1,1,1) in the fill area and outline, leaving everything else transparent.
Examples
Create a mask from a path
[Multi Path] ā path ā [Path Mask(fill_rule:Union)] ā [Preview]
Clip an image to a path shape
[Pixel Canvas] ā source ā [Mask] ā [Preview]
ā
[Path Mask] ā mask
Define an area for surface scattering
[Multi Path] ā [Path Mask] ā [Mask Scatter]
Notes
- Open subpaths are ignored.
- If there is no closed subpath, or no Path is connected, the result is transparent.
- Unlike
PathFill, this treats multiple subpaths together as one face. - The output is a white + alpha image intended for use with the
Masknode. - Use
Union / Fill allwhen overlapping areas should remain filled.