Commands  ›  Architecture / Roofs  ›  Architecture Add Pitched Roof At Top Level With Configurable Pitch

Architecture Add Pitched Roof At Top Level With Configurable Pitch

Architecture / Roofs writes to model Public API · not yet exposed

Coming soon

Before you run this

Top level defined. Top floor or perimeter walls in place to define the eaves footprint. Pitched-roof type configured in the project. Pitch angle supplied (default per project standard).

After it runs

One pitched Roof at the top level whose ridge runs along the footprint's longest axis at the supplied pitch; eaves set to the footprint perimeter.

When to use this

Don't use this when

Site-driven ridge orientations (use the topology command), mansard / butterfly / multi-zone roofs, or buildings whose roof footprint differs from the top floor.

Decision flow

1. Read the top level + the building footprint from the top floor or perimeter walls.
2. Find the footprint's longest axis — this is the ridge direction.
3. Build the eaves curve loop and the slope-direction lines for each side.
4. Create a pitched Roof in one Transaction at the supplied pitch on each plane.
5. Report ridge length, pitch and eaves perimeter.

What you'll see in the chat

on start
I'll add a pitched roof at {pitch}° now using the building footprint.
thinking
Finding the footprint's longest axis and orienting the ridge along it.
on success
Done — pitched roof placed with {pitch}° pitch and {ridge_length} m ridge.
on failure
Couldn't generate the pitched roof: {error}.

REST API

Not yet exposed

This command does not carry a [RestApi] attribute today. Once tagged, this section will auto-populate with:

  • POST /api/v1/commands/architecture_add_pitched_roof_at_top_level_with_configurable_pitch
  • Request body schema (from [RestApiParam])
  • Response schema (from [RestApiResponse])
  • curl / JS / Python code examples

Keywords & intent patterns

pitched roof · duo pitch · hipped roof · configurable pitch · residential roof

PillarArchitecture / Roofs