Sketcher ConstrainPointOnObject: Difference between revisions

From FreeCAD Documentation
No edit summary
No edit summary
Line 33: Line 33:


See also: [[Sketcher_Workbench#Drawing_aids|Drawing aids]].
See also: [[Sketcher_Workbench#Drawing_aids|Drawing aids]].

===[[Sketcher_Workbench#Continue_modes|Continue mode]]===


<!--T:16-->
<!--T:16-->
# Make sure there is no selection.
# Do one of the following (skip this step if the tool should run in [[Sketcher_Workbench#Continue_modes|continue mode]]):
#* Select a single point and a single edge (in any order).
#* Select several points and a single edge (idem).
#* Select a single point and several edges (idem).
# There are several ways to invoke the tool:
# There are several ways to invoke the tool:
#* Press the {{Button|[[Image:Sketcher_ConstrainPointOnObject.svg|16px]] [[Sketcher_ConstrainPointOnObject|Constrain point onto object]]}} button.
#* Press the {{Button|[[Image:Sketcher_ConstrainPointOnObject.svg|16px]] [[Sketcher_ConstrainPointOnObject|Constrain point onto object]]}} button.
#* Select the {{MenuCommand|Sketch → Sketcher constraints → [[Image:Sketcher_ConstrainPointOnObject.svg|16px]] Constrain point onto object}} option from the menu.
#* Select the {{MenuCommand|Sketch → Sketcher constraints → [[Image:Sketcher_ConstrainPointOnObject.svg|16px]] Constrain point onto object}} option from the menu.
#* Use the keyboard shortcut: {{KEY|O}}.
#* Use the keyboard shortcut: {{KEY|O}}.
# The cursor changes to a white cross with the tool icon.
# If the tool runs in [[Sketcher_Workbench#Continue_modes|continue mode]]:
# Select a single point and a single edge (in any order).
## The cursor changes to a white cross with the tool icon.
# A constraint is added.
## Select a single point and a single edge (in any order).
## Optionally keep creating constraints.
# Optionally keep creating constraints.
## To finish, right-click or press {{KEY|Esc}}, or start another geometry or constraint creation tool.
# To finish, right-click or press {{KEY|Esc}}, or start another geometry or constraint creation tool.

===Once-only mode===

# Do one of the following:
#* Select a single point and a single edge (in any order).
#* Select several points and a single edge (idem).
#* Select a single point and several edges (idem).
# Invoke the tool as explained above.
# A constraint is added.


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

Revision as of 09:40, 7 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 ConstrainPointOnObject

Menu location
Sketch → Sketcher constraints → Constrain point onto object
Workbenches
Sketcher
Default shortcut
O
Introduced in version
-
See also
Sketcher ConstrainCoincidentUnified, Sketcher ConstrainCoincident

Description

The Sketcher ConstrainPointOnObject tool fixes points on edges or axes. Lines are treated as infinite, and arcs are treated as full circles/ellipses.

introduced in version 0.22: This tool is replaced by the Sketcher ConstrainCoincidentUnified tool if the Unify Coincident and PointOnObject option is selected in the Sketcher Preferences.

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 point onto object button.
    • Select the Sketch → Sketcher constraints → Constrain point onto object option from the menu.
    • Use the keyboard shortcut: O.
  3. The cursor changes to a white cross with the tool icon.
  4. Select a single point and a single edge (in any order).
  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.

Once-only mode

  1. Do one of the following:
    • Select a single point and a single edge (in any order).
    • Select several points and a single edge (idem).
    • Select a single point and several edges (idem).
  2. Invoke the tool as explained above.
  3. A constraint is added.

Scripting

The constraint can be created from macros and from the Python console by using the following command:

Sketch.addConstraint(Sketcher.Constraint('PointOnObject',LineMoving,PointOfLineMoving,LineFixed))

  • Sketch is a sketch object.
  • LineMoving is the number that designates the line, which contains the point that has to be moved onto the LineFixed (the line which is fixed).
  • PointOfLineMoving is the number of the vertex of line LineMoving, that has to be moved onto the LineFixed.
  • LinedFixed is the number of the line to be affixed onto the point PointOfLineMoving.

The Sketcher scripting page explains how to identify the numbers that designate lines and points.