Arch Wall: Difference between revisions
m (|IconR=Arch_Structure.png) |
(Add Override Width info from tooltip in the code. Fixed some typos, but the text needs refining.) |
||
(29 intermediate revisions by 9 users not shown) | |||
Line 1: | Line 1: | ||
<languages/> |
<languages/> |
||
<translate> |
<translate> |
||
<!--T:28--> |
<!--T:28--> |
||
{{Docnav |
|||
{{docnav| |[[Arch_Structure|Arch Structure]]|[[Arch_Module|Arch Module]]|IconR=Arch_Structure.png}} |
|||
| |
|||
|[[Arch_Structure|Structure]] |
|||
|[[Arch_Workbench|Arch]] |
|||
| |
|||
|IconR=Arch_Structure.svg |
|||
|IconC=Workbench_Arch.svg |
|||
}} |
|||
<!--T:1--> |
<!--T:1--> |
||
Line 8: | Line 16: | ||
|Name=Arch Wall |
|Name=Arch Wall |
||
|MenuLocation=Arch → Wall |
|MenuLocation=Arch → Wall |
||
|Workbenches=[[ |
|Workbenches=[[Arch_Workbench|Arch]] |
||
|Shortcut=W A |
|Shortcut={{KEY|W}} {{KEY|A}} |
||
|SeeAlso=[[ |
|SeeAlso=[[Arch_Structure|Arch Structure]] |
||
}} |
}} |
||
Line 16: | Line 24: | ||
<!--T:3--> |
<!--T:3--> |
||
This tool builds a Wall object from scratch or on top of any other [[Part |
This tool builds a Wall object from scratch or on top of any other [[Part Workbench|shape]]-based or [[Mesh Workbench|mesh]]-based object. A wall can be built without any base object, in which case it behaves as a cubic volume, using length, width and height properties. When built on top of an existing shape, a wall can be based on: |
||
<!--T:4--> |
<!--T:4--> |
||
Line 31: | Line 39: | ||
<!--T:6--> |
<!--T:6--> |
||
Walls can also have additions or subtractions. Additions are other objects whose shapes are joined in this Wall's shape, while subtractions are subtracted. Additions and subtractions can be added with the [[Arch Add]] and [[Arch Remove]] tools. Additions and subtractions have no influence over wall parameters such as height and width, which can still be changed. Walls can also have their height automatic, if they are included into a higher-level object such as [[Arch Floor|floors]]. The height must be kept at 0, then the wall will adopt the height specified in the parent object. |
Walls can also have additions or subtractions. Additions are other objects whose shapes are joined in this Wall's shape, while subtractions are subtracted. Additions and subtractions can be added with the [[Arch Add|Arch Add]] and [[Arch Remove|Arch Remove]] tools. Additions and subtractions have no influence over wall parameters such as height and width, which can still be changed. Walls can also have their height automatic, if they are included into a higher-level object such as [[Arch Floor|floors]]. The height must be kept at 0, then the wall will adopt the height specified in the parent object. |
||
<!--T:7--> |
<!--T:7--> |
||
When several walls should intersect, you need to place them into a [[Arch Floor|floor]] to have their geometry intersected. |
When several walls should intersect, you need to place them into a [[Arch Floor|floor]] to have their geometry intersected. |
||
== |
==Usage== <!--T:8--> |
||
===Drawing a wall from scratch=== <!--T:9--> |
===Drawing a wall from scratch=== <!--T:9--> |
||
<!--T:10--> |
<!--T:10--> |
||
# Press the {{Button|[[Image:Arch Wall.svg|16px]] [[Arch Wall]]}} button, or press {{KEY|W}} then {{KEY|A}} keys |
# Press the {{Button|[[Image:Arch Wall.svg|16px]] [[Arch Wall|Arch Wall]]}} button, or press {{KEY|W}} then {{KEY|A}} keys. |
||
# Click a first point on the 3D view, or type |
# Click a first point on the 3D view, or type coordinates. |
||
# Click a second point on the 3D view, or type |
# Click a second point on the 3D view, or type coordinates. |
||
===Drawing a wall on top of a selected object=== <!--T:11--> |
===Drawing a wall on top of a selected object=== <!--T:11--> |
||
Line 49: | Line 57: | ||
<!--T:12--> |
<!--T:12--> |
||
# Select one or more base geometry objects (Draft object, sketch, etc) |
# Select one or more base geometry objects (Draft object, sketch, etc) |
||
# Press the {{Button|[[Image:Arch Wall.svg|16px]] [[Arch Wall]]}} button, or press the {{KEY|W}} then {{KEY|A}} keys |
# Press the {{Button|[[Image:Arch Wall.svg|16px]] [[Arch Wall|Arch Wall]]}} button, or press the {{KEY|W}} then {{KEY|A}} keys |
||
# Adjust needed properties such as height or width. |
# Adjust needed properties such as height or width. |
||
Line 66: | Line 74: | ||
* Multi-layer walls can be easily created by building several walls from the same baseline. By setting their Align property to either left or right, and specifying an Offset value, you can effectively construct several wall layers. Placing a window in such a wall layer will propagate the opening to the other wall layers based on the same baseline. |
* Multi-layer walls can be easily created by building several walls from the same baseline. By setting their Align property to either left or right, and specifying an Offset value, you can effectively construct several wall layers. Placing a window in such a wall layer will propagate the opening to the other wall layers based on the same baseline. |
||
* Walls can also make use of [[Arch MultiMaterial|Multi-Materials]]. When using a multi-material, the wall will become multi-layer, using the thicknesses specified by the multi-material. Any layer with a thickness of zero will have its thickness defined automatically by the remaining space defined by the Wall's Width value, after subtracting the other layers. |
* Walls can also make use of [[Arch MultiMaterial|Multi-Materials]]. When using a multi-material, the wall will become multi-layer, using the thicknesses specified by the multi-material. Any layer with a thickness of zero will have its thickness defined automatically by the remaining space defined by the Wall's Width value, after subtracting the other layers. |
||
* Walls can be made to display blocks, instead of one single solid, by turning their {{PropertyData|Make Blocks}} property on. The size and offset of blocks can be configured with different properties, and the amount of blocks is automatically calculated. |
* Walls can be made to display blocks, instead of one single solid, by turning their {{PropertyData|Make Blocks}} property on. The size and offset of blocks can be configured with different properties, and the amount of blocks is automatically calculated. |
||
==Snapping== <!--T:15--> |
==Snapping== <!--T:15--> |
||
Line 81: | Line 89: | ||
==Properties== <!--T:17--> |
==Properties== <!--T:17--> |
||
<!--T: |
<!--T:33--> |
||
Wall objects inherit the properties of [[Part |
Wall objects inherit the properties of [[Part Workbench|Part]] objects, and also have the following extra properties: |
||
⚫ | |||
⚫ | |||
⚫ | |||
* {{PropertyData|Force Wire}}: If True, and the wall is based on a face, only the border wire of the face is used, resulting in a wall bordering the face |
|||
⚫ | |||
* {{PropertyData|Width}}: The width of the wall (not used when the wall is based on a face) |
|||
⚫ | |||
⚫ | |||
⚫ | |||
<!--T: |
===Data=== <!--T:34--> |
||
{{Version|0.18}}: |
|||
<!--T:35--> |
|||
{{TitleProperty|Blocks}} |
|||
<!--T:25--> |
<!--T:25--> |
||
* {{PropertyData| |
* {{PropertyData|Block Height}}: The height of each block. |
||
* {{PropertyData|Block Length}}: The length of each block |
* {{PropertyData|Block Length}}: The length of each block. |
||
* {{PropertyData| |
* {{PropertyData|Count Broken}}: The number of broken blocks (read-only). |
||
* {{PropertyData| |
* {{PropertyData|Count Entire}}: The number of entire blocks (read-only). |
||
* {{PropertyData| |
* {{PropertyData|Joint}}: The size of the joints, the empty space, between blocks. |
||
* {{PropertyData| |
* {{PropertyData|Make Blocks}}: Enables block generation. |
||
* {{PropertyData| |
* {{PropertyData|Offset First}}: The horizontal offset of the first and every uneven line of blocks. |
||
* {{PropertyData| |
* {{PropertyData|Offset Second}}: The horizontal offset of the second and every even line of blocks. |
||
<!--T:36--> |
|||
{{TitleProperty|Component}} |
|||
⚫ | |||
<!--T:37--> |
|||
⚫ | |||
<!--T:38--> |
|||
{{TitleProperty|Wall}} |
|||
<!--T:18--> |
|||
⚫ | |||
* {{PropertyData|Area}}: Area of the whole wall, separation into blocks makes no difference (read-only). |
|||
⚫ | |||
⚫ | |||
* {{PropertyData|Length}}: The length of the wall. Read-only if the wall is not based on an unconstrained sketch with a single edge, or on a [[Draft_Wire|Draft Wire]] with a single edge. |
|||
⚫ | |||
⚫ | |||
* {{PropertyData|Override Align}}: |
|||
* {{PropertyData|Override Width}}: This overrides the {{PropertyData|Width}} attribute to set the width of each wall segment. Ignored if the {{PropertyData|Base}} object provides Widths information with the getWidths() method. (The 1st value overrides the 'Width' attribute for the 1st segment of wall; if a value is zero, 1st value of 'OverrideWidth' will be followed)")) |
|||
⚫ | |||
==Scripting== <!--T:32--> |
|||
<!--T:19--> |
|||
⚫ | |||
<!--T:20--> |
<!--T:20--> |
||
The Wall tool can be used in [[macros]] and from the [[Python]] console by using the following function: |
The Wall tool can be used in [[Macros|macros]] and from the [[Python|Python]] console by using the following function: |
||
</translate> |
</translate> |
||
{{Code|code= |
{{Code|code= |
||
Line 126: | Line 151: | ||
<!--T:22--> |
<!--T:22--> |
||
Example: |
Example: |
||
</translate> |
</translate> |
||
{{Code|code= |
{{Code|code= |
||
Line 141: | Line 167: | ||
}} |
}} |
||
<translate> |
<translate> |
||
<!--T:27--> |
<!--T:27--> |
||
{{Docnav |
|||
{{docnav| |[[Arch_Structure|Arch Structure]]|[[Arch_Module|Arch Module]]|IconR=Arch_Structure.png}} |
|||
| |
|||
⚫ | |||
|[[Arch_Structure|Structure]] |
|||
⚫ | |||
|[[Arch_Workbench|Arch]] |
|||
| |
|||
|IconR=Arch_Structure.svg |
|||
|IconC=Workbench_Arch.svg |
|||
}} |
|||
</translate> |
</translate> |
||
⚫ | |||
⚫ |
Revision as of 07:53, 22 April 2024
Arch Wall |
Menu location |
---|
Arch → Wall |
Workbenches |
Arch |
Default shortcut |
W A |
Introduced in version |
- |
See also |
Arch Structure |
Description
This tool builds a Wall object from scratch or on top of any other shape-based or mesh-based object. A wall can be built without any base object, in which case it behaves as a cubic volume, using length, width and height properties. When built on top of an existing shape, a wall can be based on:
- A linear 2D object, such as lines, wires, arcs or sketches, in which case you can change thickness, alignment (right, left or centered) and height. The length property has no effect.
- A flat face, in which case you can only change the height. Length and width properties have no effect. If the base face is vertical, however, the wall will use the width property instead of height, allowing you to build walls from space-like objects or mass studies.
- A solid, in which case length, width and height properties have no effect. The wall simply uses the underlying solid as its shape.
- A mesh, in which case the underlying mesh must be a closed, manifold solid.
Walls built from a line, a wire, a face, a solid, and a sketch
Walls can also have additions or subtractions. Additions are other objects whose shapes are joined in this Wall's shape, while subtractions are subtracted. Additions and subtractions can be added with the Arch Add and Arch Remove tools. Additions and subtractions have no influence over wall parameters such as height and width, which can still be changed. Walls can also have their height automatic, if they are included into a higher-level object such as floors. The height must be kept at 0, then the wall will adopt the height specified in the parent object.
When several walls should intersect, you need to place them into a floor to have their geometry intersected.
Usage
Drawing a wall from scratch
- Press the Arch Wall button, or press W then A keys.
- Click a first point on the 3D view, or type coordinates.
- Click a second point on the 3D view, or type coordinates.
Drawing a wall on top of a selected object
- Select one or more base geometry objects (Draft object, sketch, etc)
- Press the Arch Wall button, or press the W then A keys
- Adjust needed properties such as height or width.
Options
- Walls share the common properties and behaviours of all Arch Components
- The height, width and alignment of a wall can be set during drawing, via the task panel
- When snapping a wall to an existing wall, both walls will be joined into one. The way the two walls are joined depends on their properties: If they have the same width, height and alignment, and if the option "join base sketches" is enabled in the Arch preferences, the resulting wall will be one object based on a sketch made of several segments. Otherwise, the latter wall will be added to the first one as addition.
- Press X, Y or Z after the first point to constrain the second point on the given axis.
- To enter coordinates manually, simply enter the numbers, then press Enter between each X, Y and Z component.
- Press R or click the checkbox to check/uncheck the Relative button. If relative mode is on, the coordinates of the second point are relative to the first one. If not, they are absolute, taken from the (0,0,0) origin point.
- Press Shift while drawing to constrain your second point horizontally or vertically in relation to the first one.
- Press Esc or the Cancel button to abort the current command.
- Double-clicking on the wall in the tree view after it is created allows you to enter edit mode and access and modify its additions and subtractions
- Multi-layer walls can be easily created by building several walls from the same baseline. By setting their Align property to either left or right, and specifying an Offset value, you can effectively construct several wall layers. Placing a window in such a wall layer will propagate the opening to the other wall layers based on the same baseline.
- Walls can also make use of Multi-Materials. When using a multi-material, the wall will become multi-layer, using the thicknesses specified by the multi-material. Any layer with a thickness of zero will have its thickness defined automatically by the remaining space defined by the Wall's Width value, after subtracting the other layers.
- Walls can be made to display blocks, instead of one single solid, by turning their DataMake Blocks property on. The size and offset of blocks can be configured with different properties, and the amount of blocks is automatically calculated.
Snapping
Snapping works a bit differently with Arch walls than other Arch and Draft objects. If a wall has a baseline object, snapping will anchor to the base object, instead of the wall geometry, allowing to easily align walls by their baseline. If, however, you specifically want to snap to the wall geometry, pressing Ctrl will switch snapping to the wall object.
Second wall snapping perpendicularly to the first one
Properties
Wall objects inherit the properties of Part objects, and also have the following extra properties:
Data
Blocks
- DataBlock Height: The height of each block.
- DataBlock Length: The length of each block.
- DataCount Broken: The number of broken blocks (read-only).
- DataCount Entire: The number of entire blocks (read-only).
- DataJoint: The size of the joints, the empty space, between blocks.
- DataMake Blocks: Enables block generation.
- DataOffset First: The horizontal offset of the first and every uneven line of blocks.
- DataOffset Second: The horizontal offset of the second and every even line of blocks.
Component
- DataBase: The base object this wall is built on.
Wall
- DataAlign: The alignment of the wall on its baseline: Left, Right or Center.
- DataArea: Area of the whole wall, separation into blocks makes no difference (read-only).
- DataFace: The index of the face from the base object to use. If the value is not set or 0, the whole object is used.
- DataHeight: The height of the wall. Ignored if the wall is based on a solid. If set to zero, and the wall is inside a floor object with its height defined, the wall will automatically take the value of the floor height.
- DataLength: The length of the wall. Read-only if the wall is not based on an unconstrained sketch with a single edge, or on a Draft Wire with a single edge.
- DataNormal: The extrusion direction for the wall. If set to (0,0,0), the extrusion direction is automatic.
- DataOffset: The distance between the wall and its baseline. Works only if the Align property is set to Right or Left.
- DataOverride Align:
- DataOverride Width: This overrides the DataWidth attribute to set the width of each wall segment. Ignored if the DataBase object provides Widths information with the getWidths() method. (The 1st value overrides the 'Width' attribute for the 1st segment of wall; if a value is zero, 1st value of 'OverrideWidth' will be followed)"))
- DataWidth: The width of the wall. Ignored if the wall is based on a face or a solid.
Scripting
See also: Arch API and FreeCAD Scripting Basics.
The Wall tool can be used in macros and from the Python console by using the following function:
Wall = makeWall(baseobj=None, length=None, width=None, height=None, align="Center", face=None, name="Wall")
- Creates a
Wall
object from the givenbaseobj
, which can be a Draft object, a Sketch, a face, or a solid.- If no
baseobj
is given, you can provide the numerical values for thelength
,width
(thickness), andheight
. - If given,
face
can be used to give the index of a face from the underlying object, to build this wall on, instead of using the whole object.
- If no
align
can be"Center"
,"Left"
or"Right"
.- It returns
None
if the operation fails.
Example:
import FreeCAD, Draft, Arch
p1 = FreeCAD.Vector(0, 0, 0)
p2 = FreeCAD.Vector(2000, 0, 0)
baseline = Draft.makeLine(p1, p2)
Wall1 = Arch.makeWall(baseline, length=None, width=150, height=2000)
FreeCAD.ActiveDocument.recompute()
Wall2 = Arch.makeWall(None, length=2000, width=200, height=1000)
Draft.move(Wall2, FreeCAD.Vector(0, -1000, 0))
FreeCAD.ActiveDocument.recompute()
- 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
- 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