Create circle
create_circleCreate a circle at center (cx, cy) with radius r. Optionally apply fill, stroke, and stroke width.
Instructions
Create a <circle> centred at (cx, cy) with radius r (> 0).
When to use: drawing a circle / disc. For an oval use create_ellipse; for a box use
create_rect.
Key params: r > 0; inserted into parent_id (must exist) or the document default parent;
object_id to pin the id. Optional fill / stroke / stroke_width paint it in
this call (validated like set_fill / set_stroke; default None = unpainted).
Return shape: CreateResult — object_id (new id), analytic bbox, plus the pipeline fields
(operation_id, snapshot_id, changed, before/after preview).
Example: create_circle(doc_id, 50, 50, 25, fill="red")
Render and look before you trust this edit: render with render_preview (or live_render_view)
and inspect the result before relying on it; restore_snapshot reverts it if it is wrong.
Risk class: medium (reversible write-new on the working copy; original untouched).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| r | Yes | ||
| cx | Yes | ||
| cy | Yes | ||
| fill | No | ||
| doc_id | Yes | ||
| stroke | No | ||
| object_id | No | ||
| parent_id | No | ||
| stroke_width | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| bbox | No | ||
| doc_id | Yes | ||
| changed | Yes | ||
| summary | No | ||
| object_id | Yes | ||
| snapshot_id | Yes | ||
| operation_id | Yes | ||
| preview_after | No | ||
| preview_before | No |