PartDesign Fillet: Difference between revisions

From FreeCAD Documentation
No edit summary
m (moved templates out of translation tags + link and typo)
(35 intermediate revisions by 7 users not shown)
Line 1: Line 1:
<languages/>
{{GuiCommand|Name=PartDesign Fillet|Workbenches=[[PartDesign Workbench|PartDesign]], Complete|MenuLocation=PartDesign → Fillet|SeeAlso=[[Part Fillet]]}}
<translate>
<!--T:38-->
{{Docnav
|[[PartDesign_MultiTransform|Create MultiTransform]]
|[[PartDesign Chamfer|Chamfer]]
|[[PartDesign_Workbench|PartDesign]]
|IconL=PartDesign_MultiTransform.svg
|IconC=Workbench_PartDesign.svg
|IconR=PartDesign_Chamfer.svg
}}


<!--T:20-->
==== Description ====
{{GuiCommand
|Name=PartDesign Fillet
|Workbenches=[[PartDesign Workbench|PartDesign]]
|MenuLocation=PartDesign → Fillet
|SeeAlso=[[Part Fillet|Part Fillet]]
}}


== Description == <!--T:21-->

<!--T:28-->
This tool creates fillets (rounds) on the selected edges of an object. A new separate Fillet entry (followed by a sequential number if there are already existing fillets in the document) is created in the Project tree.
This tool creates fillets (rounds) on the selected edges of an object. A new separate Fillet entry (followed by a sequential number if there are already existing fillets in the document) is created in the Project tree.


== Usage == <!--T:22-->
[[Image:PartDesign_Fillet-01.png|thumb|left|Select edges on the object before starting the tool.]]
[[Image:PartDesign_Fillet-02.png|thumb|left|Set the fillet radius in the Fillet parameters.]]
[[Image:PartDesign_Fillet-03.png|thumb|left|A Fillet object is added in the Project tree.]]


<!--T:30-->
==== Usage ====
* Select a single or multiple edges or a face on an object, then start the tool either by clicking its icon or going into the menu. In case you selected a face all its edges are respected for filleting.

* In Fillet parameters in the [[Task_panel|Task panel]], set the fillet radius either by entering the value, or by clicking on the up/down arrows. The applied fillet is shown in real time.
* Select a single or multiple edges on an object, then start the tool either by clicking its icon or going into the menu.
* If you want to add more edges or faces click first the '''Add ref''' button and then select the edge or the face.
* In Fillet parameters in the TaskPanel, set the fillet radius either by entering the value, or by clicking on the up/down arrows. The applied fillet is shown in real time.
* If you want to remove edges or faces click the '''Remove ref''' button. All edges and faces being previously selected are highlighted in purple. Select the edge or the face to be removed.
* Click OK to validate.
* Click {{Button|OK}} to validate.
* For a chain of edges tangential to one another, one single edge can be selected; the fillet will propagate along the chain.
* For a chain of edges tangential to one another, one single edge can be selected; the fillet will propagate along the chain.
* To edit the fillet after the function has been validated, either double-click on the Fillet label in the Project tree, or right-click on it and select '''Edit Fillet'''.
* To edit the fillet after the function has been validated, either double-click on the Fillet label in the Project tree, or right-click on it and select '''Edit Fillet'''.


<!--T:29-->
[[Image:PartDesign_Fillet-01.png|400px]] [[Image:PartDesign_Fillet-02.png|400px]]


<!--T:45-->
==== PartDesign Fillet VS. Part Fillet ====
{{Caption|Left: select edges on the object before starting the tool. Right: set the fillet radius in the [[task_panel|task panel]].}}
'''The PartDesign Fillet is not to be confused with its [[Part Fillet|Part workbench counterpart]]'''. Although they share the same icon, they are not the same, and are not used the same way.


<!--T:46-->
Here is how they differ from each other:
[[Image:PartDesign_Fillet-03.png|400px]]


<!--T:47-->
* The PartDesign Fillet is ''parametric''. After a fillet has been applied, its radius can be edited; this is not possible with the Part Fillet.
{{Caption|A fillet object is added in the [[tree_view|tree view]].}}
* Edges must be selected on an object before activating the PartDesign Fillet. WIth the Part Fillet, the tool can be started, then a solid is selected, then edges.

