Projection Vision — how it works
Plan a projection-mapping job before load-in: bring in your venue, place virtual projectors, and see real coverage, brightness and pixel density — then hand a client a branded report. This guide walks the whole flow.
1 · Build your scene
From the + menu (top-left tree) add a screen — a flat wall, curved screen, dome, cube or flat panel — or Import model… to drop in a venue as .glb, .gltf or .obj. Units convert on import.
In Properties you can resize a screen, recolour it, and mark it a projection surface (only those receive light and show in the simulation; everything else is context geometry).
Screenshot: the scene tree + Add menu with a screen selected
2 · Place projectors
Click Add projector, then pick a real model + lens in its editor (resolution and lumens come from the preset). Aim it with the gizmo, and set the throw ratio and lens shift to match the lens.
Throw ratio is just distance ÷ image width — a 1.2 lens fills a 5 m wide image from 6 m away. Auto-distribute lays out a whole array across a wall or dome with the overlap you choose, edges landing exactly on the screen.
Each projector can be told which surfaces it feeds, so a front screen and a back wall are calculated independently.
3 · Simulate & read results
The mode switch (top bar, or keys 1–5) changes what the surfaces show:
- Realistic — your test pattern or uploaded media, shown only where covered.
- Coverage — which projector lights each area (one colour per projector).
- Luminance — brightness in lux (lumens over area, angle-corrected).
- Pixel density — sharpness in pixels per metre.
- Blend — where frustums overlap and brightness adds up.
Hover any surface to read the exact lux + px/m at that spot, watch the heat-map legend for the scale, and open Properties for per-surface min / average / max.
4 · Snapshots & reports
Export ▸ Capture snapshot (or C) saves the current view with its legend baked in. Export ▸ Printable report bundles your chosen snapshots with a projector schedule and per-surface figures, headed by your company branding (set it once in Report & project info). There's also a CSV schedule for spreadsheets.
Screenshot: the printable report with branding, schedule and snapshots
5 · Projects & saving
The Project menu holds it all: New project… (name it + confirm company details), Save / Load to file (a single .json that carries the venue model with it), and Cloud projects… — your private library that follows you across devices. Your work also auto-saves in the browser between visits.
Keyboard shortcuts
| 1–5 | Switch display mode (Realistic → Blend) |
| C | Capture a snapshot |
| Delete / Backspace | Remove the selected projector(s) |
| Enter | Commit a number field |
Projection Vision — created by Elias Alchikhani