# Layer Link

- Object
- Shift

Link a layer or a list of layers to other objects.

### Hierarchy

Layers 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 layers. Pressing the button Above, the same menu shows Window, the only class of objects that can own layers.

Gamgi expects users to identify first the layer or list of layers to link. When the Layer entry is active and empty, clicking the mouse over the window graphic area creates a menu with all the window layers (local selection), which can then be selected. The current layer is initially proposed in the Layer entry. Pressing the List button, the current list of layers 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 windows and lights, press the mouse over a window graphic area, to create a menu with all the objects of that class, which can then be selected.

### Method

Gamgi suppports only one method to link layers: Object.

The Object method links a layer or a list of layers to a single object, Above or Below.

When linking a layer and the Hierarchy is Above, the layer is unlinked from its current window and linked to the new one. The layer history kept by the Undo and Save mechanisms is preserved in this operation.

When the Hierarchy is Below, the child object is unlinked from its current parent and linked to the layer. 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 layers Above, all layers in the list are unlinked and linked to the parent window. When linking a list of layers Below, the child object is replicated as many times as necessary to link each layer in the list to a different replica.

Home