Sketcher ConstrainEqual: Difference between revisions

From FreeCAD Documentation
(initial editing stages - lots of edits!)
 
 
(44 intermediate revisions by 12 users not shown)
Line 1: Line 1:
<languages/>
{{GuiCommand|Name=Constraint_EqualLength|Workbenches=[[Sketcher Workbench|Sketcher]], [[PartDesign Module|PartDesign_Workbench]]|MenuLocation=Sketcher → Constrain equal|SeeAlso=[[Constraint radius]]}}
{{Page_in_progress}}
<translate>


<!--T:6-->
====Description====
{{Docnav
|[[Sketcher_ConstrainTangent|Tangent]]
|[[Sketcher_ConstrainSymmetric|Symmetric]]
|[[Sketcher_Workbench|Sketcher]]
|IconL=Sketcher_ConstrainTangent.svg
|IconR=Sketcher_ConstrainSymmetric.svg
|IconC=Workbench_Sketcher.svg
}}


<!--T:1-->
<WRONG> This tool draws an arc by picking three points: the center, the start angle along the radius, and the end angle.
{{GuiCommand
|Name=Sketcher ConstrainEqual
|MenuLocation=Sketch → Sketcher constraints → Constrain equal
|Workbenches=[[Sketcher_Workbench|Sketcher]]
|Shortcut={{KEY|E}}
|SeeAlso=[[Sketcher_ConstrainRadius|Sketcher Constrain radius]]
}}


==Description== <!--T:2-->
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:4-->
[[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>
The [[Image:Sketcher_ConstrainEqual.svg|24px]] [[Sketcher_ConstrainEqual|Sketcher ConstrainEqual]] tool constrains edges to have an equal length (lines) or curvature (other edges except [[Sketcher_CreateBSpline|B-splines]]). Selected edges must have the same type. Circles and circular arcs are of the same type (their radii are made equal), and so are ellipses and elliptical arcs (their major and minor radii are made equal).


====Usage====
==Usage==


See also: [[Sketcher_Workbench#Drawing_aids|Drawing aids]].
<WRONG> * Pick points on an empty area of the 3D view, or on an existing object (auto constraints must be active in TaskView).
* Pressing {{KEY|ESC}} or clicking the right mouse button cancels the function. </WRONG>


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


<!--T:14-->
{{languages | {{es|Sketcher_Arc/es}} }}
# Make sure there is no selection.
# There are several ways to invoke the tool:
#* Press the {{Button|[[Image:Sketcher_ConstrainEqual.svg|16px]] [[Sketcher_ConstrainEqual|Constrain equal]]}} button.
#* Select the {{MenuCommand|Sketch → Sketcher constraints → [[Image:Sketcher_ConstrainEqual.svg|16px]] Constrain equal}} option from the menu.
#* {{Version|0.22}}: Right-click in the [[3D_view|3D view]] and select the {{MenuCommand|Constrain → [[Image:Sketcher_ConstrainEqual.svg|16px]] Constrain equal}} option from the context menu.
#* Use the keyboard shortcut: {{KEY|E}}.
# The cursor changes to a cross with the tool icon.
# Select two edges of the same type.
# 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===

# Select two or more edges of the same type.
# Invoke the tool as explained above, or with the following additional option:
#* {{Version|0.22}}: Right-click in the [[3D_view|3D view]] and select the {{MenuCommand|[[Image:Sketcher_ConstrainEqual.svg|16px]] Constrain equal}} option from the context menu.
# Depending on the selection one or more constraints are added.

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

</translate>
{{Code|code=Sketch.addConstraint(Sketcher.Constraint('Equal', Edge1, Edge2))}}
<translate>

<!--T:29-->
The [[Sketcher_scripting|Sketcher scripting]] page explains the values which can be used for {{incode|Edge1}} and {{incode|Edge2}} and contains further examples on how to create constraints from Python scripts.


<!--T:7-->
{{Docnav
|[[Sketcher_ConstrainTangent|Tangent]]
|[[Sketcher_ConstrainSymmetric|Symmetric]]
|[[Sketcher_Workbench|Sketcher]]
|IconL=Sketcher_ConstrainTangent.svg
|IconR=Sketcher_ConstrainSymmetric.svg
|IconC=Workbench_Sketcher.svg
}}

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

Latest revision as of 09:35, 18 April 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 ConstrainEqual

Menu location
Sketch → Sketcher constraints → Constrain equal
Workbenches
Sketcher
Default shortcut
E
Introduced in version
-
See also
Sketcher Constrain radius

Description

The Sketcher ConstrainEqual tool constrains edges to have an equal length (lines) or curvature (other edges except B-splines). Selected edges must have the same type. Circles and circular arcs are of the same type (their radii are made equal), and so are ellipses and elliptical arcs (their major and minor radii are made equal).

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 equal button.
    • Select the Sketch → Sketcher constraints → Constrain equal option from the menu.
    • introduced in version 0.22: Right-click in the 3D view and select the Constrain → Constrain equal option from the context menu.
    • Use the keyboard shortcut: E.
  3. The cursor changes to a cross with the tool icon.
  4. Select two edges of the same type.
  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. Select two or more edges of the same type.
  2. Invoke the tool as explained above, or with the following additional option:
  3. Depending on the selection one or more constraints are added.

Scripting

Sketch.addConstraint(Sketcher.Constraint('Equal', Edge1, Edge2))

The Sketcher scripting page explains the values which can be used for Edge1 and Edge2 and contains further examples on how to create constraints from Python scripts.