DashboardItemGlobeLocation

Inherits DashboardItem

This DashboardItem shows the longitude/latitude location of the camera and its distance to the current focus node. If the current focus node is Earth, these are provided in the WGS84 reference frame; if the focus is on another planetary body, it is in the native coordinate frame for that planetary body. If the current focus node is not a planetary body, a position of (0,0) with a distance of 0 will be displayed.

Members

Name

Documentation

Type

Description

Optional

DisplayFormat

Choosing the format in which the camera location is displayed.

String

In list { DecimalDegrees, DegreeMinuteSeconds }

Yes

FontName

This value is the name of the font that is used. It can either refer to an internal name registered previously, or it can refer to a path that is used.

String

Value of type ‘String’

Yes

FontSize

This value determines the size of the font that is used to render the distance.

Double

Value of type ‘Double’

Yes

SignificantDigits

Determines the number of significant digits that are shown in the location text.

Integer

Value of type ‘Integer’

Yes

Inherited members from DashboardItem

Name

Documentation

Type

Description

Optional

Identifier

The unique identifier for this DashboardItem.

Identifier

An identifier string. May not contain ‘.’, spaces, newlines, or tabs

No

Type

Determines the type of the DashbordItem that should be created.

String

Value of type ‘String’

No

Enabled

If this value is set to ‘true’ this dashboard item is shown in the dashboard. Otherwise it will be hidden.

Boolean

Value of type ‘Boolean’

Yes

GuiName

The name for the DashboardItem that is used when showing it in the user interface.

String

Value of type ‘String’

Yes

Asset Examples

Degree/Minute/Seconds

This example adds a dashboard item that shows the position of the camera relative to the focus node, if that focus node is a globe. The longitude and latitude of the camera is provided in the sexagesimal system (degrees, minutes, seconds).

 1local Item = {
 2  Identifier = "DashboardItemGlobeLocation_Example",
 3  Type = "DashboardItemGlobeLocation",
 4  DisplayFormat = "DegreeMinuteSeconds"
 5}
 6
 7asset.onInitialize(function()
 8  openspace.dashboard.addDashboardItem(Item)
 9end)
10
11asset.onDeinitialize(function()
12  openspace.dashboard.removeDashboardItem(Item)
13end)
Basic

This example adds a dashboard item that shows the position of the camera relative to the focus node, if that focus node is a globe.

 1local Item = {
 2  Identifier = "DashboardItemGlobeLocation_Example",
 3  Type = "DashboardItemGlobeLocation"
 4}
 5
 6asset.onInitialize(function()
 7  openspace.dashboard.addDashboardItem(Item)
 8end)
 9
10asset.onDeinitialize(function()
11  openspace.dashboard.removeDashboardItem(Item)
12end)