Description | Example | Return Message | Group

BatchGraphics

Set performance response of the 2D and 3D Graphics windows

Syntax

BatchGraphics <ScenarioPath> {On | Off} [Optimize]

Description

The BatchGraphics command allows you to control whether updates to STK should occur immediately (Off) or if they should be delayed (On). This feature improves STK graphics performance when you're manipulating attributes for a large number of objects.

If setting BatchGraphics to Off, you can include the Optimize option at the end of the command. If you include it, only objects whose graphics have been changed since the previous BatchGraphics On command are updated. If you don't include the Optimize option, all objects are updated.

Note: If the Optimize option is included, only objects whose graphics have been changed will be updated, child object graphics will not be updated. Do not use Optimize if you have changed the graphics of an object that has children.

When BatchGraphics is set to On, the graphics properties changed by subsequent Connect commands are registered internally to STK. But please note: Some graphical changes may be restored when one of the following happens:

If BatchGraphics is set to On, and the connection is disconnected then BatchGraphics will be turned Off.

Note: If the VO Model command is specified within a BatchGraphics block (between BatchGraphics On and BatchGraphics Off commands), then commands that access the model file may not be processed properly as the Model file may not be fully loaded until the BatchGraphics Off command is issued. For example the VO ModelPointing command.

Example

To set graphics to update at the next animation step in the current scenario:

BatchGraphics * On

ReturnMessage

If activated, Connect returns an acknowledgement message.

Group Membership

This command belongs to the following group(s):

2D Graphics Window

VO

VO Objects

Version

4.2

STK Programming Interface 11.0.1