PartDesign Preferences: Difference between revisions

From FreeCAD Documentation
(Removed the categories, as they are added automatically by the templates)
m (fixed typos)
 
(47 intermediate revisions by 7 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
<translate>
<translate>

<!--T:91-->
<!--T:91-->
{{Docnav
{{Docnav|[[PartDesign_MoveFeatureInTree|Move object after other object]]|[[Fine-tuning|Fine-tuning]]|[[PartDesign_Workbench|PartDesign]]|IconL=|IconC=Workbench_PartDesign.svg|IconR=}}
|[[PartDesign_MoveFeatureInTree|Move object after other object]]
|[[Fine-tuning|Fine-tuning]]
|[[PartDesign_Workbench|PartDesign]]
|IconL=
|IconR=
|IconC=Workbench_PartDesign.svg
}}

</translate>
{{TOCright}}
<translate>

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


<!--T:1-->
<!--T:1-->
The preferences screen of the [[PartDesign_Workbench|PartDesign Workbench]] are found in the [[Preferences Editor|Preferences Editor]], {{MenuCommand|Edit Preferences Part design}}.
The [[Image:Workbench_Part.svg|24px]] [[Part_Workbench|Part Workbench]] and the [[Image:Workbench_PartDesign.svg|24px]] [[PartDesign_Workbench|PartDesign Workbench]] use the same preferences. They can be found in the [[Image:Preferences-part_design.svg|24px]] '''Part/Part design''' section of the [[Preferences_Editor|Preferences editor]]. This section will only be available if one of the workbenches has been loaded in the current FreeCAD session.


==Available preferences== <!--T:102-->
There are two tabs: General, and Shape view.


==General== <!--T:2-->
<!--T:98-->
There are four tabs: General, Shape view, Shape appearance and Measure.

===General=== <!--T:2-->


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

<!--T:103-->
{| 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 18: Line 37:
|-
|-
| {{MenuCommand|Automatically check model after boolean operation}}
| {{MenuCommand|Automatically check model after boolean operation}}
| If checked, after a [[Part_Booleans|boolean operation]] it will be checked if the [https://en.wikipedia.org/wiki/Boundary_representation Boundary representation] (BRep) of the model is valid. This is internally done by the function [[Part CheckGeometry|CheckGeometry]].
| If checked, the [https://en.wikipedia.org/wiki/Boundary_representation Boundary representation] (BRep) of the model is [[Part_CheckGeometry|validated]] after [[Part_Boolean|boolean operations]].
|-
|-
| {{MenuCommand|Automatically refine model after boolean operation}}
| {{MenuCommand|Automatically refine model after boolean operation}}
| If checked, the model will be refined using the function [[Part RefineShape|RefineShape]] after a [[Part_Booleans|boolean operation]].
| If checked, the model is [[Part_RefineShape|refined]] after [[Part_Boolean|boolean operations]].
|-
|-
| {{MenuCommand|Automatically refine model after sketch-based operation}}
| {{MenuCommand|Automatically refine model after sketch-based operation}}
| If checked, the model will be refined using the function [[Part RefineShape|RefineShape]] after a sketch of an object has been changed.
| If checked, the model is [[Part_RefineShape|refined]] after changes to source sketches of objects.
|-
| {{MenuCommand|Add name of base object}}
| This option has currently no effect.
|}
|}


</translate>
<!--T:4-->
[[Image:Preferences_Part_design_Tab_General.png]]
[[File:Preference_Part_Design_Tab_01.png]]
<translate>


==Shape view== <!--T:5-->
===Shape view=== <!--T:5-->


<!--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-uncollapsible mw-collapsed"
<!--T:104-->
{| class="wikitable float-right mw-collapsible mw-collapsed"
!style="width: 33%;"|Name
!style="width: 33%;"|Name
!style="width: 66%;"|Description
!style="width: 66%;"|Description
|-
|-
| {{MenuCommand|Maximum deviation depending on the model bounding box}}
| {{MenuCommand|Maximum deviation depending on the model bounding box}}
| Maximum [https://www.opencascade.com/doc/occt-7.3.0/overview/html/occt_user_guides__modeling_algos.html#occt_modalg_11_2 linear deflection] of the tesselated objects from their surface
| Maximum [https://www.opencascade.com/doc/occt-7.3.0/overview/html/occt_user_guides__modeling_algos.html#occt_modalg_11_2 linear deflection] of the [[#Tessellation|tessellated]] objects from their surface.
|-
|-
| {{MenuCommand|Maximum angular deflection}}
| {{MenuCommand|Maximum angular deflection}}
| Maximum [https://www.opencascade.com/doc/occt-7.3.0/overview/html/occt_user_guides__modeling_algos.html#occt_modalg_11_2 angular deflection] from one tesselated object section to the next section
| Maximum [https://www.opencascade.com/doc/occt-7.3.0/overview/html/occt_user_guides__modeling_algos.html#occt_modalg_11_2 angular deflection] from one [[#Tessellation|tessellated]] object section to the next section.
|}
|}

</translate>
[[Image:Preferences_Part_design_Tab_Shape_view.png]]
<translate>

===Shape appearance=== <!--T:105-->

<!--T:106-->
On the ''Shape appearance'' tab you can specify the following:

<!--T:107-->
{| 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|Shape transparency}}
| Transparency for new shapes {{Version|0.21}}.
|-
| {{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 color of the interior side of faces will be the same as the exterior side. If not checked either the [[Preferences_Editor#3D_View|backlight color]], if enabled, or black will be used instead.
|-
| {{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:

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

<!--T:109-->
This console is shown using the menu {{MenuCommand|View → Panels → Python console}}.
|}

</translate>
[[Image:Preferences_Part_design_Tab_Shape_appearance.png]]
<translate>

===Measure=== <!--T:111-->

<!--T:112-->
These preferences control the appearance of measurements created with the [[Part_Workbench#Measure|Measure tools]] available in the [[Part_Workbench|Part Workbench]] and [[PartDesign_Workbench|PartDesign Workbench]].

<!--T:113-->
On the ''Measure'' tab ({{Version|0.21}}) you can specify the following:

<!--T:114-->
{| class="wikitable float-right mw-collapsible mw-collapsed"
!style="width: 33%;"|Name
!style="width: 66%;"|Description
|-
| {{MenuCommand|3D color}}
| Color for 3D linear dimensions.
|-
| {{MenuCommand|Delta color}}
| Color for delta dimensions (parallel to the global X, Y and Z axes).
|-
| {{MenuCommand|Angular color}}
| Color for angular dimensions.
|-
| {{MenuCommand|Font size}}
| Font size in pixels.
|-
| {{MenuCommand|Bold}}
| If checked, font style bold is used.
|-
| {{MenuCommand|Italic}}
| If checked, font style italic is used.
|-
| {{MenuCommand|Font name}}
| The font to use.
|-
| {{Button|Refresh existing measurements}}
| Press this button to update existing measurements.
|}

</translate>
[[Image:Preferences_Part_design_Tab_Measure.png]]
<translate>

==Tessellation== <!--T:110-->


<!--T:7-->
<!--T:7-->
In order to display an object efficiently its surface is [https://en.wikipedia.org/wiki/Tessellation_(computer_graphics) 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.
In order to display an object efficiently its surface is [https://en.wikipedia.org/wiki/Tessellation_(computer_graphics) tessellated], 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.


<!--T:99-->
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 {{MenuCommand|Tools → Edit parameters...}} This opens the parameter editor where you navigate to {{MenuCommand|BaseApp → Preferences → Mod → Part}}.
There is a lower limit for the tessellation of 0.01%. If you really want to spend the additional time you can reduce the lower limit even further by opening the menu {{MenuCommand|Tools → Edit parameters...}} This opens the parameter editor where you navigate to {{MenuCommand|BaseApp → Preferences → Mod → Part}}.


<!--T:100-->
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.
Right click on '''Mesh deviation''' choose in the context menu '''Change value'''. Set the value to the minimum tessellation 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.


<!--T:8-->
[[File:Preference_Part_Design_Tab_02.png]]


<!--T:92-->
<!--T:92-->
{{Docnav
{{Docnav|[[PartDesign_MoveFeatureInTree|Move object after other object]]|[[Fine-tuning|Fine-tuning]]|[[PartDesign_Workbench|PartDesign]]|IconL=|IconC=Workbench_PartDesign.svg|IconR=}}
|[[PartDesign_MoveFeatureInTree|Move object after other object]]
|[[Fine-tuning|Fine-tuning]]
|[[PartDesign_Workbench|PartDesign]]
|IconL=
|IconR=
|IconC=Workbench_PartDesign.svg
}}


<!--T:93-->
{{PartDesign Tools navi}}
{{Userdocnavi}}
</translate>
</translate>
{{PartDesign Tools navi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}
[[Category:Preferences{{#translation:}}]]

Latest revision as of 11:17, 2 July 2023

Introduction

The Part Workbench and the PartDesign Workbench use the same preferences. They can be found in the Part/Part design section of the Preferences editor. This section will only be available if one of the workbenches has been loaded in the current FreeCAD session.

Available preferences

There are four tabs: General, Shape view, Shape appearance and Measure.

General

On the General tab you can specify the following:

Name Description
Automatically check model after boolean operation If checked, the Boundary representation (BRep) of the model is validated after boolean operations.
Automatically refine model after boolean operation If checked, the model is refined after boolean operations.
Automatically refine model after sketch-based operation If checked, the model is refined after changes to source sketches of objects.

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 tessellated objects from their surface.
Maximum angular deflection Maximum angular deflection from one tessellated object section to the next section.

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.
Shape transparency Transparency for new shapes introduced in version 0.21.
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 color of the interior side of faces will be the same as the exterior side. If not checked either the backlight color, if enabled, or black will be used instead.
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.

Measure

These preferences control the appearance of measurements created with the Measure tools available in the Part Workbench and PartDesign Workbench.

On the Measure tab (introduced in version 0.21) you can specify the following:

Name Description
3D color Color for 3D linear dimensions.
Delta color Color for delta dimensions (parallel to the global X, Y and Z axes).
Angular color Color for angular dimensions.
Font size Font size in pixels.
Bold If checked, font style bold is used.
Italic If checked, font style italic is used.
Font name The font to use.
Refresh existing measurements Press this button to update existing measurements.

Tessellation

In order to display an object efficiently its surface is tessellated, 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 tessellation 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 tessellation 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.