Skip to content
Disguise User Guide

Importing projectors

From r16, Designer started supporting import of projector information from external CSV files. Currently, both Mapping Matter and SimProj are supported.

The feature is intended to take a CSV file with a .txt file extension that contains the projector data. Currently, Mapping Matter and SimProj are known to work well. The CSV can be generated automatically from their programs, or manually, as long as the same format is used.

An example of CSV format without a projector UUID.

Projector_Name,Projector_Qte(Stack),Projector_Native-Rez-X,Projector_Native-Rez-Y,Projector_Lumens(lux),Projector_Brightness(%),Projector_Total_Lumens(lux),Projector_Trow-Ratio,Lens_Shift-H(%),Lens_Shift-V(%),Lens_X,Lens_Y,Lens_Z,Pitch(deg),Yaw(deg),Roll(deg),Target_X,Target_Y,Target_Z,Target_Distance,Target_Width,Target_Height,Target_Illuminance,Target_DPI,Unit_Dim,Unit_Illuminance

An example of CSV format with projector UUID.

Projector_Name,Projector_Qte(Stack),Projector_Native-Rez-X,Projector_Native-Rez-Y,Projector_Lumens(lux),Projector_Brightness(%),Projector_Total_Lumens(lux),Projector_Trow-Ratio,Lens_Shift-H(%),Lens_Shift-V(%),Lens_X,Lens_Y,Lens_Z,Pitch(deg),Yaw(deg),Roll(deg),Target_X,Target_Y,Target_Z,Target_Distance,Target_Width,Target_Height,Target_Illuminance,Target_DPI,Unit_Dim,Unit_Illuminance,Projector_UUID

Exporting the .csv file

  1. A projector configuration is created by a user in Mapping Matter or SimProj.
  2. Export the projector configuration to a correctly formatted CSV file.
  3. Add the .csv files to the Objects > Table folder of your Designer project. If this folder does not exist, please create one.
  4. Import the .csv file using the Import Projector functionality in Designer.

Importing the .csv file

  1. In Designer, open the stage editor and navigate to actions.
  2. Left-click Import projectors from table.
  3. Select the CSV file from the list of table files. If an unsupported file is selected (e.g. containing something else than projectors), the import will fail, and an error message will inform the user.
  4. If the import succeeds, all projectors in the CSV file will be imported and added to the Stage.
    • Existing projectors with the same name will be modified. If they are not in the Stage at the moment, they will be added.
    • If a projector with a certain name does not yet exist, it will be created and added to the Stage.
    • If the file contains multiple projector entries with the same name, Disguise will create duplicates with different names.
  5. Designer will notify the user with a popup message showing information about many projectors were added, modified, or failed.