Draft Fillet: Difference between revisions

From FreeCAD Documentation
(Added 'In progress')
No edit summary
Line 25: Line 25:


<!--T:4-->
<!--T:4-->
The [[Draft_Fillet|Draft Fillet]] tool creates a fillet, a rounded corner, between two [[Draft_Line|Draft Lines]]. Alternatively, it can create a chamfer, a straight edge, between those two lines.
The [[Image:Draft_Fillet.svg|24px]] [[Draft_Fillet|Draft Fillet]] command creates a fillet, a rounded corner, between two [[Draft_Line|Draft Lines]]. Alternatively, it can create a chamfer, a straight edge, between those two lines.


</translate>
</translate>
Line 40: Line 40:
#* Press the {{Button|[[Image:Draft_Fillet.svg|16px]] [[Draft_Fillet|Draft Fillet]]}} button.
#* Press the {{Button|[[Image:Draft_Fillet.svg|16px]] [[Draft_Fillet|Draft Fillet]]}} button.
#* Select the {{MenuCommand|Drafting → [[Image:Draft_Fillet.svg|16px]] Fillet}} option from the menu.
#* Select the {{MenuCommand|Drafting → [[Image:Draft_Fillet.svg|16px]] Fillet}} option from the menu.
# Enter the {{MenuCommand|Fillet radius}}. If the {{MenuCommand|Create chamfer}} option is selected this will be the length of the chamfer. Note that the command will not succeed if the radius or the chamfer length are too large for the selected lines.
# Enter the fillet radius.
# Optionally check the {{MenuCommand|Delete original objects}} option.
# Optionally check the {{MenuCommand|Create chamfer}} option.
# If you have selected one of the two previous options: Click in the {{MenuCommand|Fillet radius}} input box.
# Press {{KEY|Enter}}.
# Press {{KEY|Enter}}.

===Alternative creation of fillets and chamfers=== <!--T:9-->

<!--T:10-->
A [[Draft Wire|Draft Wire]] that has at least three points can also create a fillet or a chamfer.

<!--T:11-->
# Select two [[Draft_Line|Draft Lines]] that meet in a single point.
# Press the {{Button|[[Image:Draft_Wire.svg|16px]] [[Draft_Wire|Draft Wire]]}} button. This will fuse the two lines into a single Wire object.
# In the [[Property_editor|property editor]], enter the desired numerical value for {{PropertyData|Fillet Radius}} or {{PropertyData|Chamfer Size}}.

<!--T:12-->
This method works also when joining two different polylines.


==Options== <!--T:13-->
==Options== <!--T:13-->


<!--T:14-->
<!--T:14-->
* Press {{KEY|Esc}} or the {{Button|Close}} button to abort the command.
* Check the "Delete original objects" checkbox if you want to delete the two original lines, and leave only the new fillet object.
* Check the "Create chamfer" checkbox if you want to create a straight edge, instead of a rounded edge, between the two lines.
* Press {{KEY|Esc}} or the {{Button|Close}} button to abort the current command.


== Notes == <!--T:30-->
== Notes == <!--T:30-->
Line 67: Line 55:
<!--T:8-->
<!--T:8-->
* The resulting fillet object is not editable.
* The resulting fillet object is not editable.
* If the radius is so large that the produced arc would not be tangent to one of the lines, the operation will not succeed.
* Only single lines are supported at the moment; [[Draft_Wire|Draft Wires]], that is, lines with multiple points, may not produce the desired result.
* Only single lines are supported at the moment; [[Draft_Wire|Draft Wires]], that is, lines with multiple points, may not produce the desired result.
* A [[Draft Wire|Draft Wire]] that has at least three points can be fillet or chamfered by changing its {{PropertyData|Fillet Radius}} or {{PropertyData|Chamfer Size}} respectively. Since [[Draft_Line|Draft Lines]], and [[Draft_Wire|Draft Wires]], can be joined with the [[Image:Draft_Wire.svg|16px]] [[Draft_Wire|Draft Wire]] command, the [[Image:Draft_Join.svg|16px]] [[Draft_Join|Draft Join]] command, or the [[Image:Draft_Upgrade.svg|16px]] [[Draft_Upgrade|Draft Upgrade]] command, this provides an alternative method for creating fillets and chamfers.


