Arch Add: Difference between revisions

From FreeCAD Documentation
(Created page with '{{GuiCommand|Name=Arch Add|Workbenches=Arch|MenuLocation=Arch -> Add|SeeAlso=Arch Remove}} ====Description==== The Add tool allows you to do 2 kinds of oper…')
 
(Marked this version for translation)
(42 intermediate revisions by 6 users not shown)
Line 1: Line 1:
<languages/>
{{GuiCommand|Name=Arch Add|Workbenches=[[Arch Module|Arch]]|MenuLocation=Arch -> Add|SeeAlso=[[Arch Remove]]}}
<translate>
<!--T:14-->
{{docnav|[[Arch_CutPlane|Cut with plane]]|[[Arch_Remove|Remove component]]|[[Arch_Module|Arch]]|IconL=Arch_CutPlane.svg |IconC=Workbench_Arch.svg |IconR=Arch_Remove.svg}}


<!--T:1-->
====Description====
{{GuiCommand
|Name=Arch Add
|MenuLocation=Arch → Add
|Workbenches=[[Arch Module|Arch]]
|SeeAlso=[[Arch Remove|Arch Remove]]
}}


==Description== <!--T:10-->
The Add tool allows you to do 2 kinds of operations:

<!--T:2-->
The Add tool allows you to do 4 kinds of operations:
* Add [[Part Module|shape]]-based objects to an Arch component, such as a [[Arch Wall|wall]] or [[Arch Structure|structure]]. These objects make then part of the Arch component, and allow you to modify its shape but keeping its base properties such as width and height
* Add [[Part Module|shape]]-based objects to an Arch component, such as a [[Arch Wall|wall]] or [[Arch Structure|structure]]. These objects make then part of the Arch component, and allow you to modify its shape but keeping its base properties such as width and height
* Add Arch components, such as a [[Arch Wall|walls]] or [[Arch Structure|structures]], to a [[Arch Cell|cell]] or other cell-based objects such as [[Arch Floor|floors]].
* Add Arch components, such as a [[Arch Wall|walls]] or [[Arch Structure|structures]], to a group-based arch object such as [[Arch Floor|floors]].
* Add [[Arch Axis|axis systems]] to [[Arch Structure|structural objects]]
* Add objects to [[Arch SectionPlane|section planes]]

<!--T:13-->
The counterpart of this tool is the [[Arch Remove]] tool.

</translate>
[[Image:Arch Add example.jpg|640px]]
<translate>
<!--T:3-->
{{Caption|A box added to a wall as a component.}}

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

<!--T:5-->
# Select the objects to be added together. The last object selected will be the host Arch object.
# Press the {{Button|[[Image:Arch Add.svg|16px]] [[Arch Add|Add]]}} button.

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

<!--T:7-->
The Add tool can be used in [[macros]] and from the [[Python]] console by using the following function:
</translate>
{{Code|code=
addComponents(objectsList, host)
}}
<translate>

<!--T:8-->
* Adds the given objects in {{incode|objectsList}} to the given {{incode|host}} object.
** {{incode|objectsList}} can be a single object or a list of objects.

<!--T:9-->
Example:
</translate>
{{Code|code=
import FreeCAD, Arch, Draft, Part

p1 = FreeCAD.Vector(0, 0, 0)
p2 = FreeCAD.Vector(2000, 2000, 0)

Line = Draft.makeWire([p1, p2])
Wall = Arch.makeWall(Line, width=150, height=2000)

p3 = FreeCAD.Vector(0, 2000, 0)
p4 = FreeCAD.Vector(3000, 0, 0)

Line2 = Draft.makeWire([p3, p4])
Wall2 = Arch.makeWall(Line2, width=150, height=2000)
FreeCAD.ActiveDocument.recompute()


Arch.addComponents(Wall2, Wall)
[[Image:Arch Add example.jpg]]
FreeCAD.ActiveDocument.recompute()
}}
<translate>
<!--T:15-->
{{docnav|[[Arch_CutPlane|Cut with plane]]|[[Arch_Remove|Remove component]]|[[Arch_Module|Arch]]|IconL=Arch_CutPlane.svg |IconC=Workbench_Arch.svg |IconR=Arch_Remove.svg}}


<!--T:16-->
In the above image, a box is being added to a wall.
{{Arch Tools navi}}


<!--T:17-->
====Usage====
{{Userdocnavi}}
* Select the object(s) to be added, then the "host" object (the host object must be the last one you selected)
</translate>
* Press the [[Image:Arch Add.png|16px]] '''Add''' button

Revision as of 22:36, 9 February 2019

Arch Add

Menu location
Arch → Add
Workbenches
Arch
Default shortcut
None
Introduced in version
-
See also
Arch Remove

Description

The Add tool allows you to do 4 kinds of operations:

The counterpart of this tool is the Arch Remove tool.

A box added to a wall as a component.

How to use

  1. Select the objects to be added together. The last object selected will be the host Arch object.
  2. Press the Add button.

Scripting

See also: Arch API and FreeCAD Scripting Basics.

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

addComponents(objectsList, host)
  • Adds the given objects in objectsList to the given host object.
    • objectsList can be a single object or a list of objects.

Example:

import FreeCAD, Arch, Draft, Part

p1 = FreeCAD.Vector(0, 0, 0)
p2 = FreeCAD.Vector(2000, 2000, 0)

Line = Draft.makeWire([p1, p2])
Wall = Arch.makeWall(Line, width=150, height=2000)

p3 = FreeCAD.Vector(0, 2000, 0)
p4 = FreeCAD.Vector(3000, 0, 0)

Line2 = Draft.makeWire([p3, p4])
Wall2 = Arch.makeWall(Line2, width=150, height=2000)
FreeCAD.ActiveDocument.recompute()

Arch.addComponents(Wall2, Wall)
FreeCAD.ActiveDocument.recompute()