vw_create_pio
Creates a Vectorworks or Spotlight plug-in object by internal name at a point and sets exact parameters; use it when no typed insert tool fits, with unknown parameter names aborting placement.
Instructions
Place one Vectorworks or Spotlight plug-in object by its internal name and set its parameters. The general-purpose way to create a plug-in object when no typed tool fits; prefer vw_insert_truss_run, vw_insert_lighting_devices, vw_insert_stage_decks and the other insert tools where they exist, since those know the objects' quirks. The object is created and regenerated with the given parameters; nothing else in the document is touched. Unknown parameter names abort the call and nothing is placed. One revertible step. Returns the new object's summary as vw_find_objects lists objects ({uuid, type, name, layer, class, bbox...}) plus class; read the resulting fields with vw_get_record.
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": {
"plugin": "<plugin>",
"x": "<x>",
"y": "<y>"
},
"name": "vw_create_pio"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| x | Yes | Insertion point x in document units. | |
| y | Yes | Insertion point y in document units. | |
| layer | No | Design layer to place the new object(s) on, by name. Omitted: the user's active layer. | |
| plugin | Yes | Internal plug-in name, case-sensitive: 'TrussItem', 'Lighting Device', 'Light Position Obj', ... Learn names from vw_find_objects(type='Plug-in Object') plus vw_get_record on an existing object. | |
| 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 | Rotation in degrees, counter-clockwise, 0 = along +x. | |
| 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. | |
| parameters | No | Parameter fields to set by exact field name, for example {'Symbol': 'F34 Straight 2m', 'Name': 'T1'} for a TrussItem. An unknown name aborts the call. Omitted: plug-in defaults. |