Difference between revisions of "Arch Add"

From FreeCAD Documentation
Jump to: navigation, search
m
 
(7 intermediate revisions by 2 users not shown)
Line 2: Line 2:
 
<translate>
 
<translate>
 
<!--T:14-->
 
<!--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}}
+
{{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-->
 
<!--T:1-->
Line 18: Line 25:
 
* Add [[Part Module|shape]]-based objects to an Arch component, such as a {{KEY|[[Image:Arch_Wall.svg|16px]] [[Arch Wall|wall]]}} or {{KEY|[[Image:Arch_Structure.svg|16px]] [[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 {{KEY|[[Image:Arch_Wall.svg|16px]] [[Arch Wall|wall]]}} or {{KEY|[[Image:Arch_Structure.svg|16px]] [[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 {{KEY|[[Image:Arch_Wall.svg|16px]] [[Arch Wall|Arch Walls]]}} or {{KEY|[[Image:Arch_Structure.svg|16px]] [[Arch Structure|Arch Structures]]}}, to a group-based arch object such as {{KEY|[[Image:Arch_Floor.svg|16px]] [[Arch Floor|Arch Floors]]}}.
 
* Add Arch components, such as a {{KEY|[[Image:Arch_Wall.svg|16px]] [[Arch Wall|Arch Walls]]}} or {{KEY|[[Image:Arch_Structure.svg|16px]] [[Arch Structure|Arch Structures]]}}, to a group-based arch object such as {{KEY|[[Image:Arch_Floor.svg|16px]] [[Arch Floor|Arch Floors]]}}.
* Add {{KEY|[[Image:Arch_Axis.svg|16px]] [[Arch Axis|Axis systems]]}} to [[Arch Structure|structural objects]]
+
* Add {{KEY|[[Image:Arch_Axis.svg|16px]] [[Arch Axis|Axis systems]]}} to {{KEY|[[Image:Arch_Structure.svg|16px]] [[Arch Structure|structural objects]]}}
* Add objects to [[Arch SectionPlane|section planes]]
+
* Add objects to {{KEY|[[Image:Arch_SectionPlane.svg|16px]] [[Arch SectionPlane|section planes]]}}
  
 
<!--T:13-->
 
<!--T:13-->
Line 30: Line 37:
 
{{Caption|A box added to a wall as a component.}}
 
{{Caption|A box added to a wall as a component.}}
  
==How to use== <!--T:4-->
+
==Usage== <!--T:4-->
  
 
<!--T:5-->
 
<!--T:5-->
 
# Select the objects to be added together. The last object selected will be the host Arch object.
 
# 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.
+
# Press the {{Button|[[Image:Arch Add.svg|16px]]}} button, or use {{KEY|Arch}} → {{KEY|[[Image:Arch Add.svg|16px]] [[Arch Add|Add]]}} from the top menu.
  
 
==Scripting== <!--T:6-->
 
==Scripting== <!--T:6-->
Line 42: Line 49:
 
The Add tool can be used in [[macros]] and from the [[Python]] console by using the following function:
 
The Add tool can be used in [[macros]] and from the [[Python]] console by using the following function:
 
</translate>
 
</translate>
{{Code|code=
+
:{{Code|code=
 
addComponents(objectsList, host)
 
addComponents(objectsList, host)
 
}}
 
}}
Line 48: Line 55:
  
 
<!--T:8-->
 
<!--T:8-->
* Adds the given objects in {{incode|objectsList}} to the given {{incode|host}} object.
+
: The above code snippet 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.
+
: '''Note:''' {{incode|objectsList}} can be a single object or a list of objects.
  
 
<!--T:9-->
 
<!--T:9-->
 
Example:
 
Example:
 +
 
</translate>
 
</translate>
 
{{Code|code=
 
{{Code|code=
Line 74: Line 82:
 
}}
 
}}
 
<translate>
 
<translate>
 +
 
<!--T:15-->
 
<!--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}}
+
{{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-->
+
</translate>
{{Arch Tools navi}}
+
{{Arch Tools navi{{#translation:}}}}
  
<!--T:17-->
+
{{Userdocnavi{{#translation:}}}}
{{Userdocnavi}}
 
</translate>
 

Latest revision as of 19:14, 19 February 2020

Other languages:
čeština • ‎Deutsch • ‎English • ‎español • ‎français • ‎italiano • ‎日本語 • ‎română • ‎русский • ‎svenska • ‎Türkçe • ‎中文(中国大陆)‎

Arch Add.svg 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.svg Arch Remove tool.

Arch Add example.jpg

A box added to a wall as a component.


Usage

  1. Select the objects to be added together. The last object selected will be the host Arch object.
  2. Press the Arch Add.svg button, or use ArchArch Add.svg Add from the top menu.

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)
The above code snippet adds the given objects in objectsList to the given host object.
Note: 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()