Curves SplitCurve/it

Other languages:

This documentation is not finished. Please help and contribute documentation.

GuiCommand model explains how commands should be documented. Browse Category:UnfinishedDocu to see more incomplete pages like this one. See Category:Command Reference for all commands.

See WikiPages to learn about editing the wiki pages, and go to Help FreeCAD to learn about other ways in which you can contribute.

Curves SplitCurve

Menu location
Curves → Split curve
Workbenches
Curves
Default shortcut
None
Introduced in version
-
See also
None

Descrizione

The Curves SplitCurve tool splits selected edges.

Utilizzo

  1. Select one or more edges in the 3D view.
  2. There are several ways to invoke the tool:
    • Press the Split curve button.
    • Select the Curves → Split curve option from the menu.
  3. A SplitCurve object is created for each selected edge.
    The edge is split by Number in 2 equally long curve segments by default.
  4. Optionally edit the values in the Property editor to activate different splitting methods by setting the related properties (see Properties below):
    • Change the DatiNumber property to increase the number of equally long segments, 0 or 1 deactivates this splitting method.
    • Set the DatiDistance property to split the SplitCurve object at a distance from the start vertex for positive values or from the end vertex for negative values. 0.0 mm deactivates this splitting method.
    • Load one or more cutting objects into the DatiCutting Objects property (click on the entry field and press ... and select one or more edges and/or wires in the dialog).
      1. If DatiCut At Vertexes is false the SplitCurve object will be split at the intersection points, or at the location of the shortest distance if a cutting object is neither intersecting nor tangent.
      2. If DatiCut At Vertexes is true all vertices of the cutting objects are projected on the SplitCurve object which is then split at each of the projected points.
    • Add distance values to the DatiValues property to split the SplitCurve object at several distances from the start vertex for positive values or from the end vertex for negative values (click on the entry field and press ... and enter one or more values in the dialog). Each values can either be a length or a percentage.

Notes

  • This tool also allows the selection of an object containing a wire in the Tree View as an input edge. If it contains more than one edge, all but the first one are ignored.
  • Splitting methods that independently add splitting locations to the final result:
    1. By Number: Set the DatiNumber property to a value greater than 1 to receive segments of equal lengths.
    2. Single distance: Set the DatiDistance property to a value other than 0.0 mm.
    3. Several distances: Add distance values to the DatiValues property, either absolute (mm) or relative (%).
    4. Cutting objects: Add cutting objects to the DatiCutting Objects property,
      • Intersection points: Set the DatiCut At Vertexes property to false to split at intersection points.
      • Shortest distance: As before, to split at the shortest distance when a cutting object is neither intersecting nor touching.
      • Projected points: Set the DatiCut At Vertexes property to true to split where the vertices of the cutting object are projected onto the SplitCurve object.
  • The values of the DatiValues property can also be changed by dragging the vertices in the 3D view when the SplitCurve object is in edit mode (double-click on the SplitCurve object in the Tree view to toggle).

Properties

See also: Property editor.

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

Data

Base

  • DatiSource (LinkSub): Edge to split.

Output

  • Dati (Hidden)Normalized Parameters (FloatList): Normalized parameters list.

Split

  • DatiCut At Vertexes (Bool): Create a split point at nearest of each vertex of the cutting objects.
  • DatiCutting Objects (LinkList): List of objects that cut the curve.
  • DatiDistance (Distance): Expression-ready distance value.
  • DatiKeep Solid (Bool): Rebuild and output the complete shape.
  • DatiNumber (Integer): Number of equal segments.
  • DatiValues (StringList): List of splitting locations.
    % and units are allowed.
    Negative values are computed from edge end.