ChimeraX docs icon

Command: mousemode

mousemodecontrol ] [ alt ] [ command ] [ shift ] [ leftMode  function ] [ middleMode  function ] [ rightMode  function ] [ wheelMode  function ] [ pauseMode  function ]

The mousemode command assigns ChimeraX functions to the left, middle, and right mouse buttons, alone and in combination with the modifier keys control, alt, command, and shift. In addition, wheelMode refers to scrolling with the mouse wheel or touchpad, and pauseMode refers to pausing the cursor over something in the graphics window without clicking any buttons. See also: device, Mouse Modes for Right Button toolbar, Marker Placement, ChimeraX window

Given without arguments, the mousemode command reports the current assignments in the Log. Initial defaults include:

A touchpad or single-button mouse can be used with modifier keys to emulate middle and right mouse buttons. On a Mac, these are alt and command (), respectively. In other words, leaving alt left and command left unassigned allows them to serve the middle- and right-button functions.

Possible values of function are listed in the table below. They can be truncated to unique strings. If function contains spaces, it should be enclosed in quotation marks. Not all functions make sense for a given input mode; for example, only identify object and none are reasonable functions for pauseMode.

Multiple modifier keys and multiple “buttons” can be given in a single command, but all specified modifiers apply to all specified buttons. For example, two commands rather than one would be needed to assign functions to control right and alt wheel:

mousemode control right 'rotate and select'
mousemode alt wheel contour
(default assignment, if any)
description Mouse Modes icon
XY-rotate (screen coordinates) with cursor in central part of window,
Z-rotate with cursor in periphery, except if wheel, Y-rotate only;
see also turn, roll
XY-translate (screen coordinates),
except if wheel, Z-translate; see also move
(right, wheel)
zoom the view; see also zoom
(control left)
select items for subsequent operations; see also select
select toggle
(shift control left)
toggle selection status
(select if not already selected, deselect if selected)
identify object
show identifying information in balloon,
atomic-model chain description (if available) in status line
(shift right)
set center of rotation to atom; see also cofr
select add add to selection; see also select
(do not toggle to deselected if already selected)
select subtract subtract from selection; see also select
(do not toggle to selected if already deselected)
rotate and select click to select, drag to rotate
translate selected models translate models with any part selected
rotate selected models rotate models with any part selected
clip activate and translate front clipping plane, +Alt back plane,
+Shift slab (front and back in same direction),
+Alt-Shift slab thickness (front and back in opposite directions);
if only near/far (fixed-orientation) planes already active, move those
instead of front/back (rotatable) planes; see also clip
clip rotate activate and rotate front/back clipping planes; see also clip
label label/unlabel atom, bond, pseudobond, or residue
(by clicking on ribbon segment); see also label
contour level adjust volume data threshold level; see also volume
move planes show different planes of volume data; see also volume
place marker place marker (details...)
connect markers select and link successively clicked markers
play map series play volume series; see also vseries
none no assignment  
bond rotation adjust torsion angle; original position not retained
tug drag atoms and apply OpenMM dynamics
while button is held down (details...);
original coordinates not retained
minimize jiggle residue and its neighbors with OpenMM dynamics
while button is held down (details...);
original coordinates not retained
swapaa “mutate” and label the amino acid residue under the mouseclick,
cycling through the 20 standard types in arbitrary conformations;
original sidechain not retained

UCSF Resource for Biocomputing, Visualization, and Informatics / March 2018