==Properties== <!--T:15-->
==Properties== <!--T:15-->

<!--T:16-->
A Fillet object shares most properties from a [[Draft_Wire|Draft Wire]], however, only some of these properties are applicable to the Fillet.


===Data=== <!--T:17-->
===Data=== <!--T:17-->
Line 93: Line 78:


<!--T:28-->
<!--T:28-->
See also: [[Draft_API|Draft API]] and [[FreeCAD_Scripting_Basics|FreeCAD Scripting Basics]].
See also: [https://www.freecadweb.org/api Autogenerated API documentation] and [[FreeCAD Scripting Basics|FreeCAD Scripting Basics]].


<!--T:22-->
<!--T:22-->
To create a Draft Fillet use the {{incode|make_fillet}} method of the Draft module:
The Fillet tool can be used in [[Macros|macros]] and from the [[Python|Python]] console by using the following function:

</translate>
</translate>
{{Code|code=
{{Code|code=
Line 110: Line 96:
<!--T:24-->
<!--T:24-->
Example:
Example:

</translate>
</translate>
{{Code|code=
{{Code|code=

Revision as of 13:51, 16 March 2021

This documentation is a work in progress. Please don't mark it as translatable since it will change in the next hours and days.

Draft Fillet

Menu location
Drafting → Fillet
Workbenches
Draft
Default shortcut
None
Introduced in version
0.19
See also
Draft Line, Draft Wire

Description

The Draft Fillet command creates a fillet, a rounded corner, between two Draft Lines. Alternatively, it can create a chamfer, a straight edge, between those two lines.

Several fillets and chamfers created between two lines

Usage

  1. Select two Draft Lines that meet in a single point.
  2. There are several ways to invoke the command:
    • Press the Draft Fillet button.
    • Select the Drafting → Fillet option from the menu.
  3. Enter the Fillet radius. If the Create chamfer option is selected this will be the length of the chamfer. Note that the command will not succeed if the radius or the chamfer length are too large for the selected lines.
  4. Optionally check the Delete original objects option.
  5. Optionally check the Create chamfer option.
  6. If you have selected one of the two previous options: Click in the Fillet radius input box.
  7. Press Enter.

Options

  • Press Esc or the Close button to abort the command.

Notes

  • The resulting fillet object is not editable.
  • Only single lines are supported at the moment; Draft Wires, that is, lines with multiple points, may not produce the desired result.
  • A Draft Wire that has at least three points can be fillet or chamfered by changing its DataFillet Radius or DataChamfer Size respectively. Since Draft Lines, and Draft Wires, can be joined with the Draft Wire command, the Draft Join command, or the Draft Upgrade command, this provides an alternative method for creating fillets and chamfers.

Properties

Data

  • DataStart: (read-only) specifies the start point.
  • DataEnd: (read-only) specifies the end point.
  • DataLength: (read-only) specifies the length of the entire segment.
  • DataFillet Radius: (read-only) radius with which the fillet was created.

View

  • ViewEnd Arrow: if it is true it will display a symbol at the last point of the line, so it can be used as an annotation line.
  • ViewArrow Size: specifies the size of the symbol displayed at the end of the line.
  • ViewArrow Type: specifies the type of symbol displayed at the end of the line, which can be "Dot", "Circle", "Arrow", "Tick", or "Tick-2".

Scripting

See also: Autogenerated API documentation and FreeCAD Scripting Basics.

To create a Draft Fillet use the make_fillet method of the Draft module:

fillet = make_fillet([line1, line2], radius=100, chamfer=False, delete=False)
  • Creates a Fillet object between lines line1 and line2, using radius for the curvature.
  • If chamfer is True it will create a straight edge with the length of radius, instead of a rounded edge.
  • If delete is True it will delete the given line1 and line2, and leave only the new object.

Example:

import FreeCAD as App
import Draft
doc = App.newDocument()

p1 = App.Vector(0, 0, 0)
p2 = App.Vector(1000, 1000, 0)
p3 = App.Vector(2000, 0, 0)

line1 = Draft.make_line(p1, p2)
line2 = Draft.make_line(p2, p3)
doc.recompute()

fillet = Draft.make_fillet([line1, line2], radius=500)
doc.recompute()