StaticRotation

Inherits Rotation

A StaticRotation is using a fixed and constant rotation factor that does not change over time. The rotation value is provided as a property that can be changed at runtime, but it will not change automatically over time.

Members

Name	Documentation	Type	Description	Optional
Rotation	Stores the static rotation as a vector containing Euler angles, a quaternion representation, or a rotation matrix. For the Euler angles, the values have to be provided in radians. To convert degres to radians, you can use the math.rad function. For the Quaternion representation, the values have to be provided in the order (w, x, y, z). For the matrix form, the provided matrix will be converted into Euler angles, an operation which might fail if the matrix is not a true rotation matrix. The values are assumed to be in row-major order.	Vector3<double>, Vector4<double>, or Matrix3x3<double>	Value of type ‘Vector3’, Value of type ‘Vector4’, or Value of type ‘Matrix3x3’	No

Inherited members from Rotation

Name	Documentation	Type	Description	Optional
Type	The type of the rotation that is described in this element. The available types of rotations depend on the configuration of the application and can be written to disk on application startup into the FactoryDocumentation	String	Must name a valid Rotation type	No
TimeFrame	The time frame in which this Rotation is applied. If the in-game time is outside this range, no rotation will be applied.	Table	TimeFrame	Yes

Asset Examples

Matrix

This asset creates a scene graph node that only displays coordinate axes. The rotation of the coordinate axes are determined by a constant and unchanging static rotation that is provided by a 3-by-3 rotation matrix in column-major order.

local Node = {
  Identifier = "StaticRotation_Example_Matrix",
  Transform = {
    Rotation = {
      Type = "StaticRotation",
      Rotation = {
        -0.9999987, -0.0015927, 0.0000000,
         0.0015927, -0.9999987, 0.0000000,
         0.0000000,  0.0000000, 1.0000000
      }
    }
  },
  Renderable = {
    Type = "RenderableCartesianAxes"
  },
  GUI = {
    Name = "StaticRotation - Matrix",
    Path = "/Examples"
  }
}

asset.onInitialize(function()
  openspace.addSceneGraphNode(Node)
end)

asset.onDeinitialize(function()
  openspace.removeSceneGraphNode(Node)
end)

Time Frame

This asset creates a rotation that is only applied between 2000 JAN 01 and just prior to 2002 JAN 01. The rotation of the coordinate axes shown by this scene graph node are determined by a constant and unchanging static rotation.

local Node = {
  Identifier = "StaticRotation_Example_TimeFrame",
  Transform = {
    Rotation = {
      Type = "StaticRotation",
      Rotation = { math.pi / 2.0, 0.0, math.pi },
      TimeFrame = {
        Type = "TimeFrameInterval",
        Start = "2000 JAN 01",
        End = "2002 JAN 01"
      }
    }
  },
  Renderable = {
    Type = "RenderableCartesianAxes"
  },
  GUI = {
    Name = "StaticRotation - Time Frame",
    Path = "/Examples"
  }
}

asset.onInitialize(function()
  openspace.addSceneGraphNode(Node)
end)

asset.onDeinitialize(function()
  openspace.removeSceneGraphNode(Node)
end)

Quaternion

This asset creates a scene graph node that only displays coordinate axes. The rotation of the coordinate axes are determined by a constant and unchanging static rotation that is provided by a four-dimensional quaternion.

local Node = {
  Identifier = "StaticRotation_Example_Quaternion",
  Transform = {
    Rotation = {
      Type = "StaticRotation",
      Rotation = { 0.4873552, -0.4869268, -0.5127203, 0.5123526 }
    }
  },
  Renderable = {
    Type = "RenderableCartesianAxes"
  },
  GUI = {
    Name = "StaticRotation - Quaternion",
    Path = "/Examples"
  }
}

asset.onInitialize(function()
  openspace.addSceneGraphNode(Node)
end)

asset.onDeinitialize(function()
  openspace.removeSceneGraphNode(Node)
end)

Euler Angles

This asset creates a rotation provided by Euler angles and applies it to a scene graph node that only displays coordinate axes. The rotation of the coordinate axes are determined by a constant and unchanging static rotation.

local Node = {
  Identifier = "StaticRotation_Example_Euler",
  Transform = {
    Rotation = {
      Type = "StaticRotation",
      Rotation = { math.pi / 2.0, 0.0, math.pi }
    }
  },
  Renderable = {
    Type = "RenderableCartesianAxes"
  },
  GUI = {
    Name = "StaticRotation - Euler Angles",
    Path = "/Examples"
  }
}

asset.onInitialize(function()
  openspace.addSceneGraphNode(Node)
end)

asset.onDeinitialize(function()
  openspace.removeSceneGraphNode(Node)
end)