PartDesign Fillet: Difference between revisions

Latest revision as of 13:38, 8 June 2022

Other languages:

Scaled

Chamfer

PartDesign

Menu location
PartDesign Fillet
Part Design → Apply a dress-up feature → Fillet
Workbenches
PartDesign
Default shortcut
None
Introduced in version
-
See also
PartDesign Chamfer

Description

The PartDesign Fillet tool creates fillets (rounds) on the selected edges of an object. It adds a Fillet object to the document with its corresponding representation in the Tree view.

Usage

Add a fillet

Optionally activate the Body to fillet.
There are several ways to select edges to fillet:
- Select one or more edges of the Body individually.
- Select one or more faces of the Body to select all their edges.
- Select a feature (usually the last feature) of the Body to select all its edges. introduced in version 0.20
For a chain of tangentially connected edges only a single edge needs to be selected, the fillet will propagate along the chain.
There are several ways to invoke the tool:
- Press the Fillet button.
- Select the Part Design → Apply a dress-up feature → Fillet option from the menu.
If there is no active Body, and there are two or more Bodies in the document, the Active Body Required dialog will open and prompt you to activate one. If there is a single Body it will be activated automatically.
The Fillet parameters task panel opens. See Options for more information.
Press the OK button to finish.

Edit a fillet

Do one of the following:
- Double-click the Fillet object in the Tree view
- Right-click the Fillet object in the Tree view and select Edit Fillet from the context menu.
The Fillet parameters task panel opens.See Options for more information.
Press the OK button to finish.

Options

To add edges do one of the following:
- Press the Add button to start selecting edges and/or faces in the 3D view.
- To select all remaining edges do the following:
  1. If required press the Add button.
  2. Use the Ctrl+Shift+A keyboard shortcut, or right-click the list and select Add all edges from the context menu. introduced in version 0.20
To remove edges do one of the following:
- Press the Remove button to start deselecting edges and/or faces in the 3D view. Selected elements are highlighted in purple.
- Select one or more elements in the list and press the Del key, or right-click the list and select Remove from the context menu.
Set the Radius of the fillet.
Check the Use all edges checkbox to select all edges of the previous feature. This deactivates the selection list and the related buttons. introduced in version 0.20

Notes

PartDesign Fillet should not be confused with Part Fillet. Unless you know what you are doing, Part Fillet should not be used on a PartDesign Body. See Part and PartDesign.
Fillets cannot completely consume the adjacent faces.

Properties

Data

Base

DataBase (LinkSub): Link to the selected edges and faces of the parent feature. Can be a link to only the parent feature if DataUse All Edges is true.
DataSupport Transform (Bool): If true the filleted shape of the additive/subtractive parent feature will be used when the fillet object is included in a pattern, else only the shape of the fillet itself will be used. The default is false.
Data (hidden)Add Sub Shape (PartShape)
Data (hidden)Base Feature (Link): Link to the parent feature.
Data (hidden)_ Body (LinkHidden): Link to the parent body.

Fillet

DataRadius (QuantityConstraint): The fillet radius. The default is 1 mm.
DataUse All Edges (Bool): If true all edges of the feature are filleted, and the edges specified by DataBase are ignored. The default is false.

Part Design

DataRefine (Bool): If true redundant edges are removed from the result of the operation. The default value is determined by the Automatically refine model after sketch-based operation preference. See PartDesign Preferences.

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 after a 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 from OCCT libraries. If this type of crash occurs, the problem may need to be reported and solved in OCCT rather than in FreeCAD.

See the forum threads for more information:

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 names and filleted edges would likely become invalid. When the DataUse All Edges property (introduced in version 0.20) is true there is some protection from this. Because in such cases all the edges of the base object are used and there is no dependence on individual edge names.

Read more in topological naming problem.

Scaled

Chamfer

PartDesign

Structure tools: Part, Group
Helper tools: Create body, Create sketch, Edit sketch, Map sketch to face

