Draft Join: Difference between revisions

From FreeCAD Documentation
No edit summary
(Added 'In progress')
(24 intermediate revisions by 7 users not shown)
Line 1: Line 1:
{{Page_in_progress}}
<languages/>
<languages/>
<translate>
<translate>

<!--T:20-->
<!--T:20-->
{{Docnav
{{docnav|[[Draft_Trimex|Trim/Extend (Trimex)]]|[[Draft_Downgrade|Downgrade]]|[[Draft_Module|Draft_Module]]}}
|[[Draft_SubelementHighlight|SubelementHighlight]]
|[[Draft_Split|Split]]
|[[Draft_Module|Draft]]
|IconL=Draft_SubelementHighlight.svg
|IconR=Draft_Split.svg
|IconC=Workbench_Draft.svg
}}


<!--T:1-->
<!--T:1-->
{{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=J O
|Shortcut={{KEY|J}} {{KEY|O}}
|Version=0.18
|SeeAlso=[[Draft Split]]
|SeeAlso=[[Draft_Split|Draft Split]]
}}
}}


Line 16: Line 26:


<!--T:3-->
<!--T:3-->
The Join tool attempts to join all wires currently in the selection 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-->
==Usage== <!--T:4-->
The counterpart to this tool is the [[Draft Split]] operation.

==How to use== <!--T:4-->


<!--T:5-->
<!--T:5-->
# Select two or more wires that you wish to join together.
# Select two or more lines or wires that you wish to join together.
# Press the {{Button|[[Image:Draft Join.svg|16px]] [[Draft Join]]}} button or press {{KEY|J}} then {{KEY|O}} keys.
# Press the {{Button|[[Image:Draft_Join.svg|16px]] [[Draft_Join|Draft Join]]}} button or press {{KEY|J}} then {{KEY|O}} keys.


<!--T:21-->
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.
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.


Line 34: 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]] and [[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-->
The Join tool can be used in [[macros]] and from the [[Python]] console by using the following functions:
The Join tool can be used in [[Macros|macros]] and from the [[Python|Python]] console by using the following functions:


</translate>
{{Code|code=
{{Code|code=
joinWires(wires)
joinWires(wires)
joinTwoWires(wire1, wire2)
joinTwoWires(wire1, wire2)
}}
}}
<translate>



<!--T:19-->
<!--T:19-->
{{Docnav
{{docnav|[[Draft_Trimex|Trim/Extend (Trimex)]]|[[Draft_Downgrade|Downgrade]]|[[Draft_Module|Draft_Module]]}}
|[[Draft_SubelementHighlight|SubelementHighlight]]
{{Draft Tools navi}}
|[[Draft_Split|Split]]
{{Userdocnavi}}
|[[Draft_Module|Draft]]
|IconL=Draft_SubelementHighlight.svg
|IconR=Draft_Split.svg
|IconC=Workbench_Draft.svg
}}

</translate>
</translate>
{{Draft Tools navi{{#translation:}}}}
{{clear}}
{{Userdocnavi{{#translation:}}}}

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)