Sketcher ConstrainSymmetric: Difference between revisions

From FreeCAD Documentation
m (Normandc moved page Constraint Symmetric to Sketcher ConstrainSymmetric without leaving a redirect: Part of translatable page "Constraint Symmetric")
(→‎Run-once mode: additional option)
 
(40 intermediate revisions by 11 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
{{Page_in_progress}}
<translate>
<translate>

<!--T:5-->
{{Docnav
|[[Sketcher_ConstrainEqual|Equal]]
|[[Sketcher_ConstrainBlock|Block]]
|[[Sketcher_Workbench|Sketcher]]
|IconL=Sketcher_ConstrainEqual.svg
|IconR=Sketcher_ConstrainBlock.svg
|IconC=Workbench_Sketcher.svg
}}

<!--T:1-->
<!--T:1-->
{{GuiCommand
{{GuiCommand|Name=Constraint Symmetric|Workbenches=[[Sketcher Workbench|Sketcher]], [[PartDesign Workbench|PartDesign]]|MenuLocation=Sketch → Sketcher constraints → Constrain symmetrical|SeeAlso=[[Constraint Parallel|Constraint Parallel]]}}
|Name=Sketcher ConstrainSymmetric
|MenuLocation=Sketch → Sketcher constraints → Constrain symmetrical
|Workbenches=[[Sketcher_Workbench|Sketcher]]
|Shortcut={{KEY|S}}
|SeeAlso=[[Sketcher_ConstrainParallel|Sketcher Constraint Parallel]]
}}

==Description== <!--T:17-->

<!--T:2-->
The [[Image:Sketcher_ConstrainSymmetric.svg|24px]] [[Sketcher_ConstrainSymmetric|Sketcher ConstrainSymmetric]] tool constrains two points to be symmetrical around a line or around a third point.

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

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

===[[Sketcher_Workbench#Continue_modes|Continue mode]]===

# Make sure there is no selection.
# There are several ways to invoke the tool:
#* Press the {{Button|[[Image:Sketcher_ConstrainSymmetric.svg|16px]] [[Sketcher_ConstrainSymmetric|Constrain symmetrical]]}} button.
#* Select the {{MenuCommand|Sketch → Sketcher constraints → [[Image:Sketcher_ConstrainSymmetric.svg|16px]] Constrain symmetrical}} option from the menu.
#* {{Version|0.22}}: Right-click in the [[3D_view|3D view]] and select the {{MenuCommand|Constrain → [[Image:Sketcher_ConstrainSymmetric.svg|16px]] Constrain symmetrical}} option from the context menu.
#* Use the keyboard shortcut: {{KEY|S}}.
# The cursor changes to a white cross with the tool icon.
# Do one of the following:
#* 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).
# A constraint is added.
# Optionally keep creating constraints.
# To finish, right-click or press {{KEY|Esc}}, or start another geometry or constraint creation tool.

===Run-once mode===

# Do one of the following:
#* 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).
# Invoke the tool as explained above, or with the following additional option:
#* {{Version|0.22}}: Right-click in the [[3D_view|3D view]] and select the {{MenuCommand|[[Image:Sketcher_ConstrainSymmetric.svg|16px]] Constrain symmetrical}} option from the context menu.
# A constraint is added.

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

<!--T:19-->
Two points and a symmetry line:

</translate>
{{Code|code=Sketch.addConstraint(Sketcher.Constraint('Symmetric', Line1, PointOfLine1, Line2, PointOfLine2, SymmetryLine))}}
<translate>

<!--T:20-->
Two points and a symmetry point:

</translate>
{{Code|code=Sketch.addConstraint(Sketcher.Constraint('Symmetric', Line1, PointOfLine1, Line2, PointOfLine2, LineS, PointOfLineS))}}
<translate>

<!--T:21-->
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):

</translate>
{{Code|code=Sketch.addConstraint(Sketcher.Constraint('Symmetric', Line, 1, Line, 2, LineS, PointOfLineS))}}
<translate>

<!--T:22-->
The [[Sketcher_scripting|Sketcher scripting]] page explains the values which can be used for {{incode|Line1}}, {{incode|Line2}}, {{incode|LineS}}, {{incode|Line}}, {{incode|PointOfLine1}}, {{incode|PointOfLine2}} and {{incode|PointOfLineS}}, and contains further examples on how to create constraints from Python scripts.


====Description==== <!--T:2-->
The symmetrical constraint constrains two selected points to be symmetrical around a given line, i.e., both selected points are constrained to lie on a normal to the line through both points and are constrained to be equidistant from the line. Alternatively it can constrain two points to be symmetric with respect to a third one.


====Operation==== <!--T:3-->
<!--T:6-->
{{Docnav
[[File:SymmetricConstraint1.png|256px]]<br /><br />
|[[Sketcher_ConstrainEqual|Equal]]
Select two points (vertexes) in the sketch and a line in the sketch. The selected points and the line will be dark green.<br /><br />
|[[Sketcher_ConstrainBlock|Block]]
[[File:SymmetricConstraint2.png|256px]]<br /><br />
|[[Sketcher_Workbench|Sketcher]]
Click on the SymmetricalConstraint icon [[File:Constraint_Symmetric.png|16px]] in the Sketcher toolbar or select the Constrain Symmetrical menu item from the Sketcher Constraints sub menu of the Sketcher (or Part Design) menu item.
|IconL=Sketcher_ConstrainEqual.svg
This will apply the constraint to the selected items.<br /><br />
|IconR=Sketcher_ConstrainBlock.svg
[[File:SymmetricConstraint3.png|256px]]<br /><br />
|IconC=Workbench_Sketcher.svg
This is a geometric constraint and has no editable parameters.
}}


</translate>
</translate>
{{Sketcher_Tools_navi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}

Latest revision as of 14:13, 25 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.

Continue mode

  1. Make sure there is no selection.
  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. The cursor changes to a white cross with the tool icon.
  4. Do one of the following:
    • 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).
  5. A constraint is added.
  6. Optionally keep creating constraints.
  7. To finish, right-click or press Esc, or start another geometry or constraint creation tool.

Run-once mode

  1. Do one of the following:
    • 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. Invoke the tool as explained above, or with the following additional option:
  3. A constraint is added.

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.