Sketcher ConstrainPointOnObject: Difference between revisions

From FreeCAD Documentation
No edit summary
No edit summary
 
(75 intermediate revisions by 11 users not shown)
Line 1: Line 1:
<languages/>
{{Page_in_progress}}
<translate>
<translate>

<!--T:5-->
<!--T:13-->
<br />
{{Docnav
|[[Sketcher_ConstrainCoincident|Coincident]]
|[[Sketcher_ConstrainHorVer|Horizontal/Vertical]]
|[[Sketcher_Workbench|Sketcher]]
|IconL=Sketcher_ConstrainCoincident.svg
|IconR=Sketcher_ConstrainHorVer.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|Shortcut=Shift+O|SeeAlso=[[Constraint PointOnPoint|Constraint Coincident]]}}
|Name=Sketcher ConstrainPointOnObject
|MenuLocation=Sketch → Sketcher constraints → Constrain point onto object
|Workbenches=[[Sketcher_Workbench|Sketcher]]
|Shortcut={{KEY|O}}
|SeeAlso=[[Sketcher_ConstrainCoincidentUnified|Sketcher ConstrainCoincidentUnified]], [[Sketcher_ConstrainCoincident|Sketcher ConstrainCoincident]]
}}


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


==How to Use== <!--T:3-->
<!--T:2-->
The [[Image:Sketcher_ConstrainPointOnObject.svg|24px]] [[Sketcher_ConstrainPointOnObject|Sketcher ConstrainPointOnObject]] tool fixes points on edges or axes. Lines are treated as infinite, and open curves are virtually extended as well.
*Selct the point you want to affixe onto a line/arc/etc. (Once selected the point become green).
*Select the line you want to be affixed onto the point you have just selected (Once selected the line become green).
*Click the constraint button «point onto object » [[Image:Constraint_PointOnObject.png|32px]].


<!--T:20-->
Note : The order you select the line and point does not matter. The point will always move to line. The line remains fixed.
{{Version|0.22}}: This tool is replaced by the [[Sketcher_ConstrainCoincidentUnified|Sketcher ConstrainCoincidentUnified]] tool if the {{MenuCommand|Unify Coincident and PointOnObject}} option is selected in the [[Sketcher_Preferences#General|Sketcher Preferences]].


==Usage== <!--T:3-->
== Scripting ==
The constraint can be created from macros and from the python console by using the following command:
{{Code|code= Sketch.addConstraint(Sketcher.Constraint('PointOnObject',LineMoving,PointOfLineMoving,LineFixed))}}


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


===[[Sketcher_Workbench#Continue_modes|Continue mode]]===
* 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


<!--T:16-->
How to indentify the number that designates lines and points ? Please refer to the scripting part of [[Constraint_PointOnPoint|this wiki page]].
# Make sure there is no selection.
# There are several ways to invoke the tool:
#* 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.
#* Use the keyboard shortcut: {{KEY|O}}.
# The cursor changes to a white cross with the tool icon.
# Select a single point and a single edge (in any order).
# A constraint is added.
# Optionally keep creating constraints.
# To finish, right-click or press {{KEY|Esc}}, or start another geometry or constraint creation tool.


===Run-once mode===
<!--T:4-->

<br />
# 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.
# Depending on the selection one or more constraints are added.

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

<!--T:8-->
The constraint can be created from [[Macros|macros]] and from the [[Python|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-->
The [[Sketcher_scripting|Sketcher scripting]] page explains how to identify the numbers that designate lines and points.


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


</translate>
</translate>
{{Sketcher_Tools_navi{{#translation:}}}}
{{clear}}
{{Userdocnavi{{#translation:}}}}
<languages/>

Latest revision as of 17:38, 25 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 open curves are virtually extended as well.

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.

Run-once 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. Depending on the selection one or more constraints are 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.