Sketcher ConstrainParallel: Difference between revisions

From FreeCAD Documentation
(Add Constrain parallel constraint documentation davec49)
(→‎Run-once mode: additional option)
 
(52 intermediate revisions by 12 users not shown)
Line 1: Line 1:
<languages/>
{{GuiCommand|Name=Constraint Parallel|Workbenches=[[Sketcher Workbench|Sketcher]], [[PartDesign Module|PartDesign_Workbench]]|MenuLocation=Sketcher → Constrain parallel|SeeAlso=[[Constraint vertical]], [[Constraint horizontal]]}}
{{Page_in_progress}}
<translate>


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


<!--T:10-->
The Constrain Parallel constraint forces two selected straight lines or edges to be parallel to each other.
{{GuiCommand
|Name=Sketcher ConstrainParallel
|MenuLocation=Sketch → Sketcher constraints → Constrain parallel
|Workbenches=[[Sketcher_Workbench|Sketcher]]
|Shortcut={{KEY|P}}
|SeeAlso=[[Sketcher_ConstrainHorVer|Sketcher ConstrainHorVer]]
}}


==Description== <!--T:16-->
====Operation====
The sketch contains two randomly oriented lines.


<!--T:2-->
[[File:ConstrainParallel1.png|256px]]
The [[Image:Sketcher_ConstrainParallel.svg|24px]] [[Sketcher_ConstrainParallel|Sketcher ConstrainParallel]] tool constrains lines to be parallel.


==Usage== <!--T:20-->
Select both lines by clicking successively on each of them.


See also: [[Sketcher_Workbench#Drawing_aids|Drawing aids]].
[[File:ConstrainParallel2.png|256px]]


===[[Sketcher_Workbench#Continue_modes|Continue mode]]===
Apply the Constrain Parallel constraint by selecting the Constrain parallel icon [[File:Constraint_Parallel.png|16px]] from the Sketcher constraints toolbar or by selecting the constrain Parallel menu item from the Sketcher constraints sub menu of the Sketcher (Sketcher workbench selected) or Part Design (Part Design workbench selected) menu item.


<!--T:21-->
[[File:ConstrainParallel3.png|256px]]
# Make sure there is no selection.
# 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===
The selected lines are forced to be parallel to each other. Changing the orientation of one line while change the orientation of the other to be the same.

{{languages | {{es|Sketcher_Arc/es}} }}
# Select two or more lines. {{Version|0.22}}: Points can be included in the selection, but will be ignored.
# 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_ConstrainParallel.svg|16px]] Constrain parallel}} option from the context menu.
# Depending on the selection one or more constraints are added.

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

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

<!--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.


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

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

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.