Draft Split: Difference between revisions

From FreeCAD Documentation
(Fix typo)
(Added 'In progress')
(13 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{Page_in_progress}}
<languages/>
<languages/>
<translate>
<translate>

<!--T:20-->
<!--T:20-->
{{Docnav
{{Docnav
Line 14: Line 16:
{{GuiCommand
{{GuiCommand
|Name=Draft Split
|Name=Draft Split
|MenuLocation=Draft → Split
|MenuLocation=Modification → Split
|Workbenches=[[Draft_Module|Draft]]
|Workbenches=[[Draft_Module|Draft]]
|Shortcut={{KEY|S}} {{KEY|P}}
|Shortcut={{KEY|S}} {{KEY|P}}
Line 24: Line 26:


<!--T:3-->
<!--T:3-->
The {{Button|[[Image:Draft Split.svg|16px]] [[Draft_Split|Draft Split]]}} tool attempts to split an existing [[Draft_Line|Draft Line]] at a specified edge or point.
The {{Button|[[Image:Draft Split.svg|16px]] [[Draft_Split|Draft Split]]}} tool attempts to split an existing [[Draft_Wire|Draft Wire]] or [[Draft_Line|Draft Line]] at a specified edge.

<!--T:14-->
The counterpart to this tool is the {{Button|[[Image:Draft Join.svg|16px]] [[Draft Join|Draft Join]]}} operation.


==Usage== <!--T:4-->
==Usage== <!--T:4-->
Line 33: Line 32:
<!--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.
# Click on a wire where you want to split it.
# Hover over or near a wire at the point where you want to split it. The wire is highlighted. Click to split.


<!--T:21-->
<!--T:21-->
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.
If the wire is open, you will create two wires, each ending at the point at which you clicked.

<!--T:25-->
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== <!--T:6-->
==Options== <!--T:6-->
Line 43: Line 45:
There are no options for this tool. Either it works with the selected objects or not.
There are no options for this tool. Either it works with the selected objects or not.


==Scripting== <!--T:8-->
== Notes == <!--T:26-->

{{Emphasis|See also:}} [[Draft_API|Draft API]] and [[FreeCAD_Scripting_Basics|FreeCAD Scripting Basics]].
<!--T:14-->
* If an open wire is split and the clicked point does not lie exactly on the selected edge, the new point will not be collinear with that former edge. Use an appropriate [[Draft_Snap|Draft Snap]] option to prevent this.
* To split objects that are not [[Draft_Line|Draft Lines]] or [[Draft_Wire|Draft Wires]] you can try using {{Button|[[Image:Draft_Upgrade.svg|16px]] [[Draft_Upgrade|Draft Upgrade]]}} on them one or more times first.
* The counterpart to this tool is the {{Button|[[Image:Draft Join.svg|16px]] [[Draft Join|Draft Join]]}} operation.

==Scripting==

<!--T:8-->
See also: [https://www.freecadweb.org/api Autogenerated API documentation] and [[FreeCAD Scripting Basics|FreeCAD Scripting Basics]].


<!--T:9-->
<!--T:9-->
Line 54: Line 65:
}}
}}
<translate>
<translate>



<!--T:19-->
<!--T:19-->
Line 68: Line 80:
{{Draft Tools navi{{#translation:}}}}
{{Draft Tools navi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}
{{clear}}

Revision as of 19:41, 25 March 2021

This documentation is a work in progress. Please don't mark it as translatable since it will change in the next hours and days.

Draft Split

Menu location
Modification → 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 near a wire at the point 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

  • If an open wire is split and the clicked point does not lie exactly on the selected edge, the new point will not be collinear with that former edge. Use an appropriate Draft Snap option to prevent this.
  • To split objects that are not Draft Lines or Draft Wires you can try using Draft Upgrade on them one or more times first.
  • The counterpart to this tool is the Draft Join operation.

Scripting

See also: Autogenerated API documentation 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)