Difference between revisions of "Documentation/4.0/SlicerApplication/KeyboardShortcuts"

From Slicer Wiki
Jump to: navigation, search
m (Text replacement - "slicerWiki/index.php" to "wiki")
 
(23 intermediate revisions by 5 users not shown)
Line 1: Line 1:
<big><big>This page is work in progress </big></big>
+
<noinclude>{{documentation/versioncheck}}</noinclude>
 +
{{warning}}This page is deprecated. Please see the following link for the actual page for Slicer 4:<br>
 +
http://wiki.slicer.org/wiki/Documentation/4.0/SlicerApplication/MouseandKeyboardShortcuts
  
 +
 +
 +
 +
<!-- ---------------------------- -->
 +
{{documentation/{{documentation/version}}/slicerapplication-header}}
 +
<!-- ---------------------------- -->
 +
 +
[[Slicer4:Developers#Projects|Back to Slicer 4 Developer projects]]
 +
 +
= '''Note: this page is work in progress.''' =
  
 
= Application Hot-keys (keyboard accelerators) =
 
= Application Hot-keys (keyboard accelerators) =
  
 +
* '''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''' + '''mouse click''' to get middle mouse events.
 +
* '''Control-Left''' + '''mouse button''' should always be available as a substitute for the right mouse button to support one button mice (on Mac).
  
== '''Developers: Please note the following reserved key combinations!''' ==
+
{{warning}}'''Developers:''' Please note the following reserved key combinations!
 
 
* 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).
 
  
 +
== General ==
  
 
{| class="wikitable"
 
{| class="wikitable"
Line 16: Line 28:
 
! align="left" |Action bound to key(s)
 
! align="left" |Action bound to key(s)
 
|-
 
|-
| style="width:200px; background-color: lightgreen" | <font color="blue"> '''Ctrl+O'''
+
| style="width:200px; background-color: lightgreen" | <font color="midnightblue"> '''Ctrl+O'''
 
| align="left" style="background-color: lightgreen"|Load a new scene (clears existing scene)
 
| align="left" style="background-color: lightgreen"|Load a new scene (clears existing scene)
 
|-
 
|-
| style="width:200px; background-color: orange"| <font color="blue"> '''Ctrl+A'''  
+
| style="width:200px; background-color: palegoldenrod"| <font color="midnightblue"> '''Ctrl+A'''  
| align="left" style="background-color: orange"|Import a scene (does not clear existing scene) Brings up '''Add Data''' instead
+
| align="left" style="background-color: palegoldenrod"|Import a scene (does not clear existing scene) Brings up '''Add Data''' instead
 
|-
 
|-
| style="width:200px; background-color: lightgreen" | <font color="blue"> '''Ctrl+W'''  
+
| style="width:200px; background-color: lightgreen" | <font color="midnightblue"> '''Ctrl+W'''  
 
| align="left" style="background-color: lightgreen"| Close a scene
 
| align="left" style="background-color: lightgreen"| Close a scene
 
|-
 
|-
| style="width:200px; background-color: lightpink" |<font color="blue"> '''Ctrl+H '''  
+
| style="width:200px; background-color: lightpink" |<font color="midnightblue"> '''Ctrl+H '''  
 
| align="left" style="background-color: lightpink"| Set the current module to be the "home" module -- the module that's exposed when Slicer starts up.
 
| align="left" style="background-color: lightpink"| Set the current module to be the "home" module -- the module that's exposed when Slicer starts up.
 
|-
 
|-
| style="width:200px; background-color: lightpink" | <font color="blue"> '''Ctrl+Z '''  
+
| style="width:200px; background-color: lightpink" | <font color="midnightblue"> '''Ctrl+Z '''  
 
| align="left" style="background-color: lightpink"| Undo the last undoable action
 
| align="left" style="background-color: lightpink"| Undo the last undoable action
 
|-
 
|-
| style="width:200px; background-color: lightpink" | <font color="blue"> '''Ctrl+Y '''  
+
| style="width:200px; background-color: lightpink" | <font color="midnightblue"> '''Ctrl+Y '''  
 
| align="left" style="background-color: lightpink" | Redo the last lightpinkoable action
 
| align="left" style="background-color: lightpink" | Redo the last lightpinkoable action
 
|-
 
|-
| style="width:200px; background-color: lightgreen" | <font color="blue"> '''Space-key '''  
+
| style="width:200px; background-color: lightgreen" | <font color="midnightblue"> '''Space-key '''  
 
| align="left" style="background-color: lightgreen"| Toggles the display of Slicer's Edit Box.
 
| align="left" style="background-color: lightgreen"| Toggles the display of Slicer's Edit Box.
 
|-
 
|-
| style="width:200px; background-color: orange" | <font color="blue"> '''Ctrl+P '''  
+
| style="width:200px; background-color: palegoldenrod" | <font color="midnightblue"> '''Ctrl+P '''  
| align="left" style="background-color: orange"| Display the Python console  '''Displays the QT-real console'''
+
| align="left" style="background-color: palegoldenrod"| Display the Python console  '''Displays the QT-real console'''
 
|-
 
|-
| style="width:200px" | <font color="blue"> '''Ctrl+L '''  
+
| style="width:200px" | <font color="midnightblue"> '''Ctrl+L '''  
 
| align="left" | Create a new fiducial list.
 
| align="left" | Create a new fiducial list.
 
|-
 
|-
| style="width:200px" | <font color="blue"> '''Ctrl+I'''  
+
| style="width:200px" | <font color="midnightblue"> '''Ctrl+I'''  
 
| align="left" | Toggle between "Persistent Place" and "Transform View" interaction modes.
 
| align="left" | Toggle between "Persistent Place" and "Transform View" interaction modes.
 
|-
 
|-
| style="width:200px" | <font color="blue"> '''Ctrl+M '''  
+
| style="width:200px" | <font color="midnightblue"> '''Ctrl+M '''  
 
| align="left" | Create a new Ruler measurement between the last two placed fiducials.
 
| align="left" | Create a new Ruler measurement between the last two placed fiducials.
 
|}
 
|}
Line 57: Line 69:
 
! align="left" |Action bound to key(s)
 
! align="left" |Action bound to key(s)
 
|-
 
|-
| style="width:200px" | <font color="blue"> '''` (back-tick key)'''
+
| style="width:200px" | <font color="midnightblue"> '''` (back-tick key)'''
 
| align="left" |Navigate to next fiducial in the active Slice Viewer, or in all viewers if they are linked (back-tick is the left single-quote on the key with the tilde (~) character in the upper left side of the keyboard)
 
| align="left" |Navigate to next fiducial in the active Slice Viewer, or in all viewers if they are linked (back-tick is the left single-quote on the key with the tilde (~) character in the upper left side of the keyboard)
 
|-
 
|-
| style="width:200px" | <font color="blue"> '''Ctrl+` (back-tick key)'''  
+
| style="width:200px" | <font color="midnightblue"> '''Ctrl+` (back-tick key)'''  
 
| align="left" |Navigate to next fiducial in all Slice Viewers, independent of their linked state
 
| align="left" |Navigate to next fiducial in all Slice Viewers, independent of their linked state
 
|-
 
|-
| style="width:200px" | <font color="blue"> '''Shift+` (back-tick key)'''  
+
| style="width:200px" | <font color="midnightblue"> '''Shift+` (back-tick key)'''  
 
| align="left" | Navigate to the previous fiducial in the active Slice Viewer, or in all viewers if they are linked
 
| align="left" | Navigate to the previous fiducial in the active Slice Viewer, or in all viewers if they are linked
 
|-
 
|-
| style="width:200px" | <font color="blue"> '''Ctrl+Shift+` (back-tick key)'''  
+
| style="width:200px" | <font color="midnightblue"> '''Ctrl+Shift+` (back-tick key)'''  
 
| align="left" | Navigate to the previous fiducial in all Slice Viewers, independent of their linked state
 
| align="left" | Navigate to the previous fiducial in all Slice Viewers, independent of their linked state
 
|-
 
|-
| style="width:200px" | <font color="blue"> '''p-key'''  
+
| style="width:200px" | <font color="midnightblue"> '''p-key'''  
 
| align="left" | Place a new fiducial in the active Slice Viewer(adds to the current fiducial list, or creates a list if there are none)
 
| align="left" | Place a new fiducial in the active Slice Viewer(adds to the current fiducial list, or creates a list if there are none)
 
|-
 
|-
| style="width:200px; background-color: lightpink" | <font color="blue"> '''o-key'''  
+
| style="width:200px; background-color: lightpink" | <font color="midnightblue"> '''o-key'''  
 
| align="left" style="background-color: lightpink"| Turn on the Slice Plane reformat widget in the active Slice Viewer
 
| align="left" style="background-color: lightpink"| Turn on the Slice Plane reformat widget in the active Slice Viewer
 
|-
 
|-
| style="width:200px; background-color: lightgreen" | <font color="blue"> '''v-key'''  
+
| style="width:200px; background-color: lightgreen" | <font color="midnightblue"> '''v-key'''  
 
| align="left" style="background-color: lightgreen" | Toggles the slice plane visibility in the main 3D Viewer
 
| align="left" style="background-color: lightgreen" | Toggles the slice plane visibility in the main 3D Viewer
 
|-
 
|-
| style="width:200px; background-color: lightgreen" | <span style="background-color: lightgreen"><font color="blue"> '''r-key'''  
+
| style="width:200px; background-color: lightgreen" | <span style="background-color: lightgreen"><font color="midnightblue"> '''r-key'''  
 
| align="left" style="background-color: lightgreen"| Fits the slice view to the volume extents in the active Slice Viewer, or in all viewers if they are linked (the first non-none volume will be used in order of Background, Foreground and Label layers)
 
| align="left" style="background-color: lightgreen"| Fits the slice view to the volume extents in the active Slice Viewer, or in all viewers if they are linked (the first non-none volume will be used in order of Background, Foreground and Label layers)
 
|-
 
|-
| style="width:200px; background-color: lightgreen" | <font color="blue"> '''b-key'''  
+
| style="width:200px; background-color: lightgreen" | <font color="midnightblue"> '''b-key'''  
 
| align="left" style="background-color: lightgreen"| Decrement slice in the active Slice Viewer (left or down) by one unit of background pixel spacing
 
| align="left" style="background-color: lightgreen"| Decrement slice in the active Slice Viewer (left or down) by one unit of background pixel spacing
 
|-
 
|-
Line 87: Line 99:
 
| align="left" style="background-color: lightgreen"| Increment slice in the active Slice Viewer (right or up) by one unit of backgroun dpixel spacing
 
| align="left" style="background-color: lightgreen"| Increment slice in the active Slice Viewer (right or up) by one unit of backgroun dpixel spacing
 
|-
 
|-
| style="width:200px" | <font color="blue"> '''Backspace-key'''  
+
| style="width:200px" | <font color="midnightblue"> '''Backspace-key'''  
 
| align="left" | When the mouse is hovering over a fiducial in the Slice Viewer (turning it yellow), delete that fiducial
 
| align="left" | When the mouse is hovering over a fiducial in the Slice Viewer (turning it yellow), delete that fiducial
 
|-
 
|-
| style="width:200px" | <font color="blue"> '''Delete-key'''  
+
| style="width:200px" | <font color="midnightblue"> '''Delete-key'''  
 
| align="left" | When the mouse is hovering over a fiducial in the Slice Viewer (turning it yellow), delete that fiducial
 
| align="left" | When the mouse is hovering over a fiducial in the Slice Viewer (turning it yellow), delete that fiducial
 
|}
 
