# `mix linocut.sheet`
[🔗](https://github.com/jaman/cauldron/blob/v0.2.2/linocut/lib/mix/tasks/linocut.sheet.ex#L1)

Read a sprite sheet, clear its background, cut it into frames and write them as one
`.pic` with the frames separated by `---`.

    mix linocut.sheet run.png --out art/runner.pic --key corner --size 24x36 --expect 6

## Options

  * `--out` — where to write the `.pic`, required
  * `--key` — the background colour to clear, as `#rrggbb` or `corner` for the top-left
    pixel's colour. Default `corner`
  * `--tolerance` — how far from `--key` a colour may be and still be cleared. Default `40`
  * `--band` — which row of frames to cut, counting from the top, or `all` for every row
    in turn. Default `0`
  * `--gap` — how many blank columns or rows separate one frame from the next. Default `6`
  * `--size` — `WIDTHxHEIGHT` to draw each frame at. Default the frames' own size
  * `--colours` — how many colours the palette may hold. Default `16`
  * `--alpha` — the alpha at or above which a pixel counts as opaque. Default `128`
  * `--expect` — fail unless exactly this many frames were found
  * `--order` — the frames to write and the order to write them in, as indexes into what
    was cut counting from `0`, such as `0,1,2,3,2,1`. A frame may be left out or used
    more than once. Default every frame, left to right
  * `--nearest` — resample by taking one pixel rather than averaging

---

*Consult [api-reference.md](api-reference.md) for complete listing*