PartDesign Preferences: Difference between revisions

From FreeCAD Documentation
(New images. New heading. In Progress...)
(Added Shape appearance table from Preferences_Editor.)
Line 22: Line 22:


<!--T:3-->
<!--T:3-->
In the ''General'' tab you can specify the following:
On the ''General'' tab you can specify the following:

{| class="wikitable float-right mw-collapsible mw-collapsed"
{| class="wikitable float-right mw-collapsible mw-collapsed"
!style="width: 33%;"|Name
!style="width: 33%;"|Name
Line 47: Line 48:


<!--T:6-->
<!--T:6-->
In the ''Shape view'' tab you can specify the following:
On the ''Shape view'' tab you can specify the following:

{| class="wikitable float-right mw-collapsible mw-collapsed"
{| class="wikitable float-right mw-collapsible mw-collapsed"
!style="width: 33%;"|Name
!style="width: 33%;"|Name
Line 73: Line 75:


==Shape appearance==
==Shape appearance==

On the ''Shape appearance'' tab you can specify the following:

{| class="wikitable float-right mw-collapsible mw-collapsed"
!style="width: 33%;"|Name
!style="width: 66%;"|Description
|-
| {{MenuCommand|Shape color}}
| Color for new shapes. If the option {{MenuCommand|Random}} is set, a random color is used instead.
|-
| {{MenuCommand|Line color}}
| Line color for new shapes
|-
| {{MenuCommand|Line width}}
| Line thickness for new shapes
|-
| {{MenuCommand|Vertex color}}
| Color for new [[Glossary#Vertex|vertices]]
|-
| {{MenuCommand|Vertex size}}
| Size for new [[Glossary#Vertex|vertices]]
|-
| {{MenuCommand|Bounding box color}}
| Color of [[Property_editor#View|bounding boxes]] in the 3D view
|-
| {{MenuCommand|Two-side rendering}}
| If checked, the bottom side of the surface will be rendered the same way than the top side. If not checked, it depends on the option '''Backlight color'''; either the backlight color will be used or black.
|-
| {{MenuCommand|Text color}}
| Text color for document annotations. There is currently no dialog to add annotations to documents. Annotations can only be added using the Python console with this command:

<code>obj=App.ActiveDocument.addObject("App::Annotation", "Label")</code>

This console is shown using the menu {{MenuCommand|View → Panels → Python console}}.
|}


</translate>
</translate>

Revision as of 17:53, 11 March 2021

This documentation is a work in progress. Please don't mark it as translatable since it will change in the next hours and days.

The preferences screen of the PartDesign Workbench are found in the Preferences Editor, Edit → Preferences → Part design.

There are two tabs: General, and Shape view.

General

On the General tab you can specify the following:

Name Description
Automatically check model after boolean operation If checked, after a boolean operation it will be checked if the Boundary representation (BRep) of the model is valid. This is internally done by the function CheckGeometry.
Automatically refine model after boolean operation If checked, the model will be refined using the function RefineShape after a boolean operation.
Automatically refine model after sketch-based operation If checked, the model will be refined using the function RefineShape after a sketch of an object has been changed.
Add name of base object This option has currently no effect.

Shape view

On the Shape view tab you can specify the following:

Name Description
Maximum deviation depending on the model bounding box Maximum linear deflection of the tesselated objects from their surface
Maximum angular deflection Maximum angular deflection from one tesselated object section to the next section

In order to display an object efficiently its surface is tesselated, i.e. it is displayed with some small deviations from it real surface. This applies not only to PartDesign models, but also to other objects in FreeCAD.

There is a lower limit for the tesselation of 0.01%. If you really want to spend the additional time you can reduce the lower limit even further by opening the menu Tools → Edit parameters... This opens the parameter editor where you navigate to BaseApp → Preferences → Mod → Part.

Right click on Mesh deviation choose in the context menu Change value. Set the value to the minimum tesselation of your choice. Please keep in mind that the value is in %, i.e. for a value of 0.005% you have to enter "0.00005". The smallest value possible is 1e-7. Note: In the preferences menu you will still see 0.01% even if you set a lower value.

Shape appearance

On the Shape appearance tab you can specify the following:

Name Description
Shape color Color for new shapes. If the option Random is set, a random color is used instead.
Line color Line color for new shapes
Line width Line thickness for new shapes
Vertex color Color for new vertices
Vertex size Size for new vertices
Bounding box color Color of bounding boxes in the 3D view
Two-side rendering If checked, the bottom side of the surface will be rendered the same way than the top side. If not checked, it depends on the option Backlight color; either the backlight color will be used or black.
Text color Text color for document annotations. There is currently no dialog to add annotations to documents. Annotations can only be added using the Python console with this command:

obj=App.ActiveDocument.addObject("App::Annotation", "Label")

This console is shown using the menu View → Panels → Python console.