vw_insert_band
Places band members or backline symbols on stage at set coordinates, each with an optional name label. Inserts multiple symbols in one revertible step.
Instructions
Place a band or crew on stage: people or backline symbols at given points, each with a name label. The symbols must already be in the document (vw_list_symbols); bring them in first with vw_list_library and vw_import_resource. For a single symbol without a label use vw_insert_symbol. All-or-nothing; one revertible step removes symbols and labels together. Returns {members: [{uuid, label_uuid, ...}], class?}.
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": {
"members": "<members>"
},
"name": "vw_insert_band"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| label | No | True adds a centred text label with each member's name below the symbol. | |
| layer | No | Design layer to place the new object(s) on, by name. Omitted: the user's active layer. | |
| members | Yes | One entry per person or instrument: {'symbol': name of a symbol in the document, 'x': ..., 'y': ... (document units), optional 'z', 'rotation' in degrees (default 0) and 'name' for the label (default: the symbol name)}. At least one. | |
| 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. | |
| 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. Applied to symbols and labels. | |
| label_offset_mm | No | Distance in millimetres from the symbol's insertion point down to the label. |