Sketcher ConstrainSymmetric: Difference between revisions

From FreeCAD Documentation
(Docnav)
(Scripting_Sketcher_constraints_in_Python -> Sketcher_scripting)
(19 intermediate revisions by 8 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
<translate>
<translate>

{{Docnav|[[Sketcher_ConstrainEqual|Equal Length]]|[[Sketcher_ConstrainBlock|Constrain Block]]|[[Sketcher_Workbench|Sketcher]]|IconL=Constraint_EqualLength.png|IconC=Workbench_Sketcher.svg|IconR=Sketcher_ConstrainBlock.png}}
<!--T:5-->
{{Docnav
|[[Sketcher_ConstrainEqual|Equal Length]]
|[[Sketcher_ConstrainBlock|Constrain 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=S
|SeeAlso=[[Sketcher ConstrainParallel|Constraint Parallel]]
|SeeAlso=[[Sketcher_ConstrainParallel|Sketcher Constraint Parallel]]
}}
}}


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

<!--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.
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-->
==Usage== <!--T:3-->
[[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:9-->
{{Docnav|[[Sketcher_ConstrainEqual|Equal Length]]|[[Sketcher_ConstrainBlock|Constrain Block]]|[[Sketcher_Workbench|Sketcher]]|IconL=Constraint_EqualLength.png|IconC=Workbench_Sketcher.svg|IconR=Sketcher_ConstrainBlock.png}}
[[File:SymmetricConstraint1.png|500px]]


<!--T:10-->
{{Sketcher Tools navi}}
Select two points (vertexes) in the sketch and a line in the sketch. The selected points and the line will be dark green.


<!--T:11-->
{{Userdocnavi}}
[[File:SymmetricConstraint2.png|500px]]

<!--T:12-->
Click on {{Button|[[File:Sketcher_ConstrainSymmetric.svg|16px]] [[Sketcher_ConstrainSymmetric|Constrain symmetric]]}} or select the Constrain Symmetrical menu item from the Sketcher Constraints sub menu of the Sketcher (or Part Design) menu item.

<!--T:13-->
This will apply the constraint to the selected items.

<!--T:14-->
[[File:SymmetricConstraint3.png|500px]]

<!--T:15-->
{{Emphasis|Note:}} Before Version 0.19 (see fix [https://github.com/FreeCAD/FreeCAD/pull/3746]), if you want to define a symmetry constraint with respect to a point, the order of the selection is important, depending on if you select the tool at the beginning or at the end.
* If you click the tool first: select the first point, then the symmetry reference point, and finally the second point.
* If you click the tool last: select the first point, then the second point, and finally the symmetry reference point.

<!--T:16-->
See the tracker [https://freecadweb.org/tracker/view.php?id=4144 issue #4144], and [https://forum.freecadweb.org/viewtopic.php?f=3&t=39611 forum thread].

== 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 Length]]
|[[Sketcher_ConstrainBlock|Constrain Block]]
|[[Sketcher_Workbench|Sketcher]]
|IconL=Sketcher_ConstrainEqual.svg
|IconR=Sketcher_ConstrainBlock.svg
|IconC=Workbench_Sketcher.svg
}}


</translate>
</translate>
{{Sketcher Tools navi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}
{{clear}}

Revision as of 23:22, 23 January 2021

Sketcher ConstrainSymmetric

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

Description

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.

Usage

Select two points (vertexes) in the sketch and a line in the sketch. The selected points and the line will be dark green.

Click on Constrain symmetric 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.

Note: Before Version 0.19 (see fix [1]), if you want to define a symmetry constraint with respect to a point, the order of the selection is important, depending on if you select the tool at the beginning or at the end.

  • If you click the tool first: select the first point, then the symmetry reference point, and finally the second point.
  • If you click the tool last: select the first point, then the second point, and finally the symmetry reference point.

See the tracker issue #4144, and forum thread.

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.