Difference between revisions of "Draft Circle"

From FreeCAD Documentation
Jump to: navigation, search
(Languages in alphabetic order)
Line 1: Line 1:
{{GuiCommand|Name=Draft_Circle|Workbenches=[[Draft Module|Draft]]|MenuLocation=Drafting → Circle|Shortcut=C I|SeeAlso=[[Draft Arc]]}}
+
{{GuiCommand|Name=Draft_Circle|Workbenches=[[Draft Module|Draft]], [[Arch Module|Arch]]|MenuLocation=Draft -> Circle|Shortcut=C I|SeeAlso=[[Draft Arc]]}}
  
====Description====
+
==Description==
  
This tool draws a circle by asking for two points, the center and the radius, by picking tangents, or any combination of those.
+
The Circle tool creates a circle in the current [[Draft Workingplane|work plane]] by entering two points, the center and the radius, or by picking tangents, or any combination of those. It takes the [[Draft Linestyle|linewidth and color]] previously set on the Tasks tab.
  
[[Image:Draft_Circle_example.jpg]]
+
[[Image:Draft_Circle_example.jpg|400px]]
  
====Usage====
+
==How to use==
 +
 
 +
# Press the {{KEY|[[Image:Draft Circle.png|16px]] [[Draft Circle]]}} button, or press {{KEY|C}} then {{KEY|I}} keys
 +
# Click a first point on the 3D view, or type a [[Draft_Coordinates|coordinate]]
 +
# Click a second point on the 3D view, or enter a radius value.
 +
 
 +
==Options==
  
 
* The primary use of the circle tool is by picking two points, the centre and a point on the circumference, defining the radius.
 
* The primary use of the circle tool is by picking two points, the centre and a point on the circumference, defining the radius.
 
* By pressing {{KEY|ALT}}, you can select a tangent instead of picking a point. You can therefore construct several types of circles by selecting one, two or three tangents.
 
* By pressing {{KEY|ALT}}, you can select a tangent instead of picking a point. You can therefore construct several types of circles by selecting one, two or three tangents.
* Picking a point on an empty area of the 3d view, or on an existing object.
+
* To enter coordinates manually, simply enter the numbers, then press {{KEY|ENTER}} between each X, Y and Z component.
* Pressing {{KEY|CTRL}} will [[Draft_Snap|snap]] your point to availible snap locations.
+
* Press {{KEY|T}} or click the checkbox to check/uncheck the {{KEY|'''Continue'''}} button. If continue mode is on, the Circle tool will restart after you give the second point, allowing you to draw another circle without pressing the Circle button again.
* Pressing {{KEY|SHIFT}} [[Draft_Constrain|constrains]] your movement.
+
* Press {{KEY|CTRL}} while drawing to force [[Draft_Snap|snapping]] your point to the nearest snap location, independently of the distance.
* Enter numbers to [[Draft_Coordinates|manually insert a coordinate]].
+
* Press {{KEY|SHIFT}} while drawing to [[Draft_Constrain|constrain]] your second point horizontally or vertically in relation to the first one.
* Pressing {{KEY|ESC}} cancels the function.
+
* Press {{KEY|ESC}} or the {{KEY|'''Cancel'''}} button to abort the current Line command.
* The newly created line will take the current [[Draft_Linestyle|linestyle]].
+
 
 +
==Properties==
  
====Scripting====
+
* {{PropertyData|Radius}}: The radius of the circle
  
The created circle is a [[Part Module|Part]] feature containing one edge with only one vertex.
+
==Scripting==
  
 +
The Circle tool can by used in [[macros]] and from the python console the following way:
  
 +
import Draft
 +
myCircle = Draft.makeCircle(2)
  
 
{{languages | {{es|Draft Circle/es}} {{fr|Draft Circle/fr}} {{it|Draft Circle/it}} {{se|Draft Circle/se}} }}
 
{{languages | {{es|Draft Circle/es}} {{fr|Draft Circle/fr}} {{it|Draft Circle/it}} {{se|Draft Circle/se}} }}

Revision as of 16:52, 17 August 2012

Draft Circle.svg Draft_Circle

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


Description

The Circle tool creates a circle in the current work plane by entering two points, the center and the radius, or by picking tangents, or any combination of those. It takes the linewidth and color previously set on the Tasks tab.

Draft Circle example.jpg

How to use

  1. Press the Draft Circle.png Draft Circle button, or press C then I 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.

Options

  • The primary use of the circle tool is by picking two points, the centre and a point on the circumference, defining the radius.
  • By pressing ALT, you can select a tangent instead of picking a point. You can therefore construct several types of circles by selecting one, two or three tangents.
  • 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 Circle tool will restart after you give the second point, allowing you to draw another circle without pressing the Circle 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 second point horizontally or vertically in relation to the first one.
  • Press ESC or the Cancel button to abort the current Line command.

Properties

  • DATARadius: The radius of the circle

Scripting

The Circle tool can by used in macros and from the python console the following way:

import Draft
myCircle = Draft.makeCircle(2)
Available translations of this page: Flag-es.jpg Flag-fr.jpg Flag-it.jpg Template:Se