Sketcher ConstrainPointOnObject/en: Difference between revisions

Latest revision as of 14:51, 23 April 2024

Other languages:

Coincident

Horizontal/vertical

Sketcher

Menu location
Sketcher ConstrainPointOnObject
Sketch → Sketcher constraints → Constrain point on 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 1.0: This tool is replaced by the Sketcher ConstrainCoincidentUnified tool if the Unify Coincident and PointOnObject option is selected in the preferences.

Usage

Continue mode

Make sure there is no selection.
There are several ways to invoke the tool:
- Press the Constrain point on object button.
- Select the Sketch → Sketcher constraints → Constrain point on object option from the menu.
- Use the keyboard shortcut: O.
The cursor changes to a 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 Esc, or start another geometry or constraint creation tool.

Run-once mode

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

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 on the LineFixed (the line which is fixed).
PointOfLineMoving is the number of the vertex of line LineMoving, that has to be moved on the LineFixed.
LinedFixed is the number of the line to be affixed on the point PointOfLineMoving.

The Sketcher scripting page explains how to identify the numbers that designate lines and points.

Coincident

Horizontal/vertical

Sketcher

General: Create sketch, Edit sketch, Map sketch to face, Reorient sketch, Validate sketch, Merge sketches, Mirror sketch, Leave sketch, View sketch, View section, Toggle grid, Toggle snap, Configure rendering order, Stop operation

Sketcher geometries: Point, Line, Arc, Arc by 3 points, Circle, Circle by 3 points, Ellipse, Ellipse by 3 points, Arc of ellipse, Arc of hyperbola, Arc of parabola, B-spline by control points, Periodic B-spline by control points, B-spline by knots, Periodic B-spline by knots, Polyline, Rectangle, Centered rectangle, Rounded rectangle, Triangle, Square, Pentagon, Hexagon, Heptagon, Octagon, Regular polygon, Slot, Fillet, Corner-preserving fillet, Trim, Extend, Split, External geometry, Carbon copy, Toggle construction geometry

