Animate a sprite sheet locally (no ChatGPT)
animate_sheetSplits a local sprite-sheet PNG into aligned animation frames, a transparent looping GIF, atlas, manifest, frame PNGs, and contact preview in a new folder, leaving the source image unchanged.
Instructions
Split a local sprite sheet PNG with all poses in one image into aligned frames and a transparent looping GIF, atlas PNG, manifest, frame PNGs and contact preview in a new sibling folder. No ChatGPT or Chrome; takes seconds. The source PNG is never changed. Frames share a ground line and horizontal center of mass; jump adds an upward arc. Report quality warnings to the user. For light motion from one image, use animate_image.
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": {
"image_path": "<image_path>",
"motion": "<motion>"
},
"name": "animate_sheet"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| fps | No | Uniform frame timing, overriding the motion profile. Cannot be combined with durations_ms. | |
| rows | No | Provide with columns. | |
| size | No | GIF long-edge limit; default source scale. Whole-number nearest-neighbor enlargement or premultiplied-alpha area downscaling. Atlas and PNG frames stay at source scale. | |
| frames | No | Expected frame count; must agree with columns times rows when both are given. Omit all for automatic extraction. | |
| motion | Yes | ||
| columns | No | Provide with rows; 2-64 cells in total. | |
| air_frames | No | Jump only: inclusive [first, last] airborne frames, 1-based. | |
| background | No | Always saves a transparent GIF; white also saves a white GIF and lists that one in the gallery. | transparent |
| image_path | Yes | Local PNG; relative paths are resolved from the server's current folder. | |
| jump_height | No | Jump only: arc peak in source pixels; default half the median frame height. | |
| durations_ms | No | One duration per found frame; overrides the motion profile. | |
| include_preview | No |