vw_insert_platform
Build a stage-deck platform with one flight of steps on a chosen edge as one revertible action; returns deck and step geometry.
Instructions
Build a platform of Stage Decks together with one flight of Stage Steps on a chosen edge, as one revertible step.
The decks are laid out exactly as vw_insert_stage_decks does; the flight
is centred on the steps_on edge and descends away from the platform. Use
vw_insert_stage_decks or vw_insert_stage_steps alone when only one part is
wanted. All document units. One vw_revert_last removes decks and steps
together. Returns {decks: [{uuid, center, size}], footprint, steps: {uuid,
steps, center, size}?, class?} with geometry read back after creation.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"width": "<width>",
"depth": "<depth>",
"height": "<height>",
"x": "<x>",
"y": "<y>"
},
"name": "vw_insert_platform"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| x | Yes | Platform corner x in document units: each deck extends +width along `rotation` and +depth at 90 degrees from it, so at rotation 0 the platform fills x..x+width*columns, y..y+depth*rows. | |
| y | Yes | Platform corner y in document units: each deck extends +width along `rotation` and +depth at 90 degrees from it, so at rotation 0 the platform fills x..x+width*columns, y..y+depth*rows. | |
| rows | No | Number of decks across; at least 1. | |
| depth | Yes | Depth of one deck in document units, across `rotation`. | |
| layer | No | Design layer to place the new object(s) on, by name. Omitted: the user's active layer. | |
| rails | No | True adds a handrail on both sides of the steps. | |
| width | Yes | Width of one deck in document units, measured along `rotation`. | |
| height | Yes | Deck top height above the floor in document units; also the stage height the steps descend. | |
| columns | No | Number of decks along `rotation`; at least 1. | |
| purpose | No | Text for the object's Spotlight 'Purpose' field. Omitted: left empty. Applied to decks and steps. | |
| document | No | Name of the document this call may change, as listed by vw_list_documents. If given and another document is in front, nothing changes and the call fails; use vw_switch_document first. Always pass it for writes. | |
| position | No | Text for the object's Spotlight 'Position' field. Omitted: left empty. Applied to decks and steps. | |
| rotation | No | Platform direction in degrees: 0 = width along +x, 90 = along +y. | |
| steps_on | No | Edge that gets the flight of steps, in the platform's own frame: 'front' is the edge through (x, y) along `rotation`, 'back' the opposite edge, 'left' the edge through (x, y) across, 'right' the opposite. Omitted: decks only. | |
| step_kind | No | Stage Steps type: 'Self-Adjusting' (rental unit with a fixed stringer, shallow pitch on low stages), 'Frame Free-Standing', 'Solid Free-Standing', 'Open Free-Standing' or 'Simple' (compact flight). | Self-Adjusting |
| structure | No | Leg style of each deck: 'Legs-Basic', 'Legs-Braced', 'Folding', 'Deck Only', 'Border' or 'Simple'. | Legs-Basic |
| class_name | No | Class to assign to the new object(s), by name; it must exist (vw_create_class or vw_apply_class_standard first). Applied in a second job after the insert. Omitted: the user's active class. | |
| step_count | No | Number of steps in the flight. Omitted: about one per 8 inches of height. | |
| tread_width | No | Width of the flight in document units. Omitted: the plug-in default. |