vw_insert_truss_run
Places a straight run of truss pieces end to end or stacks them into a vertical tower, creating one linked truss system for rigging layouts.
Instructions
Place a straight run of truss pieces end to end, or stack them into a tower, linked into one truss system the way Spotlight's Insert Truss tool does.
Creates count TrussItem objects on the symbol's length centres from
(x, y) along rotation, dimensions, weight and type from the symbol's
Braceworks record, chained into a new truss system. With vertical=True
the pieces are stacked upward from (x, y, z) into a tower, optionally on
a base plate and under a top piece. Shapes with corners are
vw_insert_truss_path; for a single odd piece use vw_create_pio with
'TrussItem'. All-or-nothing; one revertible step removes the whole run
(and the import, if any). Returns {system, piece_length, total_length,
vertical, imported, pieces: [{uuid, bbox}] (towers: [{uuid, symbol, z}]
plus total_height), class?}; check with vw_list_truss.
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": {
"symbol": "<symbol>",
"x": "<x>",
"y": "<y>",
"count": "<count>"
},
"name": "vw_insert_truss_run"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| x | Yes | Start point x of the run in document units (the first piece begins here). | |
| y | Yes | Start point y of the run in document units. | |
| z | No | How high to raise the truss in document units: its underside sits at z, the centre line half the truss height above (live 2026-11-21). | |
| count | Yes | Number of pieces placed end to end; at least 1. | |
| layer | No | Design layer to place the new object(s) on, by name. Omitted: the user's active layer. | |
| symbol | Yes | Name of a truss symbol already in the document (vw_list_symbols), or in the library file given as library_path. | |
| 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. | |
| rotation | No | Direction of the run in degrees: 0 = along +x, 90 = along +y. | |
| vertical | No | True: a tower. The pieces stand on end, stacked upward from (x, y) at height z; rotation is ignored. Default False: a horizontal run. | |
| 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. | |
| top_symbol | No | With vertical: a top piece (spindle, sleeve) of the same family placed on top of the stack, such as 'Global Truss F34 Spindel'. | |
| base_symbol | No | With vertical: a base plate symbol of the same family placed under the stack, such as 'Global Truss F34 800mm Steel Plate Base' (import it first). | |
| library_path | No | Library .vwx path (vw_list_library) to import the symbol from first, when it is not in the document yet. | |
| position_name | No | Spotlight position name written into every piece, so lighting devices can refer to the run. Omitted: left empty. |