<!--T:48-->
{{Emphasis|Editor note: these images are old, they need to be updated.}}

==== PartDesign Fillet vs. Part Fillet ==== <!--T:26-->

<!--T:43-->
[[Image:PartDesign_Fillet.svg|24px]] [[PartDesign_Fillet|PartDesign Fillet]] is not to be confused with '''[[Image:Part_Fillet.svg|24px]] [[Part_Fillet|Part Fillet]]''' of the [[Part_Workbench|Part Workbench]]. Although they share the same name, they are not the same, and are not used the same way.

<!--T:44-->
Here is how they differ from each other:
* The PartDesign Fillet is ''Parametric''. After a fillet has been applied, its radius can be edited; this is not possible with the Part Fillet.
* Edges must be selected on an object before activating the PartDesign Fillet. With the Part Fillet, the tool can be started, then a solid is selected, then edges.
* The PartDesign Fillet creates a separate Fillet entry (followed by a sequential number if there are already existing fillets) in the Project tree. The Part Fillet becomes the parent of the object it was applied to.
* The PartDesign Fillet creates a separate Fillet entry (followed by a sequential number if there are already existing fillets) in the Project tree. The Part Fillet becomes the parent of the object it was applied to.
* The PartDesign Fillet offers a live preview of the fillet applied to the object before validating the function.
* The PartDesign Fillet offers a live preview of the fillet applied to the object before validating the function.
* The Part Fillet supports variable radii (with a start radius and an end radius). The PartDesign fillet doesn't.
* The Part Fillet supports variable radii (with a start radius and an end radius). The PartDesign fillet doesn't.


== Known Issues == <!--T:27-->

<!--T:31-->
Fillets, chamfers, and other features that operate on solid bodies depend on the underlying OpenCASCADE Technology (OCCT) kernel that FreeCAD uses.
The OCCT kernel occasionally has difficulty handling coincident sharp edges, where two faces meet. If this is the case FreeCAD may crash without an explanation.

<!--T:32-->
If run from the terminal, FreeCAD may output a log like this one after the crash:
</translate>
{{code|code=
#1 0x7fff63d660ba in BRep_Tool::Curve(TopoDS_Edge const&, TopLoc_Location&, double&, double&) from /usr/lib/x86_64-linux-gnu/libTKBRep.so.7+0x2a
#2 0x7fff63d69546 in BRep_Tool::Curve(TopoDS_Edge const&, double&, double&) from /usr/lib/x86_64-linux-gnu/libTKBRep.so.7+0x46
#3 0x7fff71f4fef5 in ChFi3d_Builder::PerformIntersectionAtEnd(int) from /usr/lib/x86_64-linux-gnu/libTKFillet.so.7+0x3b05
#4 0x7fff71f58307 in ChFi3d_Builder::PerformOneCorner(int, bool) from /usr/lib/x86_64-linux-gnu/libTKFillet.so.7+0x1097
#5 0x7fff71ef6218 in ChFi3d_Builder::PerformFilletOnVertex(int) from /usr/lib/x86_64-linux-gnu/libTKFillet.so.7+0x4e8
#6 0x7fff71ef71d1 in ChFi3d_Builder::Compute() from /usr/lib/x86_64-linux-gnu/libTKFillet.so.7+0xe31
#7 0x7fff720ad7c3 in BRepFilletAPI_MakeChamfer::Build() from /usr/lib/x86_64-linux-gnu/libTKFillet.so.7+0x33
#8 0x7fff723be48e in PartDesign::Chamfer::execute() from /usr/lib/freecad-daily/lib/_PartDesign.so+0x60e
...
}}
<translate>

<!--T:33-->
This output references functions located in {{incode|libTKBRep.so}}, {{incode|libTKFillet.so}}, etc., which are OCCT libraries. If this type of crashes occurs, the problem may need to be reported and solved in OCCT rather than in FreeCAD.

