Look at the sprite
lookInspect the Aseprite canvas as previews, pixel-accurate ASCII grids, filmstrips, onion-skin views, diffs, or reference comparisons to verify artwork before reporting it finished.
Instructions
See what is actually on the canvas. Ops:
• 'preview' — a nearest-neighbour upscaled PNG of the active frame (~1024px long edge). Use for overall read: silhouette, colour, whether it looks like the thing.
• 'ascii' — an exact text grid, one glyph per pixel with a colour legend and coordinate rulers. Use to verify precise pixel positions and values, to count cells, or on any client without vision. Reads up to the whole canvas; pass a region to crop. Glyphs are bound to palette indices, so every region and frame of a sprite agrees on what a glyph means; each read's legend lists only the colours it contains, so merge legends when rows from one piece go into another. Only colours outside the palette (listed in offPalette) get per-read glyphs. rulers=false prints the bare rows, which draw kind 'grid' takes back as-is: read a layer, edit the rows, send them at the same x/y.
• 'filmstrip' — every frame composited into one image. The only reliable way to review an animation, since a vision model reads just the first frame of a GIF.
• 'onion' — the target frame at full opacity over ghosted neighbouring frames, oldest-first. Use to check in-betweens and spacing while animating, without stepping through frames one at a time. Over an opaque background the target hides every ghost — pass layer to onion-skin just the part that moves.
• 'diff' — a pixel-level text diff between two frames: '.' unchanged, '-' erased, glyph = the new colour. Use it to confirm exactly what an edit touched.
• 'compare' — the reference layer (left, full opacity) beside the art without any reference layer (right), same frame, same scale. Use it when drawing from a concept or storyboard: name the few largest mismatches and fix only those.
Draw, then look, then fix. Do not report a sprite finished without looking at it.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| op | No | preview | |
| frame | No | 1-based frame number. Omit to use the active frame. | |
| layer | No | Read a single layer instead of the composited image. Honoured by preview, ascii, diff, filmstrip and onion; compare has its own `reference`. | |
| scale | No | Integer upscale for image ops, 1-128 (clamped so the output stays under ~2048px). Omit it — the automatic choice targets a ~1024px long edge, which is what a vision model can actually read. | |
| region | No | Crop. Omit to read the whole canvas. | |
| rulers | No | ascii: false drops the coordinate rulers and row labels, leaving rows you can edit and pass straight to `draw` kind 'grid' with the reported origin. | |
| sprite | No | Which sprite: its id as '#7' (what every result reports back, and the only unambiguous form — two unsaved documents are both called 'Sprite'), its filename, or its display name. Omit to use the sprite Aseprite has focused. | |
| toFrame | No | Diff: the later frame. | |
| fromFrame | No | Diff: the earlier frame. | |
| reference | No | Compare: the reference layer. Default 'reference'. | |
| framesAfter | No | Onion: ghost frames after the target. | |
| framesBefore | No | Onion: ghost frames before the target. | |
| ghostOpacity | No | Onion: opacity of the ghosted (non-target) frames. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| op | Yes | ||
| rows | No | ||
| text | No | The grid, for 'ascii' and 'diff'. | |
| scale | No | ||
| width | Yes | ||
| frames | No | Filmstrip: frame count. | |
| height | Yes | ||
| legend | No | glyph → #rrggbb. Palette colours keep the same glyph across every read of the sprite. | |
| origin | No | ascii: sprite position of the grid's top-left cell — the `x`/`y` for `draw` kind 'grid'. | |
| sprite | Yes | ||
| columns | No | ||
| gridRows | No | ascii: the bare rows, '.' transparent — `draw` kind 'grid' `rows`, with `legend` and `origin`. | |
| framesUsed | No | Onion: 1-based frame numbers composited. | |
| offPalette | No | ascii/diff: glyphs whose colour is not in the palette. Their assignment can change between reads — do not reuse them across regions. | |
| totalPixels | No | ||
| changedBounds | No | Diff: tight bounding box of every changed pixel. Null when nothing changed. | |
| changedPixels | No | ||
| percentChanged | No | Diff: changed / total * 100. |