Sketcher CreateRegularPolygon: Difference between revisions

From FreeCAD Documentation
(several ways added)
(some preparation before the final touch - first dialog title reads "Create array")
Line 23: Line 23:


<!--T:5-->
<!--T:5-->
Draws a regular polygon inscribed in a construction geometry circle.
The [[Image:Sketcher_CreateRegularPolygon.svg|24px]] [[Sketcher_CreateRegularPolygon|Sketcher CreateRegularPolygon]] tool draws a regular polygon inscribed in a construction geometry circle.
When starting the tool, a box apears asking for the number of sides of the regular polygon. Once the {{Button|OK}} button is pressed the mouse pointer changes to a white cross with a red hexagon icon.
The coordinates of the pointer are shown beside it in blue in real time.


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

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:7-->
<!--T:7-->
Line 34: Line 37:
#* Select the {{MenuCommand|Sketcher → Sketcher geometries → [[Image:Sketcher_CreateRegularPolygon.svg|16px]] Create regular polygon}} option from the menu.
#* Select the {{MenuCommand|Sketcher → Sketcher geometries → [[Image:Sketcher_CreateRegularPolygon.svg|16px]] Create regular polygon}} option from the menu.
#* The keyboard shortcut: {{KEY|G}} then {{KEY|P}}, {{KEY|R}}.
#* The keyboard shortcut: {{KEY|G}} then {{KEY|P}}, {{KEY|R}}.
# The '''Create array''' dialog opens, then enter the '''Number of Sides'''.
# Define the number of sides of the polygon in the pop up box and confirm by pressing the {{Button|OK}} button.
# The cursor changes to a white cross with the command icon.
# Click once to set the center, then move the mouse and click a second time to set one of the vertices.
# The '''Polygon parameters''' section ({{Version|0.22}}) is added at the top of the [[Sketcher_Dialog|Sketcher Dialog]].
# Pressing {{KEY|Esc}} or clicking the right mouse button cancels the function.
# Optionally change the number of '''Sides''':
#* Enter an integer value greater than two.
#* Press the {{KEY|U}} key to increase the number.
#* Press the {{KEY|J}} key to decrease the number.
# Pick the center of the polygon. Or with Pos-OVP: enter its X and/or Y coordinate.
# Pick the first point of the polygon, this also sets the radius of the circumscribing construction circle. Or with Dim-OVP: enter the radius of the circle and/or the angle of the first point. The angle is relative to the X axis of the sketch.
# The geometry is created and applicable Pos-OVP and Dim-OVP based constraints are added.


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

Revision as of 21:25, 10 February 2024

Sketcher CreateRegularPolygon

Menu location
Sketch → Sketcher geometries → Create regular polygon
Workbenches
Sketcher
Default shortcut
G P R
Introduced in version
-
See also
None

Description

The Sketcher CreateRegularPolygon tool draws a regular polygon inscribed in a construction geometry circle.

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 command:
    • Press the Regular polygon button.
    • Select the Sketcher → Sketcher geometries → Create regular polygon option from the menu.
    • The keyboard shortcut: G then P, R.
  2. The Create array dialog opens, then enter the Number of Sides.
  3. The cursor changes to a white cross with the command icon.
  4. The Polygon parameters section (introduced in version 0.22) is added at the top of the Sketcher Dialog.
  5. Optionally change the number of Sides:
    • Enter an integer value greater than two.
    • Press the U key to increase the number.
    • Press the J key to decrease the number.
  6. Pick the center of the polygon. Or with Pos-OVP: enter its X and/or Y coordinate.
  7. Pick the first point of the polygon, this also sets the radius of the circumscribing construction circle. Or with Dim-OVP: enter the radius of the circle and/or the angle of the first point. The angle is relative to the X axis of the sketch.
  8. The geometry is created and applicable Pos-OVP and Dim-OVP based constraints are added.

Notes

The circumscribed circle is construction geometry, which is only visible when editing the sketch.