Debian Codegraph @

src/bonsai/docs/guides/authoring/door.rst

raw
1 Door
2 ====
3
4 A door is a wall opening that allows passage between spaces, controlled access for people and goods.
5
6 In IFC, it's represented by the IfcDoor entity, which is a subtype of IfcBuildingElement.
7 Doors play a crucial role in building design, affecting circulation, accessibility, and space functionality.
8
9 This section covers how to add and customize doors in your BIM model using Bonsai.
10
11 Adding a Door
12 -------------
13
14 1. Select the wall where you want to place the door.
15 2. Set the 3D cursor on the wall at the desired door location.
16 3. Click on the "Create Door" tool in the Bonsai toolbar.
17 4. In the top bar, you'll see "[No IfcDoorType Found] | Name [TYPEX] | + Add IfcDoorType".
18 5. Edit [TYPEX] to use a door type name of your choice (e.g., DOOR001).
19 6. Click "+ Add IfcDoorType". The top bar will update with additional options.
20 7. Click "Add" (or press SHIFT+A) to create a door with its own type.
21 8. Adjust the door's width and height using the parameters in the top bar.
22
23 Placing a Door and Changing its Swing Direction
24 -----------------------------------------------
25
26 1. Select the wall:
27 - (Optional) Use the "Create Wall" tool to add a wall in your scene.
28 - Select the wall where you want to place the door.
29
30 Selecting the wall is crucial as it ensures that the void relation between the door and the wall is automatically created.
31
32 2. Add a Door:
33 - Use the "Create Door" tool from the toolbar.
34 - Press SHIFT+A or click "Add" to place the door on the selected wall.
35
36 **Applying Void**
37
38 If you forgot to select the wall before placing the door, you'll need to manually create the void relation:
39
40 - Select both the wall and the door.
41 - Click "Apply Void" (Shift+O) button.
42
43 .. important::
44 If you need to use "Apply Void", do this before making any modifications to the door,
45 as there are limitations with this function that may affect door orientation.
46
47 Usually, the Regen function will recalculate all the openings with existing void relationships.
48
49 3. Adjust Door Position (if needed):
50 - With the door selected, use Blender's move tools to adjust its position along the wall.
51
52 4. Regenerate the Wall Geometry:
53 - Select the wall.
54 - Press Shift+G to regenerate the wall geometry, incorporating the door opening.
55
56 .. note::
57 This step ensures the wall geometry is updated to include the door opening.
58
59 Moving the Door using Blender tools doesn't actually change the IFC model.
60 Future versions need to improve UX in that regard.
61 Synchronisation between the Blender scene and IFC model is an issue that has the highest priority.
62
63 5. Change Door Swing Direction:
64 - Select only the door.
65 - Press Shift+F to flip the door. It rotates the door by 180 degrees and moves the pivot point.
66 - Locate the "Parametric Geometry" panel in the `Scene Properties > Geometry and Materials` subtab.
67 - Find the "Door" section within this panel.
68 - Change the "Operation Type" to "SINGLE_SWING_RIGHT".
69
70 .. note::
71 The Shift+F shortcut is currently a hidden feature and not available as a button in the Door tool interface.
72
73 You may need to experiment with the combination of changing the Operation Type and using Shift+F to achieve the desired orientation.
74
75 6. Final Wall Geometry Regeneration:
76 - Select the wall again.
77 - Press Shift+G one more time to ensure all changes are properly applied.
78
79 Additional Notes
80 ----------------
81
82 - The Shift+F shortcut for flipping the door is not visible in the Door tool interface.
83 This functionality may be added as a visible button in future updates.
84 - Always use Shift+G (Regenerate) after making changes
85 to ensure the wall and door geometries are correctly updated.
86 - Avoid using Shift+O (Apply Void) as it may cause issues
87 with the door's orientation.
88
89
90 Modifying Doors
91 ---------------
92
93 .. note::
94 Some functionality is not implemented.
95
96 You can modify doors using various tools:
97
98 - Resize: Adjust the width and height parameters in the top bar.
99 - Move: Use Blender's standard move tools to reposition the door.
100 - Flip: Change the opening direction using the flip tool (Shift+F).
101
102 .. note::
103 After moving a door, you need to recalculate the void in the wall. To do this:
104
105 - Select the wall containing the moved door.
106 - Click on the "Regen" (:kbd:`Shift` + :kbd:`G`) button in the top bar or use the appropriate shortcut.
107 - This ensures that the opening in the wall is correctly positioned after moving the door.
108
109 If Regen operation doesn't achive the required result, use Apply Void function:
110
111 - Click on the "Apply Void" (:kbd:`Shift` + :kbd:`O`) button in the top bar or use the appropriate shortcut.
112 - This ensures that the opening is linked to the wall.
113
114
115 Door Properties
116 ^^^^^^^^^^^^^^^
117
118 .. note::
119 This functionality is not implemented.
120
121 After adding a door, you can customize its properties:
122
123 1. Select the door in the 3D viewport.
124 2. Go to the ... panel.
125 3. Find the ... section.
126 4. Here you can set various properties such as fire rating, u-value, or any custom properties required for your project.
127
128 .. note::
129 This functionality is not implemented.
130
131 You can customize various properties of the door:
132
133 - Dimensions (width, height, thickness)
134 - Opening direction
135 - Door type (e.g. single swing, double swing, sliding)
136 - Material
137
138
139 Creating Multiple Doors
140 -----------------------
141
142 To create multiple doors of the same type:
143
144 1. Select the desired door type from the dropdown menu in the top bar.
145 2. Set the 3D cursor on a wall where you want to place a new door.
146 3. Select the wall
147 4. Click "Add" (or press SHIFT+A) for each new door you want to create.
148 5. Adjust the 3D cursor, position and parameters for each new door as needed.
149
150 See Also
151 --------
152
153 - :doc:`../creating_walls`
154 - :doc:`../../advanced_modeling/material_assignment`