Arch Component

From FreeCAD Documentation
Revision as of 16:34, 9 May 2024 by Roy 043 (talk | contribs) (Marked this version for translation)

Arch Component

Menu location
Arch → Utilities → Component‎‏‎
Default shortcut
Introduced in version
See also


Creates a non-parametric Arch component from any Part-based object. This gives the Part-based object the same attributes and properties as other Arch objects, and allows to specify how it should be exported to IFC by setting its DataIfc Type property.


  1. Select a Part-based object.
  2. There are several ways to invoke the command:
    • Press the Component button.
    • Select the Arch → Utilities → Component option from the menu.
    • Use the keyboard shortcut: C then M.


The Arch component object is also a base shared by all other Arch objects (Arch Wall, Arch Structure, etc). Therefore some of its properties and behaviours are common to all Arch objects (except tools that don't produce solid objects, like Arch Section Plane or Arch Axis).



  • DataAdditions (LinkList): Arch Components have an addition property, that can hold reference to any number of other Shape-based objects. The shape of these additions will be united with the base shape of the component, to produce the final shape. See Notes.
  • DataAxis (Link): An optional axis or axis system on which this object should be duplicated.
  • DataBase (Link): Arch Components are always based on a Shape-based base object. Some types of Arch objects will just use the Base shape as is, others (for example Arch Wall) will do some additional operations on it, such as an extrusion. For some types, having a base object is not mandatory (Arch Structure).
  • DataClone Of (Link): Any Arch Component can be a clone of another Arch Component of the same type (a Wall can only be a clone of another Wall, etc.). The only exception is the generic Arch Component (as produced by this command), that can be clone of any other type (Wall, structure, window, etc). This allows to use a generic Arch Component to override the type of another one.
  • DataHi Res (Link): Arch Components can use the shape of another object as a higher-resolution version of themselves. For this, both the Hi Res property and the Hi Res display mode must be set. This allows, for example, to make a simple wall, and then model every brick that composes the wall, for example with Part Box. Then, use a compound of those bricks as a high-resolution version of the wall. The shape of the wall is not modified by adding a Hi-Res object. Only its representation in the 3D view will change by adopting the representation of the high-resolution version instead of its own.
  • DataHorizontal Area (Area): The area of the projection of this object onto the XY plane (read-only).
  • DataMaterial (Link): All Arch Components have a Material slot, that can contain either a Material or a MultiMaterial (not all Arch object type support the use of MultiMaterials). The DiffuseColor and Transparency properties of the attached material will define the Shape color and transparency of the Arch component. The material will be imported and exported to IFC, OBJ and DAE.
  • DataMove Base (Bool): Specifies if moving this object moves its base instead.
  • DataMove With Host (Bool): When a component is embedded inside another (for example a window inside a wall), setting this property to True will make the object move and rotate together when its host object is moved or rotated using Draft Move or Draft Rotate.
  • DataPerimeter Length (Length): The perimeter length of the horizontal area (read-only).
  • DataStandard Code (String): An optional standard (OmniClass, etc...) code for this component.
  • DataSubtractions (LinkList): Arch Components have an subtraction property, that can hold reference to any number of other Shape-based objects. The shape of these objects will be subtracted from the base shape of the component, to produce the final shape. See Notes.
  • DataVertical Area (Area): The area of all vertical faces of this object (read-only).


  • Data (Hidden)Ifc Data (Map):
  • Data (Hidden)Ifc Properties (Map):
  • DataIfc Type (Enumeration): Each Arch Component, besides the function defined by its type (wall, window, etc), also has a Role property, that can define further which kind of function it performs. For example, an Arch Structure can have a beam or column role. Generic Arch Components (as produced by this command) can have any role available in the whole Arch workbench. The role is what is used to define the type of IFC object to export to when exporting to IFC.

IFC Attributes

  • DataDescription (String): All Arch Components have a Description field, that can contain any text. This is used when exporting to IFC.
  • DataGlobal Id (String):
  • DataObject Type (String):
  • DataPredefined Type (Enumeration):
  • DataTag (Enumeration): The Tag property is another text field, which can be used to give an additional custom identity to objects.


  • The Placement of the Arch Component is applied after the additions and subtractions are done, so these are performed against the base object at its base location. Then the result is moved to the location of the Placement.
  • Objects can be added or removed to/from a Component's Additions and Subtractions lists by selecting both the object and the component, and using the Arch Add or Arch Remove commands, or from the task panel by double-clicking the Component in the Tree view. The task panel also allows to check which object is currently part of these lists.