.. _mouse_map:

Mouse Map
=========

User interaction in the 3D display is primarily performed using the mouse. The 
following table details the available functions as well as the mouse actions
required to perform those functions.

=============================  ===============================
**Function**                   **Mouse Action**
=============================  ===============================
Zoom                           Scroll wheel
Zoom                           Move mouse with *Middle* button
Zoom                           Move mouse with *Left* + *Right* buttons
Rotate                         Move mouse with *Left* button
Rotate around Z axis           Move mouse with *Left* button + *Alt* key
Translate in XY plane          Move mouse with *Left* button + *Shift* key
Translate in Z plane           Scroll wheel with *Alt* key
Select                         Click *Left* button
Select rectangle               Move mouse with *Right* button
Select add                     Click *Left* button with *Ctrl* or *Shift* key
Select grow                    Double click *Left* button
Select add grow                Double click *Left* button *Ctrl* or *Shift* key
Select rectangle and add       Move mouse with *Right* button and *Ctrl* or *Shift* key
Change clipping plane          Scroll wheel with *Ctrl* + *Shift* key
Change far clipping plane      Scroll wheel with *Alt* + *Ctrl* key
Change near clipping plane     Scroll wheel with *Alt* + *Shift* key
Text scale                     Scroll wheel with *Ctrl* key
Menu                           Click *Right* button
Adjust contour level           Scroll wheel with *Shift* key
Show labels                    Move with *Ctrl* key
=============================  ===============================

Special Builder Mouse Actions
-----------------------------
When a molecule is in *Editing* mode, the **Rotate** and **Translate in XY
plane** actions above can be applied exclusively to the molecule being
edited by holding down the *Ctrl* key (*Command* key on a Macintosh) while rotating or translating.
