Editing Layers

After creating a scene, you can customize each layer’s source, position, size, and opacity.

Assigning sources to layers

Each layer in a scene maps to a source slot number (1–8). To assign a source:

  1. Select the scene in the Scenes panel
  2. Tap a layer to edit it
  3. Choose the source slot to assign

Setting a layer’s source to 0 (or clearing it) makes that layer empty/transparent.

Layer frame

Each layer has a frame defined by four normalized values (0–1):

Value Description
X Horizontal position of the left edge
Y Vertical position of the top edge
Width Width as a fraction of the total frame
Height Height as a fraction of the total frame

For example, a layer at (0, 0, 0.5, 1.0) fills the left half of the screen.

Templates provide sensible defaults, but you can adjust these for custom layouts.

Layer opacity

Each layer has an opacity value from 0 (fully transparent) to 1 (fully opaque). Use this for:

  • Semi-transparent overlay layers
  • Fade effects between layers
  • Watermark-style compositing

OSC control

Layers can be edited via OSC:

Address Args Description
/pmix/scene/{n}/layer/{m}/source int Set layer source (slot number, 0=clear)
/pmix/scene/{n}/layer/{m}/frame float x4 Set layer frame (x, y, w, h)
/pmix/scene/{n}/layer/{m}/opacity float Set layer opacity (0–1)

Where {n} is the scene number and {m} is the layer number.

Tips

  • Gaps between layers — Templates include 1% gaps between adjacent layers. Maintain these when customizing to keep a clean look
  • Aspect ratio — Sources with different aspect ratios are letterboxed within their layer frame
  • Layer order — Lower-numbered layers render first (behind); higher-numbered layers render on top