Arch Remove: Difference between revisions
(Created page with '{{GuiCommand|Name=Arch Remove|Workbenches=Arch|MenuLocation=Arch -> Remove|SeeAlso=Arch Add}} ====Description==== The Remove tools allows you to do 2 kinds …') |
(Docnav) |
||
(41 intermediate revisions by 9 users not shown) | |||
Line 1: | Line 1: | ||
<languages/> |
|||
{{GuiCommand|Name=Arch Remove|Workbenches=[[Arch Module|Arch]]|MenuLocation=Arch -> Remove|SeeAlso=[[Arch Add]]}} |
|||
<translate> |
|||
<!--T:12--> |
|||
⚫ | |||
{{Docnav |
|||
|[[Arch_Add|Add]] |
|||
|[[Arch_Survey|Survey]] |
|||
|[[Arch_Workbench|Arch]] |
|||
|IconL=Arch_Add.svg |
|||
|IconR=Arch_Survey.svg |
|||
|IconC=Workbench_Arch.svg |
|||
}} |
|||
<!--T:1--> |
|||
{{GuiCommand |
|||
|Name=Arch Remove |
|||
|MenuLocation=Arch → Remove component |
|||
|Workbenches=[[Arch_Workbench|Arch]] |
|||
|SeeAlso=[[Arch_CutLine|Arch CutLine]], [[Arch_CutPlane|Arch CutPlane]], [[Arch_Add|Arch Add]] |
|||
}} |
|||
⚫ | |||
<!--T:3--> |
|||
The Remove tools allows you to do 2 kinds of operations: |
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 |
* Remove a subcomponent from an Arch object, for example remove a box that has been added to a wall, like in the {{Button|[[Image:Arch_Add.svg|16px]] [[Arch_Add|Arch Add]]}} example. |
||
* Subtract a [[ |
* Subtract a [[Part_Workbench|shape]]-based object from an Arch component such as a {{KEY|[[Image:Arch_Wall.svg|16px]] [[Arch_Wall|Arch Wall]]}} or {{KEY|[[Image:Arch_Structure.svg|16px]] [[Arch_Structure|Arch Structure]]}} |
||
<!--T:13--> |
|||
The counterpart of this tool is the {{Button|[[Image:Arch_Add.svg|16px]] [[Arch_Add|Arch Add]]}} tool. |
|||
</translate> |
|||
⚫ | |||
<translate> |
|||
<!--T:5--> |
|||
{{Caption|A box subtracted from a wall, leaving a hole in it.}} |
|||
⚫ | |||
<!--T:7--> |
|||
⚫ | |||
# Press the {{Button|[[Image:Arch_Remove.svg|16px]]}} button, or {{KEY|Arch}} → {{KEY|[[Image:Arch_Remove.svg|16px]] [[Arch_Remove|Remove]]}} from the top menu. |
|||
<!--T:14--> |
|||
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|[[Image:Arch_Remove.svg|16px]]}} button, or {{KEY|Arch}} → {{KEY|[[Image:Arch_Remove.svg|16px]] [[Arch_Remove|Remove]]}} from the top menu. |
|||
==Scripting== <!--T:8--> |
|||
{{Emphasis|See also:}} [[Arch_API|Arch API]] and [[FreeCAD_Scripting_Basics|FreeCAD Scripting Basics]]. |
|||
<!--T:9--> |
|||
The Remove tool can be used in [[Macros|macros]] and from the [[Python|Python]] console by using the following function: |
|||
</translate> |
|||
{{Code|code= |
|||
removeComponents(objectsList, host=None) |
|||
}} |
|||
<translate> |
|||
<!--T:10--> |
|||
* Removes the given objects in {{incode|objectsList}} from their parents. |
|||
* If a {{incode|host}} object is specified, this function will try adding the objects in {{incode|objectsList}} as holes to the {{incode|host}}. |
|||
<!--T:15--> |
|||
Example: |
|||
</translate> |
|||
{{Code|code= |
|||
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() |
|||
}} |
|||
<translate> |
|||
⚫ | |||
<!--T:16--> |
|||
In the above image, a box is being subtracted from a wall |
|||
{{Docnav |
|||
|[[Arch_Add|Add]] |
|||
|[[Arch_Survey|Survey]] |
|||
|[[Arch_Workbench|Arch]] |
|||
|IconL=Arch_Add.svg |
|||
|IconR=Arch_Survey.svg |
|||
|IconC=Workbench_Arch.svg |
|||
}} |
|||
</translate> |
|||
⚫ | |||
{{Arch Tools navi{{#translation:}}}} |
|||
⚫ | |||
{{Userdocnavi{{#translation:}}}} |
|||
* Select object(s) to be subtracted, then the Arch component from which they must be subtracted (the arch component must be the last thing you selected) |
|||
* Press the [[Image:Arch Remove.png|16px]] '''Remove''' button |
Latest revision as of 14:57, 9 March 2022
Arch Remove |
Menu location |
---|
Arch → Remove component |
Workbenches |
Arch |
Default shortcut |
None |
Introduced in version |
- |
See also |
Arch CutLine, Arch CutPlane, Arch Add |
Description
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.
Usage
- 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.
Scripting
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()
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, Surface, TechDraw, Test Framework
- Hubs: User hub, Power users hub, Developer hub