User#

Specifies a user position and parameters. In most cases, only a single unnamed user is necessary. However, in more general cases, it is possible to assign Users to specific Viewports to provide a more fine-grained control over the rendering that occurs in that viewport.

  • name (optional)
    non-empty string

    Specifies the name of this user. Each user needs to have a unique name, but there also has to be exactly one user present that has an empty name (or without a name attribute) which is used as the default user.

  • eyeseparation (optional)
    number (0.0, \(\infty\))

    Determines the eye separation used for stereoscopic viewports. If no viewports in the configuration are using stereo, this setting is ignored.

  • pos (optional)
    vec3

    A linear offset of the user position. Must define three float attributes x, y, and z. The default values are x=0, y=0, z=0, meaning that no linear offset is applied to the user’s position.

  • matrix (optional)
    array of numbers

    A generic transformation matrix that is applied to the orientation of this user.

  • orientation (optional)
    orientation

    Describes a fixed orientation for the viewing direction of this user. This can be provided either as Euler angles or as a quaternion. This value will overwrite the value specified in matrix.

  • tracking (optional)
    array of objects

    Provides information about whether this user should be tracked using a VRPN-based tracker. This child node contains two attributes with information about the tracker that this user should be associated with.

    • tracker
      string

      The name of the tracker group that this user should be linked with. This name must be a name of a Tracker that is specified in this configuration.

    • device
      string

      The name of the device in the tracker group that should be used to control the tracking for this user. The specified device has to be a Device that was specified in the tracker.