RenderableTrailTrajectory

Inherits Renderable

Members

Name

Documentation

Type

Description

Optional

Color

This value determines the RGB main color for the lines and points of the trail.

Color3

Value of type ‘Color3’

No

EndTime

The end time for the range of this trajectory. The date must be in ISO 8601 format: YYYY MM DD HH:mm:ss.xxx.

String

A valid date in ISO 8601 format

No

StartTime

The start time for the range of this trajectory. The date must be in ISO 8601 format: YYYY MM DD HH:mm:ss.xxx.

String

A valid date in ISO 8601 format

No

Translation

A translation used to compute locations along the path.

Table

Translation

No

AccurateTrailPositions

The number of vertices, each side of the object, that will be recalculated for greater accuracy. This also ensures that the object connects with the trail.

Integer

Value of type ‘Integer’

Yes

DimInAtmosphere

Decides if the object should be dimmed (i.e. faded out) when the camera is in the sunny part of an atmosphere.

Boolean

Value of type ‘Boolean’

Yes

Enabled

Determines whether this object will be visible or not.

Boolean

Value of type ‘Boolean’

Yes

EnableFade

Toggles whether the trail should fade older points out. If this value is true, the ‘Fade’ parameter determines the speed of fading. If this value is false, the entire trail is rendered at full opacity and color.

Boolean

Value of type ‘Boolean’

Yes

LineFadeAmount

The amount of the trail that should be faded. If the value is 0 then the trail will have no fading applied. A value of 0.6 will result in a trail where 60% of the extent of the trail will have fading applied to it. In other words, the 40% closest to the head of the trail will be solid and the rest will fade until completely transparent at the end of the trail. A value of 1 will result in a trail that starts fading immediately, becoming fully transparent by the end of the trail.This setting only applies if the ‘EnableFade’ value is true. If it is false, this setting has no effect.

Double

In range: ( 0, 1)

Yes

LineLength

The extent of the rendered trail. A value of 0 will result in no trail and a value of 1 will result in a trail that covers the entire extent. The setting only applies if ‘EnableFade’ is true. If it is false, this setting has no effect.

Double

In range: ( 0, 1)

Yes

LineWidth

Specifies the line width of the trail lines, if the selected rendering method includes lines. If the rendering mode is Points, this value is ignored.

Double

Greater or equal to: 0

Yes

Opacity

This value determines the opacity of this renderable. A value of 0 means completely transparent.

Double

In range: ( 0, 1)

Yes

PointSize

Specifies the base size of the points along the line, if the selected rendering method includes points. If the rendering mode is Lines, this value is ignored. If a subsampling of the values is performed, the subsampled values are half this size.

Integer

Greater or equal to: 0

Yes

RenderBinMode

A value that specifies if the renderable should be rendered in the Background, Opaque, Pre-/PostDeferredTransparency, Overlay, or Sticker rendering step.

String

In list { Background, Opaque, PreDeferredTransparent, Overlay, PostDeferredTransparent, Sticker }

Yes

Rendering

Determines how the trail should be rendered. If ‘Lines’ is selected, only the line part is visible, if ‘Points’ is selected, only the corresponding points (and subpoints) are shown. ‘Lines+Points’ shows both parts.

String

In list { Lines, Points, Lines+Points, Lines+Points }

Yes

SampleInterval

The interval between samples of the trajectory. This value (together with ‘TimeStampSubsampleFactor’) determines how far apart (in seconds) the samples are spaced along the trajectory. The final interval is calculated as SampleInterval/TimeStampSubsampleFactor. If SampleInterval is not specified, it will be automatically calculated to produce two samples per day between the ‘StartTime’ and ‘EndTime’.

Double

Value of type ‘Double’

Yes

ShowFullTrail

If true, the entire trail will be rendered. If false, only the trail until the current time in the application will be shown.

Boolean

Value of type ‘Boolean’

Yes

Tag

A single tag or a list of tags that this renderable will respond to when setting properties.

Table, or String

Value of type ‘Table’, or Value of type ‘String’

Yes

TimeStampSubsampleFactor

The factor that is used to create subsamples along the trajectory. This value (together with ‘SampleInterval’) determines how far apart (in seconds) the samples are spaced along the trajectory. Subsamples are rendered as smaller points compared to normal samples (from ‘SampleInterval’) when rendering the trail as points. The final interval is calculated as SampleInterval/TimeStampSubsampleFactor.

Integer

Greater than: 0

Yes

Type

The type of the renderable.

String

Value of type ‘String’

Yes

UseAccurateTrail

If true, the trail around the spacecraft will be recalculated to present a smoother trail. If false, the original trail will be used.

Boolean

Value of type ‘Boolean’

Yes

Inherited members from Renderable

Name

Documentation

Type

Description

Optional

DimInAtmosphere

Decides if the object should be dimmed (i.e. faded out) when the camera is in the sunny part of an atmosphere.

Boolean

Value of type ‘Boolean’

Yes

Enabled

Determines whether this object will be visible or not.

Boolean

Value of type ‘Boolean’

Yes

Opacity

This value determines the opacity of this renderable. A value of 0 means completely transparent.

Double

In range: ( 0, 1)

Yes

RenderBinMode

A value that specifies if the renderable should be rendered in the Background, Opaque, Pre-/PostDeferredTransparency, Overlay, or Sticker rendering step.

String

In list { Background, Opaque, PreDeferredTransparent, Overlay, PostDeferredTransparent, Sticker }

Yes

Tag

A single tag or a list of tags that this renderable will respond to when setting properties.

Table, or String

Value of type ‘Table’, or Value of type ‘String’

Yes

Type

The type of the renderable.

String

Value of type ‘String’

Yes

Asset Examples

 1local transforms = asset.require("./transforms")
 2local kernels = asset.require("./kernels")
 3
 4
 5
 6local TrailAtPluto = {
 7  Identifier = "NewHorizonsTrailPluto",
 8  Parent = transforms.PlutoBarycenterAccurate.Identifier,
 9  Renderable = {
10    Type = "RenderableTrailTrajectory",
11    Translation = {
12      Type = "SpiceTranslation",
13      Target = kernels.ID.NewHorizons,
14      Observer = kernels.ID.PlutoBarycenter
15    },
16    Color = { 1.0, 0.8, 0.4 },
17    ShowFullTrail = true,
18    StartTime = "2015 JUL 07 12:00:00",
19    EndTime = "2015 JUL 17 12:00:00",
20    PointSize = 5,
21    SampleInterval = 100,
22    TimeStampSubsampleFactor = 4,
23    EnableFade = false,
24    Rendering = "Lines+Points"
25  },
26  GUI = {
27    Name = "New Horizons Trail Pluto",
28    Path = "/Solar System/Missions/New Horizons",
29    Focusable = false
30  }
31}
32
33
34asset.onInitialize(function()
35  openspace.addSceneGraphNode(TrailAtPluto)
36end)
37
38asset.onDeinitialize(function()
39  openspace.removeSceneGraphNode(TrailAtPluto)
40end)
41
42asset.export(TrailAtPluto)