Difference between revisions of "Part Boolean"

From FreeCAD Documentation
Jump to navigation Jump to search
(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.)
(Marked this version for translation)
 
(One intermediate revision by one other user not shown)
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.
  
In cases of coplanarity, even if the first boolean operation succeeds, subsequent boolean operations may fail, hiding the cause of the problem. In this case, it is recommended to use the {{Button|[[File:Part_CheckGeometry.svg|16px]] [[Part_CheckGeometry|Part CheckGeometry]]}} tool to inspect all objects for problems.
+
<!--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>
 
</translate>
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.}}
 +
 +
</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-->

Latest revision as of 09:41, 28 May 2020

Other languages:
Deutsch • ‎English • ‎español • ‎français • ‎italiano • ‎polski • ‎română • ‎svenska • ‎čeština • ‎русский • ‎日本語

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

Gui Command explains how tools should be documented. See Draft ShapeString for an example of a well documented tool. Browse Category:UnfinishedDocu to see 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.

Arrow-left.svg Previous: Part Shapebuilder.svg Shapebuilder
Next: Union Part Fuse.svg Arrow-right.svg

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

PartBooleansDialog.png

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.svg Part CheckGeometry tool to inspect all objects for problems.

Part Boolean cut coplanar 1.png

Part Boolean cut coplanar 2.png

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.


Part Boolean fusion coplanar 1.png

Part Boolean fusion coplanar 2.png

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.


Arrow-left.svg Previous: Part Shapebuilder.svg Shapebuilder
Next: Union Part Fuse.svg Arrow-right.svg