Planar Projection

Describes a projection for the Viewport that is a flat projection described by simple frustum, which may be asymmetric. If you are building a new configuration file and do not know which projection type you should use, this type is probably the right one.

Parameters

type#stringrequireddefault PlanarProjection

Defines the type of this projection.

fov#FOVrequired

This element describes the field of view used the camera in this planar projection.

distance#numberoptional

The distance (in meters) at which the virtual render plane is placed. This value is only important when rendering this viewport using stereocopy as the distance and the User's eyeseparation are used to compute the change in frustum between the left and the right eyes.

orientation#Orientationoptional

Describes a fixed orientation for the virtual image plane. This can be provided either as Euler angles or as a quaternion.

offset#vec3optional

A linear offset in meters that is added to the virtual image plane. Must define three float attributes x, y, and z. The default values are x=0, y=0, z=0, meaning that no offset is applied to the image plane.

Examples

Symmetric

↓planar-symmetric.json

{
  "version": 1,
  "masteraddress": "localhost",
  "nodes": [
    {
      "address": "localhost",
      "port": 20400,
      "windows": [
        {
          "pos": { "x": 50, "y": 50 },
          "size": { "x": 1280, "y": 720 },
          "viewports": [
            {
              "projection": {
                "type": "PlanarProjection",
                "fov": { "hfov": 80, "vfov": 50.534 },
                "orientation": { "yaw": 0.0, "pitch": 0.0, "roll": 0.0 }
              }
            }
          ]
        }
      ]
    }
  ],
  "users": [
    {
      "eyeseparation": 0.06,
      "pos": { "x": 0, "y": 0, "z": 4.0 }
    }
  ]
}

Asymmetric

↓planar-asymmetric.json

{
  "version": 1,
  "masteraddress": "localhost",
  "nodes": [
    {
      "address": "localhost",
      "port": 20400,
      "windows": [
        {
          "pos": { "x": 50, "y": 50 },
          "size": { "x": 1280, "y": 720 },
          "viewports": [
            {
              "projection": {
                "type": "PlanarProjection",
                "fov": { "down": 35, "up": 15, "left": 10, "right": 70 },
                "orientation": { "yaw": 0.0, "pitch": 0.0, "roll": 0.0 }
              }
            }
          ]
        }
      ]
    }
  ],
  "users": [
    {
      "eyeseparation": 0.06,
      "pos": { "x": 0, "y": 0, "z": 4.0 }
    }
  ]
}

Orientation

↓planar-orientation.json

{
  "version": 1,
  "masteraddress": "localhost",
  "nodes": [
    {
      "address": "localhost",
      "port": 20400,
      "windows": [
        {
          "pos": { "x": 50, "y": 50 },
          "size": { "x": 1280, "y": 720 },
          "viewports": [
            {
              "projection": {
                "type": "PlanarProjection",
                "fov": { "hfov": 80, "vfov": 50.5340 },
                "orientation": { "yaw": -50.0, "pitch": 25.0, "roll": 45.0 }
              }
            }
          ]
        }
      ]
    }
  ],
  "users": [
    {
      "eyeseparation": 0.06,
      "pos": { "x": 0, "y": 0, "z": 4.0 }
    }
  ]
}