voxolith
API reference

@voxolith/gen-building

@voxolith/gen-building: procedural voxel buildings.

A small shape grammar followed by detail passes, in this order:

  1. mass: plinth, hollow storeys with floor slabs, the roof shell, gables
  2. layout: where every window and the door go, decided before any texture so timber framing can frame them
  3. walls: brick bond, ashlar courses, plaster with spalling, or a timber frame; joints are recessed so masonry has relief
  4. trim: quoins, string courses, cornice, water table
  5. openings: windows with reveals, frames, glazing bars, sills, lintels, shutters and flower boxes; a panelled or boarded door with a transom, handle, hood, lamp and steps
  6. roof: courses of tile, slate or shingle with staggered joints, or thatch with ragged eaves and a ligger ridge; ridge cap, barge boards, rafter tails, gutters and downpipes
  7. chimneys: brick stacks with a corbelled cap and hollow pots
  8. weather: streaks under sills, rising damp, roof and plinth moss

Walls are addressed in face-local coordinates: u runs along the face, y is height, and d is depth into the wall from its outer skin (d = 0), with negative d standing proud of it. Everything random comes from the injected rng or from hashes of positions, so the same seed rebuilds the same house.

Interfaces

Type Aliases

Variables

Functions

On this page