TimelineTranslation

Inherits Translation

This Translation uses a timeline of other Translation classes to calculate the final translation for the attached scene graph node. The current in-game time is used to determine which specific keyframe to currently use. It is also possible to disable the interpolation between two adjacent keyframes by setting the ShouldInterpolate parameter to false.

Members

Name	Documentation	Type	Description	Optional
Keyframes	A table of keyframes, with keys formatted as YYYY-MM-DDTHH:MM:SS and values that are valid Translation objects	Table	Table parameters	No
ShouldInterpolate	If this value is set to ‘true’, an interpolation is applied between the given keyframes. If this value is set to ‘false’, the interpolation is not applied.	Boolean	Value of type ‘Boolean’	Yes

Inherited members from Translation

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

Table parameters for Keyframes

A table of keyframes, with keys formatted as YYYY-MM-DDTHH:MM:SS and values that are valid Translation objects

• Optional: No

Name	Documentation	Type	Description	Optional
*		Table	Translation	No

Asset Examples

Basic

This asset creates a scene graph node that only displays coordinate axes whose translation of the coordinate axes is determined by a timeline of individual translations. These translations are provided as keyframes that interpolate seamlessly between different positions.

This example will only work if the in-game time is set to January 1st, 2000.

local Node = {
  Identifier = "TimelineTranslation_Example",
  Transform = {
    Translation = {
      Type = "TimelineTranslation",
      Keyframes = {
        -- The first timeline entry
        ["2000 JAN 01 00:00:00"] = {
          Type = "StaticTranslation",
          Position = { -10.0, 0.0, 0.0 }
        },
        -- The second timeline entry
        ["2000 JAN 01 12:00:00"] = {
          Type = "StaticTranslation",
          Position = { 0.0, 0.0, 0.0 }
        },
        -- The third timeline entry
        ["2000 JAN 01 23:59:59"] = {
          Type = "StaticTranslation",
          Position = { 10.0, 0.0, 0.0 }
        }
      }
    }
  },
  Renderable = {
    Type = "RenderableCartesianAxes"
  },
  GUI = {
    Name = "TimelineTranslation - Basic",
    Path = "/Examples"
  }
}

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

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

No Interpolation

This asset creates a scene graph node that only displays coordinate axes whose translation of the coordinate axes is determined by a timeline of individual translations that are used without interpolating between the timeline entries. These translations are keyframes that are used to change between different positions.

This example transitions between three positions. In this example, the interpolation between entries is disabled, which will cause the coordinate axes to change their position abruptly when the translation changes. If the interpolation were enabled, the orientation of the coordinate axes would transition seamlessly instead at the provided times.

This example will only work if the in-game time is set to January 1st, 2000.

local Node = {
  Identifier = "TimelineTranslation_Example_NoInterpolation",
  Transform = {
    Translation = {
      Type = "TimelineTranslation",
      Keyframes = {
        -- The first timeline entry
        ["2000 JAN 01 00:00:00"] = {
          Type = "StaticTranslation",
          Position = { -10.0, 0.0, 0.0 }
        },
        -- The second timeline entry
        ["2000 JAN 01 12:00:00"] = {
          Type = "StaticTranslation",
          Position = { 0.0, 0.0, 0.0 }
        },
        -- The third timeline entry
        ["2000 JAN 01 23:59:59"] = {
          Type = "StaticTranslation",
          Position = { 10.0, 0.0, 0.0 }
        }
      },
      ShouldInterpolate = false
    }
  },
  Renderable = {
    Type = "RenderableCartesianAxes"
  },
  GUI = {
    Name = "TimelineTranslation - No Interpolation",
    Path = "/Examples"
  }
}

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

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