Jump to content

Curves EditableSpline

From FreeCAD Documentation

Curves EditableSpline

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

Description[edit | edit source]

The Curves EditableSpline tool creates a freehand B-spline curve.

Usage[edit | edit source]

  1. Optionally select vertices, edges and/or faces:
    • The number of the spline vertices will match the number of selected elements.
    • The spline vertices will snap to the selected vertices, and to the midpoints of the selected edges and faces.
  2. There are several ways to invoke the tool:
    • Press the Freehand BSpline button.
    • Select the Curves → Freehand BSpline option from the menu.
  3. A Freehand_BSpline object is created and set in a special edit mode.
  4. Drag the spline into the desired shape. See options below for details
  5. Press Q, or right-click the spline in the Tree View and select the Finish editing option in the context menu to exit the edit mode and finish the command.

Options[edit | edit source]

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.

Properties[edit | edit source]

See also: Property View.

A Freehand_BSpline object is derived from a Part Feature object and inherits all its properties. It also has the following additional properties:

Data[edit | edit source]

Profile

  • DataData (VectorList): Data list.
  • DataData Type (IntegerList): Types of interpolated points.
  • DataFlags (BoolList): Tangent flags.
  • DataLinear Segments (BoolList): Linear segment flags.
  • DataParametrization (FloatConstraint): Parametrization factor.
  • DataPeriodic (Bool): Periodic curve.
  • DataSupport (LinkSubList): Constraint shapes.
  • DataTangents (VectorList): Tangents list.
  • DataTolerance (Float): Tolerance.

Scripting[edit | edit source]