pixel_compile
Compiles pixel-art animation, effects, fluid, terrain or lighting sources into an ordinary recipe revision and returns a contact sheet, with optional metadata for joints, timing, masks and counts.
Instructions
Build a character animation from parts (bipeds and four-legged animals, with idle, walk, trot, run, jump, attack and hurt templates, squash and tweens), a terrain tileset, particle effects (sparks, embers, dust, a sprite dissolving or teleporting away pixel by pixel) and spell shapes (slashes, shockwave rings, beams, lightning, magic circles, impact stars, fireballs, cel water streams and drops, auras hugging a sprite, smears trailing a sword tip), simulated smoke, fire, explosions, steam, magic swirls, water (splashes, waterfalls, drips, bubbling potions) and thick liquids (honey, slime, mud), rigid bodies (balls and blocks that bounce, stack, topple and rest, with joints, ropes and cloth), growing crystals (quartz clusters, geodes, cubes, snowflakes), falling-sand sandboxes (burning, collapse, lava meeting water, blasts), coherent interference and portal loops, or a lighting normal map. Compiles the source into an ordinary recipe revision and returns a contact sheet; metadata: true adds pose joints, contacts and timing, the autotile mask table, particle counts, fluid figures, wave counts, crystal counts, body paths, joint breaks, cloth tears or normal directions.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "pixel_compile"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| size | No | A canvas size such as "32x32" for the compiled drawing: cut to the window holding the most of it, or given margins; never scaled. | |
| frames | No | Keep this many evenly spaced frames of each animation that has more, playing as long as before. The way to fewer frames: lowering frames in a source cuts the effect short. | |
| preset | No | Instead of source: a shipped preset by name, such as "smoke-puff" (pixel_help topic presets). | |
| source | No | A pixelforge-poses, pixelforge-autotile, pixelforge-fx, pixelforge-fluid, pixelforge-wave, pixelforge-crystal, pixelforge-powder, pixelforge-bodies or pixelforge-normals document (see pixel_help topics). A normals source's recipe, or an fx symbol's {recipe, frame}, may be inline, a file under the server root or {"revision": id}. | |
| metadata | No | ||
| sequence | No | Bodies only: write numbered PNG video frames (pixel_render's sequence options, animation naming the effect) instead of a recipe; a match may run past 256 frames. | |
| animation | No | Keep only this animation (or these) of a source or preset that makes several. | |
| draftViews | No | Poses only, instead of compiling: draft grid parts turned to these angles, {"boot": [30, 330]}, as views to correct and paste into parts.<name>.views, with a comparison sheet. |