Arch Building: Difference between revisions

From FreeCAD Documentation
m (Changed section to 'Usage')
m ([[ | ]](Vertical Docnav))
Line 2: Line 2:
<translate>
<translate>
<!--T:15-->
<!--T:15-->
{{docnav
{{docnav|[[Arch_BuildingPart|Building Part]]|[[Arch_Site|Site]]|[[Arch_Module|Arch]]|IconL=Arch_BuildingPart.svg |IconC=Workbench_Arch.svg |IconR=Arch_Site.svg}}
|[[Arch_BuildingPart|Building Part]]
|[[Arch_Site|Site]]|[[Arch_Module|Arch]]
|IconL=Arch_BuildingPart.svg
|IconC=Workbench_Arch.svg
|IconR=Arch_Site.svg
}}


<!--T:1-->
<!--T:1-->
Line 10: Line 16:
|Workbenches=[[Arch Module|Arch]]
|Workbenches=[[Arch Module|Arch]]
|Shortcut=B U
|Shortcut=B U
|SeeAlso=[[Arch BuildingPart]], [[Arch Site]]
|SeeAlso=[[Arch BuildingPart|Arch BuildingPart]], [[Arch Site|Arch Site]]
}}
}}


Line 22: Line 28:
<!--T:5-->
<!--T:5-->
# Optionally, select one or more objects to be included in your new building.
# Optionally, select one or more objects to be included in your new building.
# Press the {{Button|[[Image:Arch Building.svg|16px]] [[Arch Building]]}} button, or press the {{KEY|B}} then {{KEY|U}} keys.
# Press the {{Button|[[Image:Arch Building.svg|16px]] [[Arch Building|Arch Building]]}} button, or press the {{KEY|B}} then {{KEY|U}} keys.


==Options== <!--T:6-->
==Options== <!--T:6-->
Line 28: Line 34:
<!--T:7-->
<!--T:7-->
* Starting from FreeCAD version 0.18, the Building object is actually a [[Arch BuildingPart|BuildingPart]] with its {{PropertyData|IFC role}} property set to "Building". You can convert any BuildingPart to a Building simply by changing its IFC role.
* Starting from FreeCAD version 0.18, the Building object is actually a [[Arch BuildingPart|BuildingPart]] with its {{PropertyData|IFC role}} property set to "Building". You can convert any BuildingPart to a Building simply by changing its IFC role.
* After creating a building, you can add more objects to it by drag and dropping them in the Tree View or by using the {{Button|[[Image:Arch Add.svg|16px]] [[Arch Add]]}} tool.
* After creating a building, you can add more objects to it by drag and dropping them in the Tree View or by using the {{Button|[[Image:Arch Add.svg|16px]] [[Arch Add|Arch Add]]}} tool.
* You can remove objects from a building by drag and dropping them out of it the Tree View or by using the {{Button|[[Image:Arch Remove.svg|16px]] [[Arch Remove]]}} tool.
* You can remove objects from a building by drag and dropping them out of it the Tree View or by using the {{Button|[[Image:Arch Remove.svg|16px]] [[Arch Remove|Arch Remove]]}} tool.


==Properties== <!--T:12-->
==Properties== <!--T:12-->
Line 37: Line 43:


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


<!--T:9-->
<!--T:9-->
The Building tool can be used in [[macros]] and from the [[Python]] console by using the following function:
The Building tool can be used in [[macros|macros]] and from the [[Python|Python]] console by using the following function:
</translate>
</translate>
{{Code|code=
{{Code|code=
Line 72: Line 78:
<translate>
<translate>
<!--T:14-->
<!--T:14-->
{{docnav
{{docnav|[[Arch_BuildingPart|Building Part]]|[[Arch_Site|Site]]|[[Arch_Module|Arch]]|IconL=Arch_BuildingPart.svg |IconC=Workbench_Arch.svg |IconR=Arch_Site.svg}}
|[[Arch_BuildingPart|Building Part]]
|[[Arch_Site|Site]]
|[[Arch_Module|Arch]]
|IconL=Arch_BuildingPart.svg
|IconC=Workbench_Arch.svg
|IconR=Arch_Site.svg
}}


<!--T:16-->
<!--T:16-->

Revision as of 14:38, 3 February 2020

Other languages:

Arch Building

Menu location
Arch → Building
Workbenches
Arch
Default shortcut
B U
Introduced in version
-
See also
Arch BuildingPart, Arch Site

Description

The Arch Building is a special type of FreeCAD group object particularly suited for representing a whole building unit. They are mostly used to organize your model, by containing floor objects.

Usage

  1. Optionally, select one or more objects to be included in your new building.
  2. Press the Arch Building button, or press the B then U keys.

Options

  • Starting from FreeCAD version 0.18, the Building object is actually a BuildingPart with its DataIFC role property set to "Building". You can convert any BuildingPart to a Building simply by changing its IFC role.
  • After creating a building, you can add more objects to it by drag and dropping them in the Tree View or by using the Arch Add tool.
  • You can remove objects from a building by drag and dropping them out of it the Tree View or by using the Arch Remove tool.

Properties

  • DataBuilding Type: The type of this building, to choose from a list

Scripting

See also: Arch API and FreeCAD Scripting Basics.

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

Building = makeBuilding(objectslist=None, baseobj=None, name="Building")
  • Creates a Building object from objectslist, which is a list of objects, or baseobj, which is a Shape.

Example: 

import FreeCAD, Draft, Arch

p1 = FreeCAD.Vector(0, 0, 0)
p2 = FreeCAD.Vector(2000, 0, 0)
baseline = Draft.makeLine(p1, p2)
baseline2 = Draft.makeLine(p1, -1*p2)

Wall1 = Arch.makeWall(baseline, length=None, width=150, height=2000)
Wall2 = Arch.makeWall(baseline2, length=None, width=150, height=1800)
FreeCAD.ActiveDocument.recompute()

Building = Arch.makeBuilding([Wall1, Wall2])

Site = Arch.makeSite(Building)
FreeCAD.ActiveDocument.recompute()
Arch
User documentation
Retrieved from "http://wiki.freecad.org/index.php?title=Arch_Building&oldid=596876"