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. 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

Corner radius

Each layer supports a corner radius (0–1, where 0 is square and 1 is a circle). Use this to create rounded windows for picture-in-picture or stylized layouts.

Border

Layers can have a border with configurable:

  • Width — Border thickness in pixels (0 = no border)
  • Color — Border color as a hex value (e.g., #FFFFFF for white)

Borders are useful for visually separating layers in side-by-side and PiP layouts.

Per-layer effects

Each layer can have its own video effects applied before compositing:

  • Chroma key — Remove a green or blue screen background
  • Background removal — AI-powered person segmentation

See Effects for details on configuring these effects.

OSC control

Layers can be edited via OSC:

Address Args Description
/streamit/scene/{n}/layer/{m}/source int Set layer source (slot number, 0=clear)
/streamit/scene/{n}/layer/{m}/frame float x4 Set layer frame (x, y, w, h)
/streamit/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