Sketcher constraints:
- Geometric constraints: Coincident, Point on object, Vertical, Horizontal, Parallel, Perpendicular, Tangent, Equal, Symmetric, Block
- Dimensional constraints: Lock, Horizontal distance, Vertical distance, Distance, Radius or weight, Diameter, Auto radius/diameter, Angle, Refraction (Snell's law)
- Constraint tools: Toggle driving/reference constraint, Activate/deactivate constraint

Sketcher tools: Select unconstrained DoF, Select associated constraints, Select associated geometry, Select redundant constraints, Select conflicting constraints, Show/hide internal geometry, Select origin, Select horizontal axis, Select vertical axis, Symmetry, Clone, Copy, Move, Rectangular array, Remove axes alignment, Delete all geometry, Delete all constraints

Sketcher B-spline tools: Show/hide B-spline degree, Show/hide B-spline control polygon, Show/hide B-spline curvature comb, Show/hide B-spline knot multiplicity, Show/hide B-spline control point weight, Convert geometry to B-spline, Increase B-spline degree, Decrease B-spline degree, Increase knot multiplicity, Decrease knot multiplicity, Insert knot, Join curves

Sketcher virtual space: Switch virtual space

Additional: Sketcher Dialog, Preferences, Sketcher scripting

User documentation

Getting started
Installation: Download, Windows, Linux, Mac, Additional components, Docker, AppImage, Ubuntu Snap
Basics: About FreeCAD, Interface, Mouse navigation, Selection methods, Object name, Preferences, Workbenches, Document structure, Properties, Help FreeCAD, Donate

Help: Tutorials, Video tutorials
Workbenches: Std Base, Arch, Assembly, CAM, Draft, FEM, Inspection, Mesh, OpenSCAD, Part, PartDesign, Points, Reverse Engineering, Robot, Sketcher, Spreadsheet, Start, Surface, TechDraw, Test Framework, Web

Addons: Addon Manager, External workbenches, Scripting and macros

Hubs: User hub, Power users hub, Developer hub

@@ Line 1: / Line 1: @@
 <languages/>
+{{Docnav
+|[[Sketcher_ConstrainCoincident|Coincident]]
+|[[Sketcher_ConstrainHorVer|Horizontal/vertical]]
+|[[Sketcher_Workbench|Sketcher]]
+|IconL=Sketcher_ConstrainCoincident.svg
+|IconR=Sketcher_ConstrainHorVer.svg
+|IconC=Workbench_Sketcher.svg
+}}
 {{GuiCommand
 |Name=Sketcher ConstrainPointOnObject
+|MenuLocation=Sketch → Sketcher constraints → Constrain point on object
-|Workbenches=[[Sketcher Workbench|Sketcher]]
+|Workbenches=[[Sketcher_Workbench|Sketcher]]
-|MenuLocation=Sketch → Sketcher constraints → Constrain point onto object
-|Shortcut=Shift+O
+|Shortcut={{KEY|O}}
+|SeeAlso=[[Sketcher_ConstrainCoincidentUnified|Sketcher ConstrainCoincidentUnified]], [[Sketcher_ConstrainCoincident|Sketcher ConstrainCoincident]]
-|SeeAlso=[[Sketcher ConstrainCoincident|Constrain Coincident]]
 }}
 ==Description==
-Affixes a point onto another object such as a line, arc, or sketch axis.
+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.
-==How to Use==
-#Select the point you want to affix 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).
-#Press the {{KEY|[[File:Constraint_PointOnObject.png|24px]] '''Constrain point unto object'''}} button.
+{{Version|1.0}}: This tool is replaced by the [[Sketcher_ConstrainCoincidentUnified|Sketcher ConstrainCoincidentUnified]] tool if the '''Unify Coincident and PointOnObject''' option is selected in the [[Sketcher_Preferences#General|preferences]].
-Note : The order you select the line and point does not matter. The point will always move to line. The line remains fixed.
-== Scripting ==
+==Usage==
-The constraint can be created from macros and from the python console by using the following command:
+See also: [[Sketcher_Workbench#Drawing_aids|Drawing aids]].
-{{clear}}
-{{Code|code= Sketch.addConstraint(Sketcher.Constraint('PointOnObject',LineMoving,PointOfLineMoving,LineFixed))}}
+===[[Sketcher_Workbench#Continue_modes|Continue mode]]===
-where :
+# Make sure there is no selection.
-* Sketch is a sketch object
+# There are several ways to invoke the tool:
-* 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)
+#* Press the {{Button|[[Image:Sketcher_ConstrainPointOnObject.svg|16px]] [[Sketcher_ConstrainPointOnObject|Constrain point on object]]}} button.
-*PointOfLineMoving is the number of the vertex of line LineMoving, that has to be moved onto the LineFixed
+#* Select the {{MenuCommand|Sketch → Sketcher constraints → [[Image:Sketcher_ConstrainPointOnObject.svg|16px]] Constrain point on object}} option from the menu.
-*LinedFixed is the number of the line to be affixed onto the point PointOfLineMoving
+#* Use the keyboard shortcut: {{KEY|O}}.
+# The cursor changes to a 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===
-How to identify the number that designates lines and points ? Please refer to the scripting part of [[Sketcher ConstrainCoincident]].
+# 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==
+The constraint can be created from [[Macros|macros]] and from the [[Python|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 on 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 on the {{incode|LineFixed}}.
+* {{incode|LinedFixed}} is the number of the line to be affixed on the point {{incode|PointOfLineMoving}}.
+The [[Sketcher_scripting|Sketcher scripting]] page explains how to identify the numbers that designate lines and points.
+{{Docnav
+|[[Sketcher_ConstrainCoincident|Coincident]]
+|[[Sketcher_ConstrainHorVer|Horizontal/vertical]]
+|[[Sketcher_Workbench|Sketcher]]
+|IconL=Sketcher_ConstrainCoincident.svg
+|IconR=Sketcher_ConstrainHorVer.svg
+|IconC=Workbench_Sketcher.svg
+}}
+{{Sketcher_Tools_navi{{#translation:}}}}
-[[Category:Sketcher]]
+{{Userdocnavi{{#translation:}}}}
-{{clear}}