Sketcher CreateEllipseByCenter: Difference between revisions

From FreeCAD Documentation
No edit summary
(Name=Sketcher CreateEllipseByCenter, so it finds the icon automatically)
Line 6: Line 6:
<!--T:1-->
<!--T:1-->
{{GuiCommand
{{GuiCommand
|Name=Sketcher Create Ellipse by center
|Name=Sketcher CreateEllipseByCenter
|Icon=Sketcher_CreateEllipse.svg
|Workbenches=[[Sketcher Workbench|Sketcher]]
|Workbenches=[[Sketcher Workbench|Sketcher]]
|MenuLocation=Sketch → Sketcher geometries → Create ellipse by center
|MenuLocation=Sketch → Sketcher geometries → Create ellipse by center
Line 21: Line 20:


<!--T:3-->
<!--T:3-->
[[Image:Sketcher_EllipseExample1.png‎|thumb|none|500px|The sequence of clicks is indicated by yellow arrows with numbers. C is the center, a - major diameter, b - minor diameter, F1, F2 are foci.]]
[[Image:Sketcher_EllipseExample1.png‎|500px]]

{{Caption|The sequence of clicks is indicated by yellow arrows with numbers. C is the center, a - major diameter, b - minor diameter, F1, F2 are foci.}}


==Usage== <!--T:4-->
==Usage== <!--T:4-->

Revision as of 02:31, 26 September 2020

Sketcher CreateEllipseByCenter

Menu location
Sketch → Sketcher geometries → Create ellipse by center
Workbenches
Sketcher
Default shortcut
None
Introduced in version
0.15
See also
Sketcher Ellipse by 3 Points, Sketcher Circle, Sketcher Arc of Ellipse

Description

This tool draws an ellipse by picking three points: the center, the end of major radius, the minor radius. When starting the tool, the mouse pointer changes to a white cross with a red ellipse icon. Besides are coordinates shown in real time.

The sequence of clicks is indicated by yellow arrows with numbers. C is the center, a - major diameter, b - minor diameter, F1, F2 are foci.

Usage

  • Invoke the command by clicking a toolbar button, picking the menu item, or by using keyboard shortcut (needs to be assigned first in Interface Customization).
  • First click in 3D view sets ellipse center. Second click sets the first radius and orientation of the ellipse. Third click sets the other radius (the distance from the line defined by first two clicks is the second radius).
  • After the third click, the ellipse is created, together with a set of construction geometry aligned to it (major diameter, minor diameter, two foci). The construction geometry can be manually deleted if not needed, and recreated later. See Internal Alignment Constraint and Sketcher Show Hide Internal Geometry.
  • Pressing ESC or clicking the right mouse button cancels the function.

Peculiarities

  • Major and minor axes of ellipses are strict and cannot be swapped by resizing the ellipse. This is a consequence of the solver parametrization used (center (x,y), focus1 (x,y) and minor radius length (b)) and the same strict behavior of OpenCascade. The ellipse must be rotated to swap the axes.
  • Ellipse can function as a circle when its major and minor diameter lines are deleted, and one of the foci is constrained to coincide with the center. But radius constraint won't work on such a circle.
  • Moving the ellipse by edge is the same as moving ellipse's center.