Sketcher ConstrainEqual: Difference between revisions
(Scripting_Sketcher_constraints_in_Python -> Sketcher_scripting) |
(V0.22 -> V1.0) |
||
(15 intermediate revisions by 2 users not shown) | |||
Line 1: | Line 1: | ||
<languages/> |
<languages/> |
||
{{Page_in_progress}} |
|||
<translate> |
<translate> |
||
<!--T:6--> |
<!--T:6--> |
||
{{Docnav |
{{Docnav |
||
Line 16: | Line 18: | ||
|MenuLocation=Sketch → Sketcher constraints → Constrain equal |
|MenuLocation=Sketch → Sketcher constraints → Constrain equal |
||
|Workbenches=[[Sketcher_Workbench|Sketcher]] |
|Workbenches=[[Sketcher_Workbench|Sketcher]] |
||
|Shortcut=E |
|Shortcut={{KEY|E}} |
||
|SeeAlso= |
|||
|SeeAlso=[[Sketcher_ConstrainRadius|Sketcher Constrain radius]] |
|||
}} |
}} |
||
Line 23: | Line 25: | ||
<!--T:4--> |
<!--T:4--> |
||
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). |
|||
The Constrain Equal constraint forces two or more line segments in a line, poly-line or rectangle to have equal length. If applied to arcs or circles the radii are constrained to be equal. It cannot be applied to geometry primitives which are not of the same type (e.g. line segments and arcs). |
|||
==Usage== |
|||
==Operation== <!--T:3--> |
|||
See also: [[Sketcher_Workbench#Drawing_aids|Drawing aids]]. |
|||
<!--T:10--> |
|||
The example sketch below contains a number of sketch primitives (line, poly-line, rectangle, arc and circle). |
|||
===[[Sketcher_Workbench#Continue_modes|Continue mode]]=== |
|||
<!--T:11--> |
|||
[[File:EqualConstraint1.png]] |
|||
<!--T:12--> |
|||
Select two or more line segments (e.g. line and one side of the rectangle). |
|||
<!--T:13--> |
|||
[[File:EqualConstraint2.png]] |
|||
<!--T:14--> |
<!--T:14--> |
||
# Make sure there is no selection. |
|||
Click on {{Button|[[File:Sketcher_ConstrainEqual.svg|16px]] [[Sketcher_ConstrainEqual|Constrain equal]]}} in the Sketcher toolbar (in either the Sketcher or Part Design workbenches) or select the Constrain Equal menu item from the Sketcher constraints sub menu item in either the Sketch or Part Design menu item depending upon which workbench is selected (Sketcher or Part Design) to apply the constraint to the selected items. |
|||
# There are several ways to invoke the tool: |
|||
⚫ | |||
<!--T:15--> |
|||
#* Select the {{MenuCommand|Sketch → Sketcher constraints → [[Image:Sketcher_ConstrainEqual.svg|16px]] Constrain equal}} option from the menu. |
|||
[[File:EqualConstraint3.png]] |
|||
#* {{Version|1.0}}: 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}}. |
|||
<!--T:16--> |
|||
# The cursor changes to a cross with the tool icon. |
|||
# Select two edges of the same type. |
|||
# A constraint is added. |
|||
<!--T:17--> |
|||
# Optionally keep creating constraints. |
|||
[[File:EqualConstraint4.png]] |
|||
# To finish, right-click or press {{KEY|Esc}}, or start another geometry or constraint creation tool. |
|||
<!--T:18--> |
|||
⚫ | |||
<!--T:19--> |
|||
[[File:EqualConstraint5.png]] |
|||
<!--T:20--> |
|||
Now select the line segment, all segments of the poly-line and one of the remaining unconstrained sides of the rectangle |
|||
<!--T:21--> |
|||
[[File:EqualConstraint6.png]] |
|||
<!--T:22--> |
|||
and apply {{Button|[[File:Sketcher_ConstrainEqual.svg|16px]] [[Sketcher_ConstrainEqual|Constrain equal]]}} as before. |
|||
<!--T:23--> |
|||
[[File:EqualConstraint7.png]] |
|||
<!--T:24--> |
|||
Select the line segment and the arc |
|||
<!--T:25--> |
|||
[[File:EqualConstraint8.png]] |
|||
===Run-once mode=== |
|||
<!--T:26--> |
|||
and apply {{Button|[[File:Sketcher_ConstrainEqual.svg|16px]] [[Sketcher_ConstrainEqual|Constrain equal]]}} as before. A pop-up message indicates that the constrained items have to be of the same geometrical type (lines of zero curvature or lines of non-zero curvature). |
|||
# Select two or more edges of the same type. |
|||
<!--T:27--> |
|||
# Invoke the tool as explained above, or with the following additional option: |
|||
[[File:EqualConstraint9.png]] |
|||
#* {{Version|1.0}}: 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--> |
== Scripting == <!--T:28--> |
||
Line 102: | Line 74: | ||
</translate> |
</translate> |
||
{{ |
{{Sketcher_Tools_navi{{#translation:}}}} |
||
{{Userdocnavi{{#translation:}}}} |
{{Userdocnavi{{#translation:}}}} |
||
{{clear}} |
Latest revision as of 09:42, 21 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 |
None |
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
- Make sure there is no selection.
- 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 1.0: Right-click in the 3D view and select the Constrain → Constrain equal option from the context menu.
- Use the keyboard shortcut: 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 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:
- introduced in version 1.0: Right-click in the 3D view and select the Constrain equal option from the context menu.
- 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.
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
- Hubs: User hub, Power users hub, Developer hub