Mouse navigation/en: Difference between revisions

From FreeCAD Documentation
(Updating to match new version of source page)
(Updating to match new version of source page)
(17 intermediate revisions by the same user not shown)
Line 1: Line 1:
<languages/>
<languages/>
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 which you can choose according to your preferences.


{{Docnav
== Navigation ==
|[[Getting_started|Getting started]]
The mouse gestures used for object manipulation vary depending on the Navigation style selected; the currently selected style is used for all workbenches.
|[[Selection_methods|Selection methods]]
}}


{{TOCright}}
There are two ways to change the navigation style:


==Overview==
* In the [[Preferences Editor]], {{MenuCommand|Edit → Preferences → Display → 3D View → 3D Navigation}}.
* By right-clicking in empty space in the 3D view, then selecting {{MenuCommand|Navigation style →...}} in the contextual menu.


The FreeCAD '''mouse navigation''' consists of the commands used to visually navigate 3D space and interact with the displayed objects. FreeCAD supports multiple mouse navigation styles. The default navigation style is referred to as [[#CAD_navigation|CAD Navigation]], and is very simple and practical, but FreeCAD also provides several alternative navigation styles to choose from. The selected style is used for all workbenches.
=== CAD Navigation ===
This is the default navigation style. It allows the user a simple control of the view, and does not require the use of keyboard keys except to make multi-selections.


For more information about selecting objects see [[Selection_methods|Selection methods]].
{{CAD Navigation
|Select_name=Select
|Pan_name=Pan
|Zoom_name=Zoom
|Rotate_view_name=Rotate view<br>First method
|Rotate_view_alt_name=Rotate view<br>Alternate method
|Ctrl={{KEY|Ctrl}}
|Shift={{KEY|Shift}}
|Select_text=Press the left mouse button over an object you want to select.


For more information about manipulating objects see [[Std_TransformManip|Std TransformManip]].
Holding down {{KEY|Ctrl}} allows the selection of multiple objects.
|Pan_text=Hold the middle mouse button, then move the pointer.
|Pan_mode_text=Pan mode: hold the {{KEY|Ctrl}} key, press the right mouse button once, then move the pointer. {{Version|0.17}}
|Zoom_text=Use the mouse wheel to zoom in and out.


== Selecting a navigation style ==
Clicking the middle mouse button re-centers the view on the location of the cursor.
|Zoom_mode_text=Zoom mode: hold the {{KEY|Ctrl}} and {{KEY|Shift}} keys, press the right mouse button once, then move the pointer. {{Version|0.17}}
|Rotate_view_text=Hold the middle mouse button, then press and hold the left mouse button, then move the pointer.


# Do one of the following:
The cursor location when the middle mouse button is pressed determines the center of rotation. Rotation works like spinning a ball which rotates around its center. If the buttons are released before you stop the mouse motion, the view continues [[spinning]], if this is enabled.
#* Press the {{Button|[[File:NavigationCAD.svg|16px]]}} button in the [[Status_bar|Status bar]].
#* Right-click an empty area in the [[3D_view|3D view]], and select {{MenuCommand|Navigation styles}} from the context menu.
#* Use the [[Preferences_Editor#Navigation|Preferences Editor]]. In the menu select {{MenuCommand|Edit → Preferences}} and then {{MenuCommand|Display → Navigation → 3D Navigation}}.
# Select a style from the list.
# Optionally change the {{MenuCommand|Orbit style}}: press the {{Button|[[File:NavigationCAD.svg|16px]]}} button in the [[Status_bar|Status bar]] and then choose {{MenuCommand|Settings → Orbit style}}. See [[Preferences_Editor#Navigation|Preferences Editor]].
# Optionally change the {{MenuCommand|Rotation mode}}. See [[Preferences_Editor#Navigation|Preferences Editor]].
# If the {{MenuCommand|CAD}} navigation style is selected: optionally change the {{MenuCommand|Enable animation}} setting. See [[Preferences_Editor#Navigation|Preferences Editor]].


== Available navigation styles ==
A double click with the middle mouse button sets a new center of rotation.
|Rotate_view_mode_text=Rotate mode: hold the {{KEY|Shift}} key, press the right mouse button once, then move the pointer. {{Version|0.17}}
|Rotate_view_alt_text=Hold the middle mouse button, then press and hold the right mouse button, then move the pointer.


=== Blender navigation ===
With this method the middle mouse button may be released after the right mouse button is held pressed.


The Blender navigation style was modeled after [https://www.blender.org Blender].
Users who use the mouse with their right hand may find this method easier than the first method.
}}


=== OpenInventor Navigation ===
OpenInventor navigation (formerly Inventor) was modeled after [http://en.wikipedia.org/wiki/Open_Inventor Open Inventor]. In order to select objects, you must hold down the {{KEY|Ctrl}} key.

This mode is not based on Autodesk Inventor.

{{OpenInventor Navigation
|Select_name=Select
|Pan_name=Pan
|Zoom_name=Zoom
|Rotate_view_name=Rotate view
|Ctrl={{KEY|Ctrl}}
|Select_text=Hold {{KEY|Ctrl}}, then press the left mouse button over an object you want to select.
|Pan_text=Hold the middle mouse button, then move the pointer.
|Zoom_text=Use the mouse wheel to zoom in and out.

Alternatively, hold the middle mouse button, then press and hold the left mouse button, then move the pointer.
|Rotate_view_text=Hold the left mouse button, then move the pointer.
}}

=== Blender Navigation ===

The Blender navigation style was modeled after [http://www.blender.org Blender]. Previously there was no mouse-only panning; it always required holding the {{KEY|Shift}} key. This changed in 2016, now you can hold both left and right mouse buttons to pan.
{{Blender Navigation
{{Blender Navigation
|Select_name=Select
|Select_name=Select
Line 79: Line 47:
}}
}}


=== Touchpad Navigation ===
=== CAD navigation ===


This is the default navigation style. It allows the user a simple control of the view, and does not require the use of keyboard keys except to make multi-selections.
In Touchpad Navigation, panning, zooming, and rotating the view require a modifier key together with the touchpad.

{{Touchpad Navigation
{{CAD Navigation
|Select_name=Select
|Select_name=Select
|Pan_name=Pan
|Pan_name=Pan
|Zoom_name=Zoom
|Zoom_name=Zoom
|Rotate_view_name=Rotate view
|Rotate_view_name=Rotate view<br>First method
|Rotate_view_alt_name=Rotate view<br>Alternate method
|Shift={{KEY|Shift}}
|Ctrl={{KEY|Ctrl}}
|Ctrl={{KEY|Ctrl}}
|Alt={{KEY|Alt}}
|Shift={{KEY|Shift}}
|PageUp={{KEY|PageUp}}
|PageDown={{KEY|PageDown}}
|Select_text=Press the left mouse button over an object you want to select.
|Select_text=Press the left mouse button over an object you want to select.

|Pan_text=Hold {{KEY|Shift}}, then move the pointer.
Holding down {{KEY|Ctrl}} allows the selection of multiple objects.
|Zoom_text=Use {{KEY|PageUp}} and {{KEY|PageDown}} to zoom in and out.
|Zoom_alt_text=Alternatively, hold {{KEY|Shift}} and {{KEY|Ctrl}}, then move the pointer.
|Pan_text=Hold the middle mouse button, then move the pointer.
|Rotate_view_text=Hold {{KEY|Alt}}, then move the pointer.
|Pan_mode_text=Pan mode: hold the {{KEY|Ctrl}} key, press the right mouse button once, then move the pointer.
|Zoom_text=Use the mouse wheel to zoom in and out.
|Rotate_view_alt_text=Alternatively, hold {{KEY|Shift}} and the left button, then move the pointer.

Clicking the middle mouse button re-centers the view on the location of the cursor.
|Zoom_mode_text=Zoom mode: hold the {{KEY|Ctrl}} and {{KEY|Shift}} keys, press the right mouse button once, then move the pointer.
|Rotate_view_text=Hold the middle mouse button, then press and hold the left mouse button, then move the pointer.

If the buttons are released before you stop the mouse motion, the view continues spinning, if this is enabled.

A double click with the middle mouse button sets a new center of rotation.
|Rotate_view_mode_text=Rotate mode: hold the {{KEY|Shift}} key, press the right mouse button once, then move the pointer.
|Rotate_view_alt_text=Hold the middle mouse button, then press and hold the right mouse button, then move the pointer.

With this method the middle mouse button may be released after the right mouse button is held pressed.

Users who use the mouse with their right hand may find this method easier than the first method.
}}
}}


=== Gesture Navigation ===
=== Gesture navigation ===

This style was tailored for use with a touchscreen and pen. Nevertheless, it can also be used with a mouse, and is recommended for use when using a Mac with a trackpad.


This style was introduced in version 0.16, and was tailored for use with a touchscreen and pen. Nevertheless, it can also be used with a mouse.
{{Gesture Navigation
{{Gesture Navigation
|Select_name=Select
|Select_name=Select
Line 130: Line 112:
}}
}}


=== Maya-Gesture Navigation ===
=== Maya-Gesture navigation ===

In Maya-Gesture Navigation, panning, zooming, and rotating the view require the {{KEY|Alt}} key together with a mouse button; therefore, a three-button mouse is required. It's also possible to use gestures as this mode was developed over the [[#Gesture_navigation|Gesture navigation]] mode.


In Maya-Gesture Navigation, panning, zooming, and rotating the view require the {{KEY|Alt}} key together with a mouse button; therefore, a three-button mouse is required. It's also possible to use gestures as this mode was developed over the [[Mouse Model#Gesture Navigation|Gesture Navigation]] mode.
{{MayaGesture Navigation
{{MayaGesture Navigation
|Select_name=Select
|Select_name=Select
Line 147: Line 130:
}}
}}


=== OpenCascade navigation ===

The OpenCascade navigation style was modeled after [https://www.opencascade.com/ OpenCascade].

{{OpenCascade Navigation
|Select_name=Select
|Pan_name=Pan
|Zoom_name=Zoom
|Rotate_view_name=Rotate view
|Ctrl={{KEY|Ctrl}}
|Select_text=Press the left mouse button over an object you want to select.
|Pan_text=Hold the middle mouse button, then move the pointer.
|Zoom_text=Use the mouse wheel to zoom in and out.

Alternatively, hold {{KEY|Ctrl}} and the left mouse button, then move the pointer.
|Rotate_view_text=Hold {{KEY|Ctrl}} and the right mouse button, then move the pointer.
}}

=== OpenInventor navigation ===

OpenInventor navigation (formerly Inventor) was modeled after [http://en.wikipedia.org/wiki/Open_Inventor Open Inventor]. In order to select objects, you must hold down the {{KEY|Ctrl}} key.

This mode is not based on Autodesk Inventor.

{{OpenInventor Navigation
|Select_name=Select
|Pan_name=Pan
|Zoom_name=Zoom
|Rotate_view_name=Rotate view
|Ctrl={{KEY|Ctrl}}
|Select_text=Hold {{KEY|Ctrl}}, then press the left mouse button over an object you want to select.
|Pan_text=Hold the middle mouse button, then move the pointer.
|Zoom_text=Use the mouse wheel to zoom in and out.

Alternatively, hold the middle mouse button, then press and hold the left mouse button, then move the pointer.
|Rotate_view_text=Hold the left mouse button, then move the pointer.
}}

=== OpenSCAD navigation ===

The OpenSCAD navigation style was modeled after [https://openscad.org/ OpenSCAD].

{{Version|0.20}}

{{OpenSCAD_Navigation
|Select_name=Select
|Pan_name=Pan
|Zoom_name=Zoom
|Rotate_view_name=Rotate view
|Shift={{KEY|Shift}}
|Select_text=Press the left mouse button over an object you want to select.
|Pan_text=Hold the right mouse button, then move the pointer.
|Zoom_text=Hold the middle mouse button, then move the pointer.
Alternatively, hold {{KEY|Shift}} and the right mouse button, then move the pointer.
|Rotate_view_text=Hold the left mouse button, then move the pointer.
}}


=== Revit Navigation ===
=== Revit navigation ===


The Revit navigation style was modeled after [https://en.wikipedia.org/wiki/Autodesk_Revit Revit].
This style was introduced in version 0.18.


{{Revit Navigation
{{Revit Navigation
Line 169: Line 208:
}}
}}


=== OpenCascade ===
=== TinkerCAD navigation ===


The TinkerCAD navigation style was modeled after [https://en.wikipedia.org/wiki/Tinkercad TinkerCAD].
This style was introduced in version 0.18.


{{Version|0.20}}
{{OpenCascade Navigation

{{TinkerCAD Navigation
|Select_name=Select
|Select_name=Select
|Pan_name=Pan
|Pan_name=Pan
|Zoom_name=Zoom
|Zoom_name=Zoom
|Rotate_view_name=Rotate view
|Rotate_view_name=Rotate view
|Ctrl={{KEY|Ctrl}}
|Select_text=Press the left mouse button over an object you want to select.
|Select_text=Press the left mouse button over an object you want to select.
|Pan_text=Hold the middle mouse button, then move the pointer.
|Pan_text=Hold the middle mouse button, then move the pointer.
|Zoom_text=Use the mouse wheel to zoom in and out.
|Zoom_text=Use the mouse wheel to zoom in and out.
|Rotate_view_text=Press the right mouse button, then move the pointer.

Alternatively, hold {{KEY|Ctrl}} and the left mouse button, then move the pointer.
|Rotate_view_text=Hold {{KEY|Ctrl}} and the right mouse button, then move the pointer.
}}
}}


== Selecting objects ==
=== Touchpad navigation ===


In Touchpad Navigation, panning, zooming, and rotating the view require a modifier key together with the touchpad.
=== 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.


{{Touchpad Navigation
=== Preselection ===
|Select_name=Select
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.
|Pan_name=Pan
|Zoom_name=Zoom
|Rotate_view_name=Rotate view
|Shift={{KEY|Shift}}
|Ctrl={{KEY|Ctrl}}
|Alt={{KEY|Alt}}
|PageUp={{KEY|PageUp}}
|PageDown={{KEY|PageDown}}
|Select_text=Press the left mouse button over an object you want to select.
|Pan_text=Hold {{KEY|Shift}}, then move the pointer.
|Zoom_text=Use {{KEY|PageUp}} and {{KEY|PageDown}} to zoom in and out.
|Zoom_alt_text=Alternatively, hold {{KEY|Shift}} and {{KEY|Ctrl}}, then move the pointer.
|Rotate_view_text=Hold {{KEY|Alt}}, then move the pointer.
|Rotate_view_alt_text=Alternatively, hold {{KEY|Shift}} and the left button, then move the pointer.
}}


== Manipulating Objects ==
== Hardware support ==
FreeCAD offers [[Manipulator|''manipulators'']] that are handles that can be used to modify an object's appearance, shape, or other parameters.


FreeCAD also supports some [[3D_input_devices|3D input devices]].
The [[Std ClippingPlane|clipping plane]] is an example of an object with manipulators. A [[Std ClippingPlane|clipping plane]] can be activated with the menu {{MenuCommand|View → Clipping Plane}}.


== Recommended navigation for macOS ==
== Hardware support ==


On MacBooks with a trackpad the Gesture navigation works very well, but the gestures have a special meaning:
FreeCAD also supports some [[3D input devices]].
* Zoom: drag with two fingers.
* Rotate: drag with three fingers.
* Pan: {{KEY|Ctrl}} + three fingers.


== Mac OS X Issues ==
== Developing a custom navigation ==


The tutorial [[Adding_a_new_mouse_navigation_option_to_FreeCAD|Adding a new mouse navigation option to FreeCAD]] orients developers who want to develop a custom mouse navigation option. Familiarity with the C++ syntax is required.
Recently we got reports [http://forum.freecadweb.org/viewtopic.php?f=3&t=3592&start=0 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.


{{docnav|Getting started|Navigation Cube}}


{{Docnav
{{Userdocnavi}}
|[[Getting_started|Getting started]]
|[[Selection_methods|Selection methods]]
}}


{{Userdocnavi{{#translation:}}}}
[[Category:User Documentation]]

Revision as of 10:46, 9 November 2021

Overview

The FreeCAD mouse navigation consists of the commands used to visually navigate 3D space and interact with the displayed objects. FreeCAD supports multiple mouse navigation styles. The default navigation style is referred to as CAD Navigation, and is very simple and practical, but FreeCAD also provides several alternative navigation styles to choose from. The selected style is used for all workbenches.

For more information about selecting objects see Selection methods.

For more information about manipulating objects see Std TransformManip.

Selecting a navigation style

  1. Do one of the following:
  2. Select a style from the list.
  3. Optionally change the Orbit style: press the File:NavigationCAD.svg button in the Status bar and then choose Settings → Orbit style. See Preferences Editor.
  4. Optionally change the Rotation mode. See Preferences Editor.
  5. If the CAD navigation style is selected: optionally change the Enable animation setting. See Preferences Editor.

Available navigation styles

Blender navigation

The Blender navigation style was modeled after Blender.

Select Pan Zoom Rotate view
Shift+
Press the left mouse button over an object you want to select. Hold Shift and the middle mouse button, then move the pointer.

Alternatively, hold both left and right mouse buttons, and then move the pointer.

Use the mouse wheel to zoom in and out. Hold the middle mouse button, then move the pointer.

CAD navigation

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

Select Pan Zoom Rotate view
First method
Rotate view
Alternate method
Press the left mouse button over an object you want to select.

Holding down Ctrl allows the selection of multiple objects.

Hold the middle mouse button, then move the pointer. Use the mouse wheel to zoom in and out.

Clicking the middle mouse button re-centers the view on the location of the cursor.

Hold the middle mouse button, then press and hold the left mouse button, then move the pointer.

If the buttons are released before you stop the mouse motion, the view continues spinning, if this is enabled.

A double click with the middle mouse button sets a new center of rotation.

Hold the middle mouse button, then press and hold the right mouse button, then move the pointer.

With this method the middle mouse button may be released after the right mouse button is held pressed.

Users who use the mouse with their right hand may find this method easier than the first method.

Ctrl+ Ctrl+Shift+ Shift+
Pan mode: hold the Ctrl key, press the right mouse button once, then move the pointer. Zoom mode: hold the Ctrl and Shift keys, press the right mouse button once, then move the pointer. Rotate mode: hold the Shift key, press the right mouse button once, then move the pointer.

Gesture navigation

This style was tailored for use with a touchscreen and pen. Nevertheless, it can also be used with a mouse, and is recommended for use when using a Mac with a trackpad.

Select Pan Zoom Rotate view Tilt view
Press the left mouse button over an object you want to select. Hold the right mouse button, then move the pointer. Use the mouse wheel to zoom in and out. Hold the left mouse button, then move the pointer.

In Sketcher and other edit modes, this behavior is disabled. Hold Alt when pressing the mouse button to enter rotation mode.

To set the camera's focus point for rotation, click a point with the middle mouse button. Alternatively, aim the cursor at a point and press H on the keyboard.

Hold both left and right mouse buttons, then move the pointer sideways.
Tap to select. Drag with two fingers.

Alternatively, tap and hold, then drag. This simulates the pan with the right mouse button.

Drag two fingers (pinch) closer or farther apart. Drag with one finger to rotate.

Hold Alt when in the Sketcher.

Rotate the imaginary line formed by two touch points.

On v0.18 this method is disabled by default. To enable, go to Edit → Preferences → Display, and untick "Disable touchscreen tilt gesture" checkbox.

Maya-Gesture navigation

In Maya-Gesture Navigation, panning, zooming, and rotating the view require the Alt key together with a mouse button; therefore, a three-button mouse is required. It's also possible to use gestures as this mode was developed over the Gesture navigation mode.

Select Pan Zoom Rotate view
Alt+ Alt+ Alt+
Press the left mouse button over an object you want to select. Hold Alt and the middle mouse button, then move the pointer. Hold Alt and the right mouse button, then move the pointer.

Alternatively, use the mouse wheel to zoom in and out.

Hold Alt and the left mouse button, then move the pointer.

OpenCascade navigation

The OpenCascade navigation style was modeled after OpenCascade.

Select Pan Zoom Rotate view
Ctrl+ Ctrl+ Ctrl+


Press the left mouse button over an object you want to select. Hold the middle mouse button, then move the pointer. Use the mouse wheel to zoom in and out.

Alternatively, hold Ctrl and the left mouse button, then move the pointer.

Hold Ctrl and the right mouse button, then move the pointer.

OpenInventor navigation

OpenInventor navigation (formerly Inventor) was modeled after Open Inventor. In order to select objects, you must hold down the Ctrl key.

This mode is not based on Autodesk Inventor.

Select Pan Zoom Rotate view
{{{Shift}}}+
Hold Ctrl, then press the left mouse button over an object you want to select. Hold the middle mouse button, then move the pointer. Use the mouse wheel to zoom in and out.

Alternatively, hold the middle mouse button, then press and hold the left mouse button, then move the pointer.

Hold the left mouse button, then move the pointer.

OpenSCAD navigation

The OpenSCAD navigation style was modeled after OpenSCAD.

introduced in version 0.20

Select Pan Zoom Rotate view
Shift+
Press the left mouse button over an object you want to select. Hold the right mouse button, then move the pointer. Hold the middle mouse button, then move the pointer.

Alternatively, hold Shift and the right mouse button, then move the pointer.

Hold the left mouse button, then move the pointer.

Revit navigation

The Revit navigation style was modeled after Revit.

Select Pan Zoom Rotate view
Shift+


Press the left mouse button over an object you want to select. Hold the middle mouse button, then move the pointer.

Alternatively, hold both left and right mouse buttons, then move the pointer.

Use the mouse wheel to zoom in and out. Hold Shift and the middle mouse button, then move the pointer.

Alternatively, hold the middle mouse button, then press and hold the right mouse button, then move the pointer.

TinkerCAD navigation

The TinkerCAD navigation style was modeled after TinkerCAD.

introduced in version 0.20

Select Pan Zoom Rotate view
Press the left mouse button over an object you want to select. Hold the middle mouse button, then move the pointer. Use the mouse wheel to zoom in and out. Press the right mouse button, then move the pointer.

Touchpad navigation

In Touchpad Navigation, panning, zooming, and rotating the view require a modifier key together with the touchpad.

Select Pan Zoom Rotate view
Shift+ PageUp, PageDown Alt+
Press the left mouse button over an object you want to select. Hold Shift, then move the pointer. Use PageUp and PageDown to zoom in and out. Hold Alt, then move the pointer.
Ctrl+Shift+ Shift+
Alternatively, hold Shift and Ctrl, then move the pointer. Alternatively, hold Shift and the left button, then move the pointer.

Hardware support

FreeCAD also supports some 3D input devices.

Recommended navigation for macOS

On MacBooks with a trackpad the Gesture navigation works very well, but the gestures have a special meaning:

  • Zoom: drag with two fingers.
  • Rotate: drag with three fingers.
  • Pan: Ctrl + three fingers.

Developing a custom navigation

The tutorial Adding a new mouse navigation option to FreeCAD orients developers who want to develop a custom mouse navigation option. Familiarity with the C++ syntax is required.