Sketcher CreateEllipseByCenter: Difference between revisions

From FreeCAD Documentation
(Marked this version for translation)
No edit summary
 
(57 intermediate revisions by 4 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
{{Page_in_progress}}
<translate>
<translate>

<!--T:10-->
<!--T:10-->
{{Docnav
{{Docnav|[[Sketcher_CompCreateConic|Create a conic]]|[[Sketcher CreateEllipseBy3Points|Ellipse by 3 points]]|[[Sketcher_Workbench|Sketcher]]|IconL=Sketcher_Conics.png|IconC=Workbench_Sketcher.svg|IconR=Sketcher_CreateEllipse_3points.png}}
|[[Sketcher_Create3PointCircle|Circle by 3 points]]
|[[Sketcher_CreateEllipseBy3Points|Ellipse by 3 points]]
|[[Sketcher_Workbench|Sketcher]]
|IconL=Sketcher_Create3PointCircle.svg
|IconR=Sketcher_CreateEllipseBy3Points.svg
|IconC=Workbench_Sketcher.svg
}}


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


Line 16: Line 26:


<!--T:7-->
<!--T:7-->
The [[Image:Sketcher_CreateEllipseByCenter.svg|24px]] [[Sketcher_CreateEllipseByCenter|Sketcher CreateEllipseByCenter]] tool creates an ellipse by its center, an endpoint of one of its axes, and a point along the ellipse. {{Version|0.22}}: Or optionally by both endpoints of one of its axes and a point along the ellipse.
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.


</translate>
<!--T:3-->
[[Image:Sketcher_CreateEllipseByCenter_Example.png]]
[[Image:Sketcher_EllipseExample1.png‎|500px]]
<translate>

{{Caption|Ellipse (white) with internal geometry (dark yellow)}}
<!--T:14-->
{{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-->

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

Pos-OVP = Positional [[Sketcher_Preferences#General|On-View-Parameters]]. {{Version|0.22}}<br>
Dim-OVP = Dimensional On-View-Parameters. {{Version|0.22}}


<!--T:8-->
<!--T:8-->
# There are several ways to invoke the tool:
* 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]]).
#* Press the {{Button|[[Image:Sketcher_CreateEllipseByCenter.svg|16px]] [[Sketcher_CreateEllipseByCenter|Ellipse by center, radius, rim point]]}} button.
* 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).
#* Select the {{MenuCommand|Sketcher → Sketcher geometries → [[Image:Sketcher_CreateEllipseByCenter.svg|16px]] Create ellipse by center}} option from the menu.
* 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]].
#* Use the keyboard shortcut: {{KEY|G}} then {{KEY|E}}, then {{KEY|E}}.
* Pressing {{KEY|ESC}} or clicking the right mouse button cancels the function.
# 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]].
# 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''':
#*# Pick the center of the ellipse. Or with Pos-OVP: enter its X and/or Y coordinate.
#*# Pick an endpoint of one of the axes of the ellipse, this also defines one of its radii. Or with Dim-OVP: enter this radius and/or the angle of this axis.
#*# Pick a point to define the other radius of the ellipse. Or with Dim-OVP: enter this radius.
#* [[Image:Sketcher_CreateEllipseBy3Points.svg|16px]] '''Axis endpoints''': {{Version|0.22}}
#*# Pick the endpoints of one of the axes of the ellipse, this also defines one of its radii. Or with Pos-OVP: enter their X and/or Y coordinates. No constraints are created for these points.
#*# Pick a point to define the other radius of the ellipse. Or with Pos-OVP: enter its X and/or Y coordinate. No constraint is created for this point.
# The ellipse is created, including a set of internal geometry (major axis, minor axis and two foci), and applicable Pos-OVP and Dim-OVP based constraints are added.
# If the tool runs in [[Sketcher_Workbench#Continue_modes|continue mode]]:
## Optionally keep creating ellipses.
## To finish, right-click or press {{KEY|Esc}}, or start another geometry or constraint creation tool.

==Notes==

<!--T:6-->
* Elements of the internal geometry can be deleted. They can be recreated at any time with [[Sketcher_RestoreInternalAlignmentGeometry|Sketcher RestoreInternalAlignmentGeometry]].
* Once created, the major and minor axes of an ellipse are strict and cannot be swapped by resizing. This is a consequence of the solver parametrization and the same strict behavior of [[OpenCASCADE|OpenCASCADE]]. An ellipse must be rotated to swap its axes.


==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:11-->
<!--T:11-->
{{Docnav
{{Docnav|[[Sketcher_CompCreateConic|Create a conic]]|[[Sketcher CreateEllipseBy3Points|Ellipse by 3 points]]|[[Sketcher_Workbench|Sketcher]]|IconL=Sketcher_Conics.png|IconC=Workbench_Sketcher.svg|IconR=Sketcher_CreateEllipse_3points.png}}
|[[Sketcher_Create3PointCircle|Circle by 3 points]]
|[[Sketcher_CreateEllipseBy3Points|Ellipse by 3 points]]
|[[Sketcher_Workbench|Sketcher]]
|IconL=Sketcher_Create3PointCircle.svg
|IconR=Sketcher_CreateEllipseBy3Points.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:13, 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 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 CreateArcOfEllipse

Description

The Sketcher CreateEllipseByCenter tool creates an ellipse by its center, an endpoint of one of its axes, and a point along the ellipse. introduced in version 0.22: Or optionally by both endpoints of one of its axes and a point along the ellipse.

Ellipse (white) with internal geometry (dark yellow)

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, radius, rim 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 one of the axes of the ellipse, this also defines one of its radii. Or with Dim-OVP: enter this radius and/or the angle of this axis.
      3. Pick a point to define the other radius of the ellipse. Or with Dim-OVP: enter this radius.
    • Axis endpoints: introduced in version 0.22
      1. Pick the endpoints of one of the axes of the ellipse, this also defines one of its radii. Or with Pos-OVP: enter their X and/or Y coordinates. No constraints are created for these points.
      2. Pick a point to define the other radius of the ellipse. Or with Pos-OVP: enter its X and/or Y coordinate. No constraint is created for this point.
  5. The ellipse is created, including a set of internal geometry (major axis, minor axis and two foci), and applicable Pos-OVP and Dim-OVP based constraints are added.
  6. If the tool runs in continue mode:
    1. Optionally keep creating ellipses.
    2. To finish, right-click or press Esc, or start another geometry or constraint creation tool.

Notes

  • Elements of the internal geometry can be deleted. They can be recreated at any time with Sketcher RestoreInternalAlignmentGeometry.
  • Once created, the major and minor axes of an ellipse are strict and cannot be swapped by resizing. This is a consequence of the solver parametrization and the same strict behavior of OpenCASCADE. An ellipse must be rotated to swap its axes.