Facade Module: Storefront

Generates patterned storefronts from planar outline curves: bays with a solid kickplate, a glass or solid middle band and a header band, mullion fins, optional flat canopies and column lines at the mullions.

JSON Masterplan (Beta) Nickname: Mod_Retail

Overview

Generates patterned storefronts with intelligent canopies and structure.

Inputs (14)

  • Bounds (Curve): Input Curve
  • Heights (Number): Input double
  • BayWidth (Number): Input double
  • BaseHeight (Number): Input double
  • TransomHeight (Number): Input double
  • MullionDepth (Number): Input double
  • FlipMullions (Boolean): Input bool
  • HorizPattern (Text): Input string
  • VertPattern (Text): Input string
  • CanopyDepth (Number): Input double
  • CanopyPattern (Text): Input string
  • FlipCanopy (Boolean): Input bool
  • ShowColumns (Boolean): Input bool
  • ColumnOffset (Number): Input double

Outputs (7)

  • Glass (Brep): Output Brep
  • SolidPanels (Brep): Output Brep
  • HeaderPanels (Brep): Output Brep
  • Mullions (Brep): Output Brep
  • Canopy (Brep): Output Brep
  • Columns (Curve): Output Curve
  • Info (Text): Method, assumptions, simplifications and references.

Method, assumptions and simplifications

The same notes appear in the component's Info output.

Method

  1. Each Bounds curve is split into segments and each segment into bays: count = round(segment length / BayWidth), at least 1, so bays are equal within a segment. Heights are matched by branch path and index; 4.5 is used when missing.
  2. Each bay is extruded straight up world Z into up to three bands: kickplate from 0 to BaseHeight (solid), middle band from BaseHeight to TransomHeight (glass or solid), header from TransomHeight to the full height. Heights are clamped so the bands never go negative.
  3. The glass or solid choice per bay comes from a 0 and 1 string in HorizPattern (1 = glass), repeated along the curve. VertPattern digits choose which HorizPattern line each curve uses (curve index modulo).
  4. Mullions are vertical fins extruded straight up world Z, of depth MullionDepth, perpendicular to the bay, at both ends of every bay (duplicates removed by position rounded to 3 decimals), spanning the middle band. FlipMullions reverses their side.
  5. Where CanopyPattern has 1 for that curve index and CanopyDepth > 0, a flat canopy is lofted between the curve at transom height and its plan offset by CanopyDepth (sharp corners, offset tolerance 0.1). FlipCanopy offsets to the other side.
  6. With ShowColumns, a column line is drawn at each mullion position, set ColumnOffset in from the offset canopy edge, from the ground to transom height.

Assumptions

  • Bounds are planar curves in world XY; heights are measured from the curve's Z.
  • Model units are metres; areas in the HUD are bay length × band height in m².
  • BayWidth, MullionDepth and ColumnOffset of 0 or less are replaced by 2.5, 0.2 and 0.2; BaseHeight, TransomHeight and CanopyDepth may be 0.

Simplifications and limits

  • All elements are zero-thickness surfaces; columns are lines only.
  • An unwired TransomHeight is 0, so the whole height becomes header, with no kickplate, glass or mullions (a remark is shown).
  • Canopies are flat surfaces at transom height; there is no structural logic beyond spacing columns at mullions.
  • Bay widths are rounded per segment, so they differ from BayWidth and from segment to segment.

Workflow

  • Masterplan facade outlines and floor heights -> Bounds and Heights.
  • Glass, SolidPanels, HeaderPanels -> previews or area take-offs.