Draft Split: Difference between revisions

From FreeCAD Documentation
(→‎Notes: Add note that topology objects are not directly applicable)
mNo edit summary
Line 30: Line 30:
<!--T:5-->
<!--T:5-->
# Press the {{Button|[[Image:Draft Split.svg|16px]] [[Draft Split|Draft Split]]}} button or press {{KEY|S}} then {{KEY|P}} keys.
# Press the {{Button|[[Image:Draft Split.svg|16px]] [[Draft Split|Draft Split]]}} button or press {{KEY|S}} then {{KEY|P}} keys.
# Hover over (or nearby) a wire where you want to split it. The wire is highlighted. Click to activate.
# Hover over (or nearby) a wire where you want to split it. The wire is highlighted. Click to split.


<!--T:21-->
<!--T:21-->

Revision as of 17:00, 15 February 2021

Draft Split

Menu location
Draft → Split
Workbenches
Draft
Default shortcut
S P
Introduced in version
0.18
See also
Draft Join

Description

The Draft Split tool attempts to split an existing Draft Wire or Draft Line at a specified edge.

Usage

  1. Press the Draft Split button or press S then P keys.
  2. Hover over (or nearby) a wire where you want to split it. The wire is highlighted. Click to split.

If the wire is open, you will create two wires, each ending at the point at which you clicked.

If the wire is closed, the edge which you clicked will be turned into its own open wire, and the remainder will convert into an open wire. You can think of this as "detaching" the selected wire.

Options

There are no options for this tool. Either it works with the selected objects or not.

Notes

  • The clicked point is not necessarily located on the wire (i.e., not collinear). Consequently, in this case the resulting geometry differs from the one before the command was invoked.
  • Non-editable (topology) objects of types Edge and Wire cannot be split (because they do not expose their Points). Try using Draft Upgrade on these objects first.
  • The counterpart to this tool is the Draft Join operation.

Scripting

See also: Draft API and FreeCAD Scripting Basics.

The Split tool can be used in macros and from the Python console by using the following function:

split(wire, newPoint, edgeIndex)