Create ellipse
create_ellipseCreates an ellipse centered at (cx, cy) with radii rx and ry. Supports optional fill, stroke, and parent assignment for SVG documents.
Instructions
Create an <ellipse> centred at (cx, cy) with radii rx / ry (> 0).
When to use: drawing an oval / ellipse. For a perfect circle use create_circle; for a box use
create_rect.
Key params: rx / ry > 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_ellipse(doc_id, 50, 50, 30, 18, fill="#0a0")
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 |
|---|---|---|---|
| cx | Yes | ||
| cy | Yes | ||
| rx | Yes | ||
| ry | 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 |