Appearance
AE Mask
An After Effects layer's masks as a Caddis shape — animated with the masks' own keyframes.
Category: AE (available only in the Caddis panel inside After Effects) Menu path: AE > AE Mask
Ports
| Port | Type | Direction | Description |
|---|---|---|---|
out | shape | output | One path per mask, at the current time, lined up with the layer's pixels |
Parameters
| Param | Type | Default | Description |
|---|---|---|---|
input | string | self | Which layer's masks: This Layer (the layer the Caddis effect is on) or any layer in the comp, through one of the effect's layer pickers |
mask | scalar | 0 | All Masks, or one mask by its number in the layer (the order After Effects lists them in) |
Expose Channels
None — the masks are drawn and animated in After Effects.
How It Works
Draw masks in After Effects as you always would — with the Pen tool, the shape tools, Roto Brush's outlines, mask tracking — and this node brings them into the graph as Caddis paths: a closed mask is a closed path, an open one an open path, with After Effects' own curves. Every frame Caddis renders reads the masks at that frame, so a mask you animate, track or drive with an expression moves in the graph too.
The paths sit where the masks sit on the layer: wire an AE Layer of the same layer next to it and the mask outlines its pixels exactly.
Each path carries what After Effects knows about its mask as path attributes:
| Attribute | What |
|---|---|
maskIndex | The mask's number in its layer (1, 2, …) |
opacity | Mask Opacity, 0–1 |
inverted | 1 when the mask is inverted |
feather | Mask Feather, x and y, in pixels |
expansion | Mask Expansion, in pixels |
The mask's mode (Add, Subtract…) is not applied — every mask comes through as its own path, whatever its mode, including masks set to None (a common way to keep a path just for effects).
Usage Examples
Basic: Stroke a mask
Draw a mask on your footage, then AE Mask → Draw Shape (fill off, stroke on) → Merge over the AE Layer: an animated stroke that follows the mask — with Trim Path in between, a write-on.
Creative: Particles along a path
AE Mask → Point Emitter (Emit From: Path) inside a Solver: particles are born along the mask, wherever it moves. Animate the mask path and the stream follows it frame by frame, even when Caddis renders frames out of order.
Tips
- A layer picked in Layer keeps its masks even when the layer itself is hidden — draw guide paths on a null-like solid with its eye off.
- Time Shift, Echo and the history readers (Solver, Point Trail…) read the masks at the frames they need; editing a mask keyframe anywhere in time rebuilds what was built from it.
- After Effects' mask feather and expansion are not applied to the path itself: read them from the attributes (Shape Attributes, Offset Path for expansion) if the graph needs them.
- Opening the same graph in the Caddis app shows an empty shape here: there are no After Effects masks to read.
Related Nodes
- AE Layer — the same layer's pixels, which the masks line up with
- AE Shape — a shape layer's contents instead of masks
- Draw Shape — draw the paths
- Point Emitter — emit particles along them
- Trim Path — write them on