vw_lightwright_patch
Write Lighting Device field changes as a Lightwright Data Exchange patch beside the Vectorworks file when the direct bridge is blocked, then verify the applied results.
Instructions
Change Lighting Device fields through Spotlight's Lightwright Data Exchange file instead of a job, for Lightwright round trips or when a dialog blocks the bridge.
With dry_run=False this changes the document, indirectly: the patch is
written beside the .vwx and Vectorworks applies it 1 to 2 s after it next
gains focus, so the user has to click into Vectorworks; verify afterwards
with vw_list_lighting_devices. Prefer vw_set_lighting_device_fields when the
bridge works. Refuses deletes, fields not in the export, a Symbol_Name no
fixture uses yet (an unknown symbol breaks fixture selection drawing-wide,
irreversibly) and a type change without Wattage. Before writing, the full
export is copied to ~/.vwmcp/lightwright/ (backup) and the drawing's
current values of the touched fixtures are journaled (inverse_from: live,
or export when a fixture could not be read, in which case the undo restores
possibly stale export values); vw_revert_last writes the inverse patch, which
again needs a click. After a patch the file holds only Vectorworks'
acknowledgement until the next full export. Returns {dry_run, path, changes,
patch, and when written: backup, inverse_from, note}.
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": {
"changes": "<changes>"
},
"name": "vw_lightwright_patch"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| changes | Yes | One item per fixture: {"uid": "1246.1.1.0.0", "fields": {"Channel": "201"}}. `uid` and the field names (exchange spelling: Channel, Unit_Number, Inst_Type, Purpose, Color ...) come from vw_lightwright_snapshot; only fields in the export can be written, plus Symbol_Name, Inst_Type and Wattage. | |
| dry_run | No | True (default) returns the patch text without writing anything; False writes it. | |
| document | No | Name of the document this call is meant for (as vw_list_documents shows it, with or without .vwx). If another document is active nothing changes; use vw_switch_document first. Always set it for a write. |