Documentation/4.4/SlicerApplication/MouseandKeyboardShortcuts

From Slicer Wiki
Revision as of 06:41, 25 December 2014 by UpdateBot (talk | contribs) (Nightly -> 4.4)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search
Home < Documentation < 4.4 < SlicerApplication < MouseandKeyboardShortcuts


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



Table of Content

Mouse

Keyboard Accelerators

Mouse Operations

Below is basic information about how to use the three-, two-, and one-button mouse (or trackpad) on Windows, Mac, and Linux platforms to perform basic interaction operations in Slicer:

Cross Reference

Holding down the Shift-Key while moving the mouse in any Slice Viewer will cause other Slice Viewers to scroll to the same position. This feature can be combined with cross-hairs.

Crosshairs

Crosshairs are available for precise cross-correlation between Sliceviewers. Their appearance can be changed. In Navigation mode a box at the center of the crosshair allows to center the other Sliceviewers to that location by clicking and dragging the box.

Window & Level

  • Left-click & drag in a Slice Viewer adjusts Window / Level.
    • Adjust the level by moving the mouse vertically
    • Adjust the window by moving the mouse horizontally
  • An interface with sliders and numeric input fields is available in the Volumes Module for more precise controls.

Opacity blending

  • Ctrl (Apple-Command.png on the Mac) & Left-click & drag in a Slice Viewer adjusts opacity.
    • Adjust the foreground opacity by moving the mouse vertically
    • Adjust the labelmap opacity by moving the mouse horizontally
  • An interface with sliders and numeric input fields is available in the Slice View Controller for more precise controls.
Crosshair-Toolbar
A variety of crosshair modes are available in Slicer

Rotate, Zoom, Pan

Interface Device/Action Rotate (3D viewers only) Zoom Pan
3-button Left-click & drag Right-Click & vertical drag Middle-Click & drag
2-button Left-click & drag Right-Click & vertical drag Shift+Left-Click & drag
1-button Left-click & drag Ctrl+Left-Click & vertical drag Shift+Left-Click & drag
1-button Mac Left-click & drag Apple-Command.png(command)+Left-Click & vertical drag Shift+Left-Click & drag
Trackpad Mac Left-click & drag two-fingers & vertical drag Shift+Left-Click & drag

Selecting & Manipulating

Mousing over any "pickable" object in any of Slicer's viewers will cause the cursor to change from a "pointer" into a "picking hand". When the cursor shows a picking hand, left-clicking and dragging the mouse will pick and manipulate the object. Releasing the mouse button will de-select the object.

Mouse Modes

Slicer has two mouse modes: Transform, and Place. The icons in the mouse mode toolbar at the top of the main GUI allow to switch between these mouse modes and to modulate their behavior.
  • Transform mode is the default interaction mode. This mode allows interactive rotation (3D viewer only), pan/translation and zoom (see above).
  • Place mode allows to place one object then switches modes back to Transform mode. Place mode can be made persistent by clicking the checkbox adjacent to place mode. This allows to place multiple objects (e.g. fiducials).
    • Fiducial is the default object in Place mode
    • Ruler and Region Of Interest (ROI) Widgets are other available objects in the Place Mode menu.
Mouse Mode Toolbar
Transform icon to the left

Keyboard Accelerators

  • On Mac OS X use the Command key (Apple-Command.png) instead of the Control (Ctrl) key
  • fn-Delete is used for Forward Delete on built-in keyboards of portable Macs

Note that in addition to the global keyboard accelerators listed here, individual modules may define their own accelerators that are active when the module is active. See the Editor keyboard shortcuts for example.

General

Key Effect
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+S Save a scene
Ctrl+W Close a scene
Ctrl+Z Undo the history of undoable commands, from last to first.
Ctrl+Y Redo the history of undoable commands, from last to first.
Ctrl+H Set current module to "home" module for easy access.
Space 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.
Ctrl+0 Display error log.
Ctrl+1 Interface documentation.
Ctrl+2 Display the Application Settings Interface for customizing Slicer.
Ctrl+3 Python Interactor.
Ctrl+4 Extension Manager.
Ctrl+5 Toggle Module Panel visible/invisible.
Ctrl+F Select module search box
Ctrl+Left Go to previous module in history.
Ctrl+Right Go to next module in history.

3D Viewer

Key Effect
r Fits the cameras field of view to show all that is visible in the viewer
w Show triangulated surface models as wireframe.
s Show triangulated surface models as shaded surfaces.

Slice Viewer

Key Effect
v Toggles the slice plane visibility in the main 3D Viewer
r 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)
g Toggles the opacity of the label layer
t Toggles the opacity of the foreground layer
b or f Decrease or increase visible slice in the active Slice Viewer (left or down) by one unit of background pixel spacing
[ or ] Change background volume by cycle forward or backward through the volumes loaded in the scene
{ or } Change foreground volume by cycle forward or backward through the volumes loaded in the scene
` (back-tick) 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) Reserved, but not yet implemented in Slicer 4.x
Ctrl+` (back-tick) Navigate to next fiducial in all Slice Viewers, independent of their linked state Reserved, but not yet implemented in Slicer 4.x
Shift+` (back-tick) Navigate to the previous fiducial in the active Slice Viewer, or in all viewers if they are linked Reserved, but not yet implemented in Slicer 4.x
Ctrl+Shift+` (back-tick) Navigate to the previous fiducial in all Slice Viewers, independent of their linked state Reserved, but not yet implemented in Slicer 4.x
p Place a new fiducial in the active Slice Viewer(adds to the current fiducial list, or creates a list if there are none) Reserved, but not yet implemented in Slicer 4.x
Backspace When the mouse is hovering over a fiducial in the Slice Viewer (turning it yellow), delete that fiducial Reserved, but not yet implemented in Slicer 4.x
(forward)Delete When the mouse is hovering over a fiducial in the Slice Viewer (turning it yellow), delete that fiducial Reserved, but not yet implemented in Slicer 4.x
s Selects the active slice in lightbox mode Reserved, but not yet implemented in Slicer 4.x

