Description | Example | Return Message | Group

VO Pass3D

Set leading and trailing graphics in a 3D window for all types of vehicles

Syntax

VO <ObjectPath> Pass3D {LeadTrailOption} <Parameters>

Related Commands

Description

The VO Pass3D command allows you to modify the display of vehicle tracks in a 3D window. Use the {LeadTrailOptions} to define the display of the leading and trailing portions of vehicle tracks. The leading portion of a vehicle's track begins at the vehicle's present position and moves forward along the its ephemeris. The trailing portion of a track begins at the vehicle's present position and moves backward along the vehicle's ephemeris.

{LeadTrailOption} can be:

{LeadTrailOption} <Parameters> Description
OrbitLead
  • Time <Time>
  • Percent <PercentValue>
  • OnePass
  • Quarter
  • Half
  • Full
  • All
  • None
  • CurrentInterval
  • SameAsLead
These parameters are described in the table below.
OrbitTrail
TrajLead
TrajTrail
GroundLead
GroundTrail
Inherit {On | Off} If On, the leading and trailing options are inherited from the 2D graphics settings. See Graphics Pass2D command.

Note: If the vehicle's Inherit setting is On, then any Lead/Trail entered options will be ignored.

Use OrbitLead and OrbitTrail to specify orbit pass options for Satellites.

Use TrajLead and TrajTrail to specify trajectory pass options for LaunchVehicles and Missiles.

Use GroundLead and GroundTrail to specify ground track pass options for All vehicles.

The {LeadTrailOption} <Parameters> are described in the following table:

<Parameters> Description
Time <Time> Specify the amount of time that you want the vehicle's path to display in the 3D Graphics window. <Time> is entered in seconds and should be greater or equal to 0.0.
Percent <Value> Indicate the percentage of the leading or trailing portion of a vehicle's path that will display in the 3D Graphics window.
Quarter Display one quarter of the leading or trailing portion of a vehicle's path in the 3D Graphics window.
Half Display one half of the leading or trailing portion of a vehicle's path in the 3D Graphics window.
Full Display the entire leading or trailing portion of a vehicle path in the 3D Graphics window.
OnePass Display one full pass of a satellite's orbit. This option is valid for Satellites only.
CurrentInterval When the vehicle is using Access Intervals, Custom Intervals or Realtime Intervals, display the leading portion of the vehicle's track for the graphics interval that contains the current animation time. When using Basic graphics options the entire leading portion will be displayed.
All Display the path spanning the entire vehicle ephemeris.
None Display none of the leading or trailing portion of the vehicle's path.
SameAsLead This parameter will set the trailing path display to be the same as leading path display.

Note: The SameAsLead parameter is applicable for OrbitTrail, GroundTrail and TrajTrail only.

Example

To set graphics for the ERS1 satellite so that the options aren't inherited from the 2D Graphics:

VO */Satellite/ERS1 Pass3D Inherit Off

To display the one full pass of the ERS1 satellite's orbit:

VO */Satellite/ERS1 Pass3D OrbitTrail OnePass

To turn off the vehicle's inherit setting, then set lead time to 3600.0 seconds, and set the trail time to be the same as lead:

VO */Satellite/Satellite1 Pass3d Inherit Off OrbitLead Time 3600 OrbitTrail SameAsLead

ReturnMessage

If activated, Connect returns an acknowledgement message.

Group Membership

This command belongs to the following group(s):

Vehicles

VO

VO Objects

Version

9.0

STK Programming Interface 11.0.1