Draft Join: Difference between revisions

From FreeCAD Documentation
No edit summary
No edit summary
(11 intermediate revisions by 3 users not shown)
Line 2: Line 2:
<translate>
<translate>
<!--T:20-->
<!--T:20-->
{{Docnav
{{docnav|[[Draft_Trimex|Trim/Extend (Trimex)]]|[[Draft_Downgrade|Downgrade]]|[[Draft_Module|Draft_Module]]}}
|[[Draft_Trimex|Trim/Extend (Trimex)]]
|[[Draft Split|Split]]
|[[Draft_Module|Draft]]
|IconL=Draft_Trimex.svg
|IconC=Workbench_Draft.svg
|IconR=Draft_Split.svg
}}


<!--T:1-->
<!--T:1-->
Line 9: Line 16:
|MenuLocation=Draft → Join
|MenuLocation=Draft → 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 24:


<!--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 wires currently in the selection into a single wire.


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


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


<!--T:5-->
<!--T:5-->
# Select two or more wires that you wish to join together.
# Select two or more 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 35: 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 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_Trimex|Trim/Extend (Trimex)]]
{{Draft Tools navi}}
|[[Draft Split|Split]]
{{Userdocnavi}}
|[[Draft_Module|Draft]]
|IconL=Draft_Trimex.svg
|IconC=Workbench_Draft.svg
|IconR=Draft_Split.svg
}}

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

Revision as of 18:14, 21 February 2020

Draft Join

Menu location
Draft → 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 wires currently in the selection into a single wire.

The counterpart to this tool is the Draft Split operation.

Usage

  1. Select two or more 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.

Scripting

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