Modeling tools
- Datum tools: Create a datum point, Create a datum line, Create a datum plane, Create a local coordinate system, Create a shape binder, Create a sub-object(s) shape binder, Create a clone
- Additive tools: Pad, Revolution, Additive loft, Additive pipe, Additive helix, Additive box, Additive cylinder, Additive sphere, Additive cone, Additive ellipsoid, Additive torus, Additive prism, Additive wedge
- Subtractive tools: Pocket, Hole, Groove, Subtractive loft, Subtractive pipe, Subtractive helix, Subtractive box, Subtractive cylinder, Subtractive sphere, Subtractive cone, Subtractive ellipsoid, Subtractive torus, Subtractive prism, ‎Subtractive wedge

Transformation tools: Mirrored, Linear Pattern, Polar Pattern, Create MultiTransform, Scaled
Dress-up tools: Fillet, Chamfer, Draft, Thickness
Boolean: Boolean operation

Extras: Migrate, Sprocket, Involute gear, Shaft design wizard
Context menu: Set tip, Move object to other body, Move object after other object, Appearance, Color per face

User documentation

Getting started
Installation: Download, Windows, Linux, Mac, Additional components, Docker, AppImage, Ubuntu Snap
Basics: About FreeCAD, Interface, Mouse navigation, Selection methods, Object name, Preferences, Workbenches, Document structure, Properties, Help FreeCAD, Donate

Help: Tutorials, Video tutorials
Workbenches: Std Base, Arch, Assembly, CAM, Draft, FEM, Inspection, Mesh, OpenSCAD, Part, PartDesign, Points, Reverse Engineering, Robot, Sketcher, Spreadsheet, Start, Surface, TechDraw, Test Framework, Web

Addons: Addon Manager, External workbenches, Scripting and macros

Hubs: User hub, Power users hub, Developer hub

