Slicer3:EventBindings

Keyboard accelerators

A list of global "hot-keys" and module-specific "hot-keys" for Slicer2 and Slicer3 is being actively compiled below. (This page is a little out of sync with development -- please make current!) With respect to the specification of keyboard accelerators, please follow these three recommendations;

• Before assigning "hot-keys" to functionality, either in the main Slicer application or in a new module, please consult the list below to make sure the key is not already mapped.
• Across Slicer modules, try to use similar "hot-key" assignments for similar functionality, and try to observe existing paradigms outlined below; this consistency makes Slicer easier for users to learn.
• Once you assign "hot-keys" in your module, please add those mappings to the list below for others to reference.

Design paradigms

• use CTRL-modified keys as global, and non-modified keys for module-specific accelerators.
• use ALT modifiers to access menu items
• SHIFT modifiers should apply to all instances of the same type as the current window

Design ideas

• having hotkeys to toggle between axial, saggital, and coronal views in a slice window.
• having a hotkey to toggle any window the mouse is inside between full screen and current size.
• consistent set of mouse actions in 2D, 3D and control windows
• consistent set of mouse-mode switches in 2D, 3D windows
• use the right menu button to bring up a context-dependent menu (e.g. actions appropriate for the item under the cursor).

Global "hot-keys"

Window Behavior

Action	Slicer3 Key	Meaning	Slicer3 Key
Toggle Maximize current window	Control-m	Make the current Slice or 3D View expand to full view space or return to previous size depending on current state	None
Toggle Control Pane View	F5 (KWW default)	Show or hide the Control Pane depending on state	None

MRML

Action	Slicer3 Key	Meaning	Slicer3 Key
Open Scene...	Control-O	Bring up file browser to locate .mrml file	None
Save Scene	Control-S	Save current scene no browser, disabled if no current file. If no current scene, does Save As...	None
Save Scene As...	None	Bring up file browser to locate .mrml file	None
Undo	Control-Z	Revert to last undo point	None
Redo	Control-Y	Revert to last redo point	None
Other Menu Items	Alt-<letter>	Bring up or invoke menu or menu item corresponding to letter	Same

Slice Manipulation

Action	Slicer3 Key	Meaning	Slicer3 Key
Next slice	Right Arrow and Up Arrow	Axial: move Superior, Sag: Right, Cor: Anterior	Right Arrow
Previous slice	Left Arrow and Down Arrow	Axial: move Inferior, Sag: Left, Cor: Posterior	Left Arrow
Linked Motion	Shift Key	Cause other slice windows to scroll to RAS point at current cursor location	Same
Toggle Slice Visible	v	Make the current slice window show as a plane in the 3D view	None
Toggle All Slices Visible	V	Make all slices show in 3D View	None
Toggle Foreground/Background Opacity	T	Change opacity of foreground overlay	None
Toggle Label Overlay	g	Show/Hide Label for this slice	None
Toggle Label Overlay	G	Show/Hide Label for all slices	None
Cycle Orientations	Tab	Cycle through Axial/Sagittal/Coronal	None
Cycle All Orientations	Shift-Tab	Cycle through Axial/Sagittal/Coronal in all slice windows	None
Fit to volume	f	Set the field of view to match the full extent of the foreground and background volumes	None
Fit to volumes all	Shift-F	Set the field of view in all slices to match the full extent of the foreground and background volumes	None

3D Manipulation

Action	Slicer3 Key	Meaning	Slicer3 Key
Wireframe	w	change render mode to wireframe	Same
Shaded	s	change render mode to shaded	Same
Reset View	r	Set camera to see all objects	None
Toggle Rock Mode	TBD	Toggle rock mode	None
Toggle Spin Mode	TBD	Toggle spin mode	None

Navigating Application

Action	Slicer3 Key	Meaning	Slicer3 Key
Application Menu	Space Bar	Brings up a popup menu with all the application operations and their key binding information	None
Module Navigation	Control-<number>	Jumps to the numbered module (number order is the same as the order of the shortcut icons in the toolbar at the top of the application.	None
Move through module history	Control-PageUp/PageDown	Short cuts for the two arrow buttons next to the module popup menu	None
Search for Module	Control-F	Starts an incremental search through the module names and descriptions, terminated by Enter to jump to the module. Probably needs a dialog box.	None

Module-specific hot-keys

Fiducials

Action	Slicer3 Key	Meaning	Slicer3 Key
Add Fiducial	Control-p	Adds fiducial at current pointer position	Same
Delete Fiducial	Control-d	Deletes the fiducial picked from current mouse position (ignored if no fiducial is under mouse)	Same
Select Fiducial	Control-q	Selects/Deselects the fiducial under the mouse	q

Editor

Action

Slicer3 Key

Meaning

Slicer3 Key

Mouse Actions

Button Use Constraints

• Alt-Left mouse button should always be available as a substitute for the middle mouse button to support two button mice. On Mac, you can also use the command key with a mouse click to get middle mouse events.
• Contrl-Left mouse button should always be available as a substitute for the right mouse button to support one button mice (on Mac).

Toolbar

The current mouse mode will always be visible in a toolbar in the slicer display. There will also be hot keys to select specify mouse modes. Instead of (or in addition to) a toolbar we may want to use a WWidget in the overlay planes to reflect the mouse mode.

Mouse Modes and Actions

TBD