# `mix ascii.svg`
[🔗](https://github.com/houllette/ascii_art/blob/main/lib/mix/tasks/ascii.svg.ex#L1)

Writes one frame of a piece as an SVG picture (`Ascii.Render.SVG`),
for a README, an email or a social preview.

    mix ascii.svg night-coast
    mix ascii.svg big-text --option text=hello --ink ff5f6d,ffc371 --output hello.svg
    mix ascii.svg gauge --option value=72 --parts --background 0d1117 --foreground c9d1d9

The piece is a slug or a module, as for `mix ascii.play`, and takes
the same `--option`, `--mono`, `--ink`, `--gradient`, `--parts`, `--part`
and `--paper`. It is labelled for screen readers with what it shows
(`Ascii.describe/1`).

## Options

  * `--t S` - the time to draw, in seconds (default 0: frame 0)
  * `--output FILE` - where to write it (default `<piece>.svg`; `-` for
    standard output)
  * `--font-size PX` - the font's size in pixels (default 14)
  * `--background COLOUR`, `--foreground COLOUR` - behind the picture,
    and for its uncoloured text (defaults: the piece's ground, and the
    colour of the text around it)

---

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