Design Exchange Format

The VIOSO Design Exchange Format (DEF) is a JSON-based interchange format used across VIOSO tools to transfer complete scene descriptions — projectors, cameras, screens, and spatial data — between applications.

Importing a DEF file

  1. Go to File → Import → Design Exchange Format.
  2. Select the .json DEF file from your device or platform asset library.
  3. Experience Designer parses the file and populates the scene with all projectors, cameras, and screens defined in it.

What is imported

Element Mapped to
Projectors (with position, rotation, lens, resolution, brightness) Projector objects
Cameras (with FOV, sensor, focal length) Observation camera objects
Screens (Plane or Cylinder shapes) Surface objects
Scene units (m / cm / mm / ft / in) Automatically converted to metres

Supported units

The DEF format supports m, cm, mm, ft, and in as the units field. Experience Designer converts all values to metres on import.

DEF file structure (reference)

{
  "units": "m",
  "projectors": [
    {
      "name": "Projector 1",
      "posx": 0, "posy": 3, "posz": 10,
      "rotx": -15, "roty": 0, "rotz": 0,
      "throwratio": 1.7,
      "resolutionx": 1920,
      "resolutiony": 1080,
      "brightness": 10000
    }
  ],
  "cameras": [
    {
      "name": "Calibration Cam",
      "posx": 0, "posy": 2, "posz": 15,
      "fov": 60,
      "resolutionx": 3840,
      "resolutiony": 2160
    }
  ],
  "screens": [
    {
      "name": "Main Screen",
      "shape": "Plane",
      "width": 10,
      "height": 5.6,
      "posx": 0, "posy": 2.8, "posz": 0
    }
  ]
}

Exporting to DEF

To export the current scene in DEF format:

  1. Go to File → Export → Design Exchange Format.
  2. The .json file downloads immediately.

The export includes all projectors and cameras. Screens are exported if they are a supported shape (Plane or Cylinder). Custom 3D models are not included.

results matching ""

    No results matching ""