<!--T:34-->
See the forum threads for more information:
*[https://forum.freecadweb.org/viewtopic.php?p=263818#p263818 Bug Chamfer bigger than 2mm crashes freecad]
*[https://forum.freecadweb.org/viewtopic.php?p=264827#p264827 Segfault when using part design fillet]

<!--T:35-->
The user is also responsible for the integrity of his or her own model. Depending on the model, it may be impossible to perform a fillet or chamfer if the body is not big enough to support that operation. For example, it wouldn't be possible to create a 10 mm fillet if an edge is separated only 5 mm from the next surface. In that case, the maximum radius for a fillet would be 5 mm; trying to use a larger value may result in a shape that doesn't compute, or even a crash. If using the exact limit of 5 mm doesn't work, it may be possible to use a very close approximation, like 4.9999 mm, to produce the same visible result.

=== Topological naming === <!--T:36-->
Edge numbers are not completely stable, therefore it is advisable that you finish the main design work of your solid body before applying features like fillets and chamfers, otherwise edges could change name and filleted edges would likely become invalid.

<!--T:42-->
Read more in [[topological naming problem|topological naming problem]].

==Scripting== <!--T:23-->

<!--T:37-->
The tool {{KEY|[[File:PartDesign_Fillet.svg|16px|text-top=Fillet|link=PartDesign_Fillet]] [[PartDesign_Fillet|Fillet]]}} can be used in a macro, and, from the Python console using the following function :
</translate>
{{Code|code=
Box = Box.makeFillet(3,[Box.Edges[0]]) # 1 Fillet
Box = Box.makeFillet(3,[Box.Edges[1],Box.Edges[2],Box.Edges[3],Box.Edges[4]]) # for several Fillets
}}
<translate>

<!--T:24-->
*3 = radius
*Box.Edges[2] = Edge with its number


<!--T:25-->
Example :
</translate>
{{Code|code=
import PartDesign
from FreeCAD import Base


Box = Part.makeBox(10,10,10)
Box = Box.makeFillet(3,[Box.Edges[0]]) # pour 1 Fillet
Box = Box.makeFillet(3,[Box.Edges[1],Box.Edges[2],Box.Edges[3],Box.Edges[4]]) # for several Fillets
Part.show(Box)
}}


<translate>
<!--T:39-->
{{Docnav
|[[PartDesign_MultiTransform|Create MultiTransform]]
|[[PartDesign Chamfer|Chamfer]]
|[[PartDesign_Workbench|PartDesign]]
|IconL=PartDesign_MultiTransform.svg
|IconC=Workbench_PartDesign.svg
|IconR=PartDesign_Chamfer.svg
}}


</translate>
{{clear}}
{{clear}}
{{PartDesign Tools navi{{#translation:}}}}
{{languages | {{es|PartDesign Fillet/es}} {{fr|PartDesign Fillet/fr}} {{it|PartDesign Fillet/it}} }}
{{Userdocnavi{{#translation:}}}}

Revision as of 02:00, 24 February 2020

PartDesign Fillet

Menu location
PartDesign → Fillet
Workbenches
PartDesign
Default shortcut
None
Introduced in version
-
See also
Part Fillet

Description

This tool creates fillets (rounds) on the selected edges of an object. A new separate Fillet entry (followed by a sequential number if there are already existing fillets in the document) is created in the Project tree.

Usage

  • Select a single or multiple edges or a face on an object, then start the tool either by clicking its icon or going into the menu. In case you selected a face all its edges are respected for filleting.
  • In Fillet parameters in the Task panel, set the fillet radius either by entering the value, or by clicking on the up/down arrows. The applied fillet is shown in real time.
  • If you want to add more edges or faces click first the Add ref button and then select the edge or the face.
  • If you want to remove edges or faces click the Remove ref button. All edges and faces being previously selected are highlighted in purple. Select the edge or the face to be removed.
  • Click OK to validate.
  • For a chain of edges tangential to one another, one single edge can be selected; the fillet will propagate along the chain.
  • To edit the fillet after the function has been validated, either double-click on the Fillet label in the Project tree, or right-click on it and select Edit Fillet.

Left: select edges on the object before starting the tool. Right: set the fillet radius in the task panel.

A fillet object is added in the tree view.

Editor note: these images are old, they need to be updated.

PartDesign Fillet vs. Part Fillet

PartDesign Fillet is not to be confused with Part Fillet of the Part Workbench. Although they share the same name, they are not the same, and are not used the same way.

Here is how they differ from each other:

  • The PartDesign Fillet is Parametric. After a fillet has been applied, its radius can be edited; this is not possible with the Part Fillet.
  • Edges must be selected on an object before activating the PartDesign Fillet. With the Part Fillet, the tool can be started, then a solid is selected, then edges.
  • The PartDesign Fillet creates a separate Fillet entry (followed by a sequential number if there are already existing fillets) in the Project tree. The Part Fillet becomes the parent of the object it was applied to.
  • The PartDesign Fillet offers a live preview of the fillet applied to the object before validating the function.
  • The Part Fillet supports variable radii (with a start radius and an end radius). The PartDesign fillet doesn't.

Known Issues

Fillets, chamfers, and other features that operate on solid bodies depend on the underlying OpenCASCADE Technology (OCCT) kernel that FreeCAD uses. The OCCT kernel occasionally has difficulty handling coincident sharp edges, where two faces meet. If this is the case FreeCAD may crash without an explanation.

If run from the terminal, FreeCAD may output a log like this one after the crash:

#1  0x7fff63d660ba in BRep_Tool::Curve(TopoDS_Edge const&, TopLoc_Location&, double&, double&) from /usr/lib/x86_64-linux-gnu/libTKBRep.so.7+0x2a
#2  0x7fff63d69546 in BRep_Tool::Curve(TopoDS_Edge const&, double&, double&) from /usr/lib/x86_64-linux-gnu/libTKBRep.so.7+0x46
#3  0x7fff71f4fef5 in ChFi3d_Builder::PerformIntersectionAtEnd(int) from /usr/lib/x86_64-linux-gnu/libTKFillet.so.7+0x3b05
#4  0x7fff71f58307 in ChFi3d_Builder::PerformOneCorner(int, bool) from /usr/lib/x86_64-linux-gnu/libTKFillet.so.7+0x1097
#5  0x7fff71ef6218 in ChFi3d_Builder::PerformFilletOnVertex(int) from /usr/lib/x86_64-linux-gnu/libTKFillet.so.7+0x4e8
#6  0x7fff71ef71d1 in ChFi3d_Builder::Compute() from /usr/lib/x86_64-linux-gnu/libTKFillet.so.7+0xe31
#7  0x7fff720ad7c3 in BRepFilletAPI_MakeChamfer::Build() from /usr/lib/x86_64-linux-gnu/libTKFillet.so.7+0x33
#8  0x7fff723be48e in PartDesign::Chamfer::execute() from /usr/lib/freecad-daily/lib/_PartDesign.so+0x60e
...

This output references functions located in libTKBRep.so, libTKFillet.so, etc., which are OCCT libraries. If this type of crashes occurs, the problem may need to be reported and solved in OCCT rather than in FreeCAD.

See the forum threads for more information:

The user is also responsible for the integrity of his or her own model. Depending on the model, it may be impossible to perform a fillet or chamfer if the body is not big enough to support that operation. For example, it wouldn't be possible to create a 10 mm fillet if an edge is separated only 5 mm from the next surface. In that case, the maximum radius for a fillet would be 5 mm; trying to use a larger value may result in a shape that doesn't compute, or even a crash. If using the exact limit of 5 mm doesn't work, it may be possible to use a very close approximation, like 4.9999 mm, to produce the same visible result.

Topological naming

Edge numbers are not completely stable, therefore it is advisable that you finish the main design work of your solid body before applying features like fillets and chamfers, otherwise edges could change name and filleted edges would likely become invalid.

Read more in topological naming problem.

Scripting

The tool text-top=Fillet Fillet can be used in a macro, and, from the Python console using the following function :

Box = Box.makeFillet(3,[Box.Edges[0]]) # 1 Fillet
Box = Box.makeFillet(3,[Box.Edges[1],Box.Edges[2],Box.Edges[3],Box.Edges[4]]) # for several Fillets
  • 3 = radius
  • Box.Edges[2] = Edge with its number


Example :

import PartDesign
from FreeCAD import Base

Box = Part.makeBox(10,10,10)
Box = Box.makeFillet(3,[Box.Edges[0]]) # pour 1 Fillet
Box = Box.makeFillet(3,[Box.Edges[1],Box.Edges[2],Box.Edges[3],Box.Edges[4]]) # for several Fillets
Part.show(Box)