Skip to content

Layers and the stack

A ZoneQ project is built from layers. Each enabled layer produces an image, and Stage composites those layer results into the final picture.

In a simple layer, cards form a linear stack. A shader or operator card can read the result from the card below it, transform that image, and pass a new result upward. This incoming same-frame image is Previous Pass.

The bottom image card starts with the composite of all enabled layers below its layer. To dither the picture, create a layer above that content and add Dither. Moving the layer changes which content it processes; disabling it reveals the picture before the effect. Its opacity fades between the original and processed images.

A layer in Studio with numbered cards arranged in stack order.

The numbered cards form the layer’s processing path; card inputs hold stacks of their own.

Some cards take a second image: a Mask, a Displacement or Flow field, a Foreground, or the Other image of a mix. Each of those inputs appears as its own row on the card, named after the input.

An input can hold its own little stack. Press + on the input to add cards to it — a Noise, a Blur, a shader — exactly as you add cards to a layer. Stacks can go inside stacks, and you can drag cards between them.

Every stack starts from a Base. By default that is Previous Pass, the layers below. Pick something else in the Base field:

  • Layer Sample — another layer’s result. Layers below arrive this frame; this layer and layers above arrive one frame late.
  • This layer — a result from elsewhere in this layer, such as the image before a blur. Changing that card changes every place that reads it.
  • A camera or other Rack Source, a Shared Texture, or a file from the Library.
  • Feedback — a result a card keeps for the next frame.

An input with nothing in it uses its card’s own default; hover the input to see what that is.

Blend and Split are rows too. A Blend mixes more images over the stack below, each extra input holding its own stack with its own blend mode and opacity. A Split passes one channel — Red, Green, Blue, Alpha or Luma — for masks and value inputs. Cards with more than one result, such as Cells, choose which one they pass on with Output.

A card’s menu can Share as Shared Texture, so other layers, 3D scenes and particles can use its result, or Keep as Feedback, so any stack in this layer can start from it next frame.

  1. Inside a layer: the layer’s stack, and the stacks inside its cards’ inputs, produce the layer result.
  2. Across layers: layer opacity and blend mode combine each completed layer into Stage.

Changing layer opacity affects Stage compositing; it does not stop the layer from rendering. An opacity-zero layer can still generate a field or Shared Texture for another layer.

A custom shader card also composites its color over Previous Pass. Setting a pixel’s alpha to zero reveals the incoming image; it does not erase that image. For a transparent cutout, put the shader on a separate transparent layer instead of relying on alpha zero to remove content beneath it.

Previous Pass is the image entering the current card during the current frame, whether that card sits in the layer’s stack or in a card input’s stack. It is useful for ordinary effects such as blur, color adjustment, or compositing.

Previous Frame is retained history from the card’s output at an earlier transport step. It is what makes feedback possible. See Feedback for the distinction and the Clear behavior.

Library add actions import whole layers because a layer is the stable unit that carries its stacks, bindings, controls, and dependencies together. Read Add reusable layers before extracting part of an example.