canvas_gesture
Sends one validated left-button click or drag to a current 2D/3D Marvelous Designer viewport using logical pixel points, enabling AI clients to interact without window activation.
Instructions
Send ONE complete left-button click/drag to a freshly read current 2D/3D view.
Points are viewport LOGICAL pixels, independent of DPR: click=[start]; drag=[start, intermediate...,end], at most 32 points. Uses the current tool without selecting modes. Modifiers affect these synthetic events only. MD must already be inactive/background; no window restore, activation or OS input is used. Native preflight validates dynamic bounds, references and mappings before any events. Release/cleanup is in this same RPC.
SUCCEEDED proves the closed event batch and public view readback only; selection hits, geometry, handles and XYZ require separate domain readback. Partial/unknown dispatches need root recovery; do not retry with a new request_id. Budget is cooperative between events, not a native callback timeout. Requires the scene_token returned by canvas_views.
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": {
"view": "<view>",
"view_ref": "<view_ref>",
"view_fingerprint": "<view_fingerprint>",
"action": "<action>",
"points": "<points>",
"scene_token": "<scene_token>",
"request_id": "<request_id>"
},
"name": "canvas_gesture"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| view | Yes | ||
| action | Yes | ||
| points | Yes | ||
| view_ref | Yes | ||
| budget_ms | No | ||
| modifiers | No | ||
| request_id | Yes | ||
| scene_token | Yes | ||
| view_fingerprint | Yes |