Sketcher ConstrainPointOnObject: Difference between revisions

From FreeCAD Documentation
m (Languages spanish)
(Marked this version for translation)
(38 intermediate revisions by 8 users not shown)
Line 1: Line 1:
<languages/>
{{GuiCommand|Name=Constraint PointOnObject|Workbenches=[[Sketcher Workbench|Sketcher]], [[PartDesign Module|PartDesign_Workbench]]|MenuLocation=Sketcher → Constrain point onto object|SeeAlso=[[Constraint coincedent]]}}
<translate>
<!--T:13-->
{{Docnav|[[Sketcher ConstrainCoincident|Coincident]]|[[Sketcher_ConstrainVertical|Vertical]]|[[Sketcher_Workbench|Sketcher]]|IconL=Constraint_PointOnPoint.svg|IconC=Workbench_Sketcher.svg|IconR=Constraint_Vertical.png}}


<!--T:1-->
====Description====
{{GuiCommand
|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== <!--T:2-->
<WRONG> This tool draws an arc by picking three points: the center, the start angle along the radius, and the end angle.
Affixes a point onto another object such as a line, arc, or sketch axis.


==Usage== <!--T:3-->
When starting the tool, the mouse pointer changes to a white cross with a red arc icon. The coordinates of the pointer are shown beside it in blue in real time.


<!--T:16-->
[[Image:Sketcher_ArcExample1.png|The center has been selected, dragging to set the radius‎]] [[Image:Sketcher_ArcExample2.png|407x360px|The center and start angle have been selected, dragging to set end angle‎]] </WRONG>
# 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 {{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.


<!--T:7-->
====Usage====
'''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-->
<WRONG> * Pick points on an empty area of the 3D view, or on an existing object (auto constraints must be active in TaskView).
The constraint can be created from macros and from the python console by using the following command:
* Pressing {{KEY|ESC}} or clicking the right mouse button cancels the function. </WRONG>


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


<!--T:10-->
{{languages | {{es|Constraint_PointOnObject/es}} }}
* {{incode|Sketch}} is a sketch object.
--[[User:Jdurston|Jdurston]] 00:32, 16 November 2011 (UTC)
* {{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 the scripting section of [[Sketcher ConstrainCoincident#Scripting|Sketcher ConstrainCoincident]].

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

<!--T:14-->
{{Sketcher Tools navi}}

<!--T:15-->
{{Userdocnavi}}

</translate>
{{clear}}

Revision as of 21:28, 14 February 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.