Defines 2D Graphics of tracks for a Multi-Track Object (MTO).
Track2d <MTOObjectPath> {TrackOption}
The Track2d command is used to set 2D Graphics attributes for specific tracks within a Multi-Track Object (MTO).
The following table describes the graphics option values for {TrackOption}. The table below this describes the Track2D RangeContours {TrackOption}.
| {TrackOption} | Description |
|---|---|
| Show <TrackNum> {On | Off} | Indicates if the track will be displayed. |
| ShowLabel <TrackNum> {On | Off} | Indicates if the track label will be displayed. |
| ShowMarker <TrackNum> {On | Off} | Indicates if the track marker will be displayed. |
| Color <TrackNum> {Color} | Indicates the color with which the track will be displayed. |
| MarkerColor <TrackNum> {Color} | Indicates the color with which the marker will be displayed. |
| MarkerStyle <TrackNum> {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 <TrackNum> {Color} | Indicates the color with which the line will be displayed. |
| LabelColor <TrackNum> {Color} | Indicates the color with which the label will be displayed. |
| LineWidth <TrackNum> <Width> | Indicates the width of the route line that will be displayed for the track. <Width> is a value between 1 and 10. |
| LineStyle <TrackNum> {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 <TrackNum> <Value> | Indicates the translucency of the route line that will be displayed for the track. <Value> is between 0.0 and 100.0 |
| UsePreFadetime <TrackNum> {On | Off} | Indicates if the track will be displayed for a duration ahead of its start time. |
| UsePostFadetime <TrackNum> {On | Off} | Indicates if the track will be displayed for a duration after its stop time. |
| PreFadetime <TrackNum> <Time> | Indicates the amount of time ahead of the start time that the track will be displayed. <Time> is entered in seconds. |
| PostFadetime <TrackNum> <Time> | Indicates the amount of time after the stop time that the track will be displayed. <Time> is entered in seconds. |
| UseDisplayTime <TrackNum> {On | Off} | Indicates whether lead and trail times will be set for the track. |
| LeadTime <TrackNum> {<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 <TrackNum> {<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. |
For valid {Color} options see Common Options.
This command allows you to define and modify range contours for the track specified. The format for this command is:
Track2d <MTOObjectPath> RangeContours <TrackNum> {RangeOptions} <Parameters>
The following table describes the {RangeOptions} <Parameters> available for the Track2D RangeContours command.
| {RangeOptions} | <Parameters> | Description |
|---|---|---|
| Show | {On | Off} | Display range contour graphics. |
| Explicit | <LevelValue> {Color} {LineStyle} {LineWidth} {ShowDistance} [{ShowText} ["<LabelText>" [<LabelAngle>]]] | Add individual range contour levels by
specifying the <LevelValue> 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.
<LevelValue> is entered in Connect distance units, and must be greater than 0.001. |
| 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. All values are entered in Connect distance units, <Step> must be greater than 0.0. |
| 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 issuing 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:
|
<LevelValue> and <Start> <Stop> <Step> values are entered in Connect distance units. Valid Range Contour levels have a value that is greater than 0.001. When entering levels via the StartStop option the command will not Nack if invalid levels are specified, but will only add valid levels.
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. |
The following command sets the label for track number 1 of the "mt1" object to display in the 2D Graphics window.
Track2d */MTO/mt1 showlabel 1 on
The following command sets the color of track number 2 of the "mt1" object to blue.
Track2d */MTO/mt1 color 2 blue
The following command sets the marker style of track number 1 to be a circle:
Track2d */MTO/mt1 MarkerStyle 1 Circle
The following command sets the marker style of track number 2 to be the image in the file TheChain.bmp:
Track2d */MTO/mt1 MarkerStyle 1 Custom "c:\MyTemp\TheChain.bmp"
To display the range contours for track number 2:
Track2D */MTO/MTO1 RangeContours 2 Show On
To define level values for range contours for track number 2:
Track2D */MTO/MTO1 RangeContours 2 StartStop 100000.0 300000.0 100000.0
To set the attributes for the level 100000.0 for track number 2:
Track2D */MTO/MTO1 RangeContours 2 Contour 100000.0 Color Green LineStyle 0 LineWidth 1 ShowDistance On
To add a level of 250000.0 to track number 2:
Track2D */MTO/MTO1 RangeContours 2 Explicit 250000.0 White 0 1 On On "White Level On"
This command belongs to the following group(s):
10.1
STK Programming Interface 11.0.1