Sketcher ConstrainPointOnObject: Difference between revisions

From FreeCAD Documentation
(Marked this version for translation)
m (typo)
(40 intermediate revisions by 11 users not shown)
Line 1: Line 1:
<languages/>
<translate>
<translate>
<!--T:13-->
{{Docnav
|[[Sketcher_ConstrainCoincident|Coincident]]
|[[Sketcher_ConstrainVertical|Vertical]]
|[[Sketcher_Workbench|Sketcher]]
|IconL=Sketcher_ConstrainCoincident.svg
|IconR=Sketcher_ConstrainVertical.svg
|IconC=Workbench_Sketcher.svg
}}

<!--T:1-->
<!--T:1-->
{{GuiCommand
{{GuiCommand|Name=Constraint PointOnObject|Workbenches=[[Sketcher Workbench|Sketcher]], [[PartDesign Workbench|PartDesign]]|MenuLocation=Sketch → Sketcher constraints → Constrain point onto object|SeeAlso=[[Constraint PointOnPoint|Constraint Coincident]]}}
|Name=Sketcher ConstrainPointOnObject
|MenuLocation=Sketch → Sketcher constraints → Constrain point onto object
|Workbenches=[[Sketcher_Workbench|Sketcher]]
|Shortcut={{KEY|Shift}} + {{KEY|O}}
|SeeAlso=[[Sketcher_ConstrainCoincident|Sketcher Constrain Coincident]]
}}


====Description==== <!--T:2-->
==Description== <!--T:2-->
Affixes a point onto another object such as a line, arc, or sketch axis.


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


====Usage==== <!--T:3-->
<!--T:16-->
# Select the point you want to affix onto a line/arc/etc. ('''Result:''' Once selected the point will become green).
# 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|Point on object]]}} button in the toolbar.
#* Use the {{KEY|Shift}} + {{KEY|O}} keyboard shortcut.
#* Use the {{MenuCommand|Sketch → Sketcher constraints → Constrain point onto object}} entry in the top menu.

<!--T:7-->
'''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 == <!--T:8-->
The constraint can be created from macros and from the python console by using the following command:

<!--T:17-->
{{incode|Sketch.addConstraint(Sketcher.Constraint('PointOnObject',LineMoving,PointOfLineMoving,LineFixed))}}

<!--T:10-->
* {{incode|Sketch}} is a sketch object.
* {{incode|LineMoving}} is the number that designates the line, which contains the point that has to be moved onto the {{incode|LineFixed}} (the line which is fixed).
* {{incode|PointOfLineMoving}} is the number of the vertex of line {{incode|LineMoving}}, that has to be moved onto the {{incode|LineFixed}}.
* {{incode|LinedFixed}} is the number of the line to be affixed onto the point {{incode|PointOfLineMoving}}.

<!--T:11-->
How to identify the number that designates lines and points? Please refer to [[Scripting Sketcher constraints in Python]].

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


<!--T:4-->
{{clear}}
</translate>
</translate>
{{Sketcher Tools navi{{#translation:}}}}
<languages/>
{{Userdocnavi{{#translation:}}}}
{{clear}}

Revision as of 17:45, 19 January 2021

Sketcher ConstrainPointOnObject

Menu location
Sketch → Sketcher constraints → Constrain point onto object
Workbenches
Sketcher
Default shortcut
Shift + 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 the point you want to affix onto a line/arc/etc. (Result: Once selected the point will become green).
  2. Select the line you want affixed onto the point you have just selected (Result: Once selected the line becomes green).
  3. Invoke the Constrain point onto object tool using several methods:
    • Press the Point on object button in the toolbar.
    • Use the Shift + O keyboard shortcut.
    • Use the Sketch → Sketcher constraints → 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

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.

How to identify the number that designates lines and points? Please refer to Scripting Sketcher constraints in Python.