Sketcher ConstrainPointOnObject/en: Difference between revisions

From FreeCAD Documentation
(Importing a new version from external source)
(Updating to match new version of source page)
(17 intermediate revisions by 3 users not shown)
Line 1: Line 1:
<br />
<languages/>
{{Docnav|[[Sketcher ConstrainCoincident|Coincident]]|[[Sketcher_ConstrainVertical|Vertical]]|[[Sketcher_Workbench|Sketcher]]|IconL=Constraint_PointOnPoint.svg|IconC=Workbench_Sketcher.svg|IconR=Constraint_Vertical.svg}}


{{GuiCommand
{{GuiCommand|Name=Constraint PointOnObject|Workbenches=[[Sketcher Workbench|Sketcher]], [[PartDesign Workbench|PartDesign]]|MenuLocation=Sketch → Sketcher constraints → Constrain point onto object|Shortcut=Shift+O|SeeAlso=[[Constraint PointOnPoint|Constraint Coincident]]}}
|Name=Sketcher ConstrainPointOnObject
|Icon=Constraint_PointOnObject.svg
|Workbenches=[[Sketcher Workbench|Sketcher]]
|MenuLocation=Sketch → Sketcher constraints → Constrain point onto object
|Shortcut={{KEY|Shift}} + {{KEY|O}}
|SeeAlso=[[Sketcher ConstrainCoincident|Constrain Coincident]]
}}


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


====Usage====
==Usage==
This command affixes a point (endpoint of line/arc or center point of arc/circle) onto another object (line, arc, circle or axis).


# Select the point you want to affix onto a line/arc/etc. ('''Result:''' Once selected the point will become green).
NOTE: To constrain point on object the point has to be moved into an appropriate position.
# 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 {{KEY|[[File:Constraint_PointOnObject.svg|24px]]}} 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.


'''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.
<br />


== Scripting ==
The constraint can be created from macros and from the python console by using the following command:

{{incode|Sketch.addConstraint(Sketcher.Constraint('PointOnObject',LineMoving,PointOfLineMoving,LineFixed))}}

* {{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}}.

How to identify the number that designates lines and points? Please refer to the scripting section of [[Sketcher ConstrainCoincident#Scripting|Sketcher ConstrainCoincident]].

{{Docnav|[[Sketcher ConstrainCoincident|Coincident]]|[[Sketcher_ConstrainVertical|Vertical]]|[[Sketcher_Workbench|Sketcher]]|IconL=Constraint_PointOnPoint.svg|IconC=Workbench_Sketcher.svg|IconR=Constraint_Vertical.svg}}

{{Sketcher Tools navi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}
{{clear}}
{{clear}}
<languages/>

Revision as of 21:43, 28 March 2020

Sketcher ConstrainPointOnObject

Menu location
Sketch → Sketcher constraints → Constrain point onto object
Workbenches
Sketcher
Default shortcut
Shift + O
Introduced in version
-
See also
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 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 the scripting section of Sketcher ConstrainCoincident.