Transfer Functions

Transfer function in Volume Rendering module
  • Current point (larger radius point)
    • Left click' on an existing point : make a point current
    • Right arrow key or Top arrow key: Make next point current
    • Left arrow key or Bottom arrow key: Make previous point current
    • Left click & drag: Move current point
    • Todo: Ctrl & arrow key: Move current point horizontally & vertically
  • Add a point
    • Left click in an empty space
  • Remove a point
    • Middle click: Remove and make next point current
    • Backspace key: Remove and make previous point current
    • Del[ete] key: Remove and make next point current
  • Multi-selection (blue points)
    • Right click & drag: Select points inside rubber band area
    • Right click a point: Toggle point selection
    • Space key: Toggle current point
    • Shift & arrow key: Select next/previous point
    • Left click & drag: Move selected points
    • Todo: Ctrl & arrow key: Move selected points
    • + key: Expand selected points
    • - key: Contract selected points
  • Zoom
    • Mouse wheel zooms in and out the view

Non-Slicer Keybindings for Win, Mac, and Ubuntu

  • This section was inserted for compatibility considerations.

Keyboard Shortcuts—Windows

Note: Single letter keys are shown capitalized, but you do not have to hold Shift unless it's specified. You also don't have to type the plus sign; plus sign just means push the keys on either side of it at the same time.

  • Commonly Used OS-Level Shortcuts
  1. . Alt + Tab (toggle between programs)
  2. . Windows button + M (show desktop, i.e., minimize all windows)
  3. . Windows button + Tab (show all active windows in task bar)
  4. . PrtScn (save screen capture to clipboard; "paste" the image into an image-editing program to make it into a file)
  5. . Windows button (opens applications menu)
  • Browser Shortcuts
  1. . Ctrl + T (open a new tab)
  2. . Ctrl + Shift + t (reopens the tab you last closed; works multiple times)
  3. . F5 (reload page)
  4. . Backspace (go to previous page; works multiple times)
  5. . Ctrl + Tab (cycle between tabs)
  • Commonly Used Shortcuts in Most Applications
  1. . Ctrl+ Z (undo last operation)
  2. . Ctrl + Y (redo last operation)
  3. . Crtl + O (open file)
  4. . Crtl + S (save)
  5. . Ctrl + W (close active window or file)
  6. . Crtl + Q (quit application)
  • Copy-and-Pasters' Delight
  1. . Ctrl + A (select all in active window; e.g., select all text on page)
  2. . Ctrl + X (cut to clipboard)
  3. . Ctrl + C (copy)
  4. . Ctrl + V (paste)
  • Find, Select, and Navigate Text
  1. . Ctrl + F (find; helpful if you're searching for a particular word on a website or document)
  2. . Ctrl + Shift + down arrow (select until end of line)
  3. . Ctrl + Shift + up arrow (select until beginning of line)
  4. . Ctrl + Home (move cursor to top/start of document)
  5. . Ctrl + End (move cursor to bottom/end of document)

Keyboard Shortcuts—Mac

Note: Single letter keys are shown capitalized, but you do not have to hold Shift unless it's written. You also don't have to type the plus sign; plus sign just means push the keys on either side of it at the same time.

  • Commonly Used OS-Level Shortcuts
  1. . Command + Tab (toggle between programs)
  2. . Command + M (minimize active window)
  3. . Swipe three fingers up on trackpad (show all active windows)
  4. . Command + Shift + 3 (take screen shot; the default settings will save it to a predefined location, usually the "Pictures" folder and name it "Picture1," "Picture2," etc.)
  5. . Command + N (opens new Finder from desktop; new window/file in most other programs)
  • Browser Shortcuts
  1. . Command + T (open a new tab)
  2. . Command + Shift + t (reopens the tab you last closed in Chrome, Firefox, Opera; works multiple times)
  3. . Command + R (reload page)
  4. . Backspace (go to previous page; works multiple times)
  5. . Control + Tab (cycle between tabs/go to next tab in Chrome, Firefox, Opera)
  • Commonly Used Shortcuts in Most Applications
  1. . Command + Z (undo last operation)
  2. . Command + Y (redo last operation)
  3. . Command + O (open file)
  4. . Command + S (save)
  5. . Command + W (close active window or file)
  6. . Command + Q (quit application)
  • Copy-and-Pasters' Delight
  1. . Command + A (select all in active window; e.g., select all text on page)
  2. . Command + X (cut to clipboard)
  3. . Command + C (copy)
  4. . Command + V (paste)
  • Find, Select, and Navigate Text
  1. . Command + F (find; helpful if you're searching for a particular word on a website or document)
  2. . Command + Shift + down arrow (select until end of line)
  3. . Command + Shift + up arrow (select until beginning of line)
  4. . Command + up arrow (move cursor to top/start of document)
  5. . Command + down arrow (move cursor to bottom/end of document)

Keyboard Shortcuts-Ubuntu

Ubuntu Keyboard Shortcuts are listed on this webpage.