Description | Example | Return Message | Group

Graphics SetAccessGfx

Set access graphics for an object or for all objects in a Scenario

Syntax

Graphics <ObjectPath> SetAccessGfx {AccessObject} {AccessGfxOptions}

Related Commands

Description

The Graphics SetAccessGfx Connect command controls the display of access graphics in the 2D Graphics window. At this level, you can set the display of graphics so that the parameters set here affect every access calculation. If <ObjectPath> is the Scenario, access graphics for all objects in the Scenario can be set.

Warning: If <ObjectPath> is the Scenario, and no {AccessGfxOption} is entered, or {AccessObject} is All, then all accesses for all objects will be computed. Depending on the number of objects in the Scenario, it may take some time for access graphics to display.

The following table describes the {AccessObject} values.

{AccessObject} Description
All When the {AccessObject} is All then all accesses will be computed FROM all valid objects TO the object specified by <ObjectPath>, and graphics values will be set for all accesses.
Computed When the {AccessObject} is Computed then access graphics values will only be set for accesses that have already been computed, no new accesses will be computed.
<TruncObjectPath> If <TruncObjectPath> is entered then access graphics values will be set for the access FROM the <ObjectPath> TO the <TruncObjectPath>. The access will be computed if it does not already exists.

This option is invalid if the <ObjectPath> is the Scenario Path.

The following table describes the valid {AccessGfxOptions}. Any number of these options can be entered on one command line.

{AccessGfxOption} Description
Show {On | Off} Turn on or off display of access graphics.
ShowLine {On | Off} If On, a line appears on the 2D Graphics window between the two access objects to show when they are accessible to one another during animation.
ShowAnim {On | Off} If On, a box appears around each object during access.
ShowStatic {On | Off} If On, access is highlighted in the 2D Graphics window as a thick line overlying the ground tracks for a vehicle or a vehicle sensor and as an X for a facility, a place, a target or a sensor that is attached to a facility, place or target.
LineWidth <Width> Set the line width value for the access graphics. Valid values is between 1.0 and 10.0.
Inherit {On | Off} If On, the ShowLine, ShowAnim and ShowStatic settings will be inherited from the Scenario.

To set the access graphics properties for the Scenario use the Graphics GlobalAttributes command.

If ShowLine, ShowAnim and/or ShowStatic options are set then Inherit will be turned off. If, however, the Inherit option is included on the command line it will take precedence over the settings for ShowLine, ShowAnim and ShowStatic on the same command line.

Example

To compute all accesses in the scenario, and set access graphics so that static graphics and lines overlaying the ground tracks for all objects display in the 2D Graphics window but don't display the box around the objects during animation:

Graphics * SetAccessGfx All ShowLine On ShowAnim Off ShowStatic On

To compute (if necessary) and show the line graphics with a line width of 3, for the Satellite1 to Facility1 access:

Graphics */Satellite/Satellite1 SetAccessGfx Facility/Facility1 ShowLine On LineWidth 3

To turn off the access graphics for all computed accesses in the scenario:

Graphics * SetAccessGfx Computed ShowLine Off ShowAnim Off ShowStatic Off

To compute (if necessary) and show the static and animation graphics for all access TO Satellite1:

Graphics */Satellite/Satellite1 SetAccessGfx All ShowStatic On ShowAnim On

ReturnMessage

If activated, Connect returns an acknowledgement message.

Group Membership

This command belongs to the following group(s):

2D Graphics Window

Object Tools

Version

10

STK Programming Interface 11.0.1