vw_lightwright_snapshot
Reads lighting devices from the saved Lightwright Data Exchange XML as of the last export, providing offline snapshot data with UIDs and fields even while other Vectorworks tools are blocked.
Instructions
Read the Lighting Devices as Spotlight's Lightwright Data Exchange file last exported them, from the XML beside the saved document.
Read-only. The file itself is read without a job (only the document's path
is asked from Vectorworks), so this works even while a dialog blocks the
other tools, but it shows the plot as of the last export, which can be older
than the drawing; vw_list_lighting_devices is the live view. Returns
{available, path, exported (timestamp), fields, count, fixtures: [{uid,
lightwright_id, accessories, ...}]}; {available: False, hint} when the
exchange is off (the hint says how to switch it on); and count 0 with a
hint right after a vw_lightwright_patch, when Vectorworks has written back
only an acknowledgement and the user must redo the full export. UIDs from
here are what vw_lightwright_patch takes.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "vw_lightwright_snapshot"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum number of fixtures returned (`count` still gives the total). Default 2000. | |
| fields | No | Exchange column names to keep, as the file spells them (Channel, Unit_Number, Inst_Type, Purpose, Color, Absolute_Address, User_Field_1 ...; the result's `fields` lists what the export contains). `uid` is always included. Omit for every column. | |
| position | No | Only fixtures whose Position matches this name (case-insensitive). Omit for all. |