|}
 +
 +
==Sliders and mouse==
 +
*Every click is 1 step, and 1 step is 1 slice (if there are multiple volumes (Labelmap/Back/Foreground, then its the smallest spacing of the 3 that is used).
 +
*Middle click directly jumps to the mouse.
 +
*Home/End keys go to the beginning/end.
  
 
== Global "hot-keys" ==
 
== Global "hot-keys" ==
Line 101: Line 118:
 
|- style="background:#c2c2c2; color:black" align="eft"
 
|- style="background:#c2c2c2; color:black" align="eft"
 
| style="width:20%" | Action
 
| style="width:20%" | Action
 +
| style="width:15%" | Slicer4 Key
 
| style="width:15%" | Slicer3 Key
 
| style="width:15%" | Slicer3 Key
 
| style="width:40%" | Meaning
 
| style="width:40%" | Meaning
 
|- style="background-color: lightpink"
 
|- style="background-color: lightpink"
 
| Toggle Maximize current window
 
| Toggle Maximize current window
 +
|
 
| Control-m
 
| Control-m
 
| Make the current Slice or 3D View expand to full view space or return to previous size depending on current state
 
| Make the current Slice or 3D View expand to full view space or return to previous size depending on current state
 
|-style="background-color: lightgreen"
 
|-style="background-color: lightgreen"
 
| Toggle Control Pane View
 
| Toggle Control Pane View
 +
|
 
| F5 (KWW default)
 
| F5 (KWW default)
 
| Show or hide the Control Pane depending on state
 
| Show or hide the Control Pane depending on state
Line 118: Line 138:
 
|- style="background:#c2c2c2; color:black" align="eft"
 
|- style="background:#c2c2c2; color:black" align="eft"
 
| style="width:20%" | Action
 
| style="width:20%" | Action
 +
| style="width:15%" | Slicer4 Key
 
| style="width:15%" | Slicer3 Key
 
| style="width:15%" | Slicer3 Key
 
| style="width:40%" | Meaning
 
| style="width:40%" | Meaning
Line 123: Line 144:
 
|-style="background-color: lightgreen"
 
|-style="background-color: lightgreen"
 
| Open Scene...
 
| Open Scene...
 +
|
 
| Control-O
 
| Control-O
 
| Bring up file browser to locate .mrml file
 
| Bring up file browser to locate .mrml file
 
|-style="background-color: lightgreen"
 
|-style="background-color: lightgreen"
 
| Save Scene
 
| Save Scene
 +
|
 
| Control-S
 
| Control-S
 
| Save current scene no browser, disabled if no current file. If no current scene, does Save As...
 
| Save current scene no browser, disabled if no current file. If no current scene, does Save As...
 
|-
 
|-
 
| Save Scene As...
 
| Save Scene As...
 +
|
 
| None
 
| None
 
| Bring up file browser to locate .mrml file
 
| Bring up file browser to locate .mrml file
 
|-
 
|-
 
| Undo
 
| Undo
 +
|
 
| Control-Z
 
| Control-Z
 
| Revert to last undo point
 
| Revert to last undo point
 
|-
 
|-
 
| Redo
 
| Redo
 +
|
 
| Control-Y
 
| Control-Y
 
| Revert to last lightpinko point
 
| Revert to last lightpinko point
 
|-style="background-color: lightgreen"
 
|-style="background-color: lightgreen"
 
| Other Menu Items
 
| Other Menu Items
 +
|
 
| Alt-<letter>
 
| Alt-<letter>
 
| Bring up or invoke menu or menu item corresponding to letter
 
| Bring up or invoke menu or menu item corresponding to letter
Line 148: Line 175:
  
 
=== Slice Manipulation ===
 
=== Slice Manipulation ===
 
 
{| border="1" cellpadding="5"
 
{| border="1" cellpadding="5"
 
|- style="background:#c2c2c2; color:black" align="eft"
 
|- style="background:#c2c2c2; color:black" align="eft"
 
| style="width:20%" | Action
 
| style="width:20%" | Action
 +
| style="width:15%" | Slicer4 Key
 +
| style="width:40%" | Meaning
 
| style="width:15%" | Slicer3 Key
 
| style="width:15%" | Slicer3 Key
| style="width:40%" | Meaning
 
 
| style="width:10%" | Slicer2 Key
 
| style="width:10%" | Slicer2 Key
 
|-style="background-color: lightpink"
 
|-style="background-color: lightpink"
 
| Toggle link
 
| Toggle link
 +
|
 +
| Toggle linking/unlinking all slices.
 
| l
 
| l
| Toggle linking/unlinking all slices.
 
 
| None
 
| None
 
|-style="background-color: lightgreen"
 
|-style="background-color: lightgreen"
 
| Next slice for this slice viewer
 
| Next slice for this slice viewer
 +
|
 +
| Axial: move Superior, Sag: Right, Cor: Anterior
 
| Right Arrow and Up Arrow and f
 
| Right Arrow and Up Arrow and f
| Axial: move Superior, Sag: Right, Cor: Anterior
 
 
| Right Arrow
 
| Right Arrow
 
|-style="background-color: lightgreen"
 
|-style="background-color: lightgreen"
 
| Previous slice for this slice viewer
 
| Previous slice for this slice viewer
 +
|
 +
| Axial: move Inferior, Sag: Left, Cor: Posterior
 
| Left Arrow and Down Arrow and b
 
| Left Arrow and Down Arrow and b
| Axial: move Inferior, Sag: Left, Cor: Posterior
 
 
| Left Arrow
 
| Left Arrow
 
|-
 
|-
 
| Linked Motion
 
| Linked Motion
 +
|
 +
| Cause all other slice windows to scroll to RAS point at current cursor location
 
| Shift Key
 
| Shift Key
| Cause all other slice windows to scroll to RAS point at current cursor location
 
 
| Same
 
| Same
 
|-style="background-color: lightgreen"
 
|-style="background-color: lightgreen"
 
| Toggle Slice Visible
 
| Toggle Slice Visible
 +
|
 +
| Make the current slice window show as a plane in the 3D view (respects linking)
 
| v
 
| v
| Make the current slice window show as a plane in the 3D view (respects linking)
 
 
| None
 
| None
 
|-style="background-color: lightpink"
 
|-style="background-color: lightpink"
 
| Toggle Foreground/Background Opacity
 
| Toggle Foreground/Background Opacity
 +
|
 +
| Change opacity of foreground overlay (respects linking) (toggles between current foreground opacity and hidden)
 
| t
 
| t
| Change opacity of foreground overlay (respects linking) (toggles between current foreground opacity and hidden)
 
 
| None
 
| None
 
|-style="background-color: lightgreen"
 
|-style="background-color: lightgreen"
 
| Toggle Label Overlay
 
| Toggle Label Overlay
 +
|
 +
| Show/Hide Label for this slice (respects linking) (toggles between current label opacity and hidden)
 
| g
 
| g
| Show/Hide Label for this slice (respects linking) (toggles between current label opacity and hidden)
 
 
| None
 
| None
 
|-style="background-color: lightpink"
 
|-style="background-color: lightpink"
 
| Cycle Orientations
 
| Cycle Orientations
 +
|
 +
| Cycle through focus in Axial/Sagittal/Coronal/3D window
 
| Tab
 
| Tab
| Cycle through focus in Axial/Sagittal/Coronal/3D window
 
 
| None
 
| None
 
|-style="background-color: lightgreen"
 
|-style="background-color: lightgreen"
 
| Cycle All Orientations
 
| Cycle All Orientations
 +
|
 +
| Cycle through focus in Axial/Sagittal/Coronal/3D window in opposite direction
 
| Shift-Tab
 
| Shift-Tab
| Cycle through focus in Axial/Sagittal/Coronal/3D window in opposite direction
 
 
| None
 
| None
 
|-style="background-color: lightgreen"
 
|-style="background-color: lightgreen"
 
| Fit to window
 
| Fit to window
 +
|
 +
| Set the field of view to match the full extent of the foreground and background volumes (respects linking)
 
| r
 
| r
| Set the field of view to match the full extent of the foreground and background volumes (respects linking)
 
 
| None
 
| None
 
|-
 
|-
Line 209: Line 246:
  
 
=== 3D Manipulation ===
 
=== 3D Manipulation ===
 
 
{| border="1" cellpadding="5"
 
{| border="1" cellpadding="5"
 
|- style="background:#c2c2c2; color:black" align="eft"
 
|- style="background:#c2c2c2; color:black" align="eft"
 
| style="width:20%" | Action
 
| style="width:20%" | Action
| style="width:15%" | Slicer3 Key
+
| style="width:15%" | Slicer4 Key
| style="width:40%" | Meaning
+
| style="width:15%" | Meaning
 +
| style="width:40%" | Slicer3 Key
 
| style="width:10%" | Slicer2 Key
 
| style="width:10%" | Slicer2 Key
 
|-style="background-color: lightgreen"
 
|-style="background-color: lightgreen"
 
| Wireframe
 
| Wireframe
 +
|
 +
| change render mode to wireframe
 
| w
 
| w
| change render mode to wireframe
 
 
| Same
 
| Same
 
|-style="background-color: lightgreen"
 
|-style="background-color: lightgreen"
 
| Shaded
 
| Shaded
 +
|
 +
| change render mode to shaded
 
| s
 
| s
| change render mode to shaded
 
 
| Same
 
| Same
 
|-style="background-color: lightgreen"
 
|-style="background-color: lightgreen"
 
| Reset View
 
| Reset View
 +
|
 +
| Set camera to see all objects
 
| r
 
| r
| Set camera to see all objects
 
 
| None
 
| None
 
|-
 
|-
 
| Toggle Rock Mode
 
| Toggle Rock Mode
 +
|
 +
| Toggle rock mode
 
| TBD
 
| TBD
| Toggle rock mode
 
 
| None
 
| None
 
|-
 
|-
 
| Toggle Spin Mode
 
| Toggle Spin Mode
 +
|
 +
| Toggle spin mode
 
| TBD
 
| TBD
| Toggle spin mode
 
 
| None
 
| None
 
|}
 
|}
Line 248: Line 290:
 
|- style="background:#c2c2c2; color:black" align="eft"
 
|- style="background:#c2c2c2; color:black" align="eft"
 
| style="width:20%" | Action
 
| style="width:20%" | Action
 +
| style="width:15%" | Slicer4 Key
 
| style="width:15%" | Slicer3 Key
 
| style="width:15%" | Slicer3 Key
 
| style="width:40%" | Meaning
 
| style="width:40%" | Meaning
 
|-style="background-color: lightpink"
 
|-style="background-color: lightpink"
 
| Application Menu
 
| Application Menu
 +
|
 
| Space Bar
 
| Space Bar
 
| Brings up a popup menu with all the application operations and their key binding information
 
| Brings up a popup menu with all the application operations and their key binding information
 
|-style="background-color: lightpink"
 
|-style="background-color: lightpink"
 
| Module Navigation
 
| Module Navigation
 +
|
 
| Control-<number>
 
| Control-<number>
 
| Jumps to the numbelightpink module (number order is the same as the order of the shortcut icons in the toolbar at the top of the application.
 
| Jumps to the numbelightpink module (number order is the same as the order of the shortcut icons in the toolbar at the top of the application.
 
|-style="background-color: lightpink"
 
|-style="background-color: lightpink"
 
| Move through module history
 
| Move through module history
 +
|
 
| Control-PageUp/PageDown
 
| Control-PageUp/PageDown
 
| Short cuts for the two arrow buttons next to the module popup menu
 
| Short cuts for the two arrow buttons next to the module popup menu
 
|-style="background-color: lightpink"
 
|-style="background-color: lightpink"
 
| Search for Module
 
| Search for Module
 +
|
 
| Control-F
 
| 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.
 
| Starts an incremental search through the module names and descriptions, terminated by Enter to jump to the module. Probably needs a dialog box.
Line 275: Line 322:
 
|- style="background:#c2c2c2; color:black" align="eft"
 
|- style="background:#c2c2c2; color:black" align="eft"
 
| style="width:20%" | Action
 
| style="width:20%" | Action
| style="width:15%" | Slicer2 Key
+
| style="width:15%" | Slicer4 Key
 
| style="width:40%" | Meaning
 
| style="width:40%" | Meaning
 
| style="width:10%" | Slicer3 Key
 
| style="width:10%" | Slicer3 Key
 +
| style="width:15%" | Slicer2 Key
 
|-
 
|-
 
| Add Fiducial
 
| Add Fiducial
| Control-p
+
|
 
| Adds fiducial at current pointer position
 
| Adds fiducial at current pointer position
 
| p
 
| p
 +
| Control-p
 
|-
 
|-
 
| Delete Fiducial
 
| Delete Fiducial
| Control-d
+
|
 
| Deletes the fiducial picked from current mouse position (ignored if no fiducial is under mouse) in 2D slice window
 
| Deletes the fiducial picked from current mouse position (ignored if no fiducial is under mouse) in 2D slice window
 
| backspace or delete key
 
| backspace or delete key
 +
| Control-d
 
|-
 
|-
 
| Select Fiducial
 
| Select Fiducial
| Control-q
+
|
 
| Selects/Deselects the fiducial under the mouse
 
| Selects/Deselects the fiducial under the mouse
 
| q
 
| q
 +
| Control-q
 
|-
 
|-
 
|
 
|
Line 298: Line 349:
 
| To align slices with fiducials
 
| To align slices with fiducials
 
| Hold down the Control key while moving the fiducial
 
| Hold down the Control key while moving the fiducial
 +
|
 
|-
 
|-
 
|
 
|
Line 303: Line 355:
 
| Jump to the slices aligned to the next fiducial in the list
 
| Jump to the slices aligned to the next fiducial in the list
 
| `
 
| `
 +
|
 
|-
 
|-
 
|
 
|
Line 308: Line 361:
 
| Jump to the slices aligned to the previous fiducial in the list
 
| Jump to the slices aligned to the previous fiducial in the list
 
| Control-`
 
| Control-`
 +
|
 
|-
 
|-
 
|
 
|
Line 313: Line 367:
 
| Create a new Measurements Ruler between the last two selected fiducials
 
| Create a new Measurements Ruler between the last two selected fiducials
 
| Control-m
 
| Control-m
 +
|
 
|}
 
|}
  
Line 320: Line 375:
 
|- style="background:#c2c2c2; color:black" align="eft"
 
|- style="background:#c2c2c2; color:black" align="eft"
 
| style="width:20%" | Action
 
| style="width:20%" | Action
 +
| style="width:15%" | Slicer4 Key
 
| style="width:15%" | Slicer3 Key
 
| style="width:15%" | Slicer3 Key
 
| style="width:40%" | Meaning
 
| style="width:40%" | Meaning
 
|-style="background-color: lightgreen"
 
|-style="background-color: lightgreen"
 
| Open Editor Tool Box
 
| Open Editor Tool Box
 +
|
 
| Space Bar
 
| Space Bar
 
| Opens the Editor Tool Box -- normally this is a pop-up window, but you can turn it into a persistent window by clicking the 'pin open' icon
 
| Opens the Editor Tool Box -- normally this is a pop-up window, but you can turn it into a persistent window by clicking the 'pin open' icon
 
|-style="background-color: lightpink"
 
|-style="background-color: lightpink"
 
| Open Color Selector
 
| Open Color Selector
 +
|
 
| c
 
| c
 
| Opens an interface for choosing a color
 
| Opens an interface for choosing a color
 
|-style="background-color: lightgreen"
 
|-style="background-color: lightgreen"
 
| Move to Next Slice
 
| Move to Next Slice
 +
|
 
| f
 
| f
 
| Displays the next slicelightgreen
 
| Displays the next slicelightgreen
 
|-style="background-color: lightgreen"
 
|-style="background-color: lightgreen"
 
| Move to Previous Slice
 
| Move to Previous Slice
 +
|
 
| b
 
| b
 
| Displays the previous slice
 
| Displays the previous slice
 
|-style="background-color: lightpink"
 
|-style="background-color: lightpink"
 
| Color toggle to black
 
| Color toggle to black
 +
|
 
| d
 
| d
 
| Use this while painting or drawing to quickly erase the label just specified
 
| Use this while painting or drawing to quickly erase the label just specified
 
|-style="background-color: lightpink"
 
|-style="background-color: lightpink"
 
| Apply outline
 
| Apply outline
 +
|
 
| a
 
| a
 
| Applies the current outline in Draw Effect
 
| Applies the current outline in Draw Effect
 
|-style="background-color: lightgreen"
 
|-style="background-color: lightgreen"
 
| Delete last point in Draw Effect
 
| Delete last point in Draw Effect
 +
|
 
| x
 
| x
 
| Deletes the last point in Draw Effect
 
| Deletes the last point in Draw Effect
 
|-
 
|-
 
| Fiducial cycle forward
 
| Fiducial cycle forward
 +
|
 
| `
 
| `
 
| Cycles through fiducials in a fiducial list (this is the backtick key, usually between tab and escape).
 
| Cycles through fiducials in a fiducial list (this is the backtick key, usually between tab and escape).
 
|-
 
|-
 
| Fiducial cycle backward
 
| Fiducial cycle backward
 +
|
 
| Control-`
 
| Control-`
 
| Cycles in reverse direction through a fiducial list.
 
| Cycles in reverse direction through a fiducial list.
Line 366: Line 431:
 
|- style="background:#c2c2c2; color:black" align="eft"
 
|- style="background:#c2c2c2; color:black" align="eft"
 
| style="width:20%" | Action
 
| style="width:20%" | Action
 +
| style="width:15%" | Slicer4 Key
 
| style="width:15%" | Slicer3 Key
 
| style="width:15%" | Slicer3 Key
 
| style="width:40%" | Meaning
 
| style="width:40%" | Meaning
 
|-
 
|-
 
| Middle-mouse equivalent
 
| Middle-mouse equivalent
 +
|
 
| shift + left click on the track pad
 
| shift + left click on the track pad
 
| running either os X or windows in bootcamp on a macbook pro
 
| running either os X or windows in bootcamp on a macbook pro
 
|}
 
|}
 +
 +
<!-- ---------------------------- -->
 +
{{documentation/{{documentation/version}}/slicerapplication-footer}}
 +
<!-- ---------------------------- -->

Latest revision as of 17:04, 21 November 2019

Home < Documentation < 4.0 < SlicerApplication < KeyboardShortcuts


For the latest Slicer documentation, visit the read-the-docs.


Warning Warning: This page is deprecated. Please see the following link for the actual page for Slicer 4:
http://wiki.slicer.org/wiki/Documentation/4.0/SlicerApplication/MouseandKeyboardShortcuts




Back to Slicer 4 Developer projects

Note: this page is work in progress.

Application Hot-keys (keyboard accelerators)

  • 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 + mouse click to get middle mouse events.
  • Control-Left + mouse button should always be available as a substitute for the right mouse button to support one button mice (on Mac).

Warning Warning: Developers: Please note the following reserved key combinations!

General

Key(s) Action bound to key(s)
Ctrl+O Load a new scene (clears existing scene)
Ctrl+A Import a scene (does not clear existing scene) Brings up Add Data instead
Ctrl+W Close a scene
Ctrl+H Set the current module to be the "home" module -- the module that's exposed when Slicer starts up.
Ctrl+Z Undo the last undoable action
Ctrl+Y Redo the last lightpinkoable action
Space-key Toggles the display of Slicer's Edit Box.
Ctrl+P Display the Python console Displays the QT-real console
Ctrl+L Create a new fiducial list.
Ctrl+I Toggle between "Persistent Place" and "Transform View" interaction modes.
Ctrl+M Create a new Ruler measurement between the last two placed fiducials.

Slice Viewer Hot-keys (keyboard accelerators)

Key(s) Action bound to key(s)
` (back-tick key) Navigate to next fiducial in the active Slice Viewer, or in all viewers if they are linked (back-tick is the left single-quote on the key with the tilde (~) character in the upper left side of the keyboard)
Ctrl+` (back-tick key) Navigate to next fiducial in all Slice Viewers, independent of their linked state
Shift+` (back-tick key) Navigate to the previous fiducial in the active Slice Viewer, or in all viewers if they are linked
Ctrl+Shift+` (back-tick key) Navigate to the previous fiducial in all Slice Viewers, independent of their linked state
p-key Place a new fiducial in the active Slice Viewer(adds to the current fiducial list, or creates a list if there are none)
o-key Turn on the Slice Plane reformat widget in the active Slice Viewer
v-key Toggles the slice plane visibility in the main 3D Viewer
r-key Fits the slice view to the volume extents in the active Slice Viewer, or in all viewers if they are linked (the first non-none volume will be used in order of Background, Foreground and Label layers)
b-key Decrement slice in the active Slice Viewer (left or down) by one unit of background pixel spacing
f-key Increment slice in the active Slice Viewer (right or up) by one unit of backgroun dpixel spacing
Backspace-key When the mouse is hovering over a fiducial in the Slice Viewer (turning it yellow), delete that fiducial
Delete-key When the mouse is hovering over a fiducial in the Slice Viewer (turning it yellow), delete that fiducial

Sliders and mouse

  • Every click is 1 step, and 1 step is 1 slice (if there are multiple volumes (Labelmap/Back/Foreground, then its the smallest spacing of the 3 that is used).
  • Middle click directly jumps to the mouse.
  • Home/End keys go to the beginning/end.

Global "hot-keys"

Window Behavior

Action Slicer4 Key Slicer3 Key Meaning
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
Toggle Control Pane View F5 (KWW default) Show or hide the Control Pane depending on state


MRML

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

Slice Manipulation

Action Slicer4 Key Meaning Slicer3 Key Slicer2 Key
Toggle link Toggle linking/unlinking all slices. l None
Next slice for this slice viewer Axial: move Superior, Sag: Right, Cor: Anterior Right Arrow and Up Arrow and f Right Arrow
Previous slice for this slice viewer Axial: move Inferior, Sag: Left, Cor: Posterior Left Arrow and Down Arrow and b Left Arrow
Linked Motion Cause all other slice windows to scroll to RAS point at current cursor location Shift Key Same
Toggle Slice Visible Make the current slice window show as a plane in the 3D view (respects linking) v None
Toggle Foreground/Background Opacity Change opacity of foreground overlay (respects linking) (toggles between current foreground opacity and hidden) t None
Toggle Label Overlay Show/Hide Label for this slice (respects linking) (toggles between current label opacity and hidden) g None
Cycle Orientations Cycle through focus in Axial/Sagittal/Coronal/3D window Tab None
Cycle All Orientations Cycle through focus in Axial/Sagittal/Coronal/3D window in opposite direction Shift-Tab None
Fit to window Set the field of view to match the full extent of the foreground and background volumes (respects linking) r None

3D Manipulation

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

Navigating Application

Action Slicer4 Key Slicer3 Key Meaning
Application Menu Space Bar Brings up a popup menu with all the application operations and their key binding information
Module Navigation Control-<number> Jumps to the numbelightpink module (number order is the same as the order of the shortcut icons in the toolbar at the top of the application.
Move through module history Control-PageUp/PageDown Short cuts for the two arrow buttons next to the module popup menu
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.

Module-specific hot-keys

Fiducials

Action Slicer4 Key Meaning Slicer3 Key Slicer2 Key
Add Fiducial Adds fiducial at current pointer position p Control-p
Delete Fiducial Deletes the fiducial picked from current mouse position (ignored if no fiducial is under mouse) in 2D slice window backspace or delete key Control-d
Select Fiducial Selects/Deselects the fiducial under the mouse q Control-q
To align slices with fiducials Hold down the Control key while moving the fiducial
Jump to the slices aligned to the next fiducial in the list `
Jump to the slices aligned to the previous fiducial in the list Control-`
Create a new Measurements Ruler between the last two selected fiducials Control-m

Editor

Action Slicer4 Key Slicer3 Key Meaning
Open Editor Tool Box Space Bar Opens the Editor Tool Box -- normally this is a pop-up window, but you can turn it into a persistent window by clicking the 'pin open' icon
Open Color Selector c Opens an interface for choosing a color
Move to Next Slice f Displays the next slicelightgreen
Move to Previous Slice b Displays the previous slice
Color toggle to black d Use this while painting or drawing to quickly erase the label just specified
Apply outline a Applies the current outline in Draw Effect
Delete last point in Draw Effect x Deletes the last point in Draw Effect
Fiducial cycle forward ` Cycles through fiducials in a fiducial list (this is the backtick key, usually between tab and escape).
Fiducial cycle backward Control-` Cycles in reverse direction through a fiducial list.

Platform-specific hot-keys

Action Slicer4 Key Slicer3 Key Meaning
Middle-mouse equivalent shift + left click on the track pad running either os X or windows in bootcamp on a macbook pro