Document Sketcher 1.2 features: polyline rework, font name, constraint type display, double-click rename

wiki/Sketcher_CreatePolyline.wikitext

@@ -32,28 +32,40 @@ The [[Image:Sketcher_CreatePolyline.svg|24px]] [[Sketcher_CreatePolyline|Sketche
 <!--T:4-->
 {{Caption|Polyline started with a line, a tangent arc, a perpendicular arc then a tangent line.}}
 
+{{Version|1.2}}: The tool was reworked. It now supports [[Sketcher_Workbench#On-View-Parameters|On-View-Parameters (OVP)]], has a parameters section in the [[Sketcher_Dialog|Sketcher Dialog]] with a combobox to select the segment type and a Fillet checkbox, and applies autoconstraints (tangent, perpendicular, parallel) more reliably.
+
 ==Usage== <!--T:5-->
 
 <!--T:14-->
 See also: [[Sketcher_Workbench#Drawing_aids|Drawing aids]].
 
+Pos-OVP = Positional [[Sketcher_Preferences#General|On-View-Parameters]]. {{Version|1.0}}
+Dim-OVP = Dimensional [[Sketcher_Preferences#General|On-View-Parameters]]. {{Version|1.0}}
+
 <!--T:15-->
 # There are several ways to invoke the tool:
 #* Press the {{Button|[[Image:Sketcher_CreatePolyline.svg|16px]] [[Sketcher_CreatePolyline|Polyline]]}} button.
 #* Select the {{MenuCommand|Sketch → Geometries → [[Image:Sketcher_CreatePolyline.svg|16px]] Polyline}} option from the menu.
 #* Right-click in the [[3D_View|3D View]] and select the {{MenuCommand|[[Image:Sketcher_CreatePolyline.svg|16px]] Polyline}} option from the context menu.
 #* Use the keyboard shortcut: {{KEY|G}} then {{KEY|M}}.
 # The cursor changes to a cross with the tool icon.
+# The '''Polyline Parameters''' section is added at the top of the [[Sketcher_Dialog|Sketcher Dialog]]. {{Version|1.2}}
+# Pick the first point. Or with Pos-OVP: enter its X- and/or Y-coordinate.
+# Pick the next point. Or with Pos-OVP: enter the length and/or angle of the segment.
+# The segment is created. Applicable Pos-OVP and Dim-OVP based constraints are added.
 # The modes of the tool require a previous segment. Do one of the following:
 #* Pick two points to define a line segment.
 #* Pick the endpoint of an existing line or arc segment ([[Sketcher_Workbench#Auto_constraints|Auto constraints]] must be enabled).
-# Optionally press the {{KEY|M}} key one or more times to cycle through the modes for the next segment. The available modes are:
-#* Line perpendicular to the previous segment.
-#* Line tangential to the previous segment (this is the initial mode if the previous segment is an arc).
-#* Arc tangential to the previous segment.
-#* Arc perpendicular (left) to the previous segment.
-#* Arc perpendicular (right) to the previous segment.
-#* Line only connected to the previous segment.
+# Optionally change the mode for the next segment. There are several ways:
+#* {{Version|1.2}}: Select the desired mode from the {{MenuCommand|Type}} combobox in the Polyline Parameters section.
+#* Press the {{KEY|M}} key one or more times to cycle through the modes. The available modes are:
+#** Line perpendicular to the previous segment.
+#** Line tangential to the previous segment (this is the initial mode if the previous segment is an arc).
+#** Arc tangential to the previous segment.
+#** Arc perpendicular (left) to the previous segment.
+#** Arc perpendicular (right) to the previous segment.
+#** Line only connected to the previous segment.
+# {{Version|1.2}}: Optionally check the {{MenuCommand|Fillet}} checkbox in the Polyline Parameters section to automatically create a fillet arc at the corner between the previous and next segments.
 # While in any of the arc modes, optionally hold down the {{KEY|Ctrl}} key to snap the arc to increments of 45° relative to the previous segment.
 # Pick the endpoint of the segment.
 # Optionally repeat this to create more segments.

wiki/Sketcher_Dialog.wikitext

@@ -149,7 +149,7 @@ Available options:
 | {{MenuCommand|Red. Sketch size multiplier}}
 | The same as {{MenuCommand|Sketch size multiplier}}, but for the redundant solving.
 |-
-| {{MenuCommand|Red. Convergence}} 
+| {{MenuCommand|Red. Convergence}}
 | The same as {{MenuCommand|Convergence}}, but for the redundant solving.
 |-
 | {{MenuCommand|R.Eps/R.Eps1/R.Tau}}
@@ -169,13 +169,14 @@ Available options:
 |}
 
 ==Constraints== <!--T:17-->
-
 <!--T:34-->
 This section lists the constraints in the sketch. Unchecking a constraint in the list will hide it in the sketch. Constraints can be selected in the list as well as in the sketch.
 
 <!--T:49-->
 Constraints can also be (un)hidden with [[Image:Sketcher_SwitchVirtualSpace.svg|16px]] [[Sketcher_SwitchVirtualSpace|Sketcher SwitchVirtualSpace]].
 
+{{Version|1.2}}: The constraint type is now displayed in the constraint name in the list, for example: {{Incode|ConstraintN: Distance}} instead of just {{Incode|ConstraintN}}.
+
 <!--T:35-->
 Available options:
 
@@ -219,7 +220,7 @@ Available options:
 * {{MenuCommand|Show Constraints}}: Same as checking the constraint checkbox. But, unlike the checkbox, also works for more than one constraint.
 * {{MenuCommand|Hide Constraints}}: Same as unchecking the constraint checkbox. Idem.
 * {{MenuCommand|Select Elements}}: See [[Sketcher_SelectElementsAssociatedWithConstraints|Sketcher SelectElementsAssociatedWithConstraints]].
-* {{MenuCommand|Rename}}: Renames the constraint.
+* {{MenuCommand|Rename}}: Renames the constraint. {{Version|1.2}}: Double-clicking a geometric constraint in the list now also triggers this rename action.
 * {{MenuCommand|Center Sketch}}: Centers the 3D View around the selected constraints.
 * {{MenuCommand|Delete}}: Deletes the selected constrains. The {{KEY|Del}} key can also be used.
 * {{MenuCommand|Swap Constraint Names}}: Swaps the names of selected constraints. Only works if two constraints with user given names are selected.
@@ -308,4 +309,4 @@ Clicking the text has the same effect as clicking the first available button of
 
 </translate>
 {{Sketcher_Tools_navi{{#translation:}}}}
-{{Userdocnavi{{#translation:}}}}
+{{Userdocnavi{{#translation:}}}}

wiki/Sketcher_Preferences.wikitext

@@ -66,8 +66,8 @@ On this page you can specify the following:
 <!--T:54-->
 {{Emphasis|After changing this preference you must restart FreeCAD.}}
 
-<!--T:55-->
 |-
+<!--T:55-->
 | {{MenuCommand|Unified tool for automatic horizontal/vertical constraints}} {{Version|1.0}}
 | If checked, the [[Sketcher_ConstrainHorVer|automatic horizontal/vertical constraint tool]] is added to the toolbar (it is always available in the menu and through its shortcut), and the [[Sketcher_ConstrainHorizontal|horizontal constraint tool]] and [[Sketcher_ConstrainVertical|vertical constraint tool]] are grouped below it in a dropdown.
 
@@ -186,6 +186,9 @@ On this page you can specify the following:
 | {{MenuCommand|Font size}}
 | The font size used for the labels and constraints in the sketch.
 |-
+| {{MenuCommand|Font name}} {{Version|1.2}}
+| The font type (font family) used for the labels in the sketch. This preference controls the font face in addition to the {{MenuCommand|Font size}}.
+|-
 | {{MenuCommand|Constraint symbol size}} {{Version|1.1}}
 | Pixel size for constraint symbols.
 |-

wiki/Sketcher_Workbench.wikitext

@@ -68,6 +68,8 @@ To edit the value of an existing dimensional constraint do one of the following:
 * Double-click the constraint in the [[Sketcher_Dialog|Sketcher Dialog]].
 * Right-click the constraint in the Sketcher Dialog and select the {{MenuCommand|Change value}} option from the context menu.
 
+{{Version|1.2}}: Double-clicking a geometric constraint in the Sketcher Dialog now opens the rename dialog for that constraint.
+
 === Reposition constraints === <!--T:206-->
 
 <!--T:207-->
@@ -105,7 +107,7 @@ The Sketcher Workbench tools are located in the Sketch menu and/or several toolb
 Some tools are also available from the [[3D_View|3D View]] context menu while a sketch is in edit mode, or from the context menus of the [[Sketcher_Dialog|Sketcher Dialog]].
 
 <!--T:177-->
-If a sketch is in edit mode the Structure toolbar is hidden as none of its tools can then be used. 
+If a sketch is in edit mode the Structure toolbar is hidden as none of its tools can then be used.
 
 === General === <!--T:126-->
 
@@ -169,7 +171,7 @@ These are tools for creating objects.
 * [[Image:Sketcher_CreatePoint.svg|32px]] [[Sketcher_CreatePoint|Point]]: Creates a point.
 
 <!--T:42-->
-* [[Image:Sketcher_CreatePolyline.svg|32px]] [[Sketcher_CreatePolyline|Polyline]]: Creates a series of line and arc segments connected by their endpoints. The tool has several modes.
+* [[Image:Sketcher_CreatePolyline.svg|32px]] [[Sketcher_CreatePolyline|Polyline]]: Creates a series of line and arc segments connected by their endpoints. The tool has several modes. {{Version|1.2}}: The tool was reworked and now supports OVP, has a Polyline Parameters section (Type combobox, Fillet checkbox), and applies autoconstraints more reliably.
 
 <!--T:36-->
 * [[Image:Sketcher_CreateLine.svg|32px]] [[Sketcher_CreateLine|Line]]: Creates a line. {{Version|1.0}}: The tool has three modes.
@@ -178,7 +180,7 @@ These are tools for creating objects.
 * <span id="Sketcher_CompCreateArc">[[Image:Sketcher_CreateArc.svg|x32px]][[Image:Toolbar_flyout_arrow_blue_background.svg|x32px]] Create Arc:</span><!--Do not edit span id: the Sketcher_CompCreateArc pages redirect here-->
 
 <!--T:37-->
-:* [[Image:Sketcher_CreateArc.svg|32px]] [[Sketcher_CreateArc|Arc From Center]]: Creates an arc from its center and its endpoints. {{Version|1.0}}: Or from its endpoints and a point along the arc. 
+:* [[Image:Sketcher_CreateArc.svg|32px]] [[Sketcher_CreateArc|Arc From Center]]: Creates an arc from its center and its endpoints. {{Version|1.0}}: Or from its endpoints and a point along the arc.
 
 <!--T:38-->
 :* [[Image:Sketcher_Create3PointArc.svg|32px]] [[Sketcher_Create3PointArc|Arc From 3 Points]]: Creates an arc from its endpoints and a point along the arc. {{Version|1.0}}: This is the same tool as [[Sketcher_CreateArc|Arc From Center]] but with a different initial mode.
@@ -274,7 +276,6 @@ These are tools for creating objects.
 * [[File:Sketcher_ToggleConstruction.svg|32px]] [[Sketcher_ToggleConstruction|Toggle Construction Geometry]]: Either toggles the geometry creation tools to/from construction mode, or toggles selected geometry to/from construction geometry.
 
 ===Constraints=== <!--T:55-->
-
 <!--T:56-->
 These are tools for creating [[#Constraints|constraints]]. Some constraints require the use of [[Sketcher_helper_constraint|helper constraints]].
 
@@ -538,7 +539,6 @@ These are tools for creating [[#Constraints|constraints]]. Some constraints requ
 * [[Image:Workbench_Sketcher.svg|32px]] [[Sketcher_Preferences|Preferences]]: Preferences for the Sketcher Workbench.
 
 == Drawing aids == <!--T:211-->
-
 <!--T:212-->
 The Sketcher Workbench has several drawing aids and other features that can help when creating geometry and applying constraints.
 
@@ -711,7 +711,6 @@ Using [[Sketcher_ConstrainDistanceX|horizontal]] and [[Sketcher_ConstrainDistanc
 Using [[Sketcher_ConstrainAngle|angle dimensions]] instead of [[Sketcher_ConstrainHorizontal|horizontal]] and [[Sketcher_ConstrainVertical|vertical]] constraints can also work. The angle between edges constrained by angle dimensions will not change. 180° will not become 0°, 90° will not become 270°, etc. In the image all horizontal and vertical constraints have been replaced, but just replacing two is already effective here.
 
 == Tutorials == <!--T:19-->
-
 <!--T:121-->
 * [https://forum.freecad.org/viewtopic.php?f=36&t=30104 Sketcher Lecture] by chrisb. This is a more than 80 page PDF document that serves as a detailed manual for the Sketcher. It explains the basics of Sketcher usage, and goes into a lot of detail about the creation of geometrical shapes, and each of the constraints.
 * [[Basic_Sketcher_Tutorial|Basic Sketcher Tutorial]] for beginners
@@ -745,4 +744,4 @@ For some ideas of what can be achieved with Sketcher tools, have a look at: [[Sk
 </translate>
 {{Sketcher_Tools_navi{{#translation:}}}}
 {{Userdocnavi{{#translation:}}}}
-[[Category:Workbenches{{#translation:}}]]
+[[Category:Workbenches{{#translation:}}]]