Sketcher ConstrainPointOnObject/pt-br: Difference between revisions

From FreeCAD Documentation
(Updating to match new version of source page)
(Updating to match new version of source page)
 
Line 3: Line 3:
{{Docnav
{{Docnav
|[[Sketcher_ConstrainCoincident|Coincident]]
|[[Sketcher_ConstrainCoincident|Coincident]]
|[[Sketcher_ConstrainHorVer|Horizontal/Vertical]]
|[[Sketcher_ConstrainHorVer|Horizontal/vertical]]
|[[Sketcher_Workbench|Sketcher]]
|[[Sketcher_Workbench|Sketcher]]
|IconL=Sketcher_ConstrainCoincident.svg
|IconL=Sketcher_ConstrainCoincident.svg
Line 22: Line 22:
==Description==
==Description==


The [[Image:Sketcher_ConstrainPointOnObject.svg|24px]] [[Sketcher_ConstrainPointOnObject|Sketcher ConstrainPointOnObject]] command fixes points on edges or axes.
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.


{{Version|0.22}}: This command is replaced by the [[Sketcher_ConstrainCoincidentUnified|Sketcher ConstrainCoincidentUnified]] command if the {{MenuCommand|Unify Coincident and PointOnObject}} option is selected in the [[Sketcher_Preferences#General|Sketcher Preferences]].
{{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]].


==Usage==
==Usage==


See also: [[Sketcher_Workbench#Drawing_aids|Drawing aids]].
# Optionally do one of the following:

===[[Sketcher_Workbench#Continue_modes|Continue mode]]===

# 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 on object]]}} button.
#* Select the {{MenuCommand|Sketch → Sketcher constraints → [[Image:Sketcher_ConstrainPointOnObject.svg|16px]] Constrain point on object}} option from the menu.
#* 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===

# Do one of the following:
#* Select a single point and a single edge (in any order).
#* Select a single point and a single edge (in any order).
#* Select several points and a single edge (idem).
#* Select several points and a single edge (idem).
#* Select a single point and several edges (idem).
#* Select a single point and several edges (idem).
# Invoke the tool as explained above.
# There are several ways to invoke the command:
# Depending on the selection one or more constraints are added.
#* 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}}.
# To indicate that the command has been activated the cursor changes to a white cross with the command icon.
# Optionally keep selecting elements. You can only select two elements at a time now.
# To finish the command press {{KEY|Esc}} or the right mouse button, or start a another constraints or geometries command.


==Scripting==
==Scripting==
Line 47: Line 59:


* {{incode|Sketch}} is a sketch object.
* {{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|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 onto the {{incode|LineFixed}}.
* {{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 onto the point {{incode|PointOfLineMoving}}.
* {{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.
The [[Sketcher_scripting|Sketcher scripting]] page explains how to identify the numbers that designate lines and points.
Line 56: Line 68:
{{Docnav
{{Docnav
|[[Sketcher_ConstrainCoincident|Coincident]]
|[[Sketcher_ConstrainCoincident|Coincident]]
|[[Sketcher_ConstrainHorVer|Horizontal/Vertical]]
|[[Sketcher_ConstrainHorVer|Horizontal/vertical]]
|[[Sketcher_Workbench|Sketcher]]
|[[Sketcher_Workbench|Sketcher]]
|IconL=Sketcher_ConstrainCoincident.svg
|IconL=Sketcher_ConstrainCoincident.svg

Latest revision as of 14:51, 23 April 2024

Constraint PointOnObject

Veja também
Sketch → Sketcher constraints → Constrain point onto object
Bancadas de trabalho
Sketcher, PartDesign
Atalho padrão
Nenhum
Introduzido na versão
-
Veja também
Constraint Coincident

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

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 on object button.
    • Select the Sketch → Sketcher constraints → Constrain point on object option from the menu.
    • Use the keyboard shortcut: O.
  3. The cursor changes to a 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 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.