VO ObjectLine
Display lines connecting objects in the 3D Graphics window
Syntax
VO <ScenarioPath> ObjectLine {Action} {FromObj <TruncObjectPath1>} {ToObj <TruncObjectPath2>} [{LineOptions}]
Related commands
Description
The VO ObjectLine command enables you to have STK display lines connecting objects in the 3D 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 3D Graphics window.
Valid values for {Action} are described in the following table.
| {Action} | Description |
|---|---|
| Add | Have the 3D 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 <TruncObjectPath> 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 3D Graphics window.
| {LineOption} | Description |
|---|---|
| WindowID <WinNumber> | Indicate the 3D 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 3D Graphics window. |
If {Action} is Add or Modify, use the following {LineOptions} to define the display of the lines connecting objects in the 3D Graphics window.
| {LineOption} | Description |
|---|---|
| Show {On | Off} | Setting Show to Off hides an individual line between the specified objects. |
| Color {Color} | Specify the line color. For valid {Color} options, see Common Options. |
| LineWidth <WidthValue> | 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 will be drawn 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. |
| SurfaceLine {On | Off} | When you set SurfaceLine to On, STK will draw the object line on terrain if the following are also true: (1) Using the VO SurfaceLines command, you set OnTerrain to "On" or "WhenTerrainServerIsOn", and (2) you set DrawAsGreatArc to On in this command. |
Enter all times in Connect Date units.
Examples
To display a red line of line width 3 between Satellite1 and Satellite1 in the first 3D Graphics window:
To display a line between Facility1 and Satellite2 in the second 3D Graphics window:
To modify the line from Satellite1 and Satellite2 created in the first example so that it displays in blue with a line width of 5:
To hide the line previously created line between Satellite1 and Satellite2:
To remove the line between Satellite1 and Satellite2:
To remove the line between Facility1 and Satellite2 in 3D 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_P2_S2):
Return message
Group membership
This command belongs to the following group(s):
Version
11.6