Tile object
tileArrange copies of an object into a grid with given rows, columns, and spacing, in a single reversible operation.
Instructions
Lay out a rows x cols grid of an object in ONE reversible operation.
When to use: repeating one object into a grid in a single call. To move/scale/rotate one object
use move_object / scale_object / rotate_object; to copy once use duplicate_object.
Key params: the target stays as the (0,0) cell; rows*cols - 1 deep copies (each re-id'd
uniquely, intra-clone refs rewritten) are inserted, the copy at (r, c) translated by
(c*dx, r*dy). rows/cols must each be >= 1 and their product must not exceed the engine's
tile cap; dx/dy must be finite. A 4x4 grid is one call (not 30).
Return shape: EditResult — operation_id, snapshot_id, changed (a 1x1 tile reports
changed=False), before/after preview; the whole grid lands under one snapshot (reversible).
Example: tile(doc_id, "dot", 4, 4, 20, 20)
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.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| dx | Yes | ||
| dy | Yes | ||
| cols | Yes | ||
| rows | Yes | ||
| doc_id | Yes | ||
| object_id | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| doc_id | Yes | ||
| changed | Yes | ||
| summary | No | ||
| snapshot_id | Yes | ||
| operation_id | Yes | ||
| preview_after | No | ||
| preview_before | No |