Arch Add/en: Difference between revisions
(Importing a new version from external source) |
(Updating to match new version of source page) |
||
(17 intermediate revisions by 2 users not shown) | |||
Line 1: | Line 1: | ||
⚫ | |||
{{GuiCommand|Name=Arch Add|Workbenches=[[Arch Module|Arch]]|MenuLocation=Arch -> Add|SeeAlso=[[Arch Remove]]}} |
|||
{{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 |
|||
}} |
|||
{{GuiCommand |
|||
|Name=Arch Add |
|||
|MenuLocation=Arch → Add |
|||
|Workbenches=[[Arch Module|Arch]] |
|||
|SeeAlso=[[Arch Remove|Arch Remove]] |
|||
}} |
|||
==Description== |
==Description== |
||
The Add tool allows you to do 4 kinds of operations: |
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 {{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 [[Arch Wall| |
* 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 Axis| |
* 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]]}} |
||
The counterpart of this tool is the {{Button|[[Image:Arch_Remove.svg|16px]] [[Arch Remove|Arch Remove]]}} tool. |
|||
[[Image:Arch Add example.jpg|640px]] |
[[Image:Arch Add example.jpg|640px]] |
||
{{Caption|A box added to a wall as a component.}} |
|||
==Usage== |
|||
In the above image, a box is being added to a wall. |
|||
# Select the objects to be added together. The last object selected will be the host Arch object. |
|||
==How to use== |
|||
# 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. |
|||
# Select the object(s) to be added, then the "host" object (the host object must be the last one you selected) |
|||
# Press the {{KEY|[[Image:Arch Add.png|16px]] '''Add'''}} button |
|||
==Scripting== |
==Scripting== |
||
{{Emphasis|See also:}} [[Arch API]] and [[FreeCAD Scripting Basics]]. |
|||
The Add tool can |
The Add tool can be used in [[macros]] and from the [[Python]] console by using the following function: |
||
{{Code|code= |
:{{Code|code= |
||
addComponents |
addComponents(objectsList, host) |
||
}} |
}} |
||
* Adds the given object or the objects from the given list as components to the given host Object. Use this for example to add windows to a wall, or to add walls to a floor. |
|||
: The above code snippet adds the given objects in {{incode|objectsList}} to the given {{incode|host}} object. |
|||
* Returns nothing. |
|||
: '''Note:''' {{incode|objectsList}} can be a single object or a list of objects. |
|||
Example: |
Example: |
||
{{Code|code= |
{{Code|code= |
||
import FreeCAD, Arch, Draft, Part |
import FreeCAD, Arch, Draft, Part |
||
line = Draft.makeWire([FreeCAD.Vector(0,0,0),FreeCAD.Vector(2,2,0)]) |
|||
p1 = FreeCAD.Vector(0, 0, 0) |
|||
wall = Arch.makeWall(line) |
|||
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() |
|||
⚫ | |||
FreeCAD.ActiveDocument.recompute() |
|||
}} |
}} |
||
{{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 |
|||
}} |
|||
{{Arch Tools navi{{#translation:}}}} |
|||
{{Userdocnavi{{#translation:}}}} |
Revision as of 18:15, 19 February 2020
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:
- Add shape-based objects to an Arch component, such as a wall or 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 Walls or Arch Structures, to a group-based arch object such as Arch Floors.
- Add Axis systems to structural objects
- Add objects to section planes
The counterpart of this tool is the Arch Remove tool.
A box added to a wall as a component.
Usage
- Select the objects to be added together. The last object selected will be the host Arch object.
- Press the button, or use Arch → 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 givenhost
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()
Arch
- Elements: Wall, Structure, Curtain Wall, Window, Roof, Space, Stairs, Equipment, Frame, Fence, Truss, Profile, Pipe, Pipe Connector
- Reinforcements: Straight Rebar, U-Shape Rebar, L-Shape Rebar, Stirrup, Bent-Shape Rebar, Helical Rebar, Column Reinforcement, Beam Reinforcement, Slab Reinforcement, Footing Reinforcement, Custom Rebar
- Panels: Panel, Panel Cut, Panel Sheet, Nest
- Materials: Material, Multi-Material
- Organization: Building Part, Project, Site, Building, Level, External reference, Section Plane, Schedule
- Axes: Axis, Axes system, Grid
- Modification: Cut with plane, Add component, Remove component, Survey
- Utilities: Component, Clone component, Split Mesh, Mesh to Shape, Select non-manifold meshes, Remove Shape from Arch, Close Holes, Merge Walls, Check, Toggle IFC Brep flag, 3 Views from mesh, Create IFC spreadsheet, Toggle Subcomponents
- Additional: Preferences, Import Export Preferences (IFC, DAE, OBJ, JSON, 3DS, SHP), IfcOpenShell, IfcPlusPlus, Arch API
User documentation
- Getting started
- Installation: Download, Windows, Linux, Mac, Additional components, Docker, AppImage, Ubuntu Snap
- Basics: About FreeCAD, Interface, Mouse navigation, Selection methods, Object name, Preferences, Workbenches, Document structure, Properties, Help FreeCAD, Donate
- Help: Tutorials, Video tutorials
- Workbenches: Std Base, Arch, Assembly, CAM, Draft, FEM, Inspection, Mesh, OpenSCAD, Part, PartDesign, Points, Reverse Engineering, Robot, Sketcher, Spreadsheet, Start, Surface, TechDraw, Test Framework, Web
- Hubs: User hub, Power users hub, Developer hub