Link a text or a list of texts to other objects.
Hierarchy
Texts 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 texts. Pressing
the button
Above, the same menu shows the classes
of objects that can own texts.
Gamgi expects users to identify first the text or list of texts
and then the object to link. When the
Text entry is active
and empty, clicking the mouse over a text, on the current layer
(local selection), its identification is transported to the
Text
entry. Pressing the
List button, the current list of texts
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 texts:
Object.
The
Object method links a text or a list of texts
to a single object,
Above or
Below.
When linking a text and the
Hierarchy is
Above, the text
is unlinked from its current parent and linked to the new object.
When the
Hierarchy is
Below, the child object is unlinked
from its current parent and linked to the text. 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 texts can own other texts), 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 texts
Above, all texts in the list
are unlinked and linked to the parent object. When linking a list
of texts
Below, the child object is replicated as many times
as necessary to link each text in the list to a different replica.