LuaRotation

Inherits Rotation

Members

Name	Documentation	Type	Description	Optional
Script	This value is the path to the Lua script that will be executed to compute the rotation for this transformation. The script needs to define a function ‘rotation’ that takes the current simulation time in seconds past the J2000 epoch as the first argument, the simulation time in seconds past the J2000 epoch of the last frame as the second argument, and the current wall time as milliseconds past the J2000 epoch as the third argument. It computes the rotation value factors returned as a table containing the 9 values that make up the resulting rotation matrix.	File	Value of type ‘File’	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

Asset Examples

Basic

This asset creates a SceneGraphNode that only displays coordinate axes. The rotation of coordinate axes are determined by executing a Lua file that returns the rotation matrix to be used.

The script file that is used in this example

-- The `rotation` function takes exactly three arguments and returns the 9 values that
-- make up the final rotation matrix as a table.
-- The three parameters are all provided as the number of seconds past the J2000 epoch
-- (2000-01-01 12:00:00), which can be both fractional numbers as well as negative numbers
-- for dates earlier than the epoch.
--  1. `simulationTime` is the value of the in-game clock for the current frame
--  2. `prevSimulationTime` is the value of the in-game clock for the previous frame
--  3. `wallTime` is the value of the computer clock as seconds past the epoch
function rotation(simulationTime, prevSimulationTime, wallTime)
  -- Create a rotation around the x axis
  return {
    1,                        0,                         0,
    0, math.cos(simulationTime), -math.sin(simulationTime),
    0, math.sin(simulationTime),  math.cos(simulationTime)
  }
end

local Node = {
  Identifier = "LuaRotation_Example",
  Transform = {
    Rotation = {
      Type = "LuaRotation",
      Script = asset.resource("example.lua")
    }
  },
  Renderable = {
    Type = "RenderableCartesianAxes"
  },
  GUI = {
    Name = "LuaRotation - Basic",
    Path = "/Examples"
  }
}

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

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