Sketcher ConstrainSymmetric: Difference between revisions

From FreeCAD Documentation
(How to use)
 
(33 intermediate revisions by 10 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
{{Page_in_progress}}
<translate>
<translate>

<!--T:5-->
<!--T:5-->
{{Docnav
{{Docnav|[[Sketcher_ConstrainEqual|Equal Length]]|[[Sketcher_ConstrainBlock|Constrain Block]]|[[Sketcher_Workbench|Sketcher]]|IconL=Constraint_EqualLength.png|IconC=Workbench_Sketcher.svg|IconR=Sketcher_ConstrainBlock.png}}
|[[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=Sketcher ConstrainSymmetric
|Name=Sketcher ConstrainSymmetric
|Workbenches=[[Sketcher Workbench|Sketcher]]
|MenuLocation=Sketch → Sketcher constraints → Constrain symmetrical
|MenuLocation=Sketch → Sketcher constraints → Constrain symmetrical
|Workbenches=[[Sketcher_Workbench|Sketcher]]
|Shortcut=S
|Shortcut={{KEY|S}}
|SeeAlso=[[Sketcher ConstrainParallel|Constraint Parallel]]
|SeeAlso=[[Sketcher_ConstrainParallel|Sketcher Constraint Parallel]]
}}
}}


==Description== <!--T:2-->
==Description== <!--T:17-->
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.


==How to use== <!--T:3-->
<!--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.
[[File:SymmetricConstraint1.png|256px]]<br /><br />
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 />
[[File:SymmetricConstraint2.png|256px]]<br /><br />
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.
This will apply the constraint to the selected items.<br /><br />
[[File:SymmetricConstraint3.png|256px]]<br /><br />
This is a geometric constraint and has no editable parameters.


<!--T:6-->
==Usage== <!--T:3-->
{{Docnav|[[Sketcher_ConstrainEqual|Equal Length]]|[[Sketcher_ConstrainBlock|Constrain Block]]|[[Sketcher_Workbench|Sketcher]]|IconL=Constraint_EqualLength.png|IconC=Workbench_Sketcher.svg|IconR=Sketcher_ConstrainBlock.png}}


See also: [[Sketcher_Workbench#Drawing_aids|Drawing aids]].
<!--T:7-->
{{Sketcher Tools navi}}


===[[Sketcher_Workbench#Continue_modes|Continue mode]]===
<!--T:8-->

{{Userdocnavi}}
# 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.
# 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.


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


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

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