Sketcher ConstrainHorizontal: Difference between revisions

From FreeCAD Documentation
(Not in updated V0.22 context menu.)
Tag: Manual revert
(WIP + continue mode)
Line 1: Line 1:
<languages/>
<languages/>
{{Page_in_progress}}
<translate>
<translate>


Line 24: Line 25:


<!--T:4-->
<!--T:4-->
The [[Image:Sketcher_ConstrainHorizontal.svg|24px]] [[Sketcher_ConstrainHorizontal|Sketcher ConstrainHorizontal]] command constrains lines or pairs of points to be horizontal (parallel to the horizontal axis of the sketch).
The [[Image:Sketcher_ConstrainHorizontal.svg|24px]] [[Sketcher_ConstrainHorizontal|Sketcher ConstrainHorizontal]] tool constrains lines or pairs of points to be horizontal (parallel to the horizontal axis of the sketch).


<!--T:16-->
<!--T:16-->
{{Version|0.22}}: In most cases it is advisable to use the combined [[Sketcher_ConstrainHorVer|Sketcher ConstrainHorVer]] command instead.
{{Version|0.22}}: In most cases it is advisable to use the combined [[Sketcher_ConstrainHorVer|Sketcher ConstrainHorVer]] tool instead.


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


<!--T:5-->
<!--T:5-->
# Do one of the following (optional if the tool will run in [[Sketcher_Workbench#Continue_modes|continue mode]]):
# Optionally do one of the following:
#* Select two or more points.
#* Select two or more points.
#* Select two or more lines. Points can be included in the selection, but will be ignored.
#* Select two or more lines. 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:
#* {{VersionMinus|0.21}}: Press the {{Button|[[Image:Sketcher_ConstrainHorizontal.svg|16px]] [[Sketcher_ConstrainHorizontal|Constrain horizontally]]}} button.
#* {{VersionMinus|0.21}}: Press the {{Button|[[Image:Sketcher_ConstrainHorizontal.svg|16px]] [[Sketcher_ConstrainHorizontal|Constrain horizontally]]}} button.
#* {{Version|0.22}}: Press the down arrow to the right of the {{Button|[[Image:Sketcher_ConstrainHorVer.svg||x16px]][[Image:Toolbar_flyout_arrow.svg|x16px]]}} button and select the {{MenuCommand|[[Image:Sketcher_ConstrainHorizontal.svg|16px]] Constrain horizontally}} option.
#* {{Version|0.22}}: Press the down arrow to the right of the {{Button|[[Image:Sketcher_ConstrainHorVer.svg||x16px]][[Image:Toolbar_flyout_arrow.svg|x16px]]}} button and select the {{MenuCommand|[[Image:Sketcher_ConstrainHorizontal.svg|16px]] Constrain horizontally}} option.
#* Select the {{MenuCommand|Sketch → Sketcher constraints → [[Image:Sketcher_ConstrainHorizontal.svg|16px]] Constrain horizontally}} option from the menu.
#* Select the {{MenuCommand|Sketch → Sketcher constraints → [[Image:Sketcher_ConstrainHorizontal.svg|16px]] Constrain horizontally}} option from the menu.
#* Use the keyboard shortcut: {{KEY|H}}.
#* Use the keyboard shortcut: {{KEY|H}}.
# 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 a single line or two points at a time now.
## Optionally keep selecting elements. You can only select a single line or two points 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:14-->
== Scripting == <!--T:14-->

Revision as of 16:27, 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 ConstrainHorizontal

Menu location
Sketch → Sketcher constraints → Constrain horizontally
Workbenches
Sketcher
Default shortcut
H
Introduced in version
-
See also
Sketcher ConstrainHorVer, Sketcher ConstraintVertical

Description

The Sketcher ConstrainHorizontal tool constrains lines or pairs of points to be horizontal (parallel to the horizontal axis of the sketch).

introduced in version 0.22: In most cases it is advisable to use the combined Sketcher ConstrainHorVer tool instead.

Usage

  1. Do one of the following (optional if the tool will run in continue mode):
    • Select two or more points.
    • Select two or more lines. Points can be included in the selection, but will be ignored.
  2. There are several ways to invoke the tool:
    • version 0.21 and below: Press the Constrain horizontally button.
    • introduced in version 0.22: Press the down arrow to the right of the button and select the Constrain horizontally option.
    • Select the Sketch → Sketcher constraints → Constrain horizontally option from the menu.
    • Use the keyboard shortcut: H.
  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 a single line or two points 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('Horizontal', Line))

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