Observe the current Archicad context
archicad_capture_contextRecords the active Archicad context (stories, sheets, selection, marquee, 2D viewport) to resolve spatial references like 'here' or 'selected'.
Instructions
START HERE after binding when you need to understand words such as here, this, selected, or inside the dashed marquee. Pass target.contextId from archicad_bind; do not bind again by hint. A capture records stories (floors/namespaces) that own sheet_island and outside-sheet drawing_island / loose_fragment regions, plus active selection, marquee, and 2D viewport as independent focus parts. On FloorPlan, default operator intent is the active story (summary.activeStoryHandle): if the operator did not name a floor, stay there. Read stories[] and regionRoles first (sheets and WIP clusters are siblings). Then focusResolution — use preferredRegionHits/preferredResolution for here/this marquee; regionHits remain full multi-story XY truth. For focus questions, report preferred hits first; cards with no matching focusRelationships are not hits. Use maxRegionCards=0 when focus resolution alone is enough. Use current_database when enclosing sheet and nearby cluster/table context matters; selection is a faster exact-workset mode and may omit its surrounding sheet. Keep snapshotId and expand only relevant handles. Detected sheets and title-block fields remain candidates, not ground truth.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| scope | No | Default current_database: relates marquee/selection/viewport to enclosing sheets, outside-sheet clusters, and tables. Use selection for a faster exact-workset read of selected BIM/drafting elements (Roof, Window, …); members retain type/bounds/floorIndex even when Tapir type-specific details are unsupported. Selection may omit enclosing sheets. | current_database |
| target | No | ||
| timeoutMs | No | ||
| explicitBounds | No | Optional disconnected focus rectangles in Archicad model coordinates. They supplement native selection/marquee/viewport as separate focus parts; they do not crop sheet reconstruction. | |
| maxRegionCards | No | Initial card page size. First page reserves slots for outside-sheet clusters when present. Use 0 for a compact focus-only answer; page regions later by inspecting the returned snapshotId. |