Sketcher ConstrainParallel: Difference between revisions

From FreeCAD Documentation
No edit summary
(WIP + continue mode)
Line 1: Line 1:
<languages/>
<languages/>
{{Page_in_progress}}
<translate>
<translate>


Line 24: Line 25:


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


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


<!--T:21-->
<!--T:21-->
# Optionally select two or more lines. {{Version|0.22}}: Points can be included in the selection, but will be ignored.
# Select two or more lines (optional if the tool will run in [[Sketcher_Workbench#Continue_modes|continue mode]]). {{Version|0.22}}: Points can be included in the selection, but will be ignored.
# There are several ways to invoke the command:
# There are several ways to invoke the tool:
#* Press the {{Button|[[Image:Sketcher_ConstrainParallel.svg|16px]] [[Sketcher_ConstrainParallel|Constrain parallel]]}} button.
#* 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.
#* 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|[[Image:Sketcher_ConstrainParallel.svg|16px]] Constrain parallel}} option from the context 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}}.
#* Use the keyboard shortcut: {{KEY|P}}.
# If the tool runs in [[Sketcher_Workbench#Continue_modes|continue mode]]:
# To indicate that the command has been activated the cursor changes to a white cross with the command icon.
## The cursor changes to a white cross with the tool icon.
# Optionally keep selecting elements. You can only select two lines at a time now.
## Optionally keep selecting elements. You can only select two lines at a time now.
# To finish the command press {{KEY|Esc}} or the right mouse button, or start a another constraints or geometries command.
## To finish, right-click or press {{KEY|Esc}}, or start a another constraints or geometries tool.


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

Revision as of 16:52, 29 February 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

  1. Select two or more lines (optional if the tool will run in continue mode). introduced in version 0.22: Points can be included in the selection, but will be ignored.
  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. If the tool runs in continue mode:
    1. The cursor changes to a white cross with the tool icon.
    2. Optionally keep selecting elements. You can only select two lines at a time now.
    3. To finish, right-click or press Esc, or start a another constraints or geometries tool.

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.