Command: transient

Syntax

transient <command_block>

Description

Execute a block of commands in transient mode. When transient mode completes, all global graphic items (entities and groups) created within the block will be removed.

Parameters

<command_block>
A block of commands to be executed in transient mode.

Switches

none

Notes

This command enables graphic items to be created without worrying about remembering to delete them when they are no longer required. Normally this is done automatically for local identifiers, but graphic items, i.e. entities and groups cannot be local. This therefore provides a convenient housekeeping function.

The nesting of transient blocks is permitted.

Examples

Execute a command block.

transient {
    group ga
	restore myfile.e
	ga = all
    modify ga { ls = green }
	save myfile.e, ga
}