Commands  ›  Annotation  ›  Architecture Dimension From Element Edge To Wall

Architecture Dimension From Element Edge To Wall

Annotation writes to model Public API · not yet exposed

Coming soon

Before you run this

Active document open; active view is a ViewPlan; selection contains one source element + one Wall, or both IDs supplied via resolvers.

After it runs

Exactly one new Dimension added to the active view, inside a single committed Transaction, audit trail recorded.

When to use this

Don't use this when

Face-to-face dimensions (use `ArchitectureDimensionFromElementFaceToWallFaceCommand` when built). Not for 3D views.

Decision flow

1) User or Bot picks source element + wall (resolvers: source element id, wall id, offset mm default=300). 2) Validate preconditions — Active view is ViewPlan; source element and wall exist in Doc; wall has a linear LocationCurve; else ErrorWire.WireError with reason and abort. 3) Open Transaction "Dim edge → wall". 4) Call GetElementEdges.GetReferencesForDimension(Doc, [source, wall]) to obtain ReferenceArray; if count < 2 WireError + abort. 5) Compute the dimension line: midpoint between source BB centre and wall centreline, offset perpendicular to the wall centreline by offset mm. 6) doc.Create.NewDimension(activeView, dimLine, refArray); commit Transaction. 7) Bot: return JSON {ok, dimension_id, value_mm, source_element_id, wall_id, view_id}. User: ribbon toast "Dimension placed — {value_mm} mm." 8) Any exception during resolving / computing / creating → tracker.Fail(ex); ErrorWire.WireFault with structured payload {source_id, wall_id, view_id, offset_mm}. Transaction rolls back.

What you'll see in the chat

on start
Placing dimension from selected element edge to wall…
thinking
Validating source element + wall…
Computing edge references via GetElementEdges…
Placing Dimension in active plan view…
on success
Dimension placed — {value_mm} mm between element {source_id} and wall {wall_id}.
on failure
Could not place dimension: {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_dimension_from_element_edge_to_wall
  • Request body schema (from [RestApiParam])
  • Response schema (from [RestApiResponse])
  • curl / JS / Python code examples

Keywords & intent patterns

dimension to wall · edge to wall · element to wall dimension · drawing dimension · wall coordination dimension

PillarAnnotation