Mapping Matter CSV Import
Mapping Matter is a projection planning tool that can export projector configurations as CSV files. Experience Designer reads these files and recreates the full projector layout, including positions, rotations, lens settings, and photometric data.
Importing a CSV file
- Go to File → Import → Mapping Matter CSV.
- Select the
.csvfile exported from Mapping Matter. - Experience Designer validates the headers, converts coordinates, and adds all projectors to the scene.
Supported CSV columns
| Column | Description |
|---|---|
Projector_Name |
Projector label |
Projector_Qte(Stack) |
Stack count |
Projector_Native-Rez-X |
Native horizontal resolution |
Projector_Native-Rez-Y |
Native vertical resolution |
Projector_Lumens(lux) |
Projector brightness in lumens |
Projector_Brightness(%) |
Brightness setting as percentage |
Projector_Total_Lumens(lux) |
Total output (stack × lumens × brightness%) |
Projector_Trow-Ratio |
Throw ratio |
Lens_Shift-H(%) |
Horizontal lens shift (% of image width) |
Lens_Shift-V(%) |
Vertical lens shift (% of image height) |
Lens_X / Y / Z |
Lens origin position |
Pitch(deg) |
Vertical tilt angle |
Yaw(deg) |
Horizontal pan angle |
Roll(deg) |
Roll / rotation angle |
Target_X / Y / Z |
Target surface centre position |
Target_Distance |
Throw distance to target |
Target_Width / Height |
Target surface dimensions |
Target_Illuminance |
Measured or calculated illuminance at target |
Target_DPI |
Pixel density at target |
Unit_Dim |
Dimension unit (cm, m, etc.) — all values converted to metres |
Unit_Illuminance |
Illuminance unit |
Projector_UUID |
Optional unique identifier |
Validation
If any required column is missing, the import fails with an error listing the missing headers. Rows with fewer columns than expected are skipped with a warning shown in the import report.
After import
All imported projectors appear in the scene panel and can be selected, edited, and analysed like any manually placed projector. The photometric data from the CSV (illuminance, DPI) is stored as metadata but does not override Experience Designer's live GPU-calculated analysis.
Note: Mapping Matter CSV import does not import screens or surfaces. You will need to add matching surfaces manually to run analysis in Experience Designer.