Sketcher ConstrainPointOnObject: Difference between revisions

From FreeCAD Documentation
m (Changed section to 'Usage')
No edit summary
(13 intermediate revisions by 4 users not shown)
Line 2: Line 2:
<translate>
<translate>
<!--T:13-->
<!--T:13-->
{{Docnav
{{Docnav|[[Sketcher ConstrainCoincident|Coincident]]|[[Sketcher_ConstrainVertical|Vertical]]|[[Sketcher_Workbench|Sketcher]]|IconL=Constraint_PointOnPoint.png|IconC=Workbench_Sketcher.svg|IconR=Constraint_Vertical.png}}
|[[Sketcher_ConstrainCoincident|Coincident]]
|[[Sketcher_ConstrainVertical|Vertical]]
|[[Sketcher_Workbench|Sketcher]]
|IconL=Constraint_PointOnPoint.svg
|IconC=Workbench_Sketcher.svg
|IconR=Constraint_Vertical.svg
}}


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


Line 17: Line 24:


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

#Select the point you want to affix onto a line/arc/etc. (Once selected the point become green).
<!--T:16-->
#Select the line you want to be affixed onto the point you have just selected (Once selected the line become green).
# Select the point you want to affix onto a line/arc/etc. ('''Result:''' Once selected the point will become green).
#Press the {{KEY|[[File:Constraint_PointOnObject.png|24px]] '''Constrain point unto object'''}} button.
# 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-->
<!--T:7-->
Note : The order you select the line and point does not matter. The point will always move to line. The line remains fixed.
'''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-->
== Scripting == <!--T:8-->
The constraint can be created from macros and from the python console by using the following command:
The constraint can be created from macros and from the python console by using the following command:


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

<!--T:9-->
where :


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


<!--T:11-->
<!--T:11-->
How to identify the number that designates lines and points ? Please refer to the scripting part of [[Sketcher ConstrainCoincident]].
How to identify the number that designates lines and points? Please refer to the scripting section of [[Sketcher ConstrainCoincident#Scripting|Sketcher ConstrainCoincident]].



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

|[[Sketcher_ConstrainVertical|Vertical]]
<!--T:14-->
|[[Sketcher_Workbench|Sketcher]]
{{Sketcher Tools navi}}
|IconL=Constraint_PointOnPoint.svg

|IconC=Workbench_Sketcher.svg
<!--T:15-->
|IconR=Constraint_Vertical.svg
{{Userdocnavi}}
}}


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

Revision as of 12:36, 29 September 2020

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 the scripting section of Sketcher ConstrainCoincident.