Live: export selection
live_export_selectionExport the current selection to a PNG file in the live artifacts directory. This read-only operation captures only the selected elements from the canvas.
Instructions
Export just the current live selection to a PNG under the live artifacts dir.
When to use: a PNG of only the GUI selection. For the whole canvas use live_render_view; for
pixels plus structure use live_get_scene.
Key params: none. Read-only feedback (no mutation, no approval, no Operation Record), mirroring
live_render_view. Requires an established session.
Return shape: LiveExportResult — a workspace-relative PNG path under the live artifacts dir.
Example: live_export_selection()
Risk class: low (render to artifact dir).
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": "live_export_selection"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| format | Yes | ||
| object_ids | No | ||
| size_bytes | Yes | ||
| artifact_path | Yes |