Appearance
Outputs & Displays Troubleshooting
Blank Output Screen
Step 1 — Verify the display is detected by Windows
- Right-click the Windows Desktop → Display Settings.
- Confirm all projectors/screens are listed and set to Extend (not Mirror or Disconnect).
Step 2 — Verify the output in Exaplay
- Open the STAGE tab.
- Confirm the output is assigned to the correct Windows display number.
- Click Show Test Pattern — if a pattern appears on the physical display, the output hardware is working.
Step 3 — Verify playback
- Confirm the composition is playing (Transport bar shows
▶and a running timecode). - Confirm the composition has media on Track 1 and the clips are not all off-screen or hidden.
- Check the Inspector for the selected screen — verify the output assignment matches a physical display.
Wrong Resolution / Overscan / Underscan
- Open the STAGE tab → [Output Name].
- Set Resolution to match the native resolution of the display exactly.
- Set Refresh Rate to the display's native rate (typically 60 Hz, or 50 Hz for PAL-region broadcasts).
- If the image is offset or cropped, check Position (X, Y) — these must match the display's position in Windows Display Settings.
Image Appears Upside-Down or Mirrored
This is usually a hardware/cable issue (some projectors apply a flip based on ceiling/rear mode). Check:
- The projector's built-in Image Flip setting (Front/Rear/Ceiling).
- If the projector is correctly oriented physically.
Exaplay does not currently apply a software image flip — correct this at the projector or content level.
Warp Looks Wrong After Reloading Project
- Open the STAGE tab → [Output Name].
- Confirm the
.vwffile path still exists and is accessible. - Open the screen's Projection Calibration → VIOSO… panel: the Status line names the reason the engine did not render the file, and Reapply forces a reload.
- If the warp file was on a removable drive that changed letters, update the path.
Edge Blend Seam Visible
The blend comes from the VIOSO calibration — Exaplay has no separate blend width / gamma control.
- Check that the screen has its
.vwfloaded (STAGE tab → screen → Calibration;vwf-load-errormust be empty). - Play a mid-grey test image (
128, 128, 128) and compare projector brightness at the seam — they must match for the blend to be invisible. - If projector brightnesses differ, use the Luminance effect on one output to match them, or raise Blacklevel → Overall lift for the dark floor.
- If the overlap itself is wrong (projector moved), re-run the VIOSO calibration and reload the new
.vwf.
NDI Output Not Visible to Receivers
- Open the STAGE tab → [Output Name] → confirm NDI Output is enabled.
- Confirm the stream name is set and does not conflict with other NDI sources on the network.
- Open NDI Studio Monitor on the receiving machine and scan for sources.
- Check firewall: allow TCP/UDP 5960–5989 on both the engine and the receiving machine.
- Confirm both machines are on the same subnet.
Auto Calibration (VIOSO) Fails
- Confirm the calibration camera is connected and recognised by Windows.
- Ensure the room is dark enough — stray light from windows or other sources degrades calibration quality.
- Ensure the projection surfaces are matte (not glossy) — reflective surfaces cause measurement errors.
- Allow the projectors to warm up for at least 10 minutes before calibrating for stable brightness.
- Review the VIOSO AutoAlign log for specific error messages.
