Draft Split: Difference between revisions

From FreeCAD Documentation
m (Added {{KEY}} templates)
No edit summary
(4 intermediate revisions by 2 users not shown)
Line 2: Line 2:
<translate>
<translate>
<!--T:20-->
<!--T:20-->
{{Docnav
{{Docnav|[[Draft_Join|Join]]|[[Draft_Upgrade|Upgrade]]|[[Draft_Module|Draft_Module]]|IconL=Draft_Join.svg|IconC=Workbench_Draft.svg|IconR=Draft_Upgrade.svg}}
|[[Draft_Join|Join]]
|[[Draft_Upgrade|Upgrade]]
|[[Draft_Module|Draft_Module]]
|IconL=Draft_Join.svg
|IconC=Workbench_Draft.svg
|IconR=Draft_Upgrade.svg
}}


<!--T:1-->
<!--T:1-->
Line 9: Line 16:
|MenuLocation=Draft → Split
|MenuLocation=Draft → Split
|Workbenches=[[Draft Module|Draft]]
|Workbenches=[[Draft Module|Draft]]
|Shortcut={KEY|S}} {{KEY|P}}
|Shortcut={{KEY|S}} {{KEY|P}}
|Version=0.18
|Version=0.18
|SeeAlso=[[Draft Join]]
|SeeAlso=[[Draft Join|Draft Join]]
}}
}}


Line 17: Line 24:


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


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


==Usage== <!--T:4-->
==Usage== <!--T:4-->


<!--T:5-->
<!--T:5-->
# Press the {{Button|[[Image:Draft Split.svg|16px]] [[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
# Click on a wire where you want to split it


Line 37: Line 44:


==Scripting== <!--T:8-->
==Scripting== <!--T:8-->
{{Emphasis|See also:}} [[Draft API]] and [[FreeCAD Scripting Basics]].
{{Emphasis|See also:}} [[Draft API|Draft API]] and [[FreeCAD Scripting Basics|FreeCAD Scripting Basics]].


<!--T:9-->
<!--T:9-->
The Split tool can be used in [[macros]] and from the [[Python]] console by using the following function:
The Split tool can be used in [[macros|macros]] and from the [[Python|Python]] console by using the following function:


</translate>
<!--T:22-->
{{Code|code=
{{Code|code=
split(wire, newPoint, edgeIndex)
split(wire, newPoint, edgeIndex)
}}
}}
<translate>


<!--T:19-->
<!--T:19-->
{{Docnav
{{Docnav|[[Draft_Join|Join]]|[[Draft_Upgrade|Upgrade]]|[[Draft_Module|Draft_Module]]|IconL=Draft_Join.svg|IconC=Workbench_Draft.svg|IconR=Draft_Upgrade.svg}}
|[[Draft_Join|Join]]

|[[Draft_Upgrade|Upgrade]]
<!--T:23-->
|[[Draft_Module|Draft_Module]]
{{Draft Tools navi}}
|IconL=Draft_Join.svg
|IconC=Workbench_Draft.svg
|IconR=Draft_Upgrade.svg
}}


<!--T:24-->
{{Userdocnavi}}
</translate>
</translate>
{{Draft Tools navi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}
{{clear}}
{{clear}}

Revision as of 21:33, 21 February 2020

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 wire at a specified edge or point.

The counterpart to this tool is the Draft Join operation.

Usage

  1. Press the Draft Split button or press S then P keys.
  2. Click on a wire where you want to split it

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.

Options

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

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)