Appearance
AE Layer
The After Effects layer a Caddis graph runs on — or another layer in the same comp — as an image, or one channel of it.
Category: AE (available only in the Caddis panel inside After Effects) Menu path: AE > AE Layer
Ports
| Port | Type | Direction | Description |
|---|---|---|---|
out | imageRgba16f | output | The layer's pixels at the current time, at the layer's own size |
Parameters
| Param | Type | Default | Description |
|---|---|---|---|
input | string | self | Which layer to read: This Layer (the layer the Caddis effect is applied to) or one of the effect's layer pickers |
channel | enum | RGBA | RGBA: the layer as it is. Red, Green, Blue, Alpha, Luminance or Lightness: that channel of the layer as an opaque gray image |
Expose Channels
None — the layer is picked, not animated.
How It Works
When Caddis is applied to an After Effects layer, After Effects hands the layer's pixels to Caddis on every frame, after the layer's masks and the effects above Caddis. This node is where those pixels enter the graph. It behaves like any other image source: wire it into effects, use it as a matte, sample it as a field.
This Layer is the input After Effects gives the effect. Another layer comes in through one of the Caddis effect's layer pickers, so After Effects knows the effect depends on that layer and re-renders when it changes — exactly like the Layer menus on After Effects' own effects.
Channel picks how the layer is used, like the channel menus on After Effects' own effects (Set Matte, Displacement Map). RGBA is the layer as it is. Any other choice is that one channel as an opaque gray image, the layer's size: Red, Green and Blue its color channels, Alpha its coverage, Luminance its brightness as the eye weighs red, green and blue, Lightness halfway between its brightest and darkest channel. The color channels are read the way After Effects reads them, with the coverage applied, so a soft edge stays soft and a transparent area is black.
The image keeps the layer's size. On a comp-sized layer (a solid, or footage that fills the frame) that is the whole frame; on a smaller layer it sits centered, the way the layer does in After Effects.
Usage Examples
Basic: Run a Caddis effect on footage
Apply Caddis to a footage layer. The graph starts as AE Layer → Output, which shows the layer unchanged. Put nodes between the two — Glow, Lens Blur, Colorize — and the result renders in the After Effects comp viewer and the Render Queue.
Basic: An effect on everything below
Put Caddis on an adjustment layer. There, This Layer is the composite of every layer beneath it — as for any After Effects effect on an adjustment layer — so the graph starts with it: add Draw ASCII between AE Layer and Output and the whole comp below turns into type.
Matte: another layer's alpha
Pick a layer in Layer, set Channel to Alpha, and wire it into a Matte (Luminance) — the layer's shape cuts out anything in the graph, the way Set Matte does in After Effects.
Creative: Drive particles from footage
Wire AE Layer into Image Sample, then use its scalar field as a Point Emitter's density: particles are born where the footage is bright.
Tips
- Effects above Caddis in the Effect Controls run first; Caddis sees their result — at every frame a time node or a replay reads too.
- Echo, Time Shift, Freeze Frame, Posterize Time, Loop Time, Slitscan and Optical Flow after this node read the layer at the frames they ask for (Optical Flow: the frame before, or up to nine with Temporal Smoothing on).
- Nodes that replay its history — Slitscan's Scan mode, a Solver, Point Advect, Point Trail, a Point Emitter's rate or source, Trigger, Draw Instances' time offsets — read it at every frame their replay reaches: Caddis asks After Effects for each one while it renders (empty before the layer starts and after it ends) and keeps what it builds, so only the first frame far into a layer replays it from the start. Each resolution keeps a history of its own. Changing the layer (anywhere in time) builds the history again. A node marked THIS FRAME means After Effects still runs an effect from before a Caddis update — restart After Effects.
- A layer picked from another layer arrives as its source, without that layer's own masks and effects — the same as the Layer menus on After Effects' own effects (Displacement Map, Set Matte). To read it with them, including another Caddis effect, precompose it and pick the precomp.
- On an adjustment layer, This Layer is the composite of the layers below it — at the frame, and at every frame a time node or a replay reads.
- A graph with no AE Layer node ignores the layer's pixels entirely — that is how a Caddis generator on a solid works (a new graph on a plain solid starts that way).
- Opening the same graph in the Caddis app shows a transparent image here: there is no After Effects layer to read.
Related Nodes
- AE Mask — the same layer's masks, as paths
- AE Shape — a shape layer's contents, as paths
- LayerSource — another layer's output, inside a Caddis project
- ImageSource — an image file from disk
- ImageSample — read an image as fields