Sketcher ConstrainSymmetric: Difference between revisions

From FreeCAD Documentation
m (space)
 
(30 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
|[[Sketcher_ConstrainEqual|Equal]]
|[[Sketcher_ConstrainBlock|Block]]
|Equal Length]]
|[[Sketcher_ConstrainBlock
|Constrain Block]]
|[[Sketcher_Workbench|Sketcher]]
|[[Sketcher_Workbench|Sketcher]]
|IconL=Constraint_EqualLength.png
|IconL=Sketcher_ConstrainEqual.svg
|IconR=Sketcher_ConstrainBlock.svg
|IconC=Workbench_Sketcher.svg
|IconC=Workbench_Sketcher.svg
|IconR=Sketcher_ConstrainBlock.png
}}
}}


Line 16: Line 16:
{{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.


<!--T:9-->
==Usage== <!--T:3-->
[[File:SymmetricConstraint1.png|256px]]


See also: [[Sketcher_Workbench#Drawing_aids|Drawing aids]].
<!--T:10-->
Select two points (vertexes) in the sketch and a line in the sketch. The selected points and the line will be dark green.


===[[Sketcher_Workbench#Continue_modes|Continue mode]]===
<!--T:11-->
[[File:SymmetricConstraint2.png|256px]]


# Make sure there is no selection.
<!--T:12-->
# There are several ways to invoke the tool:
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.
#* 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===
<!--T:13-->
This will apply the constraint to the selected items.


# Do one of the following:
<!--T:14-->
#* Select two points and a symmetry point (in that order).
[[File:SymmetricConstraint3.png|256px]]
#* 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.


<!--T:15-->
== Scripting == <!--T:18-->
{{Emphasis|Note:}} 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-->
<!--T:19-->
Two points and a symmetry line:
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].


</translate>
<!--T:6-->
{{Code|code=Sketch.addConstraint(Sketcher.Constraint('Symmetric', Line1, PointOfLine1, Line2, PointOfLine2, SymmetryLine))}}
{{Docnav|[[Sketcher_ConstrainEqual|Equal Length]]|[[Sketcher_ConstrainBlock|Constrain Block]]|[[Sketcher_Workbench|Sketcher]]|IconL=Constraint_EqualLength.png|IconC=Workbench_Sketcher.svg|IconR=Sketcher_ConstrainBlock.png}}
<translate>


<!--T:7-->
<!--T:20-->
Two points and a symmetry point:
{{Sketcher Tools navi}}


</translate>
<!--T:8-->
{{Code|code=Sketch.addConstraint(Sketcher.Constraint('Symmetric', Line1, PointOfLine1, Line2, PointOfLine2, LineS, PointOfLineS))}}
{{Userdocnavi}}
<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.