vw_insert_truss_path
Builds a linked truss system along an L, U, rectangle, or polyline path from straight and corner symbols, fitting whole pieces per leg and placing it at a specified height.
Instructions
Build a truss shape (L, U, rectangle, any polyline with matching bends) from straights and corners, one chained system.
Each leg takes as many whole straight pieces as fit; a corner piece sits
at every interior point and takes its own length from both legs, so legs
end up shorter than the path by the leftover gap (placed per fit).
Pieces are linked in order (one Braceworks system), hung at z, and get the
position name. Use vw_insert_truss_run for a single straight run.
All-or-nothing; one revertible step. Returns {system, piece_length,
straights, corners, legs: [{pieces, length, gap, turn}], imported,
items: [{uuid}], 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": {
"straight": "<straight>",
"corner": "<corner>",
"path": "<path>"
},
"name": "vw_insert_truss_path"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| z | No | How high to raise the truss in document units: its underside sits at z, the centre line half the truss height above. Default 0. | |
| fit | No | Where a leg's leftover goes when whole pieces do not fill it: 'start' (default) leaves the gap at the leg's end, 'center' splits it between both ends, 'end' leaves it at the leg's start. | start |
| path | Yes | [[x, y], ...] in document units: the centre line of the truss, at least two points. Every interior point gets a corner. | |
| layer | No | Design layer to place the new object(s) on, by name. Omitted: the user's active layer. | |
| corner | Yes | Name of the corner symbol of the same truss family, such as 'Global Truss F34C21 Corner' (90 degrees), F34C20 (60), F34C22 (120), F34C23 (135). The path's bends must match the corner's angle. | |
| 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. | |
| straight | Yes | Name of the straight truss symbol (in the document, or in library_path), such as 'Global Truss F34-300 Straight'. Its Braceworks record gives the piece length. | |
| 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. | |
| library_path | No | Library .vwx file (vw_list_library) to import the symbols from when they are not in the document yet. | |
| position_name | No | Spotlight position name written on every piece, so fixtures can hang on it. |