|
|
Line 1: |
Line 1: |
− | = Keyboard accelerators =
| + | <big>'''Note:''' We are migrating this content to the slicer.org domain - <font color="orange">The newer page is [http://www.slicer.org/slicerWiki/index.php/Slicer3:EventBindings#Mouse_Modes_and_Actions here]</font></big>a |
− | | |
− | A list of global "hot-keys" and module-specific "hot-keys" for Slicer2 and Slicer3 is being actively compiled below. (This page is a little out of sync with development -- please make current!) With respect to the specification of keyboard accelerators, please follow these three recommendations;
| |
− | | |
− | * Before assigning "hot-keys" to functionality, either in the main Slicer application or in a new module, please consult the list below to make sure the key is not already mapped.
| |
− | * Across Slicer modules, try to use similar "hot-key" assignments for similar functionality, and try to observe existing paradigms outlined below; this consistency makes Slicer easier for users to learn.
| |
− | * Once you assign "hot-keys" in your module, please add those mappings to the list below for others to reference.
| |
− | | |
− | == Design paradigms ==
| |
− | | |
− | * use CTRL-modified keys as global, and non-modified keys for module-specific accelerators.
| |
− | * use ALT modifiers to access menu items
| |
− | * SHIFT modifiers should apply to all instances of the same type as the current window
| |
− | | |
− | == Design ideas ==
| |
− | | |
− | * using CTRL-1, CTRL-2 CTRL-3 to navigate to most commonly used modules in the base (for instance, Data, Volumes, Editor?).
| |
− | * having hotkeys to toggle between axial, saggital, and coronal views in a slice window.
| |
− | * having a hotkey to toggle any window the mouse is inside between full screen and current size.
| |
− | * consistent set of mouse actions in 2D, 3D and control windows
| |
− | * consistent set of mouse-mode switches in 2D, 3D windows
| |
− | * use the right menu button to bring up a context-dependent menu (e.g. actions appropriate for the item under the cursor).
| |
− | | |
− | == Global "hot-keys" ==
| |
− | | |
− | === Window Behavior ===
| |
− | | |
− | {| border="1" cellpadding="5"
| |
− | |- style="background:#c2c2c2; color:black" align="eft"
| |
− | | style="width:20%" | Action
| |
− | | style="width:15%" | Slicer3 Key
| |
− | | style="width:40%" | Meaning
| |
− | | style="width:10%" | Slicer3 Key
| |
− | |-
| |
− | | 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
| |
− | | None
| |
− | |-
| |
− | | Toggle Control Pane View
| |
− | | F5 (KWW default)
| |
− | | Show or hide the Control Pane depending on state
| |
− | | None
| |
− | |}
| |
− | <br /> | |
− | | |
− | === MRML ===
| |
− | {| border="1" cellpadding="5"
| |
− | |- style="background:#c2c2c2; color:black" align="eft"
| |
− | | style="width:20%" | Action
| |
− | | style="width:15%" | Slicer3 Key
| |
− | | style="width:40%" | Meaning
| |
− | | style="width:10%" | Slicer3 Key
| |
− | | |
− | |-
| |
− | | Open Scene...
| |
− | | Control-O
| |
− | | Bring up file browser to locate .mrml file
| |
− | | None
| |
− | |-
| |
− | | Save Scene
| |
− | | Control-S
| |
− | | Save current scene no browser, disabled if no current file. If no current scene, does Save As...
| |
− | | None
| |
− | |-
| |
− | | Save Scene As...
| |
− | | None
| |
− | | Bring up file browser to locate .mrml file
| |
− | | None
| |
− | |-
| |
− | | Undo
| |
− | | Control-Z
| |
− | | Revert to last undo point
| |
− | | None
| |
− | |-
| |
− | | Redo
| |
− | | Control-Y
| |
− | | Revert to last redo point
| |
− | | None
| |
− | |-
| |
− | | Other Menu Items
| |
− | | Alt-<letter>
| |
− | | Bring up or invoke menu or menu item corresponding to letter
| |
− | | Same
| |
− | |}
| |
− | | |
− | | |
− | === Slice Manipulation ===
| |
− | | |
− | {| border="1" cellpadding="5"
| |
− | |- style="background:#c2c2c2; color:black" align="eft"
| |
− | | style="width:20%" | Action
| |
− | | style="width:15%" | Slicer3 Key
| |
− | | style="width:40%" | Meaning
| |
− | | style="width:10%" | Slicer3 Key
| |
− | |-
| |
− | | Next slice
| |
− | | Right Arrow and Up Arrow
| |
− | | Axial: move Superior, Sag: Right, Cor: Anterior
| |
− | | Right Arrow
| |
− | |-
| |
− | | Previous slice
| |
− | | Left Arrow and Down Arrow
| |
− | | Axial: move Inferior, Sag: Left, Cor: Posterior
| |
− | | Left Arrow
| |
− | |-
| |
− | | Linked Motion
| |
− | | Shift Key
| |
− | | Cause other slice windows to scroll to RAS point at current cursor location
| |
− | | Same
| |
− | |-
| |
− | | Toggle Slice Visible
| |
− | | v
| |
− | | Make the current slice window show as a plane in the 3D view
| |
− | | None
| |
− | |-
| |
− | | Toggle All Slices Visible
| |
− | | V
| |
− | | Make all slices show in 3D View
| |
− | | None
| |
− | |-
| |
− | | Toggle Foreground/Background Opacity
| |
− | | T
| |
− | | Change opacity of foreground overlay
| |
− | | None
| |
− | |-
| |
− | | Toggle Label Overlay
| |
− | | g
| |
− | | Show/Hide Label for this slice
| |
− | | None
| |
− | |-
| |
− | | Toggle Label Overlay
| |
− | | G
| |
− | | Show/Hide Label for all slices
| |
− | | None
| |
− | |-
| |
− | | Cycle Orientations
| |
− | | Tab
| |
− | | Cycle through Axial/Sagittal/Coronal
| |
− | | None
| |
− | |-
| |
− | | Cycle All Orientations
| |
− | | Shift-Tab
| |
− | | Cycle through Axial/Sagittal/Coronal in all slice windows
| |
− | | None
| |
− | |-
| |
− | | Fit to volume
| |
− | | f
| |
− | | Set the field of view to match the full extent of the foreground and background volumes
| |
− | | None
| |
− | |-
| |
− | | Fit to volumes all
| |
− | | Shift-F
| |
− | | Set the field of view in all slices to match the full extent of the foreground and background volumes
| |
− | | None
| |
− | |}
| |
− | | |
− | | |
− | === 3D Manipulation ===
| |
− | | |
− | {| border="1" cellpadding="5"
| |
− | |- style="background:#c2c2c2; color:black" align="eft"
| |
− | | style="width:20%" | Action
| |
− | | style="width:15%" | Slicer3 Key
| |
− | | style="width:40%" | Meaning
| |
− | | style="width:10%" | Slicer3 Key
| |
− | |-
| |
− | | Wireframe
| |
− | | w
| |
− | | change render mode to wireframe
| |
− | | Same
| |
− | |-
| |
− | | Shaded
| |
− | | s
| |
− | | change render mode to shaded
| |
− | | Same
| |
− | |-
| |
− | | Reset View
| |
− | | r
| |
− | | Set camera to see all objects
| |
− | | None
| |
− | |-
| |
− | | Toggle Rock Mode
| |
− | | TBD
| |
− | | Toggle rock mode
| |
− | | None
| |
− | |-
| |
− | | Toggle Spin Mode
| |
− | | TBD
| |
− | | Toggle spin mode
| |
− | | None
| |
− | |}
| |
− | | |
− | | |
− | === Navigating Application ===
| |
− | | |
− | {| border="1" cellpadding="5"
| |
− | |- style="background:#c2c2c2; color:black" align="eft"
| |
− | | style="width:20%" | Action
| |
− | | style="width:15%" | Slicer3 Key
| |
− | | style="width:40%" | Meaning
| |
− | | style="width:10%" | Slicer3 Key
| |
− | |-
| |
− | | Application Menu
| |
− | | Space Bar
| |
− | | Brings up a popup menu with all the application operations and their key binding information
| |
− | | None
| |
− | |-
| |
− | | Module Navigation
| |
− | | Control-<number>
| |
− | | Jumps to the numbered module (number order is the same as the order of the shortcut icons in the toolbar at the top of the application.
| |
− | | None
| |
− | |-
| |
− | | Move through module history
| |
− | | Control-PageUp/PageDown
| |
− | | Short cuts for the two arrow buttons next to the module popup menu
| |
− | | None
| |
− | |-
| |
− | | 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.
| |
− | | None
| |
− | |}
| |
− | | |
− | | |
− | == Module-specific hot-keys ==
| |
− | | |
− | === Fiducials ===
| |
− | | |
− | {| border="1" cellpadding="5"
| |
− | |- style="background:#c2c2c2; color:black" align="eft"
| |
− | | style="width:20%" | Action
| |
− | | style="width:15%" | Slicer3 Key
| |
− | | style="width:40%" | Meaning
| |
− | | style="width:10%" | Slicer3 Key
| |
− | |-
| |
− | | Add Fiducial
| |
− | | Control-p
| |
− | | Adds fiducial at current pointer position
| |
− | | Same
| |
− | |-
| |
− | | Delete Fiducial
| |
− | | Control-d
| |
− | | Deletes the fiducial picked from current mouse position (ignored if no fiducial is under mouse)
| |
− | | Same
| |
− | |-
| |
− | | Select Fiducial
| |
− | | Control-q
| |
− | | Selects/Deselects the fiducial under the mouse
| |
− | | q
| |
− | |}
| |
− | | |
− | | |
− | === Editor ===
| |
− | | |
− | {| border="1" cellpadding="5"
| |
− | |- style="background:#c2c2c2; color:black" align="eft"
| |
− | | style="width:20%" | Action
| |
− | | style="width:15%" | Slicer3 Key
| |
− | | style="width:40%" | Meaning
| |
− | | style="width:10%" | Slicer3 Key
| |
− | |}
| |
− | | |
− | = Mouse Actions =
| |
− | | |
− | == Button Use Constraints ==
| |
− | | |
− | * 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).
| |
− | | |
− | == Toolbar ==
| |
− | | |
− | The current mouse mode will always be visible in a toolbar in the slicer display. There will also be hot keys to select specify mouse modes. Instead of (or in addition to) a toolbar we may want to use a WWidget in the overlay planes to reflect the mouse mode.
| |
− | | |
− | == Mouse Modes and Actions ==
| |
− | | |
− | [[Slicer3:UIDesign#Working_problem:_controlling_mouse_mode_in_Slicer.27s_Viewers | Interaction design for mouse-modes is under development; you can see design and contribute feedback on this page.]]
| |