Description | Example | Return Message | Group

DefaultTrack2d

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

Syntax

DefaultTrack2d <MTOObjectPath> {TrackOptions}

Related Commands

Description

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

{TrackOptions} Description
Show {On | Off} Indicates if the track will be displayed.
ShowLine {On | Off} Indicates if the track line will be displayed.
ShowLabel {On | Off} Indicates if the track label will be displayed.
ShowMarker {On | Off} Indicates if the track marker will be displayed.
Color {Color} Indicates the color with which the track will be displayed. For valid color options see Common Options.
MarkerColor {Color} Indicates the color with which the marker will be displayed.
MarkerStyle {MarkerOptions} Indicates the marker style to use for the track marker. See Connect help for the Graphics Marker command for a description of {MarkerOptions}.
LineColor {Color} Indicates the color with which the line will be displayed.
LabelColor {Color} Indicates the color with which the label will be displayed.
LineWidth <Width> Indicates the width of the route line that will be displayed for the track. <Width> is a value between 1 and 10.
LineStyle {Style} Indicates the style of the route line that will be displayed for the track. {Style} can be a name such as Solid, Dashed, Dotted, etc, or a number 0, 1, 2, etc. For all valid {Style} options see Common Options.
LineTranslucency <Value> Indicates the translucency of the route line that will be displayed for the track. <Value> is between 0.0 and 100.0
UsePreFadetime {On | Off} Indicates if the track will be displayed for a duration ahead of its start time.
UsePostFadetime {On | Off} Indicates if the track will be displayed for a duration after its stop time.
PreFadetime <Time> Indicates the amount of time ahead of the start time that the track will be displayed. <Time> is entered in seconds.
PostFadetime <Time> Indicates the amount of time after the stop time that the track will be displayed. <Time> is entered in seconds.
UseDisplayTime {On | Off} Indicates whether lead and trail times will be set for the track.
LeadTime {<Time> | All | None} Indicates the amount of the track's route that will be displayed ahead of the track's location. <Time> is entered in seconds.
TrailTime {<Time> | All | None} Indicates the amount of the track's route that will be displayed behind the track's location. <Time> is entered in seconds.
RangeContours {RangeOptions} <Parameters> Define default values for range contours. See the table below for valid {RangeOptions} <Parameters> values.

For valid {Color} options see Common Options.

DefaultTrack2d RangeContours

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

DefaultTrack2d <MTOObjectPath> RangeContours {RangeOptions} <Parameters>

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

{RangeOptions} <Parameters> Description
Show {On | Off} Display range contour graphics.
Explicit <LevelValue> {Color} {LineStyle} {LineWidth} {ShowDistance} [{ShowText} ["<LabelText>" [<LabelAngle>]]] Define individual range contour levels by specifying its <LevelValue>, entered in Connect distance units, and display attributes. Valid values for {ShowDistance} and {ShowText} are On, Off. <LabelAngle> is entered in degrees. For valid {Color} and {LineStyle} options see Common Options.
Contour <LevelValue> {Keyword} <Value> [{Keyword} <Value>...] Change the attributes of the <LevelValue> specified. {Keyword} <Value> pairs are described in the table below.
StartStop <Start> <Stop> <Step> Generate contours beginning with the Start value and incrementing by the Step value until the Stop value is exceeded. <Start> <Stop> and <Step>is entered in Connect distance units.
Remove <LevelValue> Remove the contour representing the <LevelValue> specified.

Note: If the specified level is not found, the command will Ack, and do nothing.

RemoveAll N/A Remove all contours.
LabelAngle <Angle> Sets the LabelAngle for all existing contours. This defines where, along the contour, the text and/or distance is displayed. <Angle> can be 0 to 359 degrees, clockwise. The default is 180 degrees or the 6:00 o'clock position.

Note: Contours inserted after calling this command will still have the default LabelAngle of 180.

Fill {On | Off} [{FillStyle}] If On is entered then display the range contours as a filled polygon on the surface of the central body. The {FillStyle} can be one of: Solid, VerticalStripe, HorizontalStripe, DiagonalStripe1, DiagonalStripe2, Hatch, DiagonalHatch, Screen. The {FillStyle} value can only be entered if On is also entered.
DecimalPlaces <Value> Sets the number of decimal places for displaying the level values. <Value> can be 0 to 14. The default is 3.
LabelUnits {UnitType} Indicate the units to use for displaying the level values. Valid values for {UnitType} are:
  • Inches | IN
  • Centimeters | CM
  • Millimeters | MM
  • Microns | UM
  • Nanometers | NAM
  • Feet | FT
  • Kilofeet
  • Meter | M
  • NauticalMile | NM
  • Kilometer | KM
  • StatuteMile | SM
  • Astronomical | AU
  • EarthRADII | RE

The following table describes the {Keyword} <Value> pairs for the Contour {RangeOptions}

{Keyword} <Value> Description
Color {Color} Set the color of the contour. For valid {Color} options see Common Options.
LineStyle {LineStyle} {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.
LineWidth <Width> Indicate a pixel width value between 1.0 - 10.0
ShowDistance {On | Off} Show or Hide the contour's distance.
ShowText {On | Off} Show or hide the contour's user defined text.
Text "<Text>" Set the contour's user defined text.
LabelAngle <Angle> Define where, along the contour, the text and/or distance is displayed. <Angle> can be 0 to 359 degrees, clockwise. The default is 180 degrees or the 6:00 o'clock position.

Example

The following command sets the label for all new tracks of the "mt1" object to display in the 2D Graphics window.

DefaultTrack2d */MTO/mt1 showlabel on

The following command sets the color of all new tracks of the "mt1" object to blue.

DefaultTrack2d */MTO/mt1 color blue

The following command sets the marker style of the default track to be a square:

DefaultTrack2d */MTO/mt1 MarkerStyle Square

Set the decimal places and units for range contours of the default track:

DefaultTrack2d */MTO/mt1 RangeContours DecimalPlaces 4

DefaultTrack2d */MTO/mt1 RangeContours LabelUnits Inches

ReturnMessage

Connect returns an acknowledgment message.

Group Membership

This command belongs to the following group(s):

2D Object Graphics

MTO

Version

10.1

STK Programming Interface 11.0.1