Sketcher CreateEllipseBy3Points: Difference between revisions

From FreeCAD Documentation
(several ways added so far)
(some preparation before the final touch)
Line 25: Line 25:


<!--T:9-->
<!--T:9-->
The [[Image:Sketcher_CreateEllipseBy3Points.svg|24px]] [[Sketcher_CreateEllipseBy3Points|Sketcher CreateEllipseBy3Points]] tool creates an ellipse by three points: the endpoints of the major axis (periapsis and apoapsis) and one point on the ellipse outline to define the minor radius. {{Version|0.22}}: Or optionally by its center, the end point of the major radius, and the minor radius, see [[Image:Sketcher_CreateEllipseByCenter.svg|16px]] [[Sketcher_CreateEllipseByCenter|Sketcher CreateEllipseByCenter]]).
This tool draws an ellipse by picking three points : (1) the periapsis (first crossing of longer diameter with ellipse), (2) the apoapsis (second crossing of longer diameter with ellipse), (3) one point on a side of the longer diameter (a) defining the minor radius (b). (c) is the resulting center and (f) are the focal points.

<!--T:7-->
When starting the tool, the mouse pointer changes to a white cross with a red ellipse icon.


</translate>
</translate>
Line 35: Line 32:
<!--T:3-->
<!--T:3-->
{{Caption|The sequence of clicks is indicated by yellow arrows with numbers.<br>
{{Caption|The sequence of clicks is indicated by yellow arrows with numbers.<br>
1 is the periapsis, 2 is the apoapsis, 3 is the defining point for the minor diameter.<br>
1 is the periapsis, 2 is the apoapsis, 3 is the point defining the minor diameter,<br>
The green lines are the major and minor diameters.<br>
a is the major diameter, b is the minor diameter (green lines),<br>
c is the ellipse center and f are the focal points.<br>
The blue lines are construction lines for illustration purposes.}}
The blue lines are construction lines for illustration purposes.}}


Line 46: Line 44:
#* Select the {{MenuCommand|Sketcher → Sketcher geometries → [[Image:Sketcher_CreateEllipseBy3Points.svg|16px]] Create Ellipse by 3 points}} option from the menu.
#* Select the {{MenuCommand|Sketcher → Sketcher geometries → [[Image:Sketcher_CreateEllipseBy3Points.svg|16px]] Create Ellipse by 3 points}} option from the menu.
#* The keyboard shortcut: {{KEY|G}} then {{KEY|3}}, {{KEY|E}}.
#* The keyboard shortcut: {{KEY|G}} then {{KEY|3}}, {{KEY|E}}.
# The cursor changes to a white cross with the command icon.
# First click in 3D view sets a point that defines the crossing of the major diameter with the ellipse (periapsis). Second click in 3D view sets a point that defines the crossing of the major diameter with the ellipse opposite to the center point (apoapsis). Third click sets a point on the ellipsis defining the minor radius.
# The '''Ellipse parameters''' section ({{Version|0.22}}) is added at the top of the [[Sketcher_Dialog|Sketcher Dialog]].
# 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 [[Sketcher_RestoreInternalAlignmentGeometry|Sketcher Show Hide Internal Geometry]].
# Pressing {{KEY|ESC}} or clicking the right mouse button cancels the function.
# Optionally press the {{KEY|M}} key or select from the dropdown list in the parameters section to change the tool '''Mode''':
#* [[Image:Sketcher_CreateEllipseBy3Points.svg|16px]] '''Axis endpoints and radius''':
#*# Pick two points to define the major axis. Or with Pos-OVP: enter their X and/or Y coordinates.
#*# Pick a point on outline of the ellipse to define the minor radius. Or with Pos-OVP: enter its X and/or Y coordinates.
#* [[Image:Sketcher_CreateEllipseByCenter.svg|16px]] '''Center''': {{Version|0.22}}
#*# 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 a point on the outline of the ellipse to define the minor radius. Or with Pos-OVP: enter the minor radius.
# 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_RestoreInternalAlignmentGeometry|Sketcher Show Hide Internal Geometry]].


==Peculiarities== <!--T:16-->
==Peculiarities== <!--T:16-->

Revision as of 15:49, 10 February 2024

Sketcher CreateEllipseBy3Points

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

Description

The Sketcher CreateEllipseBy3Points tool creates an ellipse by three points: the endpoints of the major axis (periapsis and apoapsis) and one point on the ellipse outline to define the minor radius. introduced in version 0.22: Or optionally by its center, the end point of the major radius, and the minor radius, see Sketcher CreateEllipseByCenter).

The sequence of clicks is indicated by yellow arrows with numbers.
1 is the periapsis, 2 is the apoapsis, 3 is the point defining the minor diameter,
a is the major diameter, b is the minor diameter (green lines),
c is the ellipse center and f are the focal points.
The blue lines are construction lines for illustration purposes.

Usage

  1. There are several ways to invoke the command:
  2. The cursor changes to a white cross with the command 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:
    • Axis endpoints and radius:
      1. Pick two points to define the major axis. Or with Pos-OVP: enter their X and/or Y coordinates.
      2. Pick a point on outline of the ellipse to define the minor radius. Or with Pos-OVP: enter its X and/or Y coordinates.
    • Center: introduced in version 0.22
      1. Pick the center of the ellipse. Or with Pos-OVP: enter its X and/or Y coordinate.
      2. 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.
      3. Pick a point on the outline of the ellipse to define the minor radius. Or with Pos-OVP: enter the minor radius.
  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.