- GuiCommand: Name: Arch Remove MenuLocation: Arch -> Remove component Workbenches: Arch_Workbench SeeAlso: Arch_CutLine, Arch_CutPlane, Arch_Add
The Remove tools allows you to do 2 kinds of operations:
- Remove a subcomponent from an Arch object, for example remove a box that has been added to a wall, like in the Arch Add example.
- Subtract a shape-based object from an Arch component such as a ** Arch Wall ** or Arch Structure
The counterpart of this tool is the Arch Add tool.
*A box subtracted from a wall, leaving a hole in it.*- Select a subcomponent inside an Arch object.
- Press the button, or Arch → Remove from the top menu.
Or
- Select objects to be subtracted, the last object selected must the Arch object from which the other objects will be subtracted.
- Press the button, or Arch → Remove from the top menu.
See also:
Arch API and FreeCAD Scripting Basics.
The Remove tool can be used in macros and from the Python console by using the following function:
removeComponents(objectsList, host=None)
- Removes the given objects in
objectsList
from their parents. - If a
host
object is specified, this function will try adding the objects inobjectsList
as holes to thehost
.
Example:
import FreeCAD, Draft, Arch
Line = Draft.makeWire([FreeCAD.Vector(0, 0, 0),FreeCAD.Vector(2000, 2000, 0)])
Wall = Arch.makeWall(Line, width=150, height=3000)
Box = FreeCAD.ActiveDocument.addObject("Part::Box", "Box")
Box.Length = 900
Box.Width = 450
Box.Height = 2000
FreeCAD.ActiveDocument.recompute()
Draft.rotate(Box, 45)
Draft.move(Box, FreeCAD.Vector(1000, 700, 0))
Arch.removeComponents(Box, Wall)
FreeCAD.ActiveDocument.recompute()
⏵ documentation index > Arch > Arch Remove