Draft Arc: Difference between revisions

From FreeCAD Documentation
(Languages in alphabetic order)
No edit summary
Line 1: Line 1:
{{GuiCommand|Name=Draft_Arc|Workbenches=[[Draft Module|Draft]]|MenuLocation=Draft Arc|Shortcut=A R|SeeAlso=[[Draft Circle]]}}
{{GuiCommand|Name=Draft_Arc|Workbenches=[[Draft Module|Draft]], [[Arch Module|Arch]]|MenuLocation=Draft -> Arc|Shortcut=A R|SeeAlso=[[Draft Circle]]}}


====Description====
==Description==


The Arc tool creates an arc in the current [[Draft Workingplane|work plane]] by entering four points, the center, the radius, the first point and the last point, or by picking tangents, or any combination of those. It takes the [[Draft Linestyle|linewidth and color]] previously set on the Tasks tab. This tool works the same way as the [[Draft Circle]] tool, but adds start and end angles.
This tool draws an arc by picking four points: the center, the radius, the start angle and the end angle.


[[Image:Draft_Arc_example.jpg]]
[[Image:Draft_Arc_example.jpg|400px]]


====Usage====
==How to use==


# Press the {{KEY|[[Image:Draft Arc.png|16px]] [[Draft Arc]]}} button, or press {{KEY|A}} then {{KEY|R}} keys
* Pick points on an empty area of the 3d view, or on an existing object.
# Click a first point on the 3D view, or type a [[Draft_Coordinates|coordinate]]
* The arc tool inherits the [[Draft Circle|Circle tool]] functionality for its two first steps, so you can press {{KEY|ALT}} to pick a tangent instead of center or radius.
# Click a second point on the 3D view, or enter a radius value
* Pressing {{KEY|CTRL}} will [[Draft_Snap|snap]] your point to availible snap locations.
# Click a third point in the 3D view, or enter a start angle
* Pressing {{KEY|SHIFT}} will [[Draft_Constrain|constrain]] your new point in relation to the last one.
# Click a fourth point in the 3D View, or enter an end ange
* Enter numbers to [[Draft_Coordinates|manually insert a coordinate]].

* The newly created line will take the current [[Draft_Linestyle|linestyle]].
==Options==
* Pressing {{KEY|ALT}} when choosing the end angle will switch you to counter-clockwise direction.

* Pressing {{KEY|ESC}} cancels the function.
* The primary use of the arc tool is by picking four points: the centre, a point on the circumference, defining the radius, a third point defining the start of the arc, and a fourth one defining its end.
* By pressing {{KEY|ALT}}, you can select a tangent instead of picking point, to define the base circle of the arc. You can therefore construct several types of circles by selecting one, two or three tangents.
* The direction of the arc depends on the movement you are doing with your mouse. If you start to move clockwise after the third point is entered, your arc will go clockwise. To go counter-clockwise, simply move your mouse back over the third point, until the arc starts drawing in the other direction.
* To enter coordinates manually, simply enter the numbers, then press {{KEY|ENTER}} between each X, Y and Z component.
* Press {{KEY|T}} or click the checkbox to check/uncheck the {{KEY|'''Continue'''}} button. If continue mode is on, the Arc tool will restart after you give the fourth point, allowing you to draw another arc without pressing the Arc button again.
* Press {{KEY|CTRL}} while drawing to force [[Draft_Snap|snapping]] your point to the nearest snap location, independently of the distance.
* Press {{KEY|SHIFT}} while drawing to [[Draft_Constrain|constrain]] your point horizontally or vertically in relation to the center.
* Press {{KEY|ESC}} or the {{KEY|'''Cancel'''}} button to abort the current Line command.

==Properties==

* {{PropertyData|Radius}}: The radius of the arc
* {{PropertyData|First Angle}}: The angle of the first point of the arc
* {{PropertyData|Last Angle}}: The angle of the last point of the arc

==Scripting==

The Circle tool can also be used to create arcs in [[macros]] and from the python console by giving it additional arguments, the following way:

import Draft
myArc = Draft.makeCircle(2,startangle=0,endangle=90)





Revision as of 16:15, 17 August 2012

Draft_Arc

Menu location
Draft -> Arc
Workbenches
Draft, Arch
Default shortcut
A R
Introduced in version
-
See also
Draft Circle

Description

The Arc tool creates an arc in the current work plane by entering four points, the center, the radius, the first point and the last point, or by picking tangents, or any combination of those. It takes the linewidth and color previously set on the Tasks tab. This tool works the same way as the Draft Circle tool, but adds start and end angles.

How to use

  1. Press the Draft Arc button, or press A then R keys
  2. Click a first point on the 3D view, or type a coordinate
  3. Click a second point on the 3D view, or enter a radius value
  4. Click a third point in the 3D view, or enter a start angle
  5. Click a fourth point in the 3D View, or enter an end ange

Options

  • The primary use of the arc tool is by picking four points: the centre, a point on the circumference, defining the radius, a third point defining the start of the arc, and a fourth one defining its end.
  • By pressing ALT, you can select a tangent instead of picking point, to define the base circle of the arc. You can therefore construct several types of circles by selecting one, two or three tangents.
  • The direction of the arc depends on the movement you are doing with your mouse. If you start to move clockwise after the third point is entered, your arc will go clockwise. To go counter-clockwise, simply move your mouse back over the third point, until the arc starts drawing in the other direction.
  • To enter coordinates manually, simply enter the numbers, then press ENTER between each X, Y and Z component.
  • Press T or click the checkbox to check/uncheck the Continue button. If continue mode is on, the Arc tool will restart after you give the fourth point, allowing you to draw another arc without pressing the Arc button again.
  • Press CTRL while drawing to force snapping your point to the nearest snap location, independently of the distance.
  • Press SHIFT while drawing to constrain your point horizontally or vertically in relation to the center.
  • Press ESC or the Cancel button to abort the current Line command.

Properties

  • DataRadius: The radius of the arc
  • DataFirst Angle: The angle of the first point of the arc
  • DataLast Angle: The angle of the last point of the arc

Scripting

The Circle tool can also be used to create arcs in macros and from the python console by giving it additional arguments, the following way:

import Draft
myArc = Draft.makeCircle(2,startangle=0,endangle=90)


Available translations of this page: Template:Se