Part Boolean: Difference between revisions

From FreeCAD Documentation
No edit summary
(→‎Coplanar problems: 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.)
(4 intermediate revisions by the same user not shown)
Line 14: Line 14:
<!--T:1-->
<!--T:1-->
{{GuiCommand
{{GuiCommand
|Name=Part Booleans
|Name=Part Boolean
|MenuLocation=Part → Booleans
|MenuLocation=Part → Booleans
|Workbenches=[[Part Module|Part]]
|Workbenches=[[Part Module|Part]]
Line 23: Line 23:


<!--T:9-->
<!--T:9-->
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]].
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:3-->
<!--T:3-->
Line 29: Line 29:


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

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_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 → [[Part_RefineShape|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|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>

{{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>

{{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-->

Revision as of 20:07, 27 May 2020

Other languages:

This documentation is not finished. Please help and contribute documentation.

GuiCommand model explains how commands should be documented. Browse Category:UnfinishedDocu to see more incomplete pages like this one. See Category:Command Reference for all commands.

See WikiPages to learn about editing the wiki pages, and go to Help FreeCAD to learn about other ways in which you can contribute.

Part Boolean

Menu location
Part → Booleans
Workbenches
Part
Default shortcut
None
Introduced in version
-
See also
Part Union, Part Common, Part Cut and Part Section

Description

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 Part Union, Part Common, Part Cut, and Part Section.

Usage

See the individual commands:

Also see the Part → 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.

Part
User documentation
Retrieved from "http://wiki.freecad.org/index.php?title=Part_Boolean&oldid=695617"