MURASTER(1)

✨ NAME ✨

okay bestie, the title line up top says muraster(), so that's the manual name, and the whole page is about muraster 💖

muraster is literally a much simpler version of the mutool draw command. As such, it can be used to quickly rasterize an input file with a set of options. no cap, that's the whole point.

---

🎀 COMMAND LINE OPTIONS 🎀

here's the vibe, the synopsis, the whole shape of it:

muraster [options] file [pages]

🌸 [options]

• -p password — the password needed to open a password protected PDF file. 🔐
• -o filename — the output file name. 💾
• -F format — the output format (default inferred from output file name), e.g. pam, pbm, pgm, pkm, ppm. 🖼️
• -s information — show extra information:
  • m: show memory use. 🧠
  • t: show timings. ⏱️
• -R rotation — set a rotation for the output (default auto):
  • auto.
  • 0.
  • 90.
  • 180.
  • 270.
  • clockwise.
• -r x,y — comma separated x and y resolution in DPI (default: 300,300). 📏
• -w width — printable width (in inches) (default: 8.27). 📐
• -h height — printable height (in inches) (default: 11.69). 📏
• -f — fit file to page if too large. 🫶
• -B height — set the minimum band height (e.g. 32). 🎚️
• -M memory — sets the maximum band memory (e.g. 655360). 💾
• -W width — page width for EPUB layout. 📖
• -H height — page height for EPUB layout. 📖
• -S size — font size for EPUB layout. 🔤
• -U filename — file name of user stylesheet for EPUB layout. 🎨
• -X — disable document styles for EPUB layout. 🚫
• -A level — set anti-aliasing level.
  • 0: off.
  • 2: 4 levels.
  • 4: 16 levels.
  • 8: 256 levels.
• -A graphics level / text level — independently set the anti-aliasing levels for graphics and text. e.g. -A 0/4. ✨

🦋 [pages]

a comma separated list of page numbers and ranges. like, you can pick exactly which pages you want, bestie. 📄

💅 Example usage #1

this will render a raster file from page one of the input file mupdf_explored.pdf. the output file will be called test.ppm, have a clockwise rotation and specific graphics/text anti-aliasing applied. iconic.

muraster -o test.ppm -R clockwise -A 0/8 mupdf_explored.pdf 1

---

and that's the whole manual, fr fr. the footer down there just says muraster() — no version, no date, just the name, minimal main character energy 💅✨. so yeah, that's the source/version/date situation: it's literally just muraster() on its own. periodt. 🫶