@@ Line 4: / Line 4: @@
 <!--T:38-->
 {{Docnav
+|[[PartDesign_Scaled|Scaled]]
-|[[PartDesign_MultiTransform|Create MultiTransform]]
 |[[PartDesign_Chamfer|Chamfer]]
 |[[PartDesign_Workbench|PartDesign]]
-|IconL=PartDesign_MultiTransform.svg
+|IconL=PartDesign_Scaled.svg
 |IconR=PartDesign_Chamfer.svg
 |IconC=Workbench_PartDesign.svg
@@ Line 23: / Line 23: @@
 <!--T:28-->
-The [[Image:PartDesign_Fillet.svg|16px|text-top=Fillet|link=PartDesign_Fillet]] [[PartDesign_Fillet|PartDesign Fillet]] command creates fillets (rounds) on the selected edges of an object. It adds a '''Fillet''' object to the document with its corresponding representation in the [[Tree_view|Tree view]].
+The [[Image:PartDesign_Fillet.svg|24px]] '''PartDesign Fillet''' tool creates fillets (rounds) on the selected edges of an object. It adds a '''Fillet''' object to the document with its corresponding representation in the [[Tree_view|Tree view]].
 == Usage == <!--T:22-->
-=== Add a Fillet ===
+=== Add a fillet === <!--T:52-->
 <!--T:30-->
-# Optionally activate the Body to fillet (by double clicking the [[Tree_view|Tree view]] item).
+# Optionally [[PartDesign_Body#Active_status|activate]] the Body to fillet.
 # There are several ways to select edges to fillet:
-#* Select one or more edge(s) of the active Body individually.
+#* Select one or more edges of the Body individually.
-#* Select one or more face(s) on the active Body to select all surrounding edges at once.
+#* Select one or more faces of the Body to select all their edges.
-#* Select the whole active Body to select all its edges at once. {{Version|0.20}}
+#* Select a feature (usually the last feature) of the Body to select all its edges. {{Version|0.20}}
+# For a chain of tangentially connected edges only a single edge needs to be selected, the fillet will propagate along the chain.
-# There are several ways to invoke the Fillet tool:
+# There are several ways to invoke the tool:
-#* Press the {{Button|[[Image:PartDesign_Fillet.svg|16px|text-top=Fillet|link=PartDesign_Fillet]] [[PartDesign_Fillet|Fillet]]}} button.
+#* Press the {{Button|[[Image:PartDesign_Fillet.svg|16px]] [[PartDesign_Fillet|Fillet]]}} button.
 #* Select the {{MenuCommand|Part Design → Apply a dress-up feature → [[Image:PartDesign_Fillet.svg|16px]] Fillet}} option from the menu.
+# If there is no active Body, and there are two or more Bodies in the document, the {{MenuCommand|Active Body Required}} dialog will open and prompt you to activate one. If there is a single Body it will be activated automatically.
-# The Fillet parameters dialog will open in the [[Task_panel|Task panel]] and allows to set several [[#Options|options]].
+# The {{MenuCommand|Fillet parameters}} [[Task_panel|task panel]] opens. See [[#Options|Options]] for more information.
-# Click {{Button|OK}} to validate.
+# Press the {{Button|OK}} button to finish.
+=== Edit a fillet === <!--T:53-->
+<!--T:54-->
-:''Remember'':
+# Do one of the following:
-:* For a chain of edges tangential to one another, one single edge can be selected; the fillet will propagate along the chain.
+#* Double-click the Fillet object in the [[Tree_view|Tree view]]
-:* Since there must be at least one edge for the feature, the last remaining edge or face in the list cannot be removed.
+#* Right-click the Fillet object in the [[Tree_view|Tree view]] and select {{MenuCommand|Edit Fillet}} from the context menu.
-:* Uncheck the {{MenuCommand|Use all edges}} checkbox to add or remove edges and/or faces individually.
+# The {{MenuCommand|Fillet parameters}} [[Task_panel|task panel]] opens.See [[#Options|Options]] for more information.
+# Press the {{Button|OK}} button to finish.
+==Options== <!--T:55-->
-=== Edit a Fillet ===
+<!--T:56-->
-# There are two ways to reopen the Fillet parameters dialog to edit a Fillet:
+* To add edges do one of the following:
-#* Double-click on the Fillet item in the [[Tree_view|Tree view]]
+** Press the {{Button|Add}} button to start selecting edges and/or faces in the [[3D_view|3D view]].
-#* Right-click on the Fillet item in the [[Tree_view|Tree view]] and select {{MenuCommand|Edit Fillet}} from the context menu.
+** To select all remaining edges do the following:
-# The Fillet parameters dialog will open in the [[Task_panel|Task panel]] and allows to set several [[#Options|options]].
-# Click {{Button|OK}} to validate.
+**# If required press the {{Button|Add}} button.
+**# Use the {{KEY|Ctrl}}+{{KEY|Shift}}+{{KEY|A}} keyboard shortcut, or right-click the list and select {{MenuCommand|Add all edges}} from the context menu. {{Version|0.20}}
+* To remove edges do one of the following:
-==Options==
+** Press the {{Button|Remove}} button to start deselecting edges and/or faces in the [[3D_view|3D view]]. Selected elements are highlighted in purple.
+** Select one or more elements in the list and press the {{KEY|Del}} key, or right-click the list and select {{MenuCommand|Remove}} from the context menu.
-* {{MenuCommand|Radius}}: Set the fillet radius either by editing the value or by clicking on the up/down arrows.
+* Set the {{MenuCommand|Radius}} of the fillet.
-* {{MenuCommand|Add}}: Add edges to the selection by pressing the {{Button|Add}} button and selecting more edges or faces.
-*: To select all remaining edges right-click in the list and select {{MenuCommand|Add all edges}} from the context menu. {{Version|0.20}}
+* Check the {{MenuCommand|Use all edges}} checkbox to select all edges of the previous feature. This deactivates the selection list and the related buttons. {{Version|0.20}}
-* {{MenuCommand|Remove}}: Choose a way to remove edges from the selection:
-** Select each edge or face in the list of the dialog and press the {{KEY|DEL}} key or right-click in the list and select {{MenuCommand|Remove}} from the context menu.
-** Press the {{Button|Remove}} button. All edges and faces being previously selected are highlighted in purple. Select each edge or face to be removed.
-* {{MenuCommand|Use all edges}}: Select all edges by checking the {{MenuCommand|Use all edges}} checkbox {{Version|0.20}}. This deactivates the selection list and the related buttons.
 == Notes == <!--T:50-->
@@ Line 71: / Line 72: @@
 * Fillets cannot completely consume the adjacent faces.
-==Properties==
+==Properties== <!--T:57-->
+<!--T:58-->
 See also: [[Property_editor|Property editor]].
+<!--T:59-->
 A PartDesign Fillet object is derived from a [[Part_Feature|Part Feature]] object and inherits all its properties. It also has the following additional properties:
-===Data===
+===Data=== <!--T:60-->
+<!--T:61-->
 {{Properties_Title|Base}}
+<!--T:62-->
-* {{PropertyData|Base|LinkSub}}: Base. Sub-link to the parent feature's list of selected edges and faces.
+* {{PropertyData|Base|LinkSub}}: Link to the selected edges and faces of the parent feature. Can be a link to only the parent feature if {{PropertyData|Use All Edges}} is {{TRUE}}.
-* {{PropertyData|SupportTransform|Bool}}: Support Transform. "Include the base additive/subtractive shape when used in pattern features.
+* {{PropertyData|Support Transform|Bool}}: If {{TRUE}} the filleted shape of the additive/subtractive parent feature will be used when the fillet object is included in a [[PartDesign_Workbench#Transformation_tools|pattern]], else only the shape of the fillet itself will be used. The default is {{FALSE}}.
-: If disabled, only the dressed part of the shape is used for patterning. Default: {{FALSE}}.
-* {{PropertyData|AddSubShape|PartShape|hidden}}: Add Sub Shape.
+* {{PropertyData|Add Sub Shape|PartShape|hidden}}
-* {{PropertyData|BaseFeature|Link|hidden}}: Base Feature. Link to the parent feature.
+* {{PropertyData|Base Feature|Link|hidden}}: Link to the parent feature.
-* {{PropertyData|_Body|LinkHidden|hidden}}: _Body. Hidden link to the parent body.
+* {{PropertyData|_ Body|LinkHidden|hidden}}: Link to the parent body.
+<!--T:63-->
 {{Properties_Title|Fillet}}
+<!--T:64-->
-* {{PropertyData|Radius|QuantityConstraint}}: "Fillet radius". Default: {{value|1,00 mm}}.
-* {{PropertyData|UseAllEdges|Bool}}: Use All Edges. "Fillet all edges if {{TRUE}}, else use only those edges in Base property.
+* {{PropertyData|Radius|QuantityConstraint}}: The fillet radius. The default is {{value|1 mm}}.
-: If {{TRUE}}, then this overrides any edge changes made to the Base property or in the dialog". Default: {{FALSE}}.
+* {{PropertyData|Use All Edges|Bool}}: If {{TRUE}} all edges of the feature are filleted, and the edges specified by {{PropertyData|Base}} are ignored. The default is {{FALSE}}.
+<!--T:65-->
 {{Properties_Title|Part Design}}
+<!--T:66-->
-* {{PropertyData|Refine|Bool}}: "Refine shape (clean up redundant edges) after adding/subtracting". Default: {{TRUE}}.
+* {{PropertyData|Refine|Bool}}: If {{TRUE}} redundant edges are removed from the result of the operation. The default value is determined by the {{MenuCommand|Automatically refine model after sketch-based operation}} preference. See [[PartDesign_Preferences#General|PartDesign Preferences]].
 == 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.
+Fillets, chamfers, and other features that operate on solid bodies depend on the underlying [[OpenCASCADE|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.
-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:
+If run from the terminal, FreeCAD may output a log like this after a crash:
 </translate>
-{{code|code=
+{{code|lang=text|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
@@ Line 124: / Line 128: @@
 <!--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.
+This output references functions from OCCT libraries. If this type of crash occurs, the problem may need to be reported and solved in OCCT rather than in FreeCAD.
 <!--T:34-->
@@ Line 130: / Line 134: @@
 *[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:49-->
 <!--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. When the {{PropertyData|Use All Edges}} property ({{Version|0.20}}) is {{TRUE}} there is some protection from this. Because in such cases all the edges of the base object are used and there is no dependence on individual edge names.
+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 names and filleted edges would likely become invalid. When the {{PropertyData|Use All Edges}} property ({{Version|0.20}}) is {{TRUE}} there is some protection from this. Because in such cases all the edges of the base object are used and there is no dependence on individual edge names.
 <!--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_Scaled|Scaled]]
-|[[PartDesign_MultiTransform|Create MultiTransform]]
 |[[PartDesign_Chamfer|Chamfer]]
 |[[PartDesign_Workbench|PartDesign]]
-|IconL=PartDesign_MultiTransform.svg
+|IconL=PartDesign_Scaled.svg
 |IconR=PartDesign_Chamfer.svg
 |IconC=Workbench_PartDesign.svg