Sketcher CreateEllipseBy3Points: Difference between revisions

From FreeCAD Documentation
(Caption template)
No edit summary
 
(29 intermediate revisions by 4 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
{{Page_in_progress}}
<translate>
<translate>

<!--T:12-->
<!--T:12-->
{{Docnav
{{Docnav|[[Sketcher CreateEllipseByCenter|Ellipse by center]]|[[Sketcher_CreateArcOfEllipse|Arc of ellipse]]|[[Sketcher_Workbench|Sketcher]]|IconL=Sketcher_CreateEllipse.svg|IconC=Workbench_Sketcher.svg|IconR=Sketcher_Elliptical_Arc.png}}
|[[Sketcher_CreateEllipseByCenter|Ellipse]]
|[[Sketcher_CreateArcOfEllipse|Arc of ellipse]]
|[[Sketcher_Workbench|Sketcher]]
|IconL=Sketcher_CreateEllipseByCenter.svg
|IconR=Sketcher_CreateArcOfEllipse.svg
|IconC=Workbench_Sketcher.svg
}}


<!--T:1-->
<!--T:1-->
{{GuiCommand
{{GuiCommand
|Name=Sketcher CreateEllipseBy3Points
|Name=Sketcher CreateEllipseBy3Points
|Workbenches=[[Sketcher Workbench|Sketcher]]
|MenuLocation=Sketch → Sketcher geometries → Create ellipse by 3 points
|MenuLocation=Sketch → Sketcher geometries → Create ellipse by 3 points
|Workbenches=[[Sketcher_Workbench|Sketcher]]
|Shortcut={{KEY|G}} {{KEY|3}} {{KEY|E}}
|Version=0.15
|Version=0.15
|SeeAlso=[[Sketcher_CreateEllipseByCenter|Sketcher Ellipse by center]], [[Sketcher CreateCircle|Sketcher Circle]], [[Sketcher_CreateArcOfEllipse|Sketcher Arc of Ellipse]]
|SeeAlso=[[Sketcher_CreateEllipseByCenter|Sketcher CreateEllipseByCenter]]
}}
}}


Line 16: Line 26:


<!--T:9-->
<!--T:9-->
The [[Image:Sketcher_CreateEllipseBy3Points.svg|24px]] [[Sketcher_CreateEllipseBy3Points|Sketcher CreateEllipseBy3Points]] tool creates an ellipse by the endpoints of one of its axes and a point along the ellipse. {{Version|0.22}}: This is the same tool as [[Sketcher_CreateEllipseByCenter|Sketcher CreateEllipseByCenter]] but with a different initial mode.
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>
[[Image:Ellipse_3Point.png‎]]
<translate>

<!--T:3-->
{{Caption|The sequence of clicks is indicated by yellow arrows with numbers. 1 is the periapsis, 2 is the apoapsis, 3 is the defining point for minor diameter, green lines are major and minor diameters. Blue lines are random construction lines just for illustration purpose.}}


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

See also: [[Sketcher_Workbench#Drawing_aids|Drawing aids]].


<!--T:10-->
<!--T:10-->
# There are several ways to invoke the tool:
* Press the {{Button|[[File:Sketcher_CreateEllipseBy3Points.svg|16px]] [[Sketcher_CreateEllipseBy3Points|Ellipse by 3 points]]}} button.
#* Press the {{Button|[[Image:Sketcher_CreateEllipseBy3Points.svg|16px]] [[Sketcher_CreateEllipseBy3Points|Ellipse by axis endpoints, rim point]]}} button.
* 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.
#* Select the {{MenuCommand|Sketcher → Sketcher geometries → [[Image:Sketcher_CreateEllipseBy3Points.svg|16px]] Create ellipse by 3 points}} option from the menu.
#* Use the keyboard shortcut: {{KEY|G}} then {{KEY|3}}, then {{KEY|E}}.
# For further steps see [[Sketcher_CreateEllipseByCenter#Usage|Sketcher CreateEllipseByCenter]].


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

* 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 ConstrainInternalAlignment|Internal Alignment Constraint]] and [[Sketcher RestoreInternalAlignmentGeometry|Sketcher Show Hide Internal Geometry]].
See [[Sketcher_CreateEllipseByCenter#Notes|Sketcher CreateEllipseByCenter]].
* Pressing {{KEY|ESC}} or clicking the right mouse button cancels the function.


==Peculiarities== <!--T:6-->
* 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.


<!--T:13-->
<!--T:13-->
{{Docnav
{{Docnav|[[Sketcher CreateEllipseByCenter|Ellipse by center]]|[[Sketcher_CreateArcOfEllipse|Arc of ellipse]]|[[Sketcher_Workbench|Sketcher]]|IconL=Sketcher_CreateEllipse.svg|IconC=Workbench_Sketcher.svg|IconR=Sketcher_Elliptical_Arc.png}}
|[[Sketcher_CreateEllipseByCenter|Ellipse]]
|[[Sketcher_CreateArcOfEllipse|Arc of ellipse]]
|[[Sketcher_Workbench|Sketcher]]
|IconL=Sketcher_CreateEllipseByCenter.svg
|IconR=Sketcher_CreateArcOfEllipse.svg
|IconC=Workbench_Sketcher.svg
}}


</translate>
</translate>
{{Sketcher Tools navi{{#translation:}}}}
{{Sketcher_Tools_navi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}
{{clear}}

Latest revision as of 14:15, 19 March 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 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 CreateEllipseByCenter

Description

The Sketcher CreateEllipseBy3Points tool creates an ellipse by the endpoints of one of its axes and a point along the ellipse. introduced in version 0.22: This is the same tool as Sketcher CreateEllipseByCenter but with a different initial mode.

Usage

See also: Drawing aids.

  1. There are several ways to invoke the tool:
    • Press the Ellipse by axis endpoints, rim point button.
    • Select the Sketcher → Sketcher geometries → Create ellipse by 3 points option from the menu.
    • Use the keyboard shortcut: G then 3, then E.
  2. For further steps see Sketcher CreateEllipseByCenter.

Notes

See Sketcher CreateEllipseByCenter.