Projection Mapping & Warp/Blend

Exaplay 3 integrates with VIOSO for professional geometric warping and edge blending across multiple projectors.

What Is Warp/Blend?

When multiple projectors cover the same surface (a curved screen, a building facade, or a multi-projector flat screen), two corrections are needed:

• Geometric warping — corrects lens distortion and keystoning so the image aligns with the physical surface.
• Edge blending — fades the overlapping region between adjacent projectors so the join is invisible.

VIOSO handles both using a calibration file (.vwf) produced by its auto-calibration software.

Loading a Calibration File

1. Open Config → Outputs.
2. Select the output you want to warp.
3. Click Load Warp File and choose the .vwf file produced by VIOSO Calibrator.
4. The warp is applied immediately; toggle it on/off with the Warp Enable switch.

Manual Warp Editor

For simple single-projector corrections without VIOSO Calibrator, Exaplay 3 includes a built-in grid warp editor.

Open it from Config → Outputs → Edit Warp.

Control Points

The editor shows a grid of control points overlaid on the output. Each point can be moved to correct the geometry at that location.

Action	How
Select point	Click the point
Move point (fine)	Arrow keys (0.01 unit steps)
Move point (coarse)	Shift + Arrow keys (0.1 unit steps)
Cycle points	Tab / Shift+Tab
Deselect	Escape or Enter
Reset all	Click the Reset button

Interpolation Mode

Choose between Linear and Bicubic interpolation from the Interpolation drop-down. Bicubic produces smoother results but requires more GPU.

Advanced Projection Setup and 3D Warp

Experimental — new in 3.3. Alongside the classic grid editor above, Exaplay 3.3 introduces two more advanced editors for each screen. Both are hidden by default — switch on Settings → Debug mode first (this also reveals other in-development features, so treat them as preview-quality, not yet production-ready).

With Debug mode on, open Config → Outputs, select a screen, and you'll see two extra rows:

• Projection Setup → Open editor — a 2D editor covering the warp grid, softedge (blend) falloff curves, and basic blacklevel for that screen, with a projector selector.
• 3D Warp → Open editor — a manual 3D pose warper: pick a surface model or import a GLB/OBJ mesh, position a virtual projector, and calibrate its pose from projected crosshairs / picked points.

Both editors share a safety net:

• Revert — undo every change made since the editor was opened, back to the state it had when opened.
• Reset to defaults — wipe this screen's projection setup (2D) or 3D warp (surface, pose, markers, blend) back to its neutral default. This can't be undone, but Revert still works afterwards.

Edge Blending

Edge blending parameters are loaded from the VIOSO .vwf file. If you need to manually adjust the blend curve:

1. Open Config → Outputs → Edge Blend.
2. Adjust the Blend Width slider for each overlapping edge (0–100 %).
3. Adjust the Gamma Curve to control the blend falloff shape.

Auto-Calibration (VIOSO)

If VIOSO AutoAlign is installed and a calibration camera is connected:

1. Go to the Auto Calibration view (/autocalibration).
2. Follow the on-screen wizard.
3. The resulting .vwf file is saved and loaded automatically.