Appearance
Surfaces View
The Surfaces view displays and manages video content layers that get mapped onto your LED screens. This is where you control what appears on your LED walls.
What is a Surface?
A surface is a content layer with a defined resolution. Surfaces can display:
- Test patterns — Built-in diagnostic and calibration patterns
- Video files — Uploaded video content
- Image files — Static image content
- No source — A blank surface
Surface Panel (Sidebar)
The Surfaces sidebar panel lets you manage all surfaces:
Creating Surfaces
Click + to add a new surface. Set its name and pixel dimensions.
Source Type
Choose from four source types:
| Source | Description |
|---|---|
| No Source | Blank surface |
| Video File | Upload a video file for playback |
| Image File | Upload a static image |
| Test Pattern | Select from built-in test patterns |
Video Controls
For video sources, you get playback controls:
- Play/Pause
- Loop toggle
- Volume control
Scale Mode
When the source content doesn't match the surface resolution:
| Mode | Behavior |
|---|---|
| Fit | Scale to fit with letterboxing |
| Fill | Scale to fill, cropping excess |
| Stretch | Stretch to fill (may distort) |
| 1:1 | Display at native resolution |
Logo Overlay
Add a logo image overlay to any surface:
- Upload a logo image
- Set position (center, corners)
- Adjust scale
Surface Instances
A surface instance is a placement of a surface onto a specific output. One surface can have multiple instances on different outputs.
Creating Instances
Add an instance to place a surface on an output at a specific position and size. Set:
- Output — Which video output to place it on
- Position — X/Y coordinates within the output
- Size — Width and height in pixels
Positioning
In the Surfaces view workspace, you can:
- Drag instances to reposition them
- Resize by dragging edges or corners
- Nudge with arrow keys (1px, or 10px with Shift)
- Auto-pack to arrange instances automatically
Linking to Screens
Surface instances can be linked to screens. When linked:
- The screen's panels render the surface content
- The Panel Map test pattern uses real panel data from the linked screen
- Changes to screen wiring are reflected in the test pattern visualization
Output Selection
Use the output dropdown at the top of the Surfaces view to switch between outputs. Each output shows its own set of surface instances.
Visibility
Toggle surface instance visibility with the eye icon. Hidden instances remain configured but aren't rendered, useful for comparing different content arrangements.
