Command: suppress

Syntax

suppress <command_block>

Description

Execute a command or block of commands with graphic output suppressed.

Parameters

<command_block>
One command or a block of commands to be executed without graphic output.

Switches

-dbt=<num>
A transition style to be invoked at the end of any contents repaint necessary on closure of the command block. This feature is used only when double buffering is active for the window and facilitates presentation-type effects. See here for a description of all available transition styles. If this switch is omitted, the transition style of the window is used (see window.double_buffering).
-q
Quiet mode. This suppresses the redrawing of graphic windows after <command_block> has been executed. This switch should be used with caution since window display lists may be left in an unreliable state if not updated.

Notes

The graphic output resulting from all commands is suppressed with the exception of the wpaint command which may be used to periodically refresh all or specific windows.

The suppression applies to graphic windows only.

After <command_block> has been executed, the contents of relevant graphic windows are redrawn unless the -q switch was used.

No graphics are drawn at all while suppression is on. This includes repaints caused by window exposures.

Examples

Execute one command.

suppress exec read_data()

Execute a command block.

suppress {
    modify ga { ls = red }
    modify gb { ls = green }
    kill gd
    box;plan
}