Part Boolean: Difference between revisions

From FreeCAD Documentation
(→‎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.)
(Marked this version for translation)
Line 30: Line 30:
==Usage== <!--T:10-->
==Usage== <!--T:10-->


<!--T:11-->
See the individual commands:
See the individual commands:
* {{Button|[[Image:Part_Fuse.svg|16px]] [[Part_Union|Part Union]]}}
* {{Button|[[Image:Part_Fuse.svg|16px]] [[Part_Union|Part Union]]}}
Line 39: Line 40:
Also see the {{MenuCommand|Part → [[Part_RefineShape|Refine Shape]]}} menu.
Also see the {{MenuCommand|Part → [[Part_RefineShape|Refine Shape]]}} menu.


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


<!--T:13-->
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.
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.


<!--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.


Line 51: Line 54:
<translate>
<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.}}
{{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.}}


Line 59: Line 63:
<translate>
<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.}}
{{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.}}



Revision as of 09:41, 28 May 2020

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.