3D view: Difference between revisions

From FreeCAD Documentation
(Marked this version for translation)
Line 2: Line 2:
<translate>
<translate>


== Introduction ==
== Introduction == <!--T:1-->


<!--T:2-->
The [[3D view|3D view]] of FreeCAD is an instance of a Coin3D [[Scenegraph|scenegraph]]. Coin3D is a library that implements the OpenInventor 2.1 scene description standard.
The [[3D view|3D view]] of FreeCAD is an instance of a Coin3D [[Scenegraph|scenegraph]]. Coin3D is a library that implements the OpenInventor 2.1 scene description standard.


<!--T:3-->
Certain properties of the view, like background color, [[Mouse Model|mouse navigation]] style, and zooming steps, can be configured in the [[Preferences_Editor|preferences editor]].
Certain properties of the view, like background color, [[Mouse Model|mouse navigation]] style, and zooming steps, can be configured in the [[Preferences_Editor|preferences editor]].


<!--T:4-->
[[File:FreeCAD_3D_view.png|800px]]
[[File:FreeCAD_3D_view.png|800px]]


<!--T:5-->
{{Caption|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 by loading the [[Draft Workbench|Draft Workbench]].}}
{{Caption|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 by loading the [[Draft Workbench|Draft Workbench]].}}


== Actions ==
== Actions == <!--T:6-->


<!--T:7-->
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:
* {{MenuCommand|[[Mouse Model|Navigation styles]]}}: different button styles to use with a 3-button mouse or laptop trackpad.
* {{MenuCommand|[[Mouse Model|Navigation styles]]}}: different button styles to use with a 3-button mouse or laptop trackpad.


<!--T:8-->
However, once a [[Workbenches|Workbench]] is loaded, there are additional commands:
However, once a [[Workbenches|Workbench]] is loaded, there are additional commands:
* {{MenuCommand|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}}
Line 26: Line 32:
* {{MenuCommand|Document window}}: docked, undocked, and fullscreen.
* {{MenuCommand|Document window}}: docked, undocked, and fullscreen.


<!--T:9-->
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:
* {{MenuCommand|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.
Line 34: Line 41:
* {{MenuCommand|[[Std Delete|Delete]]}}: delete the object.
* {{MenuCommand|[[Std Delete|Delete]]}}: delete the object.


<!--T:10-->
For example, with the [[Draft Workbench|Draft Workbench]] and one object selected:
For example, with the [[Draft Workbench|Draft Workbench]] and one object selected:
* {{MenuCommand|Draft}}
* {{MenuCommand|Draft}}
* {{MenuCommand|Utilities}}
* {{MenuCommand|Utilities}}


== Details ==
== Details == <!--T:11-->


<!--T:12-->
Since FreeCAD uses Qt as its graphical toolkit, FreeCAD uses the Quarter library to use Coin3D in a Qt environment.
Since FreeCAD uses Qt as its graphical toolkit, FreeCAD uses the Quarter library to use Coin3D in a Qt environment.


<!--T:13-->
Moreover, it is possible to interact directly with the 3D view scenegraph from the [[Python console|Python console]] by using the Python library Pivy.
Moreover, it is possible to interact directly with the 3D view scenegraph from the [[Python console|Python console]] by using the Python library Pivy.


<!--T:14-->
For more information see the power user documentation:
For more information see the power user documentation:
* [[Scenegraph|Scenegraph]], description of Coin3D.
* [[Scenegraph|Scenegraph]], description of Coin3D.
Line 49: Line 60:
* [[Third_Party_Libraries|Third party libraries]] used by FreeCAD.
* [[Third_Party_Libraries|Third party libraries]] used by FreeCAD.


<!--T:15-->
{{Interface}}
{{Interface}}
{{Userdocnavi}}
{{Userdocnavi}}

Revision as of 14:27, 26 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.

Certain properties of the view, like background color, mouse navigation style, and zooming steps, can be configured in the preferences editor.

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 by loading 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:

Template:Interface