Mouse navigation

From FreeCAD Documentation
Revision as of 20:47, 27 April 2016 by FuzzyBot (talk | contribs) (Importing a new version from external source)
Jump to navigation Jump to search

The FreeCAD mouse model consists of the commands used to visually navigate the 3D space and interact with the objects displayed. FreeCAD supports multiple mouse model navigation styles. The default navigation style is referred to as "CAD Navigation," and is very simple and practical, but FreeCAD also provides alternative navigation styles, that you can choose according to your preferences.


The object handling is common to all workbenches. The following mouse gestures can be used to control the object position and view according to which Navigation style is selected.

There are two ways to change the navigation style:

  • In the Preferences Editor, Display section, 3D View tab;
  • By right-clicking in empty space in the 3D view area, then selecting Navigation style in the contextual menu.

CAD Navigation (default)

This is the default navigation style and allows the user a simple control of the view, and does not require the use of keyboard keys except to make multi-selections.

{{{Select_name}}} {{{Pan_name}}} {{{Zoom_name}}} {{{Rotate_view_name}}} {{{Rotate_view_alt_name}}}
Hand cursor.png Pan cursor.png Zoom cursor.png Rotate cursor.png Rotate cursor.png
Mouse LMB.svg Mouse MMB hold.svg Mouse MMB rotate.svg Mouse MMB+LMB hold.svg Mouse MMB+RMB hold.svg
{{{Select_text}}} {{{Pan_text}}} {{{Zoom_text}}} {{{Rotate_view_text}}} {{{Rotate_view_alt_text}}}
{{{Ctrl}}}+Mouse RMB.svg {{{Ctrl}}}+{{{Shift}}}+Mouse RMB.svg {{{Shift}}}+Mouse RMB.svg
{{{Pan_mode_text}}} {{{Zoom_mode_text}}} {{{Rotate_view_mode_text}}}

Inventor Navigation

In Inventor Navigation, modeled after Open Inventor (not to be confused with Autodesk Inventor), there is no mouse-only selection. In order to select objects, you must hold down the CTRL key. Template:Inventor Navigation

Blender Navigation

In Blender Navigation, modeled after Blender, there is no mouse-only panning. In order to pan the view, you must hold down the SHIFT key.

{{{Select_name}}} {{{Pan_name}}} {{{Zoom_name}}} {{{Rotate_view_name}}}
Hand cursor.png Pan cursor.png Zoom cursor.png Rotate cursor.png
Mouse LMB.svg {{{Shift}}}+Mouse MMB hold.svg Mouse LMB+RMB hold.svg Mouse MMB rotate.svg Mouse MMB hold.svg
{{{Select_text}}} {{{Pan_text}}} {{{Zoom_text}}} {{{Rotate_view_text}}}

Touchpad Navigation

In Touchpad Navigation, neither panning, nor zooming, nor rotating the view, are mouse-only (or touchpad-only) operations.

{{{Select_name}}} {{{Pan_name}}} {{{Zoom_name}}} {{{Rotate_view_name}}}
Hand cursor.png Pan cursor.png Zoom cursor.png Rotate cursor.png
Touchpad LB.svg {{{Shift}}}+Touchpad.svg {{{PageUp}}}, {{{PageDown}}} {{{Alt}}}+Touchpad.svg
{{{Select_text}}} {{{Pan_text}}} {{{Zoom_text}}} {{{Rotate_view_text}}}
{{{Shift}}}+{{{Ctrl}}}+Touchpad.svg {{{Shift}}}+Touchpad LB hold.svg
{{{Zoom_alt_text}}} {{{Rotate_view_alt_text}}}

Gesture Navigation (v0.16)

This navigation style was tailored for usability with touchscreen and pen, but is very usable with mouse too.

{{{Select_name}}} {{{Pan_name}}} {{{Zoom_name}}} {{{Rotate_view_name}}} {{{Tilt_view_name}}}
Hand cursor.png Pan cursor.png Zoom cursor.png Rotate cursor.png Rotate cursor.png
Mouse LMB.svg Mouse RMB hold.svg Mouse MMB rotate.svg Mouse LMB hold.svg Mouse LMB+RMB hold.svg
{{{Select_text}}} {{{Pan_text}}} {{{Zoom_text}}} {{{Rotate_view_text}}} {{{Tilt_view_text}}}
Touch Tap.svg Touch Two-Finger-Drag.svg Touch Tap-Hold-Drag.svg Touch Pinch.svg Touch One-Finger-Drag.svg Touch Rotate.svg
{{{Select_gesture_text}}} {{{Pan_gesture_text}}} {{{Zoom_gesture_text}}} {{{Rotate_view_gesture_text}}} {{{Tilt_view_gesture_text}}}

Maya-Gesture Navigation

In Maya-Gesture Navigation, all view movements are archived pressing ALT and a mouse button, so that it will be needed to have a 3 button mouse in order to correctly use this navigation mode. Alternately it's possible to use gestures as this mode was been developed over the normal Gesture Navigation mode.

{{{Select_name}}} {{{Pan_name}}} {{{Zoom_name}}} {{{Rotate_view_name}}}
Hand cursor.png Pan cursor.png Zoom cursor.png Rotate cursor.png
Mouse LMB.svg {{{Alt}}}+Mouse MMB hold.svg {{{Alt}}}+Mouse RMB hold.svg Mouse MMB rotate.svg {{{Alt}}}+Mouse LMB hold.svg
{{{Select_text}}} {{{Pan_text}}} {{{Zoom_text}}} {{{Rotate_view_text}}}

Selecting objects

Simple selection

Objects can be selected by a click with the left mouse button either by clicking on the object in the 3D-view or by selecting it in the tree view.


There is also a Preselection mechanism that highlights objects and displays information before selection by just hovering the mouse over the objects. If you don't like this behaviour or you have a slow machine, you can switch preselection off in the preferences.

Manipulating Objects

FreeCAD offers manipulators that are handles that can be used to modify an object's appearance, shape, or other parameters.



The clipping plane is a good example of an object with manipulators. A clipping plane can be activated with the View→Clipping Plane menu. After activation the clipping plane object appears and shows seven obvious manipulators as little boxes: One on each end of its three coordinate axes and one on the center of the plane normal axis. There are four more that are not as obvious: The plane itself and the thin part of the three axis objects.

To scale the object click with the left mouse button on the box manipulators at the end of the axes and pull them back and forth. Depending on the object the manipulators work independently or synchronously.
Out of plane shifting
To shift the object along its normal vector, pull the long box on the center of an axis with the left mouse button. For the clipping plane there is only one manipulator along the normal vector.
In plane shifting
To move the center of the clipping plane, click on the plane object and pull it to the desired location.
Clicking on the thin part of the axes puts the manipulator in rotation mode.

Hardware support

FreeCAD also supports some 3D input devices.

Mac OS X Issues

Recently we got reports on the forum from Mac users that those mouse button and key combination do not work as expected. Unfortunately, none of the developers owns a Mac, neither do the other regular contributors. We need your help to determine which mouse buttons and key combination work so we can update this wiki.

Other languages:
Bahasa Indonesia • ‎Deutsch • ‎English • ‎Türkçe • ‎español • ‎français • ‎hrvatski • ‎italiano • ‎polski • ‎português • ‎português do Brasil • ‎română • ‎svenska • ‎čeština • ‎български • ‎русский • ‎українська • ‎中文 • ‎中文(中国大陆)‎