Difference between revisions of "Arch Remove"

From FreeCAD Documentation
Jump to: navigation, search
(Marked this version for translation)
m (Grammer)
(4 intermediate revisions by the same user not shown)
Line 16: Line 16:
 
<!--T:3-->
 
<!--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 [[Part Module|shape]]-based object from an Arch component such as a [[Arch Wall|wall]] or [[Arch Structure|structure]]
+
* Subtract a [[Part Module|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-->
 
<!--T:13-->
The counterpart of this tool is the [[Arch Add]] tool.
+
The counterpart of this tool is the {{Button|[[Image:Arch_Add.svg|16px]] [[Arch Add|Arch Add]]}} tool.
  
 
</translate>
 
</translate>
Line 32: Line 32:
 
<!--T:7-->
 
<!--T:7-->
 
# Select a subcomponent inside an Arch object.
 
# Select a subcomponent inside an Arch object.
# Press the {{Button|[[Image:Arch Remove.svg|16px]] [[Arch Remove|Remove]]}} button.
+
# 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-->
 
<!--T:14-->
 
Or
 
Or
 
# Select objects to be subtracted, the last object selected must the Arch object from which the other objects will be subtracted.
 
# 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]] [[Arch Remove|Remove]]}} button.
+
# 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-->
 
==Scripting== <!--T:8-->

Revision as of 20:55, 20 January 2020

Other languages:
čeština • ‎Deutsch • ‎English • ‎español • ‎français • ‎italiano • ‎日本語 • ‎română • ‎русский • ‎svenska • ‎Türkçe • ‎中文(中国大陆)‎
Arrow-left.svg Previous: Arch Add.svg Add component
Next: Survey Arch Survey.svg Arrow-right.svg

Arch Remove.svg Arch Remove

Menu location
Arch → Remove
Workbenches
Arch
Default shortcut
None
Introduced in version
-
See also
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.svg Arch Add example.
  • Subtract a shape-based object from an Arch component such as a Arch Wall.svg Arch Wall or Arch Structure.svg Arch Structure

The counterpart of this tool is the Arch Add.svg Arch Add tool.

Arch Remove example.jpg

A box subtracted from a wall, leaving a hole in it.


How to use

  1. Select a subcomponent inside an Arch object.
  2. Press the Arch Remove.svg button, or ArchArch Remove.svg Remove from the top menu.

Or

  1. Select objects to be subtracted, the last object selected must the Arch object from which the other objects will be subtracted.
  2. Press the Arch Remove.svg button, or ArchArch Remove.svg 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 in objectsList as holes to the host.

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()
Arrow-left.svg Previous: Arch Add.svg Add component
Next: Survey Arch Survey.svg Arrow-right.svg