Sketcher CreateEllipseByCenter: Difference between revisions

From FreeCAD Documentation
No edit summary
(Usage WIP)
Line 36: Line 36:


<!--T:8-->
<!--T:8-->
# There are several ways to invoke the command:
# There are several ways to invoke the tool:
#* Press the {{Button|[[Image:Sketcher_CreateEllipseByCenter.svg|16px]] [[Sketcher_CreateEllipseByCenter|Ellipse by center, major radius, point]]}} button.
#* Press the {{Button|[[Image:Sketcher_CreateEllipseByCenter.svg|16px]] [[Sketcher_CreateEllipseByCenter|Ellipse by center, major radius, point]]}} button.
#* Select the {{MenuCommand|Sketcher → Sketcher geometries → [[Image:Sketcher_CreateEllipseByCenter.svg|16px]] Create Ellipse by center}} option from the menu.
#* Select the {{MenuCommand|Sketcher → Sketcher geometries → [[Image:Sketcher_CreateEllipseByCenter.svg|16px]] Create Ellipse by center}} option from the menu.
#* The keyboard shortcut: {{KEY|G}} then {{KEY|E}}, {{KEY|E}}.
#* Use the keyboard shortcut: {{KEY|G}} then {{KEY|E}}, then {{KEY|E}}.
# The cursor changes to a white cross with the command icon.
# The cursor changes to a white cross with the current tool mode icon.
# The '''Ellipse parameters''' section ({{Version|0.22}}) is added at the top of the [[Sketcher_Dialog|Sketcher Dialog]].
# The '''Ellipse parameters''' section ({{Version|0.22}}) is added at the top of the [[Sketcher_Dialog|Sketcher Dialog]].
# Optionally press the {{KEY|M}} key or select from the dropdown list in the parameters section to change the tool '''Mode''':
# Optionally press the {{KEY|M}} key or select from the dropdown list in the parameters section to change the tool mode:
#* [[Image:Sketcher_CreateEllipseByCenter.svg|16px]] '''Center''':
#* [[Image:Sketcher_CreateEllipseByCenter.svg|16px]] '''Center''':
#*# Pick the center of the ellipse. Or with Pos-OVP: enter its X and/or Y coordinate.
#*# Pick the center of the ellipse. Or with Pos-OVP: enter its X and/or Y coordinate.
#*# Pick a point to set the major radius, and the orientation of the major axis. Or with Dim-OVP: enter the major radius of the ellipse and the angle of the major axis.
#*# Pick an endpoint of the major axis. Or with Dim-OVP: enter the distance from the center to this endpoint and/or the angle of the major axis.
#*# Pick a point on the outline of the ellipse to define the minor radius. Or with Pos-OVP: enter the minor radius.
#*# Pick a point to define the ellipse. Or with Dim-OVP: enter the distance from the center to an endpoint of its minor axis.
#* [[Image:Sketcher_CreateEllipseBy3Points.svg|16px]] '''Axis endpoints and radius''': {{Version|0.22}}
#* [[Image:Sketcher_CreateEllipseBy3Points.svg|16px]] '''Axis endpoints and radius''': {{Version|0.22}}
#*# Pick three points of the ellipse outline. Or with Pos-OVP: enter their X and/or Y coordinates.
#*# Pick three points of the ellipse outline. Or with Pos-OVP: enter their X and/or Y coordinates.

Revision as of 14:18, 13 February 2024

This documentation is a work in progress. Please don't mark it as translatable since it will change in the next hours and days.

Sketcher CreateEllipseByCenter

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

Description

The Sketcher CreateEllipseByCenter tool creates an ellipse by its center, an endpoint of its major axis, and a point along the ellipse or an endpoint of its minor axis. introduced in version 0.22: Or optionally by the endpoints of its major axis and a point along the ellipse.

Usage

See also: Drawing aids.

Pos-OVP = Positional On-View-Parameters. introduced in version 0.22
Dim-OVP = Dimensional On-View-Parameters. introduced in version 0.22

  1. There are several ways to invoke the tool:
    • Press the Ellipse by center, major radius, point button.
    • Select the Sketcher → Sketcher geometries → Create Ellipse by center option from the menu.
    • Use the keyboard shortcut: G then E, then E.
  2. The cursor changes to a white cross with the current tool mode icon.
  3. The Ellipse parameters section (introduced in version 0.22) is added at the top of the Sketcher Dialog.
  4. Optionally press the M key or select from the dropdown list in the parameters section to change the tool mode:
    • Center:
      1. Pick the center of the ellipse. Or with Pos-OVP: enter its X and/or Y coordinate.
      2. Pick an endpoint of the major axis. Or with Dim-OVP: enter the distance from the center to this endpoint and/or the angle of the major axis.
      3. Pick a point to define the ellipse. Or with Dim-OVP: enter the distance from the center to an endpoint of its minor axis.
    • Axis endpoints and radius: introduced in version 0.22
      1. Pick three points of the ellipse outline. Or with Pos-OVP: enter their X and/or Y coordinates.
  5. The geometry is created and applicable Pos-OVP and Dim-OVP based constraints are added (none for Axis endpoints and radius). A set of internal geometry aligned to it (major diameter, minor diameter, two foci) is also created. The internal geometry can be manually deleted if not needed, and recreated later. See Sketcher Show Hide Internal Geometry.

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.