Part Boolean: Difference between revisions

From FreeCAD Documentation
mNo edit summary
(Module to Workbench renaming.)
 
(25 intermediate revisions by 6 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
{{Template:UnfinishedDocu{{#translation:}}}}
<translate>
<translate>
<!--T:5-->
<!--T:5-->
{{Docnav
{{Docnav
|[[Part_CompoundFilter|CompoundFilter]]
|[[Part_Shapebuilder|Shapebuilder]]
|[[Part_Union|Union]]
|[[Part_Cut|Cut]]
|[[Part_Module|Part]]
|[[Part_Workbench|Part]]
|IconL=Part_Shapebuilder.svg
|IconL=Part_CompoundFilter.svg
|IconR=Part_Cut.svg
|IconC=Workbench_Part.svg
|IconC=Workbench_Part.svg
|IconR=Part_Fuse.svg
}}
}}


<!--T:1-->
<!--T:1-->
{{GuiCommand
{{GuiCommand
|Name=Part Booleans
|Name=Part Boolean
|MenuLocation=Part → Booleans
|MenuLocation=Part → Boolean → Boolean...
|Workbenches=[[Part Module|Part]]
|Workbenches=[[Part_Workbench|Part]]
|SeeAlso=[[Part Union|Part Union]], [[Part Common|Part Common]], [[Part Cut|Part Cut]] and [[Part Section|Part Section]]
|SeeAlso=[[Part_Cut|Part Cut]], [[Part_Fuse|Part Fuse]], [[Part_Common|Part Common]], [[Part_Section|Part Section]]
}}
}}


Line 23: Line 22:


<!--T:9-->
<!--T:9-->
{{Button|[[File:Part_Boolean.svg|16px]] [[Part_Boolean|Part Boolean]]}} is a generic all-in-one boolean tool. It allows you to specify the objects and operation to perform via a single dialog.
This command is a generic all-in-one boolean tool. It allows you to specify what operation to perform and what parameters to use via the dialog below. For quicker boolean operations, see also [[Image:Part_Fuse.svg|24px]] [[Part Union|Part Union]], [[Image:Part_Common.svg|24px]][[Part Common|Part Common]], [[Image:Part_Cut.svg|24px]] [[Part Cut|Part Cut]] and [[Image:Part_Section.svg|24px]] [[Part Section|Part Section]].

<!--T:17-->
For quicker access to these operations, use {{Button|[[File:Part_Cut.svg|16px]] [[Part_Cut|Part Cut]]}}, {{Button|[[File:Part_Fuse.svg|16px]] [[Part_Fuse|Part Fuse]]}}, {{Button|[[File:Part_Common.svg|16px]] [[Part_Common|Part Common]]}} and {{Button|[[File:Part_Section.svg|16px]] [[Part_Section|Part Section]]}}.


<!--T:3-->
<!--T:3-->
[[File:PartBooleansDialog.png]]
[[File:PartBooleansDialog.png]]

<!--T:18-->
{{Caption|Dialog to select objects and perform boolean operations with them.}}


==Usage== <!--T:10-->
==Usage== <!--T:10-->

<!--T:11-->
See the individual commands:
* {{Button|[[Image:Part_Cut.svg|16px]] [[Part_Cut|Part Cut]]}}
* {{Button|[[Image:Part_Fuse.svg|16px]] [[Part_Fuse|Part Fuse]]}}
* {{Button|[[Image:Part_Common.svg|16px]] [[Part_Common|Part Common]]}}
* {{Button|[[Image:Part_Section.svg|16px]] [[Part Section|Part Section]]}}


<!--T:4-->
<!--T:4-->
Also see the {{MenuCommand|Part → [[Part_RefineShape|Refine Shape]]}} menu.
Also see the {{MenuCommand|Part → Create a copy → [[Part_RefineShape|Refine Shape]]}} menu.

== Coplanar problems == <!--T:12-->

<!--T:13-->
The boolean operations are performed by the internal geometry kernel, [[OpenCASCADE|OpenCASCADE Technology]] (OCCT). This library sometimes has problems producing boolean results when the input objects share an edge or a face. To be sure the boolean operation is successful the recommendation is that the shapes intersect each other clearly; this means that in most cases, one shape should protrude or be larger in size than the other shape.

<!--T:14-->
In cases of coplanarity, even if the first boolean operation succeeds, subsequent boolean operations may fail. In this case, the problem may not be in the last operation done, but in the older ones, that is, in the nested operations as indicated in the [[Tree_view|tree view]]. To troubleshoot these issues, it is recommended to use the {{Button|[[File:Part_CheckGeometry.svg|16px]] [[Part_CheckGeometry|Part CheckGeometry]]}} tool to inspect all objects for problems.

</translate>
[[File:Part_Boolean_cut_coplanar_1.png|500px]]

[[File:Part_Boolean_cut_coplanar_2.png|500px]]
<translate>

<!--T:15-->
{{Caption|Left: shapes that share a face, a boolean cut may produce incorrect results. Right: shapes that intersect each other clearly, the boolean cut will be successful in most cases.}}

</translate>
[[File:Part_Boolean_fusion_coplanar_1.png|500px]]

[[File:Part_Boolean_fusion_coplanar_2.png|500px]]
<translate>

<!--T:16-->
{{Caption|Left: shapes that share a face, a boolean union may produce incorrect results. Right: shapes that intersect each other clearly, the boolean union will be successful in most cases.}}




<!--T:6-->
<!--T:6-->
{{Docnav
{{Docnav
|[[Part_CompoundFilter|CompoundFilter]]
|[[Part_Shapebuilder|Shapebuilder]]
|[[Part_Union|Union]]
|[[Part_Cut|Cut]]
|[[Part_Module|Part]]
|[[Part_Workbench|Part]]
|IconL=Part_Shapebuilder.svg
|IconL=Part_CompoundFilter.svg
|IconR=Part_Cut.svg
|IconC=Workbench_Part.svg
|IconC=Workbench_Part.svg
|IconR=Part_Fuse.svg
}}
}}

<!--T:7-->
{{Part Tools navi}}

<!--T:8-->
{{Userdocnavi}}


</translate>
</translate>
{{Part Tools navi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}

Latest revision as of 12:11, 25 August 2021

Part Boolean

Menu location
Part → Boolean → Boolean...
Workbenches
Part
Default shortcut
None
Introduced in version
-
See also
Part Cut, Part Fuse, Part Common, Part Section

Description

Part Boolean is a generic all-in-one boolean tool. It allows you to specify the objects and operation to perform via a single dialog.

For quicker access to these operations, use Part Cut, Part Fuse, Part Common and Part Section.

Dialog to select objects and perform boolean operations with them.

Usage

See the individual commands:

Also see the Part → Create a copy → Refine Shape menu.

Coplanar problems

The boolean operations are performed by the internal geometry kernel, OpenCASCADE Technology (OCCT). This library sometimes has problems producing boolean results when the input objects share an edge or a face. To be sure the boolean operation is successful the recommendation is that the shapes intersect each other clearly; this means that in most cases, one shape should protrude or be larger in size than the other shape.

In cases of coplanarity, even if the first boolean operation succeeds, subsequent boolean operations may fail. In this case, the problem may not be in the last operation done, but in the older ones, that is, in the nested operations as indicated in the tree view. To troubleshoot these issues, it is recommended to use the Part CheckGeometry tool to inspect all objects for problems.

Left: shapes that share a face, a boolean cut may produce incorrect results. Right: shapes that intersect each other clearly, the boolean cut will be successful in most cases.

Left: shapes that share a face, a boolean union may produce incorrect results. Right: shapes that intersect each other clearly, the boolean union will be successful in most cases.