term.gfx.sprite

sheet(source, opts) -> sheet, err

Create a sprite sheet (atlas) over a source image

Two ways to define frames:

• Tile grid: tile_w, tile_h (required), margin (border, default 0), spacing (gap between tiles, default 0). Frames are numbered left-to-right, top-to-bottom starting at 1.
• Explicit: frames — an array of {x,y,w,h} rects (1-indexed) and/or a map of name -> {x,y,w,h}.

sheet:frame(index_or_name) returns a sprite; sheet:nframes() the count.