Description | Example | Return Message | Group

DefaultTrack3d

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

Syntax

DefaultTrack3d <MTOObjectPath> {TrackOptions}

Related Commands

Description

The DefaultTrack3d command is used to set default 3D Graphics attributes for all new tracks within a Multi-Track Object (MTO).

{TrackOptions} Description
Show {On | Off} Indicates whether to show 3d graphics for the track.
UseLabelOffset {On | Off} Enable to specify the location of the track label relative to the track.
LabelOffsetInPixels {On | Off} Enable to define the offset by pixel values instead of the default (Cartesian).
LabelOffset <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 {On | Off} Enable to orient the model as an aircraft, or disable to orient the model as a surface vehicle.
DefaultAzimuth [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 ({Option} <Value>)... Specifies a model. Valid values for {Option} <Value> are:
  • Show <On | Off>. Indicates if a model will be used or not.
  • Filename "<FilePath>". Indicates the model file to use for the track.
  • Color {Normal | DefaultFromMarker}. Indicates the default color of the model. The Normal value is the default setting, and sets the default color to white. If this option is set to DefaultFromMarker, then the default color is the same as the marker color. Note: This option will only affect colorless models.
ScaleModel <ScaleFactor> Defines the absolute scale factor.
ScaleLog <ScaleFactor> Defines the model scale exponentially.
Marker {Options} Refer to the VO Marker command.
SwapDistance ({Option} <Value>)... Valid values for {Option} <Value> are:
  • Use {On | Off}. Enables the use of Swap Distances in the 3D Graphics window.
  • MarkerOn <Value>. Indicates the nearest distance at which the marker is visible in the 3D Graphics window.
  • MarkerOff <Value>. Indicates the furthest distance at which the marker is visible in the 3D Graphics window.
  • LabelOn <Value>. Indicates the nearest distance at which the Label is visible in the 3D Graphics window.
  • LabelOff <Value>. Indicates the furthest distance at which the Label is visible in the 3D Graphics window.
  • ModelOn <Value>. Indicates the nearest distance at which the Model is visible in the 3D Graphics window.
  • ModelOff <Value>. Indicates the furthest distance at which the Model is visible in the 3D Graphics window.
  • PointOn <Value>. Indicates the nearest distance at which the Point is visible in the 3D Graphics window.
  • PointOff <Value>. Indicates the furthest distance at which the Point is visible in the 3D Graphics window.
  • Assert ModelShowing. Restricts the setting of values to objects that are set to display models.
<Value> is entered in Connect Distance units. Multiple {Option} <Value> pairs can be entered in one command.
Point {Options} Set Point attributes. Valid values for {Options} are:
  • Show {On | Off}
  • Size <Value>

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 {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:
  • UseAttachPoint {On | Off}
  • AttachPoint "<Name>"
TranslucentTrackTrail {On | Off} Indicate whether the trailing track will fade out behind MTO tracks.
SaveArticFileOnSave {On | Off} Enter On to set the MTO to save articulation files when the MTO is saved. The default for this option is Off.
ReadArticFileOnLoad {On | Off} Enter On to set the MTO to read articulation files when the MTO is loaded. The default for this option is Off. Reading the articulation files for the tracks on load could effect performance.
EphemDropLines <Parameters> Define default values for ephemeris drop lines. See the section below for valid <Parameters> values.
PosDropLine <Parameters> Define default values for the position drop line. See the section below for valid <Parameters> values.
RangeContours <Parameters> Define default values for the range contours. See the section below for valid <Parameters> values.
BorderWall <Parameters> Define default values for the border walls for range contour rings. See the section below for valid <Parameters> values.

DefaultTrack3d EphemDropLines

This command allows you to define default values for ephemeris drop lines. The format for this command is:

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

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

The following table describes the {EphemOptions} <Parameters> available for the DefaultTrack3d 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.
Interval <Value> Indicate a time between drop lines. Value should be greater than 0, and is entered in seconds. Default value is 60 seconds.

DefaultTrack3d PosDropLine

This command allows you to define default values for the position drop line. The format for this command is:

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

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

The following table describes the {PosOptions} <Parameters> available for the DefaultTrack3d 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.

DefaultTrack3d RangeContours

This command allows you to define default values for range contours. The format for this command is:

DefaultTrack3d <MTOObjectPath> RangeContours {RangeOptions} <Parameters>

The following table describes the {RangeOptions} <Parameters> available for the DefaultTrack3d 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

DefaultTrack3d BorderWall

This command allows you to define default values for border walls for range contour rings. The format for this command is:

DefaultTrack3d <MTOObjectPath> BorderWall {WallOptions} <Parameters>

The following table describes the {WallOptions} <Parameters> available for the DefaultTrack3d 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.

  • Terrain - Reference the upper edge limit of the boundary wall at the altitude of the terrain.
  • MSL - Reference the upper edge limit of the boundary wall at mean sea level.
  • WGS84 or Ellipsoid - Reference the upper edge limit of the boundary wall at the altitude of the central body's reference ellipsoid. This is the default value.
  • Object - Reference the upper edge limit to the object's altitude.
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.

  • Terrain - Reference the lower edge limit of the boundary wall at the altitude of the terrain.
  • MSL - Reference the lower edge limit of the boundary wall at mean sea level.
  • WGS84 or Ellipsoid - Reference the lower edge limit of the boundary wall at the altitude of the central body's reference ellipsoid. This is the default value.
  • Object - Reference the lower edge limit to the object's altitude.
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.

Example

The following command sets the tracks to be shown, by default.

DefaultTrack3d */MTO/mt1 Show On

The following command enables swap distances for tracks in the "mt1" object and sets the viewable range for the marker to be between 0 and 2000 km.

DefaultTrack3d */MTO/mt1 SwapDistance Use On markeron 0 markeroff 2000

The following command sets the label offset for tracks in the "mt1" object using the default (Cartesian) value set.

DefaultTrack3d */MTO/mt1 Labeloffset 0 20 20

Set default to show Points, at a size of 7 pixels:

DefaultTrack3d */MTO/mt1 Point Show On Size 7

Set default swap distances for Points:

DefaultTrack3d */MTO/mt1 SwapDistance Use On PointOn 24000000 PointOff 48000000

Set default values for position drop line:

DefaultTrack3d */MTO/MTO1 PosDropLine Type MSL Show On Color Default LineWidth 4

Set default values for ephemeris drop lines:

DefaultTrack3d */MTO/MTO1 EphemDropLines Type WGS84 Show On Color Cyan Interval 30 Linewidth 2

Set default values for border walls:

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

ReturnMessage

Connect returns an acknowledgment message.

Group Membership

This command belongs to the following group(s):

MTO

Version

10.1

STK Programming Interface 11.0.1