Mouse navigation: Difference between revisions
No edit summary |
(Marked this version for translation) |
||
(123 intermediate revisions by 16 users not shown) | |||
Line 1: | Line 1: | ||
<languages/> |
|||
<translate> |
<translate> |
||
<!--T:59--> |
|||
{{Docnav |
|||
|[[Getting_started|Getting started]] |
|||
|[[Selection_methods|Selection methods]] |
|||
}} |
|||
</translate> |
|||
{{TOCright}} |
|||
<translate> |
|||
==Overview== <!--T:60--> |
|||
<!--T:1--> |
<!--T:1--> |
||
The FreeCAD '''mouse |
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. |
||
<!--T:79--> |
|||
For more information about selecting objects see [[Selection_methods|Selection methods]]. |
|||
<!--T:80--> |
|||
For more information about manipulating objects see [[Std_TransformManip|Std TransformManip]]. |
|||
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. |
|||
== Selecting a navigation style == <!--T:61--> |
|||
<!--T:3--> |
|||
There are two ways to change the navigation style: |
|||
<!--T:4--> |
<!--T:4--> |
||
# Do one of the following: |
|||
* In the [[Preferences Editor]], Display section, ''3D View'' tab; |
|||
#* Press the {{Button|[[File:NavigationCAD_dark.svg|16px]]}} button in the [[Status_bar|Status bar]]. |
|||
* By right-clicking in empty space in the 3D view area, then selecting ''Navigation style'' in the contextual menu. |
|||
#* 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_dark.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 == <!--T:81--> |
|||
<!--T:87--> |
|||
With all navigation styles, unless selecting objects from a sketch in edit mode, you must hold {{KEY|Ctrl}} to select multiple objects. |
|||
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. |
|||
{{CAD Navigation}} |
|||
=== Blender navigation === <!--T:7--> |
|||
<!--T:70--> |
|||
The Blender navigation style was modeled after [https://www.blender.org Blender]. |
|||
In Inventor Navigation, modeled after [http://en.wikipedia.org/wiki/Open_Inventor 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 {{KEY|CTRL}} key. |
|||
{{Inventor Navigation}} |
|||
<!--T:8--> |
|||
{{Blender 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 {{KEY|Shift}} and the middle mouse button, then move the pointer. |
|||
<!--T:42--> |
|||
Alternatively, hold both left and right mouse buttons, and then move the pointer. |
|||
|Zoom_text=Use the mouse wheel to zoom in and out. |
|||
|Rotate_view_text=Hold the middle mouse button, then move the pointer. |
|||
}} |
|||
<!--T: |
=== CAD navigation === <!--T:62--> |
||
In Blender Navigation, modeled after [http://www.blender.org Blender], there is no mouse-only panning. In order to pan the view, you must hold down the {{KEY|SHIFT}} key. |
|||
{{Blender Navigation}} |
|||
<!--T:5--> |
|||
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. |
|||
<!--T:32--> |
|||
{{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. |
|||
|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. |
|||
|Zoom_text=Use the mouse wheel to zoom in and out. |
|||
<!--T: |
<!--T:34--> |
||
Clicking the middle mouse button re-centers the view on the location of the cursor. |
|||
In Touchpad Navigation, neither panning, nor zooming, nor rotating the view, are mouse-only (or touchpad-only) operations. |
|||
|Zoom_mode_text=Zoom mode: hold the {{KEY|Ctrl}} and {{KEY|Shift}} keys, press the right mouse button once, then move the pointer. |
|||
{{Touchpad Navigation}} |
|||
|Rotate_view_text=Hold the middle mouse button, then press and hold the left mouse button, then move the pointer. |
|||
<!--T:35--> |
|||
If the buttons are released before you stop the mouse motion, the view continues spinning, if this is enabled. |
|||
<!--T:36--> |
|||
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. |
|||
<!--T:37--> |
|||
With this method the middle mouse button may be released after the right mouse button is held pressed. |
|||
<!--T:38--> |
|||
Users who use the mouse with their right hand may find this method easier than the first method. |
|||
}} |
|||
=== Gesture navigation === <!--T:25--> |
|||
<!--T:73--> |
|||
=== Gesture Navigation (v0.16) === <!--T:25--> |
|||
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. |
|||
<!--T:26--> |
<!--T:26--> |
||
{{Gesture Navigation |
|||
This navigation style was tailored for usability with touchscreen and pen, but is very usable with mouse too. |
|||
|Select_name=Select |
|||
{{Gesture Navigation}} |
|||
|Pan_name=Pan |
|||
|Zoom_name=Zoom |
|||
|Rotate_view_name=Rotate view |
|||
|Tilt_view_name=Tilt view |
|||
|Select_text=Press the left mouse button over an object you want to select. |
|||
|Select_gesture_text=Tap to select. |
|||
|Pan_text=Hold the right mouse button, then move the pointer. |
|||
|Pan_gesture_text=Drag with two fingers. |
|||
<!--T:43--> |
|||
Alternatively, tap and hold, then drag. This simulates the pan with the right mouse button. |
|||
|Zoom_text=Use the mouse wheel to zoom in and out. |
|||
|Zoom_gesture_text=Drag two fingers (pinch) closer or farther apart. |
|||
|Rotate_view_text=Hold the left mouse button, then move the pointer. |
|||
In [[Sketcher Workbench|Sketcher]] and other edit modes, this behavior is disabled. Hold {{KEY|Alt}} when pressing the mouse button to enter rotation mode. |
|||
<!--T:44--> |
|||
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 {{KEY|H}} on the keyboard. |
|||
|Rotate_view_gesture_text=Drag with one finger to rotate. |
|||
<!--T:45--> |
|||
Hold {{KEY|Alt}} when in the [[Sketcher Workbench|Sketcher]]. |
|||
|Tilt_view_text=Hold both left and right mouse buttons, then move the pointer sideways. |
|||
|Tilt_view_gesture_text=Rotate the imaginary line formed by two touch points. |
|||
<!--T:46--> |
|||
This method is disabled by default. To enable, go to {{MenuCommand|Edit → Preferences → Display → Navigation}}, and uncheck the "Disable touchscreen tilt gesture" checkbox. |
|||
}} |
|||
=== Maya-Gesture navigation === <!--T:30--> |
|||
<!--T:71--> |
|||
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 style was developed over the [[#Gesture_navigation|Gesture navigation]] style. |
|||
<!--T:31--> |
<!--T:31--> |
||
{{MayaGesture Navigation |
|||
In ""Maya-Gesture Navigation"", all view movements are archived pressing {{KEY|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=Select |
|||
{{MayaGesture Navigation}} |
|||
|Pan_name=Pan |
|||
|Zoom_name=Zoom |
|||
|Rotate_view_name=Rotate view |
|||
|Alt={{KEY|Alt}} |
|||
|Select_text=Press the left mouse button over an object you want to select. |
|||
|Pan_text=Hold {{KEY|Alt}} and the middle mouse button, then move the pointer. |
|||
|Zoom_text=Hold {{KEY|Alt}} and the right mouse button, then move the pointer. |
|||
<!--T:47--> |
|||
Alternatively, use the mouse wheel to zoom in and out. |
|||
|Rotate_view_text=Hold {{KEY|Alt}} and the left mouse button, then move the pointer. |
|||
}} |
|||
=== |
=== OpenCascade navigation === <!--T:54--> |
||
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. |
|||
<!--T:74--> |
|||
The OpenCascade navigation style was modeled after [https://www.opencascade.com/ OpenCascade]. |
|||
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. |
|||
<!--T:56--> |
|||
{{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. |
|||
<!--T:57--> |
|||
Alternatively, hold {{KEY|Ctrl}} and the left mouse button, then move the pointer. |
|||
FreeCAD offers [[Manipulator|''manipulators'']] that are handles that can be used to modify an object's appearance, shape, or other parameters. |
|||
|Rotate_view_text=Hold {{KEY|Ctrl}} and the right mouse button, then move the pointer. |
|||
}} |
|||
=== OpenInventor navigation === <!--T:63--> |
|||
<!--T:6--> |
|||
OpenInventor navigation (formerly Inventor) was modeled after [http://en.wikipedia.org/wiki/Open_Inventor Open Inventor]. In order to select objects, you must hold the {{KEY|Shift}} or {{KEY|Ctrl}} key. |
|||
<!--T:39--> |
|||
This style is not based on Autodesk Inventor. |
|||
<!--T:40--> |
|||
{{OpenInventor Navigation |
|||
|Select_name=Select |
|||
|Pan_name=Pan |
|||
|Zoom_name=Zoom |
|||
|Rotate_view_name=Rotate view |
|||
|Shift={{KEY|Shift}} |
|||
|Select_text=Hold {{KEY|Shift}}, then press the left mouse button over an object you want to select. |
|||
<!--T: |
<!--T:86--> |
||
Hold {{KEY|Ctrl}} instead to select multiple objects. |
|||
. |
|||
|Pan_text=Hold the middle mouse button, then move the pointer. |
|||
|Zoom_text=Use the mouse wheel to zoom in and out. |
|||
<!--T: |
<!--T:41--> |
||
Alternatively, hold the middle mouse button, then press and hold the left mouse button, then move the pointer. |
|||
{{Note|''Obsolete''|The [[Std ClippingPlane|clipping plane]] is a good example of an object with manipulators. A [[Std ClippingPlane|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. |
|||
|Rotate_view_text=Hold the left mouse button, then move the pointer. |
|||
;Scaling: 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. |
|||
=== OpenSCAD navigation === <!--T:75--> |
|||
;Rotation: Clicking on the thin part of the axes puts the manipulator in rotation mode. |
|||
<!--T:76--> |
|||
The OpenSCAD navigation style was modeled after [https://openscad.org/ OpenSCAD]. |
|||
<!--T:77--> |
|||
{{Version|0.20}} |
|||
<!--T:78--> |
|||
{{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. |
|||
<!--T:88--> |
|||
{{VersionMinus|0.21}} Hold {{KEY|Ctrl}} and {{KEY|Shift}} when pressing the mouse button to drag an object in a sketch in edit mode. |
|||
|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. |
|||
<!--T:89--> |
|||
Alternatively, and when a sketch is in edit mode, hold the middle mouse button, then press and hold the right mouse button, then move the pointer. |
|||
}} |
|||
=== Revit navigation === <!--T:48--> |
|||
<!--T:69--> |
|||
The Revit navigation style was modeled after [https://en.wikipedia.org/wiki/Autodesk_Revit Revit]. |
|||
<!--T:50--> |
|||
{{Revit 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 middle mouse button, then move the pointer. |
|||
<!--T:51--> |
|||
Alternatively, hold both left and right mouse buttons, then move the pointer. |
|||
<!--T:52--> |
|||
|Zoom_text=Use the mouse wheel to zoom in and out. |
|||
|Rotate_view_text=Hold {{KEY|Shift}} and the middle mouse button, then move the pointer. |
|||
<!--T:53--> |
|||
Alternatively, hold the middle mouse button, then press and hold the right mouse button, then move the pointer. |
|||
}} |
|||
=== TinkerCAD navigation === <!--T:82--> |
|||
<!--T:83--> |
|||
The TinkerCAD navigation style was modeled after [https://en.wikipedia.org/wiki/Tinkercad TinkerCAD]. |
|||
<!--T:84--> |
|||
{{Version|0.20}} |
|||
<!--T:85--> |
|||
{{TinkerCAD Navigation |
|||
|Select_name=Select |
|||
|Pan_name=Pan |
|||
|Zoom_name=Zoom |
|||
|Rotate_view_name=Rotate view |
|||
|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. |
|||
|Rotate_view_text=Press the right mouse button, then move the pointer. |
|||
}} |
|||
=== Touchpad navigation === <!--T:9--> |
|||
<!--T:72--> |
|||
With the Touchpad navigation style, panning, zooming, and rotating the view require a modifier key together with the touchpad. This style can also be used with a mouse. |
|||
<!--T:10--> |
|||
{{Touchpad Navigation |
|||
|Select_name=Select |
|||
|Pan_name=Pan |
|||
|Zoom_name=Zoom |
|||
|Rotate_view_name=Rotate view |
|||
|Ctrl={{KEY|Ctrl}} |
|||
|Shift={{KEY|Shift}} |
|||
|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|Ctrl}} and {{KEY|Shift}}, 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. |
|||
}} |
}} |
||
Line 76: | Line 307: | ||
<!--T:18--> |
<!--T:18--> |
||
FreeCAD also supports some [[3D input devices]]. |
FreeCAD also supports some [[3D_input_devices|3D input devices]]. |
||
== |
== Recommended navigation for macOS == <!--T:19--> |
||
<!--T:20--> |
<!--T:20--> |
||
On MacBooks with a trackpad the Gesture navigation works very well, but the gestures have a special meaning: |
|||
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. |
|||
* Zoom: drag with two fingers. |
|||
* Rotate: drag with three fingers. |
|||
* Pan: {{KEY|Ctrl}} + three fingers. |
|||
== Developing a custom navigation == <!--T:67--> |
|||
<!--T:68--> |
|||
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. |
|||
<!--T:21--> |
<!--T:21--> |
||
{{Docnav |
|||
{{docnav|Getting started|Document structure}} |
|||
|[[Getting_started|Getting started]] |
|||
|[[Selection_methods|Selection methods]] |
|||
}} |
|||
<!--T:22--> |
|||
[[Category:User Documentation]] |
|||
</translate> |
</translate> |
||
{{Userdocnavi{{#translation:}}}} |
|||
<languages/> |
Latest revision as of 13:45, 24 March 2024
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.
- Do one of the following:
- Press the button in the Status bar.
- Right-click an empty area in the 3D view, and select Navigation styles from the context menu.
- Use the Preferences Editor. In the menu select Edit → Preferences and then Display → Navigation → 3D Navigation.
- Select a style from the list.
- Optionally change the Orbit style: press the button in the Status bar and then choose Settings → Orbit style. See Preferences Editor.
- Optionally change the Rotation mode. See Preferences Editor.
- If the CAD navigation style is selected: optionally change the Enable animation setting. See Preferences Editor.
With all navigation styles, unless selecting objects from a sketch in edit mode, you must hold Ctrl to select multiple objects.
The Blender navigation style was modeled after Blender.
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.
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.
This method is disabled by default. To enable, go to Edit → Preferences → Display → Navigation, and uncheck the "Disable touchscreen tilt gesture" checkbox. |
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 style was developed over the Gesture navigation style.
The OpenCascade navigation style was modeled after OpenCascade.
OpenInventor navigation (formerly Inventor) was modeled after Open Inventor. In order to select objects, you must hold the Shift or Ctrl key.
This style is not based on Autodesk Inventor.
The OpenSCAD navigation style was modeled after OpenSCAD.
The Revit navigation style was modeled after Revit.
The TinkerCAD navigation style was modeled after TinkerCAD.
With the Touchpad navigation style, panning, zooming, and rotating the view require a modifier key together with the touchpad. This style can also be used with a mouse.
Hardware support
FreeCAD also supports some 3D input devices.
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.
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.
- Getting started
- Installation: Download, Windows, Linux, Mac, Additional components, Docker, AppImage, Ubuntu Snap
- Basics: About FreeCAD, Interface, Mouse navigation, Selection methods, Object name, Preferences, Workbenches, Document structure, Properties, Help FreeCAD, Donate
- Help: Tutorials, Video tutorials
- Workbenches: Std Base, Arch, Assembly, CAM, Draft, FEM, Inspection, Mesh, OpenSCAD, Part, PartDesign, Points, Reverse Engineering, Robot, Sketcher, Spreadsheet, Surface, TechDraw, Test Framework
- Hubs: User hub, Power users hub, Developer hub