Draft Arc 3Points: Difference between revisions
(You can also approximate a circular arc by using the Draft BSpline, Draft BezCurve, and Draft CubicBezCurve tools.) |
mNo edit summary |
||
(72 intermediate revisions by 7 users not shown) | |||
Line 1: | Line 1: | ||
<languages/> |
<languages/> |
||
{{UnfinishedDocu}} |
|||
<translate> |
<translate> |
||
<!--T:1--> |
<!--T:1--> |
||
{{Docnav |
|||
{{Docnav|[[Draft_Arc|Arc]]|[[Draft_Ellipse|Ellipse]]|[[Draft_Module|Draft]]|IconL=Draft_Circle.svg |IconC=Workbench_Draft.svg|IconR=Draft_Ellipse.svg}} |
|||
|[[Draft_Arc|Arc]] |
|||
|[[Draft_Circle|Circle]] |
|||
|[[Draft_Workbench|Draft]] |
|||
|IconL=Draft_Arc.svg |
|||
|IconR=Draft_Circle.svg |
|||
|IconC=Workbench_Draft.svg |
|||
}} |
|||
<!--T:2--> |
<!--T:2--> |
||
{{GuiCommand |
{{GuiCommand |
||
|Name=Draft Arc 3Points |
|Name=Draft Arc 3Points |
||
|MenuLocation= |
|MenuLocation=Drafting → Arc tools → Arc by 3 points |
||
|Workbenches=[[ |
|Workbenches=[[Draft_Workbench|Draft]], [[Arch_Workbench|Arch]] |
||
|Shortcut={{KEY|A}} {{KEY|T}} |
|Shortcut={{KEY|A}} {{KEY|T}} |
||
|SeeAlso=[[Draft Circle|Draft Circle]], [[Draft Ellipse]] |
|||
|Version=0.19 |
|Version=0.19 |
||
|SeeAlso=[[Draft_Arc|Draft Arc]], [[Draft_Circle|Draft Circle]] |
|||
}} |
}} |
||
Line 20: | Line 25: | ||
<!--T:4--> |
<!--T:4--> |
||
The [[Draft Arc 3Points |
The [[Image:Draft_Arc_3Points.svg|24px]] '''Draft Arc 3Points''' command creates a circular arc on the current [[Draft_SelectPlane|working plane]] from three points that define its circumference. The center and radius are calculated from these points. |
||
<!--T:24--> |
|||
Use the [[Draft Arc|Draft Arc]] tool to create a circular arc by specifying the center, the radius, and the start and end angles. To draw an elliptical arc use [[Draft Ellipse|Draft Ellipse]]. You can also approximate a circular arc by using the [[Draft BSpline|Draft BSpline]], [[Draft BezCurve|Draft BezCurve]], and [[Draft CubicBezCurve|Draft CubicBezCurve]] tools. |
|||
A Draft Arc is in fact a [[Draft_Circle|Draft Circle]] with a {{PropertyData|First Angle}} that is not the same as its {{PropertyData|Last Angle}}. |
|||
</translate> |
</translate> |
||
[[Image:Draft_Arc_3Points_example.png|400px]] |
[[Image:Draft_Arc_3Points_example.png|400px]] |
||
<translate> |
<translate> |
||
<!--T:5--> |
<!--T:5--> |
||
{{Caption|Arc defined by three points |
{{Caption|Arc defined by three points on its circumference}} |
||
== |
==Usage== <!--T:6--> |
||
<!--T:25--> |
|||
See also: [[Draft_Tray|Draft Tray]], [[Draft_Snap|Draft Snap]] and [[Draft_Constrain|Draft Constrain]]. |
|||
<!--T:7--> |
<!--T:7--> |
||
# There are several ways to invoke the command: |
|||
# Press the {{Button|[[Image:Draft Arc 3Points.svg|16px]] [[Draft Arc 3Points]]}} button, or press {{KEY|A}} then {{KEY|T}} keys. |
|||
# |
#* Press the {{Button|[[Image:Draft_Arc_3Points.svg|16px]] [[Draft_Arc_3Points|Arc by 3 points]]}} button. |
||
#* Select the {{MenuCommand|Drafting → Arc tools → [[Image:Draft_Arc_3Points.svg|16px]] Arc by 3 points}} option from the menu. |
|||
# Click a second point on the 3D view, or type a [[Draft_Coordinates|coordinate]] and press the {{Button|[[Image:Draft_AddPoint.svg|16px]] [[Draft_AddPoint|add point]]}} button. |
|||
#* Use the keyboard shortcut: {{KEY|A}} then {{KEY|T}}. {{Version|0.20}} |
|||
# Click a third point in the 3D view, or type a [[Draft_Coordinates|coordinate]] and press the {{Button|[[Image:Draft_AddPoint.svg|16px]] [[Draft_AddPoint|add point]]}} button. |
|||
# The {{MenuCommand|Arc by 3 points}} task panel opens. See [[#Options|Options]] for more information. |
|||
# The arc will be created after the third point is given. |
|||
# Pick the first point in the [[3D_view|3D view]], or type coordinates and press the {{Button|[[Image:Draft_AddPoint.svg|16px]] Enter point}} button. |
|||
# Pick the second point in the [[3D_view|3D view]], or type coordinates and press the {{Button|[[Image:Draft_AddPoint.svg|16px]] Enter point}} button. |
|||
# Pick the third point in the [[3D_view|3D view]], or type coordinates and press the {{Button|[[Image:Draft_AddPoint.svg|16px]] Enter point}} button. |
|||
==Options== <!--T:8--> |
==Options== <!--T:8--> |
||
<!--T:26--> |
|||
See the options in [[Draft Arc|Draft Arc]]. |
|||
The single character keyboard shortcuts available in the task panel can be changed. See [[Draft_Preferences|Draft Preferences]]. The shortcuts mentioned here are the default shortcuts (for version 0.22). |
|||
<!--T:18--> |
|||
* To manually enter coordinates enter the X, Y and Z component, and press {{KEY|Enter}} after each. Or you can press the {{Button|[[Image:Draft_AddPoint.svg|16px]] Enter point}} button when you have the desired values. It is advisable to move the pointer out of the [[3D_view|3D view]] before entering coordinates. |
|||
* Press {{KEY|R}} or click the {{MenuCommand|Relative}} checkbox to toggle relative mode. If relative mode is on, coordinates are relative to the last point, if available, else they are relative to the coordinate system origin. |
|||
* Press {{KEY|G}} or click the {{MenuCommand|Global}} checkbox to toggle global mode. If global mode is on, coordinates are relative to the global coordinate system, else they are relative to the [[Draft_SelectPlane|working plane]] coordinate system. {{Version|0.20}} |
|||
* Press {{KEY|N}} or click the {{MenuCommand|Continue}} checkbox to toggle continue mode. If continue mode is on, the command will restart after finishing, allowing you to continue creating arcs. {{Version|0.20}} |
|||
* Press {{KEY|S}} to switch [[Draft_Snap|Draft snapping]] on or off. |
|||
* Press {{KEY|Esc}} or the {{Button|Close}} button to abort the command. |
|||
==Notes== <!--T:27--> |
|||
<!--T:28--> |
|||
* A Draft Arc can be edited with the [[Draft_Edit|Draft Edit]] command. |
|||
==Preferences== <!--T:29--> |
|||
<!--T:30--> |
|||
See also: [[Preferences_Editor|Preferences Editor]] and [[Draft_Preferences|Draft Preferences]]. |
|||
<!--T:31--> |
|||
* If the {{MenuCommand|Edit → Preferences... → Draft → General → Create Part primitives if possible}} option is checked, the command will create a non-editable [[Part_Feature|Part Feature]] instead of a Draft Circle. |
|||
==Properties== <!--T:9--> |
==Properties== <!--T:9--> |
||
<!--T:10--> |
<!--T:10--> |
||
See [[Draft_Circle#Properties|Draft Circle]]. |
|||
An Arc object shares all properties from a [[Draft Circle]], but some properties only make sense for the circle. See [[Draft Arc|Draft Arc]] for more information. |
|||
==Scripting== <!--T:13--> |
==Scripting== <!--T:13--> |
||
{{Emphasis|See also:}} [[Draft API]] and [[FreeCAD Scripting Basics]]. |
|||
<!--T:19--> |
|||
There is no specific function to create an arc by three points. |
|||
See also: [https://freecad.github.io/SourceDoc/ Autogenerated API documentation] and [[FreeCAD Scripting Basics|FreeCAD Scripting Basics]]. |
|||
<!--T:20--> |
|||
To create an arc use the same function to create circles, with additional arguments. See the information in [[Draft Arc|Draft Arc]] and [[Draft Circle|Draft Circle]]. |
|||
To create a Draft Arc by 3 points use the {{incode|make_arc_3points}} method of the Draft module: |
|||
</translate> |
|||
<!--T:14--> |
|||
{{Code|code= |
|||
{{Docnav|[[Draft_Arc|Arc]]|[[Draft_Ellipse|Ellipse]]|[[Draft_Module|Draft]]|IconL=Draft_Circle.svg |IconC=Workbench_Draft.svg|IconR=Draft_Ellipse.svg}} |
|||
arc = make_arc_3points(points, placement=None, face=False, support=None, map_mode="Deactivated", primitive=False) |
|||
}} |
|||
<translate> |
|||
<!--T: |
<!--T:21--> |
||
* Creates an {{incode|arc}} object from the given {{incode|points}} list. |
|||
{{Draft Tools navi}} |
|||
* If a {{incode|placement}} is given, the center of the circular arc will be moved to this place. See [[Placement|Placement]] for more information. |
|||
* If {{incode|face}} is {{incode|True}}, the arc will make a face, that is, it will appear filled. |
|||
* If {{incode|support}} is given, it is a {{incode|LinkSubList}}, that is, a list indicating an object and a subelement of that object. This is used so that the object appears referenced to this support. |
|||
: For example: <code>support=[(obj, ("Face1"))]</code>. |
|||
* If {{incode|map_mode}} is given, it is a string defining a type of mapping, for example: <code>map_mode='FlatFace'</code>, <code>map_mode='ThreePointsPlane'</code>, etc. See [[Part_EditAttachment|Part EditAttachment]] for more information. |
|||
* If {{incode|primitive}} is {{incode|True}}, the arc created will be a simple [[Part_Feature|Part Feature]], not a complex Draft object. |
|||
<!--T:22--> |
|||
Example: |
|||
</translate> |
|||
{{Code|code= |
|||
import FreeCAD as App |
|||
import Draft |
|||
doc = App.newDocument() |
|||
points = [App.Vector(0, 0, 0), |
|||
App.Vector(5, 10, 0), |
|||
App.Vector(10, 0, 0)] |
|||
arc = Draft.make_arc_3points(points) |
|||
doc.recompute() |
|||
}} |
|||
<translate> |
|||
<!--T:14--> |
|||
{{Docnav |
|||
|[[Draft_Arc|Arc]] |
|||
|[[Draft_Circle|Circle]] |
|||
|[[Draft_Workbench|Draft]] |
|||
|IconL=Draft_Arc.svg |
|||
|IconR=Draft_Circle.svg |
|||
|IconC=Workbench_Draft.svg |
|||
}} |
|||
<!--T:16--> |
|||
{{Userdocnavi}} |
|||
</translate> |
</translate> |
||
{{Draft Tools navi{{#translation:}}}} |
|||
{{clear}} |
|||
{{Userdocnavi{{#translation:}}}} |
Latest revision as of 10:04, 30 January 2024
Draft Arc 3Points |
Menu location |
---|
Drafting → Arc tools → Arc by 3 points |
Workbenches |
Draft, Arch |
Default shortcut |
A T |
Introduced in version |
0.19 |
See also |
Draft Arc, Draft Circle |
Description
The Draft Arc 3Points command creates a circular arc on the current working plane from three points that define its circumference. The center and radius are calculated from these points.
A Draft Arc is in fact a Draft Circle with a DataFirst Angle that is not the same as its DataLast Angle.
Arc defined by three points on its circumference
Usage
See also: Draft Tray, Draft Snap and Draft Constrain.
- There are several ways to invoke the command:
- Press the Arc by 3 points button.
- Select the Drafting → Arc tools → Arc by 3 points option from the menu.
- Use the keyboard shortcut: A then T. introduced in version 0.20
- The Arc by 3 points task panel opens. See Options for more information.
- Pick the first point in the 3D view, or type coordinates and press the Enter point button.
- Pick the second point in the 3D view, or type coordinates and press the Enter point button.
- Pick the third point in the 3D view, or type coordinates and press the Enter point button.
Options
The single character keyboard shortcuts available in the task panel can be changed. See Draft Preferences. The shortcuts mentioned here are the default shortcuts (for version 0.22).
- To manually enter coordinates enter the X, Y and Z component, and press Enter after each. Or you can press the Enter point button when you have the desired values. It is advisable to move the pointer out of the 3D view before entering coordinates.
- Press R or click the Relative checkbox to toggle relative mode. If relative mode is on, coordinates are relative to the last point, if available, else they are relative to the coordinate system origin.
- Press G or click the Global checkbox to toggle global mode. If global mode is on, coordinates are relative to the global coordinate system, else they are relative to the working plane coordinate system. introduced in version 0.20
- Press N or click the Continue checkbox to toggle continue mode. If continue mode is on, the command will restart after finishing, allowing you to continue creating arcs. introduced in version 0.20
- Press S to switch Draft snapping on or off.
- Press Esc or the Close button to abort the command.
Notes
- A Draft Arc can be edited with the Draft Edit command.
Preferences
See also: Preferences Editor and Draft Preferences.
- If the Edit → Preferences... → Draft → General → Create Part primitives if possible option is checked, the command will create a non-editable Part Feature instead of a Draft Circle.
Properties
See Draft Circle.
Scripting
See also: Autogenerated API documentation and FreeCAD Scripting Basics.
To create a Draft Arc by 3 points use the make_arc_3points
method of the Draft module:
arc = make_arc_3points(points, placement=None, face=False, support=None, map_mode="Deactivated", primitive=False)
- Creates an
arc
object from the givenpoints
list. - If a
placement
is given, the center of the circular arc will be moved to this place. See Placement for more information. - If
face
isTrue
, the arc will make a face, that is, it will appear filled. - If
support
is given, it is aLinkSubList
, that is, a list indicating an object and a subelement of that object. This is used so that the object appears referenced to this support.
- For example:
support=[(obj, ("Face1"))]
.
- If
map_mode
is given, it is a string defining a type of mapping, for example:map_mode='FlatFace'
,map_mode='ThreePointsPlane'
, etc. See Part EditAttachment for more information. - If
primitive
isTrue
, the arc created will be a simple Part Feature, not a complex Draft object.
Example:
import FreeCAD as App
import Draft
doc = App.newDocument()
points = [App.Vector(0, 0, 0),
App.Vector(5, 10, 0),
App.Vector(10, 0, 0)]
arc = Draft.make_arc_3points(points)
doc.recompute()
- Drafting: Line, Polyline, Fillet, Arc, Arc by 3 points, Circle, Ellipse, Rectangle, Polygon, B-spline, Cubic Bézier curve, Bézier curve, Point, Facebinder, ShapeString, Hatch
- Annotation: Text, Dimension, Label, Annotation styles, Annotation scale
- Modification: Move, Rotate, Scale, Mirror, Offset, Trimex, Stretch, Clone, Array, Polar array, Circular array, Path array, Path link array, Point array, Point link array, Edit, Subelement highlight, Join, Split, Upgrade, Downgrade, Wire to B-spline, Draft to sketch, Set slope, Flip dimension, Shape 2D view
- Draft Tray: Select plane, Set style, Toggle construction mode, AutoGroup
- Snapping: Snap lock, Snap endpoint, Snap midpoint, Snap center, Snap angle, Snap intersection, Snap perpendicular, Snap extension, Snap parallel, Snap special, Snap near, Snap ortho, Snap grid, Snap working plane, Snap dimensions, Toggle grid
- Miscellaneous: Apply current style, Layer, Manage layers, Add a new named group, Move to group, Select group, Add to construction group, Toggle normal/wireframe display, Create working plane proxy, Heal, Show snap toolbar
- Additional: Constraining, Pattern, Preferences, Import Export Preferences, DXF/DWG, SVG, OCA, DAT
- Context menu:
- Layer container: Merge layer duplicates, Add new layer
- Layer: Activate this layer, Select layer contents
- Text: Open hyperlinks
- Wire: Flatten
- Working plane proxy: Write camera position, Write objects state
- 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, Surface, TechDraw, Test Framework
- Hubs: User hub, Power users hub, Developer hub