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

From Slicer Wiki
Jump to: navigation, search
m (Text replacement - "slicerWiki/index.php" to "wiki")
 
(18 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 93: Line 105:
 
| 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 229: 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 268: 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 295: 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 318: 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 323: 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 328: 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 333: 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 340: 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 386: 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