Sketcher ConstrainPointOnObject/en: Difference between revisions

From FreeCAD Documentation
(Updating to match new version of source page)
(Updating to match new version of source page)
Line 23: Line 23:
==Usage==
==Usage==


# Select a point and an edge in any order.
# Select the point you want to affix onto a line/arc/etc. ('''Result:''' Once selected the point will become green).
# There are several ways to invoke the command:
# Select the line you want affixed onto the point you have just selected ('''Result:''' Once selected the line becomes green).
# Invoke the '''Constrain point onto object''' tool using several methods:
#* Press the {{Button|[[File:Sketcher_ConstrainPointOnObject.svg|16px]] [[Sketcher_ConstrainPointOnObject|Constrain point onto object]]}} button in the toolbar.
#* Press the {{Button|[[File:Sketcher_ConstrainPointOnObject.svg|16px]] [[Sketcher_ConstrainPointOnObject|Constrain point onto object]]}} button in the toolbar.
#* Use the {{KEY|O}} keyboard shortcut.
#* Use the {{KEY|O}} keyboard shortcut.
#* Use the {{MenuCommand|Sketch → Sketcher constraints → [[File:Sketcher_ConstrainPointOnObject.svg|16px]] Constrain point onto object}} entry in the top menu.
#* Use the {{MenuCommand|Sketch → Sketcher constraints → [[File:Sketcher_ConstrainPointOnObject.svg|16px]] Constrain point onto object}} entry in the top menu.

'''Note:''' The order you select the line and point does not matter. The point will always move to line. In other words, the line remains fixed.


==Scripting==
==Scripting==

Revision as of 21:10, 20 March 2022

Sketcher ConstrainPointOnObject

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

Description

Affixes a point onto another object such as a line, arc, or sketch axis.

Usage

  1. Select a point and an edge in any order.
  2. There are several ways to invoke the command:
    • Press the Constrain point onto object button in the toolbar.
    • Use the O keyboard shortcut.
    • Use the Sketch → Sketcher constraints → Constrain point onto object entry in the top menu.

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.