Mouse-look Navigation™ User-guide
Chapters
Home
Features
Settings & Keymaps
Extras
Changelog
Table of Contents
Settings
UI section
- Info in header - whether to display mode and zoom info in 3D Viewport's header during the navigation
- Buttons in header - whether to display Mouselook Navigation buttons in 3D Viewport's header
- Use Blender's colors - if enabled, Blender's 3D Viewport\View Overlay theme color is used for crosshair and for ZBrush border
- Crosshair - whether to display the crosshair
- Focus Point - whether to display the viewport's focus point (when it's not the same as the current orbit point)
- Visible - color for the visible parts of the crosshair
- Obscured - color for the obscured parts of the crosshair
- ZBrush border - whether to display ZBrush border
- Scale - relative size of the border (percentage of viewport size)
- Min - absolute size of the border (in pixels)
- Color - color of the border
Behavior section
- Non-blocking - if enabled, navigation will not block execution of other operators
- Framerate - update rate during the navigation (in frames per second)
- FPS horizontal - if enabled, FPS forward/backward moves in horizontal plane, and up/down moves in the world's vertical direction
- Zoom to selection - if both this and Blender's Rotate Around Selection preference are enabled, Mouselook Navigation will zoom to the center of selection
- Adjust Multires - if this and the Fast Navigate option (in Blender's Sculpt menu) are enabled, the sculpt resolution of Multires modifier will be set to 1 during the navigation in Sculpt mode (WARNING: for high-detail meshes, this will cause lag / delays when starting or ending the navigation)
- Zoom speed - speed multiplier for zooming.
- Rotation speed - speed multiplier for rotation.
- Movement speed - speed multiplier for FPS movement.
- Autolevel speed - the speed of autolevelling
- Geometry detection (affects the addon's behavior in ZBrush mode and/or when Blender's Auto Depth preference is enabled)
- Geometry detection method - how to detect the geometry under the mouse
- Raycast - uses raycasting; can detect only mesh objects (WARNING: causes problems in Sculpt mode)
- Selection - uses Blender's selection operator (WARNING: causes problems in Sculpt mode)
- Z-buffer - renders the viewport to a depth buffer (WARNING: triggers a full viewport redraw; may potentially crash Blender, if other addons attempt to use wm.redraw_timer() in the same frame)
- Object modes - in which object modes geometry detection should be used
- Radius - distance (in pixels) to the nearest geometry, above which ZBrush navigation is allowed
- Orbit snap (options for angle snapping during orbiting)
- Projection - if Blender's Auto Perspective preference is enabled, orbit snapping would switch the view to Orthographic or Perspective mode
- Don't change projection - stay in the original projection mode
- Blender's projection - use Blender's default Auto Perspective behavior
- ON: Ortho, OFF: Perspective - switch to Orthographic when snapping, and to Perspective otherwise
- ON: Ortho, OFF: Original - switch to Orthographic when snapping, and to the initial projection mode otherwise
- Subdivs - number of intermediate angles to which the view rotation can be snapped (1 snaps to each 90 degrees, 2 snaps to each 45 degrees, and so on)
- Trackball (options related to Trackball mode)
- Trackball mode - which trackball algorithm to use
- Center - rotation depends only on mouse speed and not on mouse position
- Wrapped - like Center, but rotation depends on mouse position
- Blender - attempts to emulate Blender's trackball behavior (though does not behave exactly the same)
- Autolevel - enables or disables autolevelling in the trackball mode
- Up - if enabled, autolevelling would always try to orient view's up axis to world's up axis in trackball mode
- Auto switch - enables or disables automatic switching between Trackball and Turntable in certain object modes
- Auto Trackball modes dropdown - in which object modes to auto-switch to Trackball
- Show - if enabled, the Trackball toggle in 3D Viewport's header will be shown
Keymaps
Here you can customize the keymaps / shortcuts used for invoking the navigation operator, and its behavior. These keymaps are automatically registered on addon initialization.
Common options
- Invert - which directions/axes should be inverted
Keymap management
-
Add Keymap - adds a new keymap configuration to the list (note: this does not automatically update Blender's keymaps)
-
Update keymaps - updates Blender's keymaps according to the list of keymap configurations
-
Load Preset - a popup panel for loading and managing keymap presets
![<https://github.com/dairin0d/blender-2.8-scripts/raw/master/docs/mouselook_navigation/keymap-presets.png>](<https://github.com/dairin0d/blender-2.8-scripts/raw/master/docs/mouselook_navigation/keymap-presets.png>)
- Reset - resets the list of presets
- Add - saves the current setup to a new preset
- Load - loads the specified preset (and updates Blender's keymaps)
- Delete - deletes the specified preset
- Presets can also be imported from and exported to the file system (the corresponding options are located in the context menu - simply right-click on any button in the Keymap presets panel)
- If you didn't right-click on a specific preset, then the "Export" option will export the current setup
List of keymap configurations
Each of the keymap configurations has the following elements:
- ⊙ - (un)selects the corresponding keymap
- Modifiers - which modifier(s) (Shift, Ctrl, Alt...) to use for this shortcut
- Keys (events) - key(s) and event(s) that should trigger the keymap's operator (a separate keymap will be registered for each combination)
- Keymaps - in which of the Blender's keymap categories the shortcuts should be registered (note: only those relevant to 3D viewport navigation are listed here)
- X - deletes the corresponding keymap configuration
- Preceding operators (left) - which operators need to have higher priority than this keymap's operator (asterisk * means all operators)
- Succeeding operators (right) - which operators need to have lower priority than this keymap's operator (asterisk * means all operators)
Keymap-specific options
This section shows options for the selected keymap configuration (or the default options, if no keymap is selected). Each keymap-specific option has an Override toggle (📌), which allows to override the default value.
- Transitions - allowed transitions between modes