Sketcher ConstrainParallel: Difference between revisions

From FreeCAD Documentation
(Marked this version for translation)
(→‎Run-once mode: additional option)
 
(26 intermediate revisions by 5 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
{{Page_in_progress}}
<translate>
<translate>

<!--T:12-->
<!--T:12-->
{{Docnav
{{Docnav
|[[Sketcher_ConstrainVertical|Vertical]]
|[[Sketcher_ConstrainHorizontal|Horizontal]]
|[[Sketcher_ConstrainPerpendicular|Perpendicular]]
|[[Sketcher_ConstrainPerpendicular|Perpendicular]]
|[[Sketcher_Workbench|Sketcher]]
|[[Sketcher_Workbench|Sketcher]]
|IconL=Constraint_Horizontal.svg
|IconL=Sketcher_ConstrainVertical.svg
|IconR=Sketcher_ConstrainPerpendicular.svg
|IconC=Workbench_Sketcher.svg
|IconC=Workbench_Sketcher.svg
|IconR=Constraint_Perpendicular.png
}}
}}


Line 14: Line 16:
{{GuiCommand
{{GuiCommand
|Name=Sketcher ConstrainParallel
|Name=Sketcher ConstrainParallel
|Icon=Constraint Parallel.svg
|Workbenches=[[Sketcher Workbench|Sketcher]]
|MenuLocation=Sketch → Sketcher constraints → Constrain parallel
|MenuLocation=Sketch → Sketcher constraints → Constrain parallel
|Workbenches=[[Sketcher_Workbench|Sketcher]]
|Shortcut={{KEY|Shift}} + {{KEY|P}}
|Shortcut={{KEY|P}}
|SeeAlso=[[Sketcher ConstrainVertical|Constraint Vertical]], [[Sketcher ConstrainHorizontal|Constraint Horizontal]]
|SeeAlso=[[Sketcher_ConstrainHorVer|Sketcher ConstrainHorVer]]
}}
}}


Line 24: Line 25:


<!--T:2-->
<!--T:2-->
The [[Image:Sketcher_ConstrainParallel.svg|24px]] [[Sketcher_ConstrainParallel|Sketcher ConstrainParallel]] tool constrains lines to be parallel.
The Constrain Parallel constraint forces two selected straight lines or edges to be parallel to each other.


==Operation== <!--T:17-->
==Usage== <!--T:20-->


See also: [[Sketcher_Workbench#Drawing_aids|Drawing aids]].
<!--T:3-->
The sketch contains two randomly oriented lines.


===[[Sketcher_Workbench#Continue_modes|Continue mode]]===
<!--T:4-->
[[Image:ConstrainParallel1.png|256px]]


<!--T:5-->
<!--T:21-->
# Make sure there is no selection.
Select both lines by clicking successively on each of them.
# There are several ways to invoke the tool:
#* Press the {{Button|[[Image:Sketcher_ConstrainParallel.svg|16px]] [[Sketcher_ConstrainParallel|Constrain parallel]]}} button.
#* Select the {{MenuCommand|Sketch → Sketcher constraints → [[Image:Sketcher_ConstrainParallel.svg|16px]] Constrain parallel}} option from the menu.
#* {{Version|0.22}}: Right-click in the [[3D_view|3D view]] and select the {{MenuCommand|Constrain → [[Image:Sketcher_ConstrainParallel.svg|16px]] Constrain parallel}} option from the context menu.
#* Use the keyboard shortcut: {{KEY|P}}.
# The cursor changes to a white cross with the tool icon.
# Select two lines.
# 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:6-->
[[File:ConstrainParallel2.png|256px]]


# Select two or more lines. {{Version|0.22}}: Points can be included in the selection, but will be ignored.
<!--T:7-->
# Invoke the tool as explained above, or with the following additional option:
Apply the Constrain Parallel constraint by either:
#* {{Version|0.22}}: Right-click in the [[3D_view|3D view]] and select the {{MenuCommand|[[Image:Sketcher_ConstrainParallel.svg|16px]] Constrain parallel}} option from the context menu.
* Pressing the {{Button|[[Image:Constraint_Parallel.png|16px]] [[Sketcher ConstrainParallel|Constrain Parallel]]}} button from the Sketcher constraints toolbarby selecting the Constraint Parallel menu item from the Sketcher constraints sub menu of the Sketcher (Sketcher workbench selected) or Part Design (Part Design workbench selected) menu item.
# Depending on the selection one or more constraints are added.
* Use the {{KEY|Shift}} + {{KEY|P}} keyboard shortcut.

* Use the {{MenuCommand|Sketch → Sketcher constraints → Constrain parallel}} entry from the top menu.
== Scripting == <!--T:18-->

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


<!--T:8-->
<!--T:19-->
The [[Sketcher_scripting|Sketcher scripting]] page explains the values which can be used for {{incode|Line1}} and {{incode|Line2}} and contains further examples on how to create constraints from Python scripts.
[[Image:ConstrainParallel3.png|256px]]


<!--T:9-->
'''Result:''' The selected lines are forced to be parallel to each other. Changing the orientation of one line will change the orientation of the other to be the same.


<!--T:13-->
<!--T:13-->
{{Docnav
{{Docnav
|[[Sketcher_ConstrainVertical|Vertical]]
|[[Sketcher_ConstrainHorizontal|Horizontal]]
|[[Sketcher_ConstrainPerpendicular|Perpendicular]]
|[[Sketcher_ConstrainPerpendicular|Perpendicular]]
|[[Sketcher_Workbench|Sketcher]]
|[[Sketcher_Workbench|Sketcher]]
|IconL=Constraint_Horizontal.svg
|IconL=Sketcher_ConstrainVertical.svg
|IconR=Sketcher_ConstrainPerpendicular.svg
|IconC=Workbench_Sketcher.svg
|IconC=Workbench_Sketcher.svg
|IconR=Constraint_Perpendicular.png
}}
}}


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

Latest revision as of 14:04, 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 ConstrainParallel

Menu location
Sketch → Sketcher constraints → Constrain parallel
Workbenches
Sketcher
Default shortcut
P
Introduced in version
-
See also
Sketcher ConstrainHorVer

Description

The Sketcher ConstrainParallel tool constrains lines to be parallel.

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 parallel button.
    • Select the Sketch → Sketcher constraints → Constrain parallel option from the menu.
    • introduced in version 0.22: Right-click in the 3D view and select the Constrain → Constrain parallel option from the context menu.
    • Use the keyboard shortcut: P.
  3. The cursor changes to a white cross with the tool icon.
  4. Select two lines.
  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. Select two or more lines. introduced in version 0.22: Points can be included in the selection, but will be ignored.
  2. Invoke the tool as explained above, or with the following additional option:
  3. Depending on the selection one or more constraints are added.

Scripting

Sketch.addConstraint(Sketcher.Constraint('Parallel', Line1, Line2))

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