Keyboard & Mouse usage

1. Using the keyboard & mouse in UnityMol
- 1.1. Emacs Notation for Keyboard Shortcuts
2. General Mouse shortcuts
3. General keyboard shortcuts
- 3.1. Shortcuts for the User Interface
- 3.2. Keyboard mapping in the Python console

1. Using the keyboard & mouse in UnityMol

A number of keyboard shortcuts and keyboard-modified mouse actions are defined in UnityMol. An overview of the implemented keyboard mapping can be found here.

1.1. Emacs Notation for Keyboard Shortcuts

This document follows Emacs-style notation for keyboard shortcuts:

C-x means holding Control (⌃) while pressing x.
M-x means holding Meta (⌥ on macOS, Alt on most keyboards) while pressing x. While upper case M represents the meta key, a lower case m represents the m key.
S-x means holding Shift while pressing x.
RET refers to the Enter key.
SPC refers to the Space key.
DEL refers to Backspace (⌫), while Delete refers to the forward delete key (Supr on AZERTY).

Mouse buttons are written as Mouse-1 (left), Mouse-2 (right), and Mouse-3 (middle).

2. General Mouse shortcuts

Key combo	Description
Hold & Drag `Mouse-Left`	Rotate all loaded molecules
Hold & Drag `Mouse-Right`	Zoom in and Zoom out all loaded molecules
Hold & Drag `Mouse-Middle`	Translate all loaded molecules
`Mouse-Wheel`	Zoom in and Zoom out all loaded molecules

3. General keyboard shortcuts

The functionalities listed below are generally available in the UnityMol scene view of the desktop version. Some are used in combination with the mouse to change its behavior.

Key combo	Description
`M-r`	Reset position, rotation and rotation center
`t-Mouse-1`	Translate the molecule that has been clicked on
`r-Mouse-1`	Rotate the molecule that has been clicked on
`M-Mouse-1`	Label atom information
`Mouse-1`	Add/remove clicked atom/residue/chain to/from selection
`C-Mouse-1`	Add clicked atom/residue/chain to selection
`f`	When a selection exists, focus (zoom in) on selection
`m-Mouse-1`	Set measuring points for distance/angle/dihedral measurements
`1`	Hyperballs representation
`2`	Cartoon representation
`3`	Surface representation
`4`	Van der Waals representation
`Home`	Zoom in
`End`	Zoom out
`up`	RotationX left
`down`	RotationX right
`left`	RotationY left
`right`	RotationY right
`Page up`	RotationZ left
`Page down`	RotationZ right
`Esc`	Cancel
`Return` or `SPC`	Submit

3.1. Shortcuts for the User Interface

This is work in progress to map functions from the graphical user interface (GUI) to keyboard shortcuts.

Key combo	Description
`C-DEL`	Toggle display of the UI menu on/off
`M-p`	Take a screenshot
`M-l`	Open File Load dialog

3.2. Keyboard mapping in the Python console

To simplify editing in the Python console, some basic abbreviations have been implemented as follows.

Key combo	Description
`C-SPC`	Toggle display of the python console on/off
`S-Return`	Use for multi-line inputs (for instance function definitions)
`C-a`	Go to start of line (Mac-only ??)
`C-e`	Go to end of line (Mac-only ??)
`up`	Recall previous command from history
`down`	Forward to next command in history
`TAB`	When typing a command, molecule or selection name or path, cycle through autocompletions
`⌘-a, ⌘-c, ⌘-v`	Select the entire line, copy, paste system-level shortcuts (Mac-only)