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.
|
Menu location |
---|
Curves → Split curve |
Workbenches |
Curves |
Default shortcut |
None |
Introduced in version |
- |
See also |
None |
Description
The Curves SplitCurve tool splits selected edges.
Usage
- Select one or more edges in the 3D view.
- There are several ways to invoke the tool:
- Press the
Split curve button.
- Select the Curves →
Split curve option from the menu.
- Press the
- A SplitCurve object is created for each selected edge.
- The edge is split by Number in 2 equally long curve segments by default.
- Optionally edit the values in the Property editor to activate different splitting methods by setting the related properties (see Properties below):
- Change the DataNumber property to increase the number of equally long segments,
0
or1
deactivates this splitting method. - Set the DataDistance 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 DataCutting Objects property (click on the entry field and press ... and select one or more edges and/or wires in the dialog).
- If DataCut 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. - If DataCut 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.
- If DataCut At Vertexes is
- Add distance values to the DataValues 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.
- Change the DataNumber property to increase the number of equally long segments,
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:
- By Number: Set the DataNumber property to a value greater than 1 to receive segments of equal lengths.
- Single distance: Set the DataDistance property to a value other than
0.0 mm
. - Several distances: Add distance values to the DataValues property, either absolute (mm) or relative (%).
- Cutting objects: Add cutting objects to the DataCutting Objects property,
- Intersection points: Set the DataCut 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 DataCut At Vertexes property to
true
to split where the vertices of the cutting object are projected onto the SplitCurve object.
- Intersection points: Set the DataCut At Vertexes property to
- The values of the DataValues 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
- DataSource (
LinkSub
): Edge to split.
Output
- Data (Hidden)Normalized Parameters (
FloatList
): Normalized parameters list.
Split
- DataCut At Vertexes (
Bool
): Create a split point at nearest of each vertex of the cutting objects. - DataCutting Objects (
LinkList
): List of objects that cut the curve. - DataDistance (
Distance
): Expression-ready distance value. - DataKeep Solid (
Bool
): Rebuild and output the complete shape. - DataNumber (
Integer
): Number of equal segments. - DataValues (
StringList
): List of splitting locations.- % and units are allowed.
- Negative values are computed from edge end.
This page is retrieved from https://wiki.freecad.org/Curves_SplitCurve