Commands  ›   ›  Sheet View Setup Create Callout Wrapping Room Or Space Boundary

Sheet View Setup Create Callout Wrapping Room Or Space Boundary

writes to model Public API · not yet exposed

Coming soon

Before you run this

Active document open; parent view supports callouts; Room/Space id resolves; project has a Detail ViewFamilyType.

After it runs

One new callout view added, inside one committed Transaction, audit trail recorded.

When to use this

Don't use this when

Arbitrary region callouts (use SheetViewSetupCreateCalloutOnViewAtBoundingBoxCommand).

Decision flow

1) User or Bot supplies parent view id (defaults to active view) + room or space id + margin mm (default 600). 2) Resolve the element; if it is neither a Room nor a Space WireError + abort. 3) Resolve Detail ViewFamilyType id via ResolveDetailViewFamilyTypeId.FindFirstInDocument; if invalid WireError + abort. 4) Open Transaction 'Create callout (room/space wrap)'. 5) rect = GetCalloutRectangle.FromRoom(room, marginFt) OR FromSpace(space, marginFt). 6) callout = ViewSection.CreateCallout(doc, parentView.Id, vftId, rect.min, rect.max); commit. 7) Bot: JSON {ok, callout_view_id, parent_view_id, room_or_space_id, margin_mm}. User: toast 'Callout placed around {target.Name}.' 8) Any exception → tracker.Fail(ex); WireFault {parent_view_id, room_or_space_id, margin_mm}.

What you'll see in the chat

on start
Creating callout wrapping Room/Space…
thinking
Resolving Room or Space element…
Computing padded bounding box…
Calling ViewSection.CreateCallout…
on success
Callout view {callout_view_id} placed around {target_name}.
on failure
Could not create callout: {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/sheet_view_setup_create_callout_wrapping_room_or_space_boundary
  • Request body schema (from [RestApiParam])
  • Response schema (from [RestApiResponse])
  • curl / JS / Python code examples

Keywords & intent patterns

sheetviewsetupcreatecalloutwrappingroomorspaceboundary · callout · room · space · architecture

Pillar