Track3d

Defines 3D Graphics of tracks for a Multi-Track Object (MTO).

Syntax

Track3d <MTOObjectPath> {TrackOption}

Related Commands

• Track
• Track2d
• Defaulttrack
• Defaulttrack2d
• Defaulttrack3d
• VO MTOAttributes

Description

The Track3d command is used to set 3D Graphics attributes for specific tracks within a Multi-Track Object (MTO).

The following table describes the graphics option values for {TrackOption}. Following this are descriptions of the Track3D EphemDropLines, PosDropLine, RangeContours, BorderWall, and Articulation {TrackOption}.

Track3D EphemDropLines

This command allows you to display and set attributes for the ephemeris drop lines for the track specified. The format for this command is:

Track3d <MTOObjectPath> EphemDropLines <TrackNum> Type {WGS84 | Terrain | MSL} {EphemOptions} <Parameters>

• If Type is MSL, the line will drop from the vehicle to mean sea level.
• If Type is Terrain, the line will drop from the vehicle to terrain.
• If Type is WGS84, the line will drop from the vehicle to the central body's reference ellipsoid,

Note: A line may drop "up" if the track has negative altitude.

The following table describes the {EphemOptions} <Parameters> available for the Track3D EphemDropLines command.

Track3D PosDropLine

This command allows you to display and set attributes for the position drop line for the track specified. The format for this command is:

Track3d <MTOObjectPath> PosDropLine <TrackNum> Type {WGS84 | Terrain | MSL} {PosOptions} <Parameters>

• If Type is MSL, the line will drop from the vehicle to mean sea level.
• If Type is Terrain, the line will drop from the vehicle to terrain.
• If Type is WGS84, the line will drop from the vehicle to the central body's reference ellipsoid,

Note: A line may drop "up" if the vehicle has negative altitude.

The following table describes the {PosOptions} <Parameters> available for the Track3D PosDropLine command.

Track3D RangeContours

This command allows you to modify range contours for the track specified. The format for this command is:

Track3d <MTOObjectPath> RangeContours <TrackNum> {RangeOptions} <Parameters>

The following table describes the {RangeOptions} <Parameters> available for the Track3D RangeContours command.

Track3D BorderWall

This command allows you to define a border wall for range contour rings of the track specified. The format for this command is:

Track3d <MTOObjectPath> BorderWall <TrackNum> {WallOptions} <Parameters>

The following table describes the {WallOptions} <Parameters> available for the Track3D BorderWall command.

Track3D Articulations

This command allows you to define articulations for a model that the track is using. The track must have a model defined to use this command. The format for this command is:

Track3d <MTOObjectPath> {ArticulationKeyword} {<TrackNum> | *} {ArticulateOptions}

After the {ArticulationKeyword} enter the track number or enter * to indicate all tracks.

Since MTOs are meant to be dynamic, by default, the articulation files for the tracks will not be saved or loaded. There is a performance hit trying to load them by default. See the SaveArticFileOnSave and ReadArticFileOnLoad keywords below for save and load options.

The following table describes the {ArticulationKeywords} available, and the {ArticulateOptions} for each keyword.

Example

The following command enables swap distances for track number one of the "mt1" object and sets the viewable range for the marker to be between 0 and 2000 km.

Track3d */MTO/mt1 SwapDistance 1 Use On markeron 0 markeroff 2000

Fade out the trailing track behind MTO track 1:

Track3d */MTO/MTO1 TranslucentTrackTrail 1 On

The following command sets the label offset for track number two of the "mt1" object using the default (Cartesian) value set.

Track3d */MTO/mt1 Labeloffset 2 0 20 20

Show Points for track 3 of mt1, at a size of 7 pixels:

Track3d */MTO/mt1 Point 3 Show On Size 7

Show position drop line for the first track of the MTO:

Track3d */MTO/MTO1 PosDropLine 1 Type WGS84 Show On Color Default LineWidth 4

Show ephemeris drop lines for track 1:

Track3d */MTO/MTO1 EphemDropLines 1 Type MSL Show On Color Cyan Interval 30 Linewidth 2

Change attributes for ephemeris drop lines for track 1:

Track3d */MTO/MTO1 EphemDropLines 1 Type MSL Color Yellow Interval 130 Linewidth 1

Define a border wall on the second track of an MTO:

Track3D */MTO/MTO1 BorderWall 2 Show On TopAltRef WGS84 TopAltRefValue 200000 BottomAltRef WGS84 BottomAltRefValue 0 UseTranslucency Off

Add a Model to track 1 of an MTO, and set an articulation for the track:

Track3D */MTO/MTO1 Model 1 Show On File "C:\Users\stkUser\mtoArticsSave\scaling_sphere.mdl"

Track3D */MTO/MTO1 AddArticulation 1 ArticulationName SphereScale TransformationName ScaleX StartTime 60 Duration 600 StartValue 1.0 EndValue 10.0

Set the MTO to read the articulation files for all tracks on load:

Track3D */MTO/MTO1 ReadArticFileOnLoad * On

ReturnMessage

Group Membership

This command belongs to the following group(s):

MTO

Version

10.1

STK Programming Interface 11.0.1