3D view: Difference between revisions

From FreeCAD Documentation
(More information on right clicking)
(→‎Actions: MenuCommand template. Small fixes.)
Line 12: Line 12:


When the default [[Start Workbench]] is active, right clicking on the 3D view shows only one command:
When the default [[Start Workbench]] is active, right clicking on the 3D view shows only one command:
* [[Mouse Model|Navigation styles]]
* {{MenuCommand|[[Mouse Model|Navigation styles]]}}: different button styles to use with a 3-button mouse or laptop trackpad.


However, once a [[Workbenches|Workbench]] is chosen, there are additional commands:
However, once a [[Workbenches|Workbench]] is loaded, there are additional commands:
* Link actions: creates different types of [[Std_LinkMake|App::Link]] objects. {{Version|0.19}}
* {{MenuCommand|Link actions}}: creates different types of [[Std_LinkMake|App::Link]] objects. {{Version|0.19}}
* [[Std_ViewFitAll|Fit all]]
* {{MenuCommand|[[Std_ViewFitAll|Fit all]]}}: pan and zoom the 3D view to fit all objects in the document in the screen.
* [[Std_ViewFitSelection|Fit selection]]
* {{MenuCommand|[[Std_ViewFitSelection|Fit selection]]}}: pan and zoom the 3D view to fit the currently selected object in the screen.
* Draw style menu: solid, wireframe, and point options.
* {{MenuCommand|Draw style}}: solid, wireframe, and point options.
* [[Std_View_Menu|Standard views]]: isometric, top, bottom, left, right.
* {{MenuCommand|[[Std_View_Menu|Standard views]]}}: isometric, top, bottom, left, right.
* Measure menu: create some measurements.
* {{MenuCommand|Measure}}: create some measurements on the 3D view with the selected objects, or clear the measurements on the screen.
* Document window: docked, undocked, and fullscreen.
* {{MenuCommand|Document window}}: docked, undocked, and fullscreen.


Additionally, depending on the workbench and object that is active, other command menus may become available. For example, with the [[Part Workbench|Part Workbench]] and one object selected:
Additionally, depending on the workbench and object that is active, other command menus may become available. For example, with the [[Part Workbench|Part Workbench]] and one object selected:
* Appearance: color and sizes of lines and vertices, and color of faces.
* {{MenuCommand|Appearance}}: color and sizes of lines and vertices, and color of faces.
* Toggle visibility: hide or show.
* {{MenuCommand|Toggle visibility}}: hide or show.
* Toggle selectability: set to be able able to be selected or not. Change the property by toggling the {{PropertyView|Selectable}} in the [[Property editor|Property editor]].
* {{MenuCommand|Toggle selectability}}: set to be able to be selected or not. Change the property by toggling {{PropertyView|Selectable}} in the [[Property editor|Property editor]].
* Go to selection: select the object in the tree view.
* {{MenuCommand|Go to selection}}: select the object in the tree view.
* Random color: assign a random color to the object.
* {{MenuCommand|Random color}}: assign a random color to the object.
* [[Std Delete|Delete]]: delete the object.
* {{MenuCommand|[[Std Delete|Delete]]}}: delete the object.


For example, with the [[Draft Workbench|Draft Workbench]] and one object selected:
For example, with the [[Draft Workbench|Draft Workbench]] and one object selected:
* Draft.
* {{MenuCommand|Draft}}
* Utilities.
* {{MenuCommand|Utilities}}


== Details ==
== Details ==

Revision as of 06:42, 21 September 2019

Introduction

The 3D view of FreeCAD is an instance of a Coin3D scenegraph. Coin3D is a library that implements the OpenInventor 2.1 scene description standard.

By the default the 3D view shows a small widget with coordinate axes, and the navigation cube also with coordinate axes; the grid can be displayed and configured using the Draft Workbench.

Actions

When the default Start Workbench is active, right clicking on the 3D view shows only one command:

  • Navigation styles: different button styles to use with a 3-button mouse or laptop trackpad.

However, once a Workbench is loaded, there are additional commands:

  • Link actions: creates different types of App::Link objects. introduced in version 0.19
  • Fit all: pan and zoom the 3D view to fit all objects in the document in the screen.
  • Fit selection: pan and zoom the 3D view to fit the currently selected object in the screen.
  • Draw style: solid, wireframe, and point options.
  • Standard views: isometric, top, bottom, left, right.
  • Measure: create some measurements on the 3D view with the selected objects, or clear the measurements on the screen.
  • Document window: docked, undocked, and fullscreen.

Additionally, depending on the workbench and object that is active, other command menus may become available. For example, with the Part Workbench and one object selected:

  • Appearance: color and sizes of lines and vertices, and color of faces.
  • Toggle visibility: hide or show.
  • Toggle selectability: set to be able to be selected or not. Change the property by toggling ViewSelectable in the Property editor.
  • Go to selection: select the object in the tree view.
  • Random color: assign a random color to the object.
  • Delete: delete the object.

For example, with the Draft Workbench and one object selected:

  • Draft
  • Utilities

Details

Since FreeCAD uses Qt as its graphical toolkit, FreeCAD uses the Quarter library to use Coin3D in a Qt environment.

Moreover, it is possible to interact directly with the 3D view scenegraph from the Python console by using the Python library Pivy.

For more information see the power user documentation: