Arch Equipment

From FreeCAD Documentation
Jump to: navigation, search
Other languages:
Deutsch • ‎English • ‎español • ‎français • ‎italiano • ‎русский • ‎українська

Arch Equipment.png Arch Equipment

Menu location
Arch → Equipment
Default shortcut
See also
3 views from mesh


The Equipment tool offers you a simple and convenient way to insert non-structural, standalone elements such as pieces of furniture, hidro-sanitary equipments or electrical appliances to your projects. Equipments are based on Part shapes, which allow them to benefit from the solidity and possibilities of BRep geometry, and generate nice views when rendered to plan and section views.

Arch equipment example.jpg

As of version 0.17, equipment objects also have a HiRes property where a Mesh object can be attached. Equipment objects can then be made to display that mesh in the 3D view instead of their shape, which allows to use any high-resolution mesh objects such as detailed pieces of furniture commonly found on websites.

Arch equipment mesh.jpg

When using the Arch OBJ exporter, all equipments that are in Mesh display mode will be exported as their mesh instead of their shape.

How to use

  1. Select a Part shape, and optionally a Mesh object
  2. Press the Arch Equipment.png Arch Equipment button, or press E then Q keys


  • Equipments share the common properties and behaviours of all Arch Components


  • DATAModel: A description of the model of this equipment.
  • DATAUrl: An URL of the product page where more information about this equipment can be found.
  • DATAMesh: A Mesh representation to use for this equipment. When set, the Mesh display mode becomes available.


The Equipment tool can by used in macros and from the python console by using the following function:

makeEquipment ( baseObject ) 
  • Creates an equipment object from a base object (Mesh or Part)
  • Returns the new equipment object, or None if the operation failed.


import Part, Arch
box = Part.makeBox(2,2,2)
base = FreeCAD.ActiveDocument.addObject("Part::Feature","Box")
base.Shape = box