# Group Link

- Object
- Shift

Link a group or a list of groups to other objects.

### Hierarchy

Groups can be linked to objects above or below, in the Gamgi hierarchy. Pressing the button Below (the default), the class menu shows the classes of objects that can be owned by groups. Pressing the button Above, the same menu shows the classes of objects that can own groups: Layer (the default) and Group.

### Object

Gamgi expects users to identify first the group or list of groups and then the object to link. When the Group entry is active and empty, clicking the mouse over a group, on the current layer (local selection), its identification is transported to the Group entry. Pressing the List button, the current list of groups is selected instead.

Gamgi is now expecting users to click on a object of the class currently selected in the class menu. This object can be in a different layer or window (global selection).

To select a visible object, just press the mouse over the object, in its window. To select objects without visual representation, such as layers and lights, press the mouse over the graphic area in the window, to create a menu with all the objects of that class in the window, which can then be selected.

### Method

Gamgi suppports only one method to link groups: Object.

The Object method links a group or a list of groups to a single object, Above or Below.

When linking an group and the Hierarchy is Above, the group is unlinked from its current parent and linked to the new object. When the group is moved to a different layer, its bonds are automatically removed. When the Hierarchy is Below, the child object is unlinked from its current parent and linked to the group. An error is issued when the parent already owned the child object.

When the new child previously owned the new parent (a situation made possible because groups can own other groups), the new parent is first linked to the new child parent. An error is issued when the parent already owned the child object.

After the linking operation, Gamgi always puts on top the window and layer containing the linked objects.

When linking a list of groups Above, all groups in the list are unlinked and linked to the parent object. When linking a list of groups Below, the child object is replicated as many times as necessary to link each group in the list to a different replica.
Home