Facade Module: Rhythmic Balconies
2D patterned balconies with merge logic and corner isolation. The slab area in the HUD is a quick estimate (bay length x Depth), approximate for curved bays.
Overview
2D patterned balconies with merge logic, corner isolation, and fast math.
Inputs (14)
- Bounds (Curve): Curve boundaries
- Heights (Number): Heights
- BayWidth (Number): Bay width
- Depth (Number): Depth
- RailHeight (Number): Rail height
- HeaderDrop (Number): Header drop
- HorizPattern (Text): Horizontal pattern
- VertPattern (Text): Vertical pattern
- MergeAdjacent (Boolean): Merge adjacent
- FlipDir (Boolean): Flip direction
- FirstBalcony (Boolean): First balcony
- CornerWindow (Boolean): Corner window
- CornerOffset (Number): Corner offset
- SegLength (Boolean): Seg length
Outputs (8)
- Slabs (Brep): Slabs
- Railings (Brep): Railings
- Partitions (Brep): Partitions
- Glass (Brep): Glass
- SolidPanels (Brep): Solid panels
- HeaderPanels (Brep): Header panels
- CornerPanels (Brep): Corner panels
- Info (Text): Method, assumptions, simplifications and references.
Method, assumptions and simplifications
The same notes appear in the component's Info output.
Method
- Each boundary curve is one floor (height from Heights by path and index, default 4.0 m); all walls, rails and partitions are extruded straight up along world Z. Its segments are sorted into corner pieces and middle pieces.
- With SegLength, segments shorter than 2 × BayWidth become corner pieces. With CornerOffset > 0, each longer segment loses CornerOffset at both ends to corner pieces.
- Corner pieces become a full-height solid panel, or with CornerWindow glass to height - HeaderDrop plus a header panel.
- Middle pieces are divided into bays of about BayWidth (round(length / BayWidth) equal parts). Bays are numbered along the floor and the active horizontal pattern (chosen by the VertPattern digit for that floor) says which bays get a balcony (1).
- A balcony bay gets glass to height - HeaderDrop, a header above, a slab (straight loft between the bay line and its copy offset by Depth, FlipDir for the other side), a railing (the offset line extruded RailHeight) and side partitions of RailHeight. With MergeAdjacent, the partition between two neighbouring balconies is left out.
- Other bays get a full-height solid panel. With FirstBalcony False, the first curve of each branch (ground floor) has no balconies.
- The HUD reports glass, solid, header and corner areas (length × height), slab area (bay length × Depth, approximate for curved bays) and the balcony count.
Assumptions
- Bounds are horizontal lines or outlines at floor levels, in metres, listed from the ground floor up within each branch.
- Defaults: BayWidth 3.0 m, Depth 1.5 m, RailHeight 1.1 m, HeaderDrop 0, HorizPattern 10, VertPattern 0; non-positive sizes fall back to defaults.
Simplifications and limits
- All parts are zero-thickness surfaces; slabs have no thickness and railings are solid surfaces.
- Offsets for curved bays use a coarse 0.1 tolerance; areas are length × size, not measured on the surfaces.
Workflow
- Facade JSON Parser BoundsExt and Heights -> Bounds and Heights; outputs -> Custom Preview or bake.