Curves EditableSpline: Difference between revisions

From FreeCAD Documentation
(Added notes about the modifier keys while in edit mode.)
(Moved the info from the Tips paragraph to the Usage paragraph. I hope that's OK...)
 
(18 intermediate revisions by 2 users not shown)
Line 22: Line 22:


<!--T:4-->
<!--T:4-->
The [[Image:Curves_EditableSpline.svg|24px]] [[Curves_EditableSpline|Curves EditableSpline]] creates a freehand B-Spline curve. This tool is part of the [[External_workbenches|external workbench]] called [[Curves_Workbench|Curves]].
The [[Image:Curves_EditableSpline.svg|24px]] [[Curves_EditableSpline|Curves EditableSpline]] creates a freehand B-spline curve. This tool is part of the [[External_workbenches|external workbench]] called [[Curves_Workbench|Curves]].


==Usage== <!--T:5-->
==Usage== <!--T:5-->


<!--T:6-->
<!--T:6-->
# Switch to the [[Image:Curves_workbench_icon.svg|24px]] [[Curves_Workbench|Curves]] workbench (install from [[Image:Std_AddonMgr.svg|24px]] [[Std_AddonMgr|Addon Manager]] is necessary, if not previously installed)
# Switch to the [[Image:Curves_workbench_icon.svg|24px]] [[Curves_Workbench|Curves]] workbench (install from [[Image:Std_AddonMgr.svg|24px]] [[Std_AddonMgr|Addon Manager]] is necessary, if not previously installed).
# Optionally select vertexes, edges and/or faces:
#* The number of vertexes of the spline will match the number of selected elements.
#* The spline vertexes will be snapped to the selected vertexes, and to the midpoints of the selected edges and faces.
# To invoke the command, do one of the following:
# To invoke the command, do one of the following:
#* Press the [[Image:Curves_EditableSpline.svg|24px]] button in the Curves toolbar.
#* Press the [[Image:Curves_EditableSpline.svg|24px]] button in the Curves toolbar.
#* Use the {{MenuCommand|Curves → Freehand BSpline}} entry in the dropdown menu.
#* Use the {{MenuCommand|Curves → Freehand BSpline}} entry in the dropdown menu.


==Options== <!--T:12-->


==Notes== <!--T:7-->
<!--T:13-->
While active the several actions and behaviors can be controlled by keys and mouse clicks.
During the command a special edit mode is active and there are several actions and behaviors that can be controlled by keys and mouse clicks.


<!--T:14-->
The '''''a''''' key selects or deselects all.
* To move a vertex or guide line (guide lines are the straight lines between vertexes) press and hold down the left mouse button on it, and move the mouse.

* The {{KEY|A}} key selects or deselects all vertexes and guide lines.
Clicking a vertex selects it. While selected, holding down the left mouse button and moving the the cursor will move the vertex.
* The {{KEY|I}} key will add a vertex to the segment belonging to the selected guide line. The new vertex will be selected.

* The {{KEY|T}} key sets or un-sets tangent mode for the selected vertexes or guide lines (relative to the view direction).
Clicking on a segment selects the segment (this is the straight guide line between two vertexes).
* The {{KEY|P}} key aligns selected objects.

* The {{KEY|S}} key can be used to snap a vertex to a vertex belonging to another B-spline. With a vertex of the B-spline being edited selected, hold down the {{KEY|Ctrl}} key and add the target vertex to the selection, then hit the {{KEY|S}} key. The vertexes are snapped together.
The hitting '''''i''''' key will add a vertex in this segment. The new vertex is now selected.
* To unsnap vertexes, select the snapped vertex pair and again hit the {{KEY|S}} key. The vertex of the B-spline being edited remains selected and can now be moved.

The '''''t''''' key sets or un-sets tangent (relative to view direction).
* The {{KEY|L}} key sets or un-sets the linear interpolation.
* The {{KEY|X}}, {{KEY|Y}} or {{KEY|Z}} keys can be used to constrain the movement of the object being dragged. While dragging, hit the desired axis key. Hit the same key again to disable the constraint.

* The {{KEY|Q}} key finishes the command and exits edit mode.
The '''''p''''' key aligns selected objects.

The '''''s''''' key can be used to snap a vertex to another vertex. With a vertex of the b-spline being edited selected, hold the control key down and left click the target vertex (as you would to control click multi-select). The hit the '''''s''''' key; the vertex is snapped together.

To unsnap vertexes, select the snapped vertex pair and hit the '''''s''''' key. The vertex of the b-spline being edited remains selected and can now be moved with the mouse.

The '''''l''''' key set or un-sets the linear interpolation.

The '''''x''''', '''''y''''', or '''''z''''' keys can be used to constrain the movement of the vertex while being dragged.

The '''''q''''' key exits edit mode.

Recompute is disabled during edit mode.


==Limitations== <!--T:8-->
==Limitations== <!--T:8-->

Latest revision as of 14:55, 25 February 2023

Other languages:

Curves EditableSpline

Menu location
Curves → Freehand BSpline
Workbenches
Curves
Default shortcut
None
Introduced in version
-
See also
None

Description

The Curves EditableSpline creates a freehand B-spline curve. This tool is part of the external workbench called Curves.

Usage

  1. Switch to the Curves workbench (install from Addon Manager is necessary, if not previously installed).
  2. Optionally select vertexes, edges and/or faces:
    • The number of vertexes of the spline will match the number of selected elements.
    • The spline vertexes will be snapped to the selected vertexes, and to the midpoints of the selected edges and faces.
  3. To invoke the command, do one of the following:
    • Press the button in the Curves toolbar.
    • Use the Curves → Freehand BSpline entry in the dropdown menu.

Options

During the command a special edit mode is active and there are several actions and behaviors that can be controlled by keys and mouse clicks.

  • To move a vertex or guide line (guide lines are the straight lines between vertexes) press and hold down the left mouse button on it, and move the mouse.
  • The A key selects or deselects all vertexes and guide lines.
  • The I key will add a vertex to the segment belonging to the selected guide line. The new vertex will be selected.
  • The T key sets or un-sets tangent mode for the selected vertexes or guide lines (relative to the view direction).
  • The P key aligns selected objects.
  • The S key can be used to snap a vertex to a vertex belonging to another B-spline. With a vertex of the B-spline being edited selected, hold down the Ctrl key and add the target vertex to the selection, then hit the S key. The vertexes are snapped together.
  • To unsnap vertexes, select the snapped vertex pair and again hit the S key. The vertex of the B-spline being edited remains selected and can now be moved.
  • The L key sets or un-sets the linear interpolation.
  • The X, Y or Z keys can be used to constrain the movement of the object being dragged. While dragging, hit the desired axis key. Hit the same key again to disable the constraint.
  • The Q key finishes the command and exits edit mode.

Limitations

Properties

Scripting