Command: wgroup

Syntax

wgroup <window> {, <groups> ... }

Description

Redefine the display groups for a graphic window.

Parameters

• <window>
  A window identifier. This must be a graphic window.

• <groups>
  If present, this defines which groups are to displayed in the window. This will supersede all display groups currently defined for the window.

Switches

• -add=<groups>
  Add additional groups to the window’s display group list. The specified groups also get removed from the window’s exclusion group list.

• -ign=<groups>
  Remove groups from the window’s display group list and exclusion group list.

• -rem=<groups>
  Remove groups from the window’s display group list. The specified groups also get added to the window’s exclusion group list.

Notes

If the window is not currently in use, no action is taken.

As well as having a list of display groups, a window has a list of exclusion groups which suppresses their display in the window. A group cannot be in both lists for a window.

Defining no groups in a windows display group list defines the display group to be the all group, the default for new windows. To indicate an empty display group list us the group null.

When a window has a display group list, its exclusion group list is defined to be all modeling groups marked exclusive which are not present in the display group list.

When a group is added to the display group list it gets removed from the exclusion group list if necessary.

When a group is removed from the display group list it gets added to the exclusion group list.

When a group is made exclusive (by setting its group.exclusive member) it is immediately added to the exclusion group list of all windows, unless it is present in a window’s display group list.

Examples

Define a window's display group list.

wgroup win1, gra, grb

Add a group and exclude two others from a window.

wgroup win2, -add=furniture, -rem=<chairs,tables>

Define a window's group list to be the default, i.e. the all group.

wgroup win3

Define a window's group list to be "no entities", effectively suppressing graphics in the window.

wgroup win4, null

See Also