Back to appUser guide

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 = D ÷ WprojectorD — throw distanceW

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:

Realisticmedia on the wallCoveragewho lights whatLuminancebrightness (lux)Pixel densitysharpness (px/m)Blendoverlap regions
  • 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.
overlap is brighter — a blend gradient evens it out

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

15Switch display mode (Realistic → Blend)
CCapture a snapshot
Delete / BackspaceRemove the selected projector(s)
EnterCommit a number field

Projection Vision — created by Elias Alchikhani