Keyboard and mouse shortcuts

FSLeyes has a number of keyboard and mouse shortcuts and modifiers which can make performing various tasks more convenient. This page contains a list of all keyboard and mouse shortcuts available for use within FSLeyes.

Modifier keys

The following symbols and terms are used to represent various keyboard keys:

• ⇧: Shift key

• ⌃: Control key

• ⌘: Command key (on macOS; Control key on other platforms)

• ⌥: Option key (on macOS; Alt on other platforms)

• ↑: Up arrow key

• ↓: Down arrow key

• ←: Left arrow key

• →: Right arrow key

• Left mouse: Left mouse button, typically a one-finger tap on a touchpad

• Right mouse: Right mouse button, typically a two-finger tap on a touchpad

• Middle mouse: Left mouse button, typically a three-finger tap on a touchpad

• Mouse wheel: Mouse-wheel scrolling, typically a two-finger drag on a touchpad

General

The following shortcuts are available throughout FSLeyes.

Shortcut	Action
⌘ + q	Exit FSLeyes
⌘ + ⇧ + /	Open FSLeyes user documentation
⌘ + ⇧ + d	Change to default view/control panel layout
⌘ + 1	Open ortho view
⌘ + 2	Open lightbox view
⌘ + 3	Open time series view
⌘ + 4	Open histogram view
⌘ + 5	Open power spectrum view
⌘ + 6	Open 3D view
⌘ + 7	Open Python shell
⌘ + w	Close focused view
⌘ + ⌥ + x	Remove all controls from focused view
⌘ + o	Load new overlay
⌘ + d	Load new overlay from directory
⌘ + s	Load new overlay from $FSLDIR/data/standard/
⌘ + ↑	Select next overlay in list (within the focused view)
⌘ + ↓	Select previous overlay in list (within the focused view)
⌘ + f	Show/hide selected overlay (within the focused view)
⌘ + ⇧ + f	Show/hide all overlays exept the bottom one (within the focused view)
⌘ + ⇧ + n	Create new image
⌘ + ⇧ + c	Copy selected image
⌘ + ⇧ + s	Save selected image
⌘ + ⇧ + r	Re-load selected overlay
⌘ + ⇧ + w	Remove selected overlay

Ortho, lightbox, and 3D views

The following shortcuts are available within ortho, lightbox, and 3D views.

Shortcut	Action
⌘ + ⌥ + 1	Open/close overlay list
⌘ + ⌥ + 2	Open/close location panel
⌘ + ⌥ + 3	Open/close overlay information
⌘ + ⌥ + 4	Open/close overlay display settings
⌘ + ⌥ + 5	Open/close view settings
⌘ + ⌥ + 6	Open/close FSL atlas panel
⌘ + ⌥ + 7	Open/close overlay display toolbar
⌘ + ⌥ + 8	Open/close ortho/lightbox/3D toolbar
⌘ + ⌥ + 9	Open/close file tree panel
⌥ + m	Start/stop movie mode

Some additional shortcuts are available within ortho views.

Shortcut	Action
⌘ + ⌥ + a	Open/close annotations panel
⌥ + e	Toggle edit mode
⌥ + r	Reset zoom/pan
⌥ + c	Reset location to centre
⌥ + o	Reset location to world origin
⌥ + l	Show/hide orientation labels
⌥ + c	Show/hide location cursor
⌥ + x	Show/hide X (sagittal) canvas
⌥ + y	Show/hide Y (coronal) canvas
⌥ + z	Show/hide Z (axial) canvas
⌥ + i	Seed correlation on 4D image
↑	Move location up in focused canvas
↓	Move location down in focused canvas
←	Move location left in focused canvas
→	Move location right in focused canvas
- / _	Previous slice in focused canvas
+ / =	Next slice in focused canvas

Plotting views

The following shortcuts and actions are available within time series, histogram, and power spectrum views.

Shortcut	Action
⌘ + ⌥ + 1	Open/close overlay list
⌘ + ⌥ + 2	Open/close plot list
⌘ + ⌥ + 3	Open/close time series/histogram/ power spectrum toolbar
⌘ + ⌥ + 4	Open/close time series/histogram/ power spectrum control panel
⌘ + i	Import data from file
⌘ + e	Save data to file
Left mouse click/drag	Pan
Right mouse click/drag	Zoom
⌘ + left mouse click/drag	Adjust overlay range, when a 3D histogram overlay is shown (histogram view only)
⌘ + left mouse click/drag	Change volume (time series view only)

Ortho, lightbox, and 3D view interaction

The following actions are available in the ortho view.

Shortcut	Action
Left mouse click/drag	Change location
Right mouse drag	Zoom to rectangle
Middle mouse drag	Pan
⌘ + mouse wheel/ scroll	Zoom
⌥ + mouse drag	Pan
⇧ + mouse wheel/scroll	Change slice
⇧ + mouse click+drag	Select nearest vertex (when a mesh overlay is selected)
⌘ + ⇧ + mouse click+drag	Adjust brightness/contrast with the mouse
⌘ + ⇧ + right mouse click+drag	Adjust brightness/contrast by selecting a region (when a volume overlay is selected)

The following actions are available in the lightbox view.

Shortcut	Action
Left mouse click+drag	Change location
⌘ + mouse wheel/scroll	Zoom

The following actions are available in the 3D view.

Shortcut	Action
Left mouse click+drag	Rotate scene
Middle mouse click+drag	Pan
⌘ + mouse wheel/scroll	Zoom
⌥ + mouse click+drag	Pan
⇧ + mouse click+drag	Select nearest vertex (for mesh overlays) or voxel (for volume overlays)

Ortho edit mode

The following shortcuts and actions are available in ortho edit mode.

Shortcut	Action
⌘ + z	Undo last change
⌘ + y	Redo last undone change
⌘ + n	Create new mask
⌘ + ⇧ + a	Clear selection (select mode only)
⌘ + b	Fill selected voxels (select mode only)
⌘ + e	Erase selected voxels (select mode only)
⌘ + i	Invert selection (select mode only)
⌘ + c	Copy/paste data across images (select mode only)
⌘ + p	Copy/paste selection across slices (select mode only)

The following actions are available when using the pencil, eraser, bucket, or select-by-intensity tools:

Shortcut	Action
All tools
⇧ + left mouse click+drag	Change location
⇧ + mouse wheel/scroll	Change slice
⌥ + left mouse click+drag	Pan
⌘ + mouse wheel/scroll	Zoom
Middle mouse click+drag	Pan
Pencil tool
Left mouse click+drag	Draw/select voxels
Right mouse click+drag	Erase/de-select voxels
Eraser tool
Left mouse click+drag	Erase/de-select voxels
Right mouse click+drag	Draw/select voxels
Pencil and eraser tools
⌘ + ⇧ + mouse wheel/scroll	Change cursor size
Select-by-intensity tool
⌘ + ⇧ + mouse wheel/scroll	Change intensity threshold
⌥ + ⇧ + mouse wheel/scroll	Change selection radius

The ortho crop tool

The following actions are available when using the ortho crop tool.

Shortcut	Action
Left mouse click+drag	Adjust crop box
⇧ + left mouse click+drag	Change location
⇧ + left mouse click+drag	Change location
⌥ + left mouse click+drag	Pan
⌘ + mouse wheel/scroll	Zoom