Draft Join: Difference between revisions

From FreeCAD Documentation
(wires -> lines or wires)
(Added 'In progress')
(8 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{Page_in_progress}}
<languages/>
<languages/>
<translate>
<translate>

<!--T:20-->
<!--T:20-->
{{Docnav
{{Docnav
|[[Draft_SubelementHighlight|SubelementHighlight]]
|[[Draft_Trimex|Trim/Extend (Trimex)]]
|[[Draft Split|Split]]
|[[Draft_Split|Split]]
|[[Draft_Module|Draft]]
|[[Draft_Module|Draft]]
|IconL=Draft_Trimex.svg
|IconL=Draft_SubelementHighlight.svg
|IconR=Draft_Split.svg
|IconR=Draft_Split.svg
|IconC=Workbench_Draft.svg
|IconC=Workbench_Draft.svg
Line 14: Line 16:
{{GuiCommand
{{GuiCommand
|Name=Draft Join
|Name=Draft Join
|MenuLocation=Draft → Join
|MenuLocation=Modification → Join
|Workbenches=[[Draft_Module|Draft]], [[Arch_Module|Arch]]
|Workbenches=[[Draft_Module|Draft]], [[Arch_Module|Arch]]
|Shortcut={{KEY|J}} {{KEY|O}}
|Shortcut={{KEY|J}} {{KEY|O}}
Line 25: Line 27:
<!--T:3-->
<!--T:3-->
The {{Button|[[Image:Draft Join.svg|16px]] [[Draft_Join|Draft Join]]}} tool attempts to join all selected [[Draft_Line|Draft Lines]] and [[Draft_Wire|Draft Wires]] into a single wire.
The {{Button|[[Image:Draft Join.svg|16px]] [[Draft_Join|Draft Join]]}} tool attempts to join all selected [[Draft_Line|Draft Lines]] and [[Draft_Wire|Draft Wires]] into a single wire.

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


==Usage== <!--T:4-->
==Usage== <!--T:4-->
Line 43: Line 42:
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:25-->

{{Emphasis|See also:}} [[Draft API|Draft API]] and [[FreeCAD Scripting Basics|FreeCAD Scripting Basics]].
<!--T:14-->
* To join 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 Split.svg|16px]] [[Draft_Split|Draft Split]]}} 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 55: Line 62:
}}
}}
<translate>
<translate>



<!--T:19-->
<!--T:19-->
{{Docnav
{{Docnav
|[[Draft_SubelementHighlight|SubelementHighlight]]
|[[Draft_Trimex|Trim/Extend (Trimex)]]
|[[Draft Split|Split]]
|[[Draft_Split|Split]]
|[[Draft_Module|Draft]]
|[[Draft_Module|Draft]]
|IconL=Draft_Trimex.svg
|IconL=Draft_SubelementHighlight.svg
|IconR=Draft_Split.svg
|IconR=Draft_Split.svg
|IconC=Workbench_Draft.svg
|IconC=Workbench_Draft.svg
Line 69: Line 77:
{{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 Join

Menu location
Modification → Join
Workbenches
Draft, Arch
Default shortcut
J O
Introduced in version
0.18
See also
Draft Split

Description

The Draft Join tool attempts to join all selected Draft Lines and Draft Wires into a single wire.

Usage

  1. Select two or more lines or wires that you wish to join together.
  2. Press the Draft Join button or press J then O keys.

If the open end of a wire in your selection coincides with the open end of another wire in your selection, they will be joined into a single wire. The properties of the first wire in your selection will remain and the rest of the objects will be deleted.

Options

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

Notes

Scripting

See also: Autogenerated API documentation and FreeCAD Scripting Basics.

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

joinWires(wires)
joinTwoWires(wire1, wire2)