Control what stays visible with masks
Use a mask to crop an image into a circle, show a pattern within letter outlines, or fade content gradually.
A mask controls which parts of the target remain visible, which parts disappear, and how much opacity remains. Hidden content is still there: you can move, edit, or replace it.
How the three mask modes work
floma supports vector, alpha, and luminance masks.
- Vector clips by geometry. Use it for circles, custom outlines, and shapes with holes.
- Alpha uses opacity. Use it for fades and partially transparent areas.
- Luminance uses brightness and opacity. Use it for black-and-white or grayscale masks.
Vector masks clip to a shape
A vector mask defines the visible area with closed geometry. Content inside the shape remains visible; content outside is hidden. Fill color and opacity do not affect the clipping area.
For example, a circular vector mask shows the target only inside the circle. Filling that circle with black, white, or red produces the same clipping area.
Masks can contain complex curves, holes, and multiple shapes. To build one mask from several shapes, put them in a group and set the group to Vector.
Alpha masks read opacity
An alpha mask reads the opacity at each point. Color does not affect the result.
- Fully opaque areas let the target show completely.
- Fully transparent areas hide the target.
- Partially transparent areas show the target partially.
Equally opaque black and white produce the same alpha mask. The target also keeps its own opacity: a target at 50% opacity seen through a mask at 50% opacity ends up at 25% opacity.
Luminance masks read brightness
A luminance mask uses both brightness and opacity. Opaque white reveals the target, black hides it, gray reveals it partially, and fully transparent areas hide it.
The same opaque black area therefore reveals content in Alpha mode and hides it in Luminance mode. Choose Luminance for black-and-white artwork used as a mask, or Alpha for a fade built from transparency.
A mask affects siblings above it
A mask follows layer order and affects only the layers above it that share the same parent. Its scope ends at the next mask or the parent boundary.
This example follows the layers panel from top to bottom:
Group
├─ Pattern B ← masked
├─ Pattern A ← masked
├─ Mask
└─ Background ← unaffected One mask can control several targets. The target content is composited together before the mask is applied, so overlapping areas are processed as part of that combined result.
Keep a mask and its targets in a dedicated group when you want to isolate them from other sibling layers.
Use a group as the mask source
Paths and groups can both be masks. When a group becomes a mask, its children form the mask source together, and the group controls siblings above it. Two separate circles inside that group can reveal the target in two separate circular areas.
The group's children form its mask source; they are not the targets of that group's own mask.
Enable a mask in the properties panel
- Select a path or group.
- Find Mask in the Layer section of the right-hand properties panel.
- Choose Vector, Alpha, or Luminance.
- Place the targets above the mask under the same parent in the layers panel.
A mask icon appears next to the layer name. The source stops appearing as ordinary artwork, but you can still select, move, and edit it, with a blue selection box. Choose None to return the layer to ordinary content.
Mask and layout are mutually exclusive
If a group defines both a mask and a layout, the mask takes precedence and the layout becomes inactive. Its Layout controls are hidden while the mask is enabled. Clearing the mask reactivates the saved layout settings.
Masks and targets participating in a parent stack or grid layout flow are not fully supported yet. The editor reports unsupported combinations and refuses to enable the mask.
Keep clipping and masks when importing SVG
SVG commonly uses <clipPath> for a geometric clipping area and <mask> for visibility controlled by opacity or brightness.
When importing SVG, floma converts supported clipping and masks into editable layer structures:
<clipPath>becomes a vector mask.- An alpha-based
<mask>becomes an alpha mask. - A luminance-based
<mask>becomes a luminance mask.
Clipping paths support complex closed curves, holes, and combinations of shapes. Multiple shapes in an SVG mask remain inside a mask group, along with supported fills, opacity, strokes, transforms, and internal clipping.
After import, find those masks in the layers panel and continue editing their shapes, content, or mode. The converted layers and mask effects are preserved; the original SVG tag structure and resource references may change.
Current import limits
Some SVG masks cannot be reproduced completely yet:
- For the mask region,
maskUnitssupports the default or explicitobjectBoundingBox, but notuserSpaceOnUse. - Text, externally linked images, some gradients, and filters inside a mask remain subject to SVG import limitations.
- External resource references and some complex clipping structures are not fully supported.
Import results list unsupported content. Check the imported mask layers and canvas to see what was preserved and what still needs adjustment.
Keep the mask effect when exporting
SVG export generates the appropriate clipping or mask definition for vector masks, and SVG mask definitions for alpha and luminance masks.
When exporting only selected masked content, the controlling mask is included too, so the content keeps its clipping effect outside the current document.