Frames
frameDestructive
Manage animation steps in Aseprite: list, add, duplicate, delete, reorder, activate, or set durations. Adjust per-step timing to shape cycle motion.
Instructions
Manage animation frames. Ops: 'list', 'add', 'duplicate', 'delete', 'set_duration', 'activate', 'reorder'. Durations are milliseconds per frame and carry most of the life in a cycle — hold a contact pose longer than a pass pose. Use count to add several at once and durations to set a whole cycle's timing in one call.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| op | Yes | ||
| count | No | ||
| frame | No | 1-based frame number. Omit to use the active frame. | |
| sprite | No | Sprite filename or id. Omit to use the sprite Aseprite has focused. | |
| toIndex | No | For 'reorder'. | |
| linkCels | No | For 'duplicate': share the cel image instead of copying it, so edits apply to both. | |
| durations | No | Per-frame durations from frame 1, for 'set_duration'. | |
| afterFrame | No | Insert position. Default: at the end. | |
| durationMs | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| frames | No | ||
| sprite | Yes | ||
| frameCount | Yes | ||
| activeFrame | No | ||
| totalDurationMs | No |