Sketcher ConstrainParallel: Difference between revisions

From FreeCAD Documentation
No edit summary
(→‎Run-once mode: additional option)
 
(40 intermediate revisions by 10 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
{{Page_in_progress}}
<translate>
<translate>

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

<!--T:10-->
<!--T:10-->
{{GuiCommand
{{GuiCommand|Name=Constraint Parallel|Workbenches=[[Sketcher Workbench|Sketcher]], [[PartDesign Workbench|PartDesign]]|MenuLocation=Sketch → Sketcher constraints → Constrain parallel|SeeAlso=[[Sketcher ConstrainVertical|Constraint Vertical]], [[Sketcher ConstrainHorizontal|Constraint Horizontal]]}}
|Name=Sketcher ConstrainParallel
|MenuLocation=Sketch → Sketcher constraints → Constrain parallel
|Workbenches=[[Sketcher_Workbench|Sketcher]]
|Shortcut={{KEY|P}}
|SeeAlso=[[Sketcher_ConstrainHorVer|Sketcher ConstrainHorVer]]
}}


====Description==== <!--T:2-->
==Description== <!--T:16-->
The Constrain Parallel constraint forces two selected straight lines or edges to be parallel to each other.


====Operation==== <!--T:3-->
<!--T:2-->
The [[Image:Sketcher_ConstrainParallel.svg|24px]] [[Sketcher_ConstrainParallel|Sketcher ConstrainParallel]] tool constrains lines to be parallel.
The sketch contains two randomly oriented lines.


<!--T:4-->
==Usage== <!--T:20-->
[[File:ConstrainParallel1.png|256px]]


See also: [[Sketcher_Workbench#Drawing_aids|Drawing aids]].
<!--T:5-->
Select both lines by clicking successively on each of them.


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

[[File:ConstrainParallel2.png|256px]]
<!--T:21-->
# 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===

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


<!--T:8-->
[[File:ConstrainParallel3.png|256px]]


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


</translate>
</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.