SpatialDirection class Models

The SpatialDirection class defines the direction a participant is facing. The class is specified as a set of three Euler rotations about the corresponding axis. The following properties define a rotation about the specified positive axis:

  • x: A rotation about the x-axis
  • y: A rotation about the y-axis
  • z: A rotation about the z-axis

Yaw: A rotation about the up axis, where the default environment is the y rotation

Pitch: A rotation about the right axis, where the default environment is the x rotation.

Roll: A rotation about the forward axis, where the default environment is the z rotation.


When using custom environment directions set in ConferenceService.setSpatialEnvironment, the rotation is defined to always rotate about the relevant axis according to the left handed curl rule. In the animations above you can see, for the y-axis rotation, if you curl your left hand up around with your thumb pointing down the +y axis, the direction the participant will rotate is in the direction the fingers are curling around the given axis. You can see the rotation arrows in those reference animations which correspond to positive rotation direction are pointing the same direction as the fingers of the curled left hand.

When a direction contains rotations around more than one axis, the rotations are applied in a defined order: yaw, pitch, and then roll. With the standard environment, this corresponds to y, x, and then z. When using custom environment directions, the directions are always in the order of yaw/pitch/roll, but which (x,y,z) axis those correspond to is different.

Constructors

SpatialDirection(double x, double y, double z)

Properties

hashCode int
The hash code for this object.
read-onlyinherited
runtimeType Type
A representation of the runtime type of the object.
read-onlyinherited
x double
The Euler rotation about the x-axis, in degrees.
read / write
y double
The Euler rotation about the y-axis, in degrees.
read / write
z double
The Euler rotation about the z-axis, in degrees.
read / write

Methods

noSuchMethod(Invocation invocation) → dynamic
Invoked when a non-existent method or property is accessed.
inherited
toJson() Map<String, Object?>
Returns a representation of this object as a JSON object.
toString() String
A string representation of this object.
inherited

Operators

operator ==(Object other) bool
The equality operator.
inherited