Sketcher ConstrainSymmetric: Difference between revisions

From FreeCAD Documentation
(WIP)
No edit summary
Line 47: Line 47:
##* Select a point, a symmetry line and another point (idem).
##* Select a point, a symmetry line and another point (idem).
##* Select a line and a symmetry point (idem).
##* Select a line and a symmetry point (idem).
## To finish, right-click or press {{KEY|Esc}}, or start a another constraints or geometries tool.
## To finish, right-click or press {{KEY|Esc}}, or start another constraints or geometries tool.


== Scripting == <!--T:18-->
== Scripting == <!--T:18-->

Revision as of 16:41, 6 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 ConstrainSymmetric

Menu location
Sketch → Sketcher constraints → Constrain symmetrical
Workbenches
Sketcher
Default shortcut
S
Introduced in version
-
See also
Sketcher Constraint Parallel

Description

The Sketcher ConstrainSymmetric tool constrains two points to be symmetrical around a line or around a third point.

Usage

See also: Drawing aids.

  1. Do one of the following (optional if the tool will run in continue mode):
    • Select two points and a symmetry point (in that order).
    • Select two points and a symmetry line (in any order).
    • Select a line and a symmetry point (idem).
  2. There are several ways to invoke the tool:
    • Press the Constrain symmetrical button.
    • Select the Sketch → Sketcher constraints → Constrain symmetrical option from the menu.
    • introduced in version 0.22: Right-click in the 3D view and select the Constrain → Constrain symmetrical option from the context menu.
    • Use the keyboard shortcut: S.
  3. If the tool runs in continue mode:
    1. The cursor changes to a white cross with the tool icon.
    2. Optionally keep selecting elements:
      • Select two points and a symmetry point (in that order).
      • Select two points and a symmetry line (idem).
      • Select a point, a symmetry line and another point (idem).
      • Select a line and a symmetry point (idem).
    3. To finish, right-click or press Esc, or start another constraints or geometries tool.

Scripting

Two points and a symmetry line:

Sketch.addConstraint(Sketcher.Constraint('Symmetric', Line1, PointOfLine1, Line2, PointOfLine2, SymmetryLine))

Two points and a symmetry point:

Sketch.addConstraint(Sketcher.Constraint('Symmetric', Line1, PointOfLine1, Line2, PointOfLine2, LineS, PointOfLineS))

A line and a symmetry point (In the GUI one can select a line and a point, but it uses internally the same form as above, with the two extremities of the same line):

Sketch.addConstraint(Sketcher.Constraint('Symmetric', Line, 1, Line, 2, LineS, PointOfLineS))

The Sketcher scripting page explains the values which can be used for Line1, Line2, LineS, Line, PointOfLine1, PointOfLine2 and PointOfLineS, and contains further examples on how to create constraints from Python scripts.