A mouse is essential to select objects and to use GAMGI efficiently.
Object selection
Pressing, with the left button, one of the object labels on the top
menu area, pops up a menu with all the available tasks for that object,
which can subsequentially be selected with the mouse or with the keyboard.
Pressing a label in the main menu (above the window drawing area),
with the middle button, means that the user is about to select an
object of that class. If this class has a visual representation
(atom, bond, molecule, cell, etc.), subsequently pressing the mouse
over the visual representation of an object of this class results
in the selection of the object.
If the selected class has no visual representation (light, layer, window,
gamgi), or the visual representation is ambiguous, when it belongs to
more than one object of the selected class (possible in recursive objects
such as text, group, cluster, assembly), then a menu pops up, listing
the possible objects, and allowing the selection of one, with the mouse
or the keyboard.
A convenient short-cut to select the current layer, the current window
and the current gamgi (everything), is to press twice over
Layer,
Window and
Gamgi respectively, on the main menu.
Dragging and pressing
Dragging the mouse over the window drawing area changes the selected
object when
Axes is off and the layer referential when
Axes
is on: 1) pressing the left button rotates the object (referential)
around its geometric center along the three X,Y,Z axes: dragging
horizontally rotates along the vertical axis, dragging vertically
rotates along the horizontal axis, and dragging along a circular arc
far from the center rotates along the axis perpendicular to the screen;
2) pressing the center button moves the object (referential) in the
dragging direction; 3) pressing the right button up and down scales
the object (layer) up and down respectively.
This functionality is available even for objects without visual
representation, as lights. Dragging and pressing the left button
when a directional or spot light is selected, changes the light
direction. Dragging and pressing the middle button for a positional
light, changes the light position. Dragging and pressing the right
button for a spot light, changes the light angle.
When a task window for a given object class is open (as
Atom Create,
Layer Modify or
Bond Remove), GAMGI attempts to use any mouse
pressing over the drawing area to recognize an object of the same class,
using the criteria described above to select an object (with
or without visual representation).
When an object is found, its information is usually transported
to the task window (and in some cases automatically executed),
but this object does not replace the current object, which always
needs to be explicitly selected: the two picking modes are independent.
To select an atom, for example, when
Molecule Measure is open,
just press the middle button over the
Atom label on the main menu
and click the mouse over the atom visual representation. Clicking again
over the same atom, this time GAMGI is not expecting an object selection,
so the default picking mode is executed and the molecule owning the atom
is measured.
Ruler handling
Pressing on
Rotate,
Move, or
Scale (below the
window drawing area) activates the positional ruler. This ruler is
algebraic, centered around 0: for positive (counter-colockwise) changes,
click on the right side of the ruler and for larger changes, click
farther away from the ruler center.
Pressing again on
rotate,
move, or
scale disables
the ruler and its position returns to zero. Everytime an action is
active, its label in the tool bar is highlighted, showing the default
color again when disabled.