Part Boolean: Difference between revisions

From FreeCAD Documentation
(Removed UnfinishedDocu template because the explanation is in the individual pages for fuse, cut, common, and section.)
(Module to Workbench renaming.)
 
(12 intermediate revisions by 4 users not shown)
Line 3: Line 3:
<!--T:5-->
<!--T:5-->
{{Docnav
{{Docnav
|[[Part_CompoundFilter|CompoundFilter]]
|[[Part_Builder|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
}}
}}


Line 14: Line 14:
{{GuiCommand
{{GuiCommand
|Name=Part Boolean
|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 22: 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 {{Button|[[File:Part_Fuse.svg|16px]] [[Part_Union|Part Union]]}}, {{Button|[[File:Part_Common.svg|16px]] [[Part_Common|Part Common]]}}, {{Button|[[File:Part_Cut.svg|16px]] [[Part_Cut|Part Cut]]}}, and {{Button|[[File:Part_Section.svg|16px]] [[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-->
Line 31: Line 37:
<!--T:11-->
<!--T:11-->
See the individual commands:
See the individual commands:
* {{Button|[[Image:Part_Fuse.svg|16px]] [[Part_Union|Part Union]]}}
* {{Button|[[Image:Part_Cut.svg|16px]] [[Part_Cut|Part Cut]]}}
* {{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_Common.svg|16px]] [[Part_Common|Part Common]]}}
* {{Button|[[Image:Part_Section.svg|16px]] [[Part Section|Part Section]]}}
* {{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-->
== Coplanar problems == <!--T:12-->
Line 45: Line 51:


<!--T:14-->
<!--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.
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>
</translate>
Line 64: Line 70:
<!--T:16-->
<!--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.}}
{{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_Builder|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
}}
}}



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.