Positioning and Scaling
Every overlay (text, image, countdown) can be precisely positioned, scaled, and rotated on screen.
Coordinate system
Overlay positions use normalized coordinates from 0 to 1:
- (0, 0) = top-left corner
- (0.5, 0.5) = center of screen
- (1, 1) = bottom-right corner
This means positions are resolution-independent — an overlay at (0.5, 0.8) is always at the center-bottom regardless of output resolution.
Positioning
Set the overlay’s position by specifying X and Y coordinates:
| Position | X | Y |
|---|---|---|
| Top-left | 0.05 | 0.05 |
| Top-center | 0.5 | 0.05 |
| Top-right | 0.95 | 0.05 |
| Center | 0.5 | 0.5 |
| Bottom-left | 0.05 | 0.95 |
| Bottom-center | 0.5 | 0.95 |
| Bottom-right | 0.95 | 0.95 |
| Lower third | 0.5 | 0.8 |
Scaling
Scale controls the size of the overlay relative to its natural size:
- 1.0 = original size (default)
- 0.5 = half size
- 2.0 = double size
- Range: 0.1 to 10
Rotation
Rotation is specified in degrees:
- 0 = no rotation (default)
- 90 = rotated 90° clockwise
- -45 = rotated 45° counter-clockwise
- Range: -180 to 180
OSC control
| Address | Args | Description |
|---|---|---|
/pmix/overlay/{n}/position |
float, float | Set X, Y position (0–1) |
/pmix/overlay/{n}/scale |
float | Set scale (0.1–10) |
/pmix/overlay/{n}/rotation |
float | Set rotation (-180 to 180) |
Tips
- Lower thirds — Position at Y=0.75–0.85 for the standard lower-third area
- Corner bugs (logos) — Position near corners with a small scale (0.15–0.25)
- Safe area — Keep important overlays within 0.05–0.95 on both axes to avoid being cut off by some displays
- Consistency — Use the same positions for recurring elements (always put the lower third in the same spot)