Graphics ObjectLine
Display lines connecting objects in the 2D Graphics window
Syntax
Graphics <ScenarioPath> ObjectLine {Action} FromObj <TruncObjectPath1> ToObj <TruncObjectPath2> [{LineOptions}]
Description
The Graphics ObjectLine command enables you to display lines connecting objects in the 2D Graphics window. Indicate the object from which the line should start and the object to which the line should point using the truncated object paths of the objects. Use the {Action} options and their associated {LineOptions} to define the display of the lines in the 2D Graphics window.
Valid values for {Action} are described in the following table.
| {Action} | Description |
|---|---|
| Add | Have the 2D Graphics window display a line between the objects specified using <TruncObjectPath1> and <TruncObjectPath2>. |
| Modify | Modify the attributes of the line between the objects specified using <TruncObjectPath1> and <TruncObjectPath2>. If there is currently no line connecting the specified objects, Connect will return a NACK. |
| Delete | Remove the line between the objects specified using <TruncObjectPath1> and <TruncObjectPath2>. If there is currently no line connecting the specified objects, Connect will return a NACK. |
| DeleteAll | Remove all lines between objects.
Do not enter other parameters when using DeleteAll, except the optional WindowID <WinNumber> option. |
For any {Action}, use the following {LineOptions} to define or delete the lines connecting objects in the 2D Graphics window.
| {LineOption} | Description |
|---|---|
| WindowID <WinNumber> | Indicate the 2D Graphics window within which you would like the action to take place. If you do not specify this option, STK will apply all actions to lines in the first 2D Graphics window. |
If {Action} is Add or Modify, use the following {LineOptions} to define the display of the lines connecting objects in the 2D Graphics window.
| {LineOption} | Description |
|---|---|
| Show {On | Off|} | Setting Show to Off hides an individual line between the specified objects. |
| Color {Color} | Set the color of the line. For valid {Color} options, see Common Options. |
| LineWidth <Width> | Enter a pixel width value between 1.0 and 10.0. |
| FromObjData <ObjectData> | Use this option to enter additional information about the From object.
If the FromObj is an MTO, then use this option to specify the track number that the object line will be drawn from. If the FromObj is a satellite collection, then use this option to specify the entry name that the object line will be drawn from. |
| ToObjData <ObjectData> | Use this option to enter additional information about the To object.
If the ToObj is an MTO, then use this option to specify the track number that the object line will be drawn to. If the ToObj is a satellite collection, then use this option to specify the entry name that the object line will be drawn to. |
| IntervalType {UseIntervals | AlwaysOn} | Indicate whether the line should be always on or should use the defined intervals. |
| AddIntervals <numIntervals> ("<StartTime>" "<StopTime>")... | Adds the specified intervals. |
| ModifyInterval "<StartTime>" "<StopTime>" Color {Color} | Modifies the color of a single interval. For valid {Color} options, see Common Options. |
| LoadIntervals "<IntervalFile>" | Adds the intervals in the file to the existing interval list.
"<IntervalFile>" 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. |
| ImportIntervals "<TimeComponent>" | Adds the intervals from the specified Interval or Interval List component to the existing interval list.
For information about "<TimeComponent>", see Component Specification. |
| DeleteIntervals <numIntervals> ("<StartTime>" "<StopTime>")... | Deletes the specified intervals. This is valid only if {Action} is Modify. |
| DeleteAllIntervals | Deletes all intervals. |
| DrawAsGreatArc {On | Off} | If you enter On, STK will draw the line as a great arc, preventing it from intersecting the central body. This will create a line that stays on the surface of the central body, rather than going through it in a straight line. |
Enter all times in Connect Date units.
Examples
To display a red line of line width 3 between Satellite1 and Satellite2 in the first 2D Graphics window:
To display a line between Facility1 and Satellite2 in the second 2D Graphics window:
To modify the line from Satellite1 to Satellite2, created in the first example, so that it displays in blue with a line width of 5:
To hide the line previously created between Satellite1 and Satellite2:
To remove the line between Satellite1 and Satellite2:
To remove the line between Facility1 and Satellite2 in 2D Graphics window number 2:
Examples
To add a line between Satellite1 and Facility1, with two intervals:
To modify the line to use display intervals:
The following two commands will set the colors of the two intervals:
Examples
To add a line between track 1 of mto1 and track 2 of mto2:
To add a line between two SatelliteCollection1 entries (from Shell_1_P2_S1 to Shell_1_P1_S2):
Delete all object lines in the first 2d graphics window:
Return message
Group membership
This command belongs to the following group(s):
Version
11.6