Draft Ellipse: Difference between revisions

From FreeCAD Documentation
(Created page with "<translate> {{GuiCommand|Name=Draft_Ellipse|Workbenches=Draft, Arch|MenuLocation=Draft -> Ellipse|Shortcut=E L|SeeAlso=Draft Circle}} ==D...")
 
(Marked this version for translation)
Line 1: Line 1:
<translate>
<translate>
<!--T:1-->
{{GuiCommand|Name=Draft_Ellipse|Workbenches=[[Draft Module|Draft]], [[Arch Module|Arch]]|MenuLocation=Draft -> Ellipse|Shortcut=E L|SeeAlso=[[Draft Circle]]}}
{{GuiCommand|Name=Draft_Ellipse|Workbenches=[[Draft Module|Draft]], [[Arch Module|Arch]]|MenuLocation=Draft -> Ellipse|Shortcut=E L|SeeAlso=[[Draft Circle]]}}


==Description==
==Description== <!--T:2-->


<!--T:3-->
The Ellipse tool creates an ellipse in the current [[Draft Workingplane|work plane]] by entering two points, defining the corner of a rectangular box in which the ellipse will fit. It takes the [[Draft Linestyle|linewidth and color]] previously set on the Tasks tab.
The Ellipse tool creates an ellipse in the current [[Draft Workingplane|work plane]] by entering two points, defining the corner of a rectangular box in which the ellipse will fit. It takes the [[Draft Linestyle|linewidth and color]] previously set on the Tasks tab.


<!--T:4-->
[[Image:Draft_ellipse_example.jpg|400px]]
[[Image:Draft_ellipse_example.jpg|400px]]


==How to use==
==How to use== <!--T:5-->
# Press the {{KEY|[[Image:Draft Ellipse.png|16px]] [[Draft Ellipse]]}} button, or press {{KEY|E}} then {{KEY|L}} keys
# Press the {{KEY|[[Image:Draft Ellipse.png|16px]] [[Draft Ellipse]]}} button, or press {{KEY|E}} then {{KEY|L}} keys
# Click a first point on the 3D view, or type a [[Draft_Coordinates|coordinate]]
# Click a first point on the 3D view, or type a [[Draft_Coordinates|coordinate]]
# Click a second point on the 3D view, or type a [[Draft_Coordinates|coordinate]]
# Click a second point on the 3D view, or type a [[Draft_Coordinates|coordinate]]


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


<!--T:7-->
* To enter coordinates manually, simply enter the numbers, then press {{KEY|ENTER}} between each X, Y and Z component.
* 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 Ellipse tool will restart after you give the second point, allowing you to draw another ellipse without pressing the Ellipse button again.
* Press {{KEY|T}} or click the checkbox to check/uncheck the {{KEY|'''Continue'''}} button. If continue mode is on, the Ellipse tool will restart after you give the second point, allowing you to draw another ellipse without pressing the Ellipse button again.
Line 23: Line 27:
* Ellipses, when in "Flat Lines" display mode, can display a hatch pattern, by setting their "Pattern" property below.
* Ellipses, when in "Flat Lines" display mode, can display a hatch pattern, by setting their "Pattern" property below.


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


<!--T:9-->
* {{PropertyData|Major Radius}}: The major radius of the ellipse
* {{PropertyData|Major Radius}}: The major radius of the ellipse
* {{PropertyData|Minor Radius}}: The major radius of the ellipse
* {{PropertyData|Minor Radius}}: The major radius of the ellipse
Line 30: Line 35:
* {{PropertyView|Pattern Size}}: Specifies the size of the hatch pattern
* {{PropertyView|Pattern Size}}: Specifies the size of the hatch pattern


==Scripting==
==Scripting== <!--T:10-->
The Ellipse tool can by used in [[macros]] and from the python console by using the following function:
The Ellipse tool can by used in [[macros]] and from the python console by using the following function:
</translate>
</translate>
Line 37: Line 42:
</syntaxhighlight>
</syntaxhighlight>
<translate>
<translate>
<!--T:11-->
* Creates an ellipse object with given major and minor radius.
* Creates an ellipse object with given major and minor radius.
* If a placement is given, it is used.
* If a placement is given, it is used.
Line 42: Line 48:
* Returns the newly created object.
* Returns the newly created object.


<!--T:12-->
Example:
Example:
</translate>
</translate>

Revision as of 15:04, 13 February 2014

Draft_Ellipse

Menu location
Draft -> Ellipse
Workbenches
Draft, Arch
Default shortcut
E L
Introduced in version
-
See also
Draft Circle

Description

The Ellipse tool creates an ellipse in the current work plane by entering two points, defining the corner of a rectangular box in which the ellipse will fit. It takes the linewidth and color previously set on the Tasks tab.

How to use

  1. Press the Draft Ellipse button, or press E then L keys
  2. Click a first point on the 3D view, or type a coordinate
  3. Click a second point on the 3D view, or type a coordinate

Options

  • 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 Ellipse tool will restart after you give the second point, allowing you to draw another ellipse without pressing the Ellipse 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 I or the Filled button to have the ellipse to appear as a face after it has been closed. This simply sets the View->Property of the ellipse to "Flat lines" or "Wireframe", so it can easily be changed later.
  • Press ESC or the Cancel button to abort the command.
  • Ellipses, when in "Flat Lines" display mode, can display a hatch pattern, by setting their "Pattern" property below.

Properties

  • DataMajor Radius: The major radius of the ellipse
  • DataMinor Radius: The major radius of the ellipse
  • ViewPattern: Specifies a hatch pattern to fill the ellipse with
  • ViewPattern Size: Specifies the size of the hatch pattern

Scripting

The Ellipse tool can by used in macros and from the python console by using the following function:

 makeEllipse (majorradius, minorradius, [placement], [facemode])
  • Creates an ellipse object with given major and minor radius.
  • If a placement is given, it is used.
  • If facemode is False, the ellipse is shown as a wireframe, otherwise as a face.
  • Returns the newly created object.

Example:

 import Draft
 myEllipse = Draft.makeEllipse(4,2)