View source for Documentation/4.8/SlicerApplication/MouseandKeyboardShortcuts

<noinclude>{{documentation/versioncheck}}</noinclude>
<!-- ---------------------------- -->
{{documentation/{{documentation/version}}/slicerapplication-header}}
<!-- ---------------------------- -->

=Table of Content=
{| border="0" align="center" width="100%" valign="top" cellspacing="7" cellpadding="2"
|-
! width="50%"|
! |
! width="50%"|
|- 
|valign="top"|
=Mouse=
*[[Documentation/{{documentation/version}}/SlicerApplication/MouseandKeyboardShortcuts#Cross_Reference|Cross reference]]
*[[Documentation/{{documentation/version}}/SlicerApplication/MouseandKeyboardShortcuts#Window_.26_Level| Window Level]]
*[[Documentation/{{documentation/version}}/SlicerApplication/MouseandKeyboardShortcuts#Opacity_blending|Opacity Blending]]
*[[Documentation/{{documentation/version}}/SlicerApplication/MouseandKeyboardShortcuts#Rotate.2C_Zoom.2C_Pan|Rotate, Zoom, Pan]]
*[[Documentation/{{documentation/version}}/SlicerApplication/MouseandKeyboardShortcuts#Selecting_.26_Manipulating|Selecting and Manipulating]]
*[[Documentation/{{documentation/version}}/SlicerApplication/MouseandKeyboardShortcuts#Mouse_Modes|Mouse modes]]

|bgcolor="#CCCCCC"|
|valign="top"|

=[[Documentation/{{documentation/version}}/SlicerApplication/MouseandKeyboardShortcuts#Keyboard_Accelerators| Keyboard Accelerators]]=
*[[Documentation/{{documentation/version}}/SlicerApplication/MouseandKeyboardShortcuts#General| General]]
*[[Documentation/{{documentation/version}}/SlicerApplication/MouseandKeyboardShortcuts#3D_Viewer| 3D Viewer]]
*[[Documentation/{{documentation/version}}/SlicerApplication/MouseandKeyboardShortcuts#Slice_Viewer| Slice Viewer]]
*[[Documentation/{{documentation/version}}/SlicerApplication/MouseandKeyboardShortcuts#Transfer_Functions| Transfer functions]]
*[[Documentation/{{documentation/version}}/SlicerApplication/MouseandKeyboardShortcuts#Keyboard_Shortcuts.E2.80.94Windows| Non-Slicer Key bindings for Windows]]
*[[Documentation/{{documentation/version}}/SlicerApplication/MouseandKeyboardShortcuts#Keyboard_Shortcuts.E2.80.94Mac| Non-Slicer Key bindings for Mac]]
*[[Documentation/{{documentation/version}}/SlicerApplication/MouseandKeyboardShortcuts#Python_Interactor|Python Interactor]]
|}

=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 [http://www.slicer.org/slicerWiki/index.php/Documentation/{{documentation/version}}/Modules/Volumes Volumes Module] for more precise controls.

==Opacity blending== 
*Ctrl ([[image: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.

|[[image:2011-12-Crosshair-Toolbar.png|150px|thumb|Crosshair-Toolbar<br>A variety of crosshair modes are available in Slicer]]
|}

==Rotate, Zoom, Pan==

{| border="1" width="100%" valign="top" cellspacing="3" cellpadding="3"
|style="background:#ffefd5;"|'''Interface Device/Action'''	
|style="background:lightyellow;" |'''Rotate''' (3D viewers only) 	
|style="background:lightyellow;" |'''Zoom''' 	
|style="background:lightyellow;" |'''Pan''' 
|-
|style="background:bisque;" |'''3-button''' 	
|Left-click & drag 	
|Right-Click & vertical drag 	
|Middle-Click & drag 
|-
|style="background:bisque;" |'''2-button'''
|Left-click & drag 	
|Right-Click & vertical drag 	
|Shift+Left-Click & drag 
|-
|style="background:bisque;" |'''1-button''' 	
|Left-click & drag 	
|Ctrl+Left-Click & vertical drag 	
|Shift+Left-Click & drag
|- 
|style="background:bisque;" |'''1-button Mac''' 	
|Left-click & drag 	
|[[image:Apple-Command.png]](command)+Left-Click & vertical drag 	
|Shift+Left-Click & drag
|- 
|style="background:bisque;" |'''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.
|[[image:MouseModeToolbar-2011-12.png|thumb|200px|Mouse Mode Toolbar<br>Transform icon to the left]]
|}

=Keyboard Accelerators=
*On Mac OS X use the Command key ([[image: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 [[Documentation/{{documentation/version}}/Modules/Editor#Keystrokes|Editor keyboard shortcuts]] for example.

==General==

{| class="wikitable"
|- border="1"
! align="left" |Key
! align="left" |Effect
|-
| style="width:200px" | '''Ctrl+O'''
| align="left"|Load a new scene (clears existing scene)
|-
| style="width:200px"|'''Ctrl+A''' 
| align="left"|Import a scene (does not clear existing scene) Brings up '''Add Data''' instead
|-
| style="width:200px" |'''Ctrl+S''' 
| align="left"| Save a scene
|-
| style="width:200px" |'''Ctrl+W''' 
| align="left"| Close a scene
|-
| style="width:200px" |'''Ctrl+Z''' 
| align="left"| Undo the history of undoable commands, from last to first.
|-
| style="width:200px" |'''Ctrl+Y''' 
| align="left"| Redo the history of undoable commands, from last to first.
|-
| style="width:200px" |'''Ctrl+H''' 
| align="left"| Set current module to "home" module for easy access.
|-
| style="width:200px"| '''Space''' 
| align="left"| Toggles the display of Slicer's Edit Box.
|-
| style="width:200px" | '''Ctrl+P ''' 
| align="left"| Display the Python console  '''Displays the QT-real console'''
|-
| style="width:200px" | '''Ctrl+L ''' 
| align="left" | Create a new fiducial list.
|-
| style="width:200px" | '''Ctrl+I''' 
| align="left" | Toggle between "Persistent Place" and "Transform View" interaction modes.
|-
| style="width:200px" | '''Ctrl+M ''' 
| align="left" | Create a new Ruler measurement between the last two placed fiducials.
|-
| style="width:200px" | '''Ctrl+0 ''' 
| align="left" | Display error log.
|-
| style="width:200px" | '''Ctrl+1 ''' 
| align="left" | Interface documentation.
|-
| style="width:200px" | '''Ctrl+2 ''' 
| align="left" | Display the '''Application Settings Interface''' for customizing Slicer.
|-
| style="width:200px" | '''Ctrl+3 ''' 
| align="left" | Python Interactor.
|-
| style="width:200px" | '''Ctrl+4 ''' 
| align="left" | Extension Manager.
|-
| style="width:200px" | '''Ctrl+5 ''' 
| align="left" | Toggle Module Panel visible/invisible.
|-
| style="width:200px" | '''Ctrl+F ''' 
| align="left" | Select module search box
|-
| style="width:200px" | '''Ctrl+Left ''' 
| align="left" | Go to previous module in history.
|-
| style="width:200px" | '''Ctrl+Right ''' 
| align="left" | Go to next module in history.
|}

== 3D Viewer==

{| class="wikitable"
|- border="1"
! align="left" |Key
! align="left" |Effect
|- style="width:200px" | <span style="background-color: lightgreen"><font color="midnightblue">
|'''r''' 
| align="left"| Fits the cameras field of view to show all that is visible in the viewer
|-
| style="width:200px" |'''w ''' 
| align="left" | Show triangulated surface models as wireframe.
|-
| style="width:200px" |'''s ''' 
| align="left" | Show triangulated surface models as shaded surfaces.
|}

== Slice Viewer==

{| class="wikitable"
|- border="1"
! align="left" |Key
! align="left" |Effect
|-
| style="width:200px" | '''v''' 
| align="left"| Toggles the slice plane visibility in the main 3D Viewer
|-
| style="width:200px" | '''r''' 
| align="left""| 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" | '''g''' 
| align="left""| Toggles the opacity of the label layer
|-
| style="width:200px" | '''t''' 
| align="left""| Toggles the opacity of the foreground layer
|-
| style="width:200px" | '''b''' or '''f'''
| align="left"| Decrease or increase visible slice in the active Slice Viewer (left or down) by one unit of background pixel spacing
|-
| style="width:200px" | '''[''' or ''']'''
| align="left"| Change background volume by cycle forward or backward through the volumes loaded in the scene 
|-
| style="width:200px" | '''{''' or '''}'''
| align="left"| Change foreground volume by cycle forward or backward through the volumes loaded in the scene 
|-
| style="width:200px" | '''` (back-tick)'''
| 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) ''Reserved, but not yet implemented in Slicer 4.x''
|-
| style="width:200px" | '''Ctrl+` (back-tick)''' 
| align="left" |Navigate to next fiducial in all Slice Viewers, independent of their linked state ''Reserved, but not yet implemented in Slicer 4.x''
|-
| style="width:200px" | '''Shift+` (back-tick)''' 
| align="left" | 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''
|-
| style="width:200px" | '''Ctrl+Shift+` (back-tick)''' 
| align="left" | Navigate to the previous fiducial in all Slice Viewers, independent of their linked state ''Reserved, but not yet implemented in Slicer 4.x''
|-
| style="width:200px" | '''p''' 
| 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) ''Reserved, but not yet implemented in Slicer 4.x''
|-
| style="width:200px" | '''Backspace''' 
| align="left" | 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''
|-
| style="width:200px" | (forward)'''Delete''' 
| align="left" | 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''
|-
| style="width:200px" | '''s''' 
| align="left" | Selects the active slice in lightbox mode ''Reserved, but not yet implemented in Slicer 4.x''
|}

==Transfer Functions==
[[image:VolumeRendering-TransferFunction.png|thumb|right|348px|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
** '''Ctrl & arrow key''': Move current point horizontally & vertically'' ''(to do)''
* 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
** '''Ctrl & arrow key''': Move selected points'' ''(to do)''
** '''+ 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.

*source: http://www.pcmag.com/article2/0,2817,2400112,00.asp
==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
#. Alt + Tab (toggle between programs)
#. Windows button + M (show desktop, i.e., minimize all windows)
#. Windows button + Tab (show all active windows in task bar)
#. PrtScn (save screen capture to clipboard; "paste" the image into an image-editing program to make it into a file)
#. Windows button (opens applications menu)

*Browser Shortcuts
#. Ctrl + T (open a new tab)
#. Ctrl + Shift + t (reopens the tab you last closed; works multiple times)
#. F5 (reload page)
#. Backspace (go to previous page; works multiple times)
#. Ctrl + Tab (cycle between tabs)

*Commonly Used Shortcuts in Most Applications
#. Ctrl+ Z (undo last operation)
#. Ctrl + Y (redo last operation)
#. Crtl + O (open file)
#. Crtl + S (save)
#. Ctrl + W (close active window or file)
#. Crtl + Q (quit application)

*Copy-and-Pasters' Delight
#. Ctrl + A (select all in active window; e.g., select all text on page)
#. Ctrl + X (cut to clipboard)
#. Ctrl + C (copy)
#. Ctrl + V (paste)

*Find, Select, and Navigate Text
#. Ctrl + F (find; helpful if you're searching for a particular word on a website or document)
#. Ctrl + Shift + down arrow (select until end of line)
#. Ctrl + Shift + up arrow (select until beginning of line)
#. Ctrl + Home (move cursor to top/start of document)
#. 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
#. Command + Tab (toggle between programs)
#. Command + M (minimize active window)
#. Swipe three fingers up on trackpad (show all active windows)
#. 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.)
#. Command + N (opens new Finder from desktop; new window/file in most other programs)

*Browser Shortcuts
#. Command + T (open a new tab)
#. Command + Shift + t (reopens the tab you last closed in Chrome, Firefox, Opera; works multiple times)
#. Command + R (reload page)
#. Backspace (go to previous page; works multiple times)
#. Control + Tab (cycle between tabs/go to next tab in Chrome, Firefox, Opera)

*Commonly Used Shortcuts in Most Applications
#. Command + Z (undo last operation)
#. Command + Y (redo last operation)
#. Command + O (open file)
#. Command + S (save)
#. Command + W (close active window or file)
#. Command + Q (quit application)

*Copy-and-Pasters' Delight
#. Command + A (select all in active window; e.g., select all text on page)
#. Command + X (cut to clipboard)
#. Command + C (copy)
#. Command + V (paste)

*Find, Select, and Navigate Text
#. Command + F (find; helpful if you're searching for a particular word on a website or document)
#. Command + Shift + down arrow (select until end of line)
#. Command + Shift + up arrow (select until beginning of line)
#. Command + up arrow (move cursor to top/start of document)
#. Command + down arrow (move cursor to bottom/end of document)

==Keyboard Shortcuts-Ubuntu==
[https://help.ubuntu.com/community/KeyboardShortcuts Ubuntu Keyboard Shortcuts] are listed on this webpage.

== Python Interactor ==
* '''Ctrl + H''' : Print help message
* '''Ctrl + R''' : Open a file dialog to select a file to run