Track3d
Defines 3D Graphics of tracks for a Multi-Track Object (MTO).
Syntax
Track3d <MTOObjectPath> {TrackOption}
Related commands
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}.
{TrackOption} | Description |
---|---|
Show <TrackNum> {On | Off} | Indicates if the track will be displayed. TrackNum refers to a specific id of a track within the MTO object. An asterisk (*) represents all tracks within an MTO object if you want to apply a setting globabally rather than to one individual track. |
Marker <TrackNum> {Options} | Refer to the VO Marker command. |
UseLabelOffset <TrackNum> {On | Off} | Enable to specify the location of the track label relative to the track. |
LabelOffsetInPixels <TrackNum> {On | Off} | Enable to define the offset by pixel values instead of the default (Cartesian). |
LabelOffset <TrackNum> <X> <Y> [<Z>] | Defines the position of the track label relative to the track. If the label offset is defined by Cartesian values, then <Z> is required and <X> <Y> and <Z> values are input in meters. |
ZAxisTowardsNadir <TrackNum> {On | Off} | Enable to orient the model as an aircraft, or disable to orient the model as a surface vehicle. |
DefaultAzimuth <TrackNum> [Angle <Angle>] [UseOnLast {On | Off}] | Specify the initial bearing of the model, relative to north.
Angle <Angle> - Specify the angle in degrees from -360 to 360. UseOnLast {On | Off} - Sets the model to use the default azimuth when it is at the last waypoint. |
Model <TrackNum> ({Option} <Value>)... | Specifies a model. Valid values for {Option} <Value> are:
"<FilePath>" can be the path to a file on your local drive or the path to a file on an SDF server. See Specifying Paths for "<SDFFilePath>" syntax information. |
ScaleModel <TrackNum> <ScaleFactor> | Defines the absolute scale factor. |
ScaleLog <TrackNum> <ScaleFactor> | Defines the model scale exponentially. |
SwapDistance <TrackNum> ({Option} <Value>)... |
Valid values for {Option} <Value> are:
|
Point <TrackNum> {Options} | Set Point attributes. Valid values for {Options} are:
The Show option defaults to Off. The Size option sets the diameter in pixels. Value must be greater than 0.0. Default is 5.0. |
ObjectLineAttachPt <TrackNum> {Options} | Use the ObjectLineAttachPt option to set an ObjectLine to be attached to a specific point on the MTO track's model. Use the VO ObjectLine command to define object lines. Valid values for {Options} are:
|
TranslucentTrackTrail <TrackNum> {On | Off} | Indicate whether the trailing track will fade out behind an MTO track. |
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,
A line may drop "up" if the track has negative altitude.
The following table describes the {EphemOptions} <Parameters> available for the Track3D EphemDropLines command.
{EphemOptions} <Parameters> | Description |
---|---|
Show {On | Off} | Hides or shows the ephemeris drop lines. |
Color {{Color} | Default} | Set the color of the drop lines. If you specify Default, then the object color is used. For valid {Color} options see Common Options. |
LineWidth <LineWidth> | Indicate a pixel width value between 1.0 and 10.0. |
LineStyle {LineStyle} | Set the line style for the line. {LineStyle} can be a name such as Solid, Dashed, Dotted, etc, or a number 0, 1, 2, etc. For all valid {LineStyle} options see Common Options. |
Interval <Value> | Indicate a time between drop lines. Value should be greater than 0, and is entered in seconds. Default value is 60 seconds. |
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,
A line may drop "up" if the vehicle has negative altitude.
The following table describes the {PosOptions} <Parameters> available for the Track3D PosDropLine command.
{PosOptions} <Parameters> | Description |
---|---|
Show {On | Off} | Hides or shows the position drop lines. |
Color {{Color} | Default} | Set the color of the drop lines. If you specify Default, then the object color is used. For valid {Color} options see Common Options. |
LineWidth <LineWidth> | Indicate a pixel width value between 1.0 and 10.0. |
LineStyle {LineStyle} | Set the line style for the line. {LineStyle} can be a name such as Solid, Dashed, Dotted, etc, or a number 0, 1, 2, etc. For all valid {LineStyle} options see Common Options. |
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.
{RangeOptions} <Parameters> | Description |
---|---|
Show {On | Off} | Hides or shows the range contours. |
TranslucentLines {On | Off} | Turns on or off line translucency for the range contours. |
Translucency <Value> | Set the line translucency for range contours, <Value> is between 0.0 and 100.0 |
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.
{BorderWallOption} <Value> | Description |
---|---|
Show {On | Off} | Displays or hides the boundary for the range contour as a wall that extends from the lower edge altitude to the upper edge altitude. |
UseTranslucency {On | Off} | Turns on or off translucency for the BorderWall. |
Translucency <Value> | Translucency sets the amount of light to pass through an object but diffusing it so that objects aren't clearly visible. <Value> ranges from 0 (opaque) to 100 (completely transparent). The default value is 70. |
UseLineTranslucency {On | Off} | Turns on or off line translucency for the BorderWall. |
LineTranslucency <Value> | LineTranslucency sets the amount of light to pass through lines. <Value> ranges from 0 (opaque) to 100 (completely transparent). The default value is 70. |
TopAltRef {RefOption} | If Central Body is Earth then the valid values for {RefOption} are: Terrain, MSL, WGS84, Object. If Central Body is not Earth then the valid values for {RefOption} are: Terrain, Ellipsoid, Object.
|
TopAltRefValue <Value> | Specify the altitude of the upper edge limit of the boundary wall. Valid values are -10000000.0 (-1e+007) through 10000000000.0 (1e+010). The default value is 0. |
BottomAltRef {RefOption} | If Central Body is Earth then the valid values for {RefOption} are: Terrain, MSL, WGS84, Object. If Central Body is not Earth then the valid values for {RefOption} are: Terrain, Ellipsoid, Object.
|
BottomAltRefValue <Value> | Specify the altitude of the lower edge limit of the boundary wall. Valid values are -10000000.0 (-1e+007) through 10000000000.0 (1e+010). The default value is 0. |
SampleRate <Value> | This value must be greater than 0.0. The default value is 2. |
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.
{ArticulationKeyword} | Description | ||||
---|---|---|---|---|---|
AddArticulation | Define the movement for movable parts on the selected model. The articulations perform dynamic transformations on the primitives in a model. For {ArticulateOptions} values see the VO AddArticulation command. | ||||
PruneArtic | Control the amount of data being kept by the system for an articulation when receiving it via Connect. The following {ArticulateOptions} are available:
| ||||
ArticulationFile | Enter "<Filepath>" which specifies the absolute path of an articulation file to use for loading 3D model articulations, for the specified track. | ||||
ReloadArticFile | Reload the appropriate articulation file for an object's model. The model articulation file contains a time-ordered list of data about each articulation that can be applied to the associated object. For MTO a valid articulation file name has the format <MTOName>_<TrackNum>.mtoma, for example MTO1_2.mtoma | ||||
SaveArticFileOnSave | Enter On or Off to set the MTO to save or not save articulation files when the MTO is saved. | ||||
ReadArticFileOnLoad | Enter On or Off to set the MTO to read or not read the articulation file on load of the MTO object. |
Examples
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.
Fade out the trailing track behind MTO track 1:
The following command sets the label offset for track number two of the "mt1" object using the default (Cartesian) value set.
Show Points for track 3 of mt1, at a size of 7 pixels:
Show position drop line for the first track of the MTO:
Show ephemeris drop lines for track 1:
Change attributes for ephemeris drop lines for track 1:
Define a border wall on the second track of an MTO:
Add a Model to track 1 of an MTO, and set an articulation for the track:
Set the MTO to read the articulation files for all tracks on load:
Set Satellite1.sama as the articulation file for track 2 of MTO1:
Return message
Connect returns an acknowledgement message.Group membership
This command belongs to the following group(s):
Version
11.6