vw_screenshot
Capture the Vectorworks document window as an image without scripting, even when a dialog blocks other tools. Check drawn results, see what is in front, and optionally map pixels to drawing coordinates.
Instructions
Capture the Vectorworks document window as an image, without going through Vectorworks.
Read-only; no job and no Apple Event (unless mapping is requested), so it works even while a dialog blocks every other tool. Use it to check drawn results or to see what is in front; vw_render_layers draws layers from their geometry instead, independent of the window. Returns the image plus JSON {window (screen geometry), path (saved PNG), in_front (dialogs or open menus that stall jobs), mapping? or mapping_error?, view?}.
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_screenshot"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| title | No | Part of a document window's title, to pick one when several are open. Default: the largest document window. | |
| mapping | No | True: run one small job to read the view (centre, zoom, layer scale) and return `mapping`, so a pixel in the picture can be turned into drawing coordinates with vw_point_to_world (exact in Top/Plan views only). Default False: no job at all. | |
| max_width | No | The image is shrunk to at most this many pixels wide. Default 1600. |