IMAGEN(1)

💖 IMAGEN(1) 💖

okay so bestie, welcome to the General Commands Manual, section 1, and today's main character is imagen. Buckle up, she's cute but she works. 🎀

✨ NAME ✨

image — translate LaTeX documents to GIF images. yes literally that's the whole job. slay. 💅

🌸 SYNOPSIS 🌸

imagen <base>

🦋 DESCRIPTION 🦋

so this manual page is just a lil' quick doc of the imagen command, no biggie. fun fact: it was written specifically for the Debian GNU/Linux distribution because the original program didn't come with a manual page at all. not me writing the docs the devs forgot 😭

imagen is a simple shell script that takes a LaTeX document and translates it into many images. that's her whole vibe.

lowkey important: if you wanna know how to use imagen together with hevea, go read the hevea manual. they're a duo, they do everything together. 🫶

👑 OPTIONS 👑

here's the summary of every option, no gatekeeping, all facts preserved bestie:

• -png — produce images in the png format. this is the default, so if you do nothing, you get png. iconic behavior honestly.
• -gif — produce images in gif format instead of png.
• -pnm — produce images in pnm format instead of png.
• -mag nnnn — changes the enlarging ratio applied while translating DVI into Postscript. more precisely, dvips gets run with the -xnnnn option. the default value for this ratio is 1414, which means that by default imagen magnifies LaTeX output by a factor of 1.414. math queen ✨
• -t arg — passes the option -t arg to dvips. for instance, using -t a3 may help when images are truncated on the right. (translation: your image got cut off on the right? this is your girl.)
• -pdf — has imagen call pdflatex instead of latex. glow up route unlocked 💅
• -extra command — inserts command as an additional stage in the imagen ppm to png/gif production chain. command is a Unix filter that expects a ppm image on its standard input and outputs a ppm image on its standard output. a sensible choice for command is one command from the netpbm package, or several such commands piped together. build your own pipeline, main character energy 🔥
• -quant number — adds an extra color quantization step in the imagen ppm image production chain, where number is the maximal number of colors in the produced images. this option may be needed in response to a failure in the image production chain. it can also help in limiting image file sizes. tiny files, big slay 🍓

🌈 SEE ALSO 🌈

• hevea(1)
• latex(1)
• gs(1)
• dvips(1)
• ppmtopng(1)
• ppmtogif(1)

the HeVeA documentation can be found on the HeVeA home page at http://hevea.inria.fr. on a Debian system it can also be accessed at /usr/share/doc/hevea-doc/html, provided the package hevea-doc (from the non-free section) is installed. iykyk 📚

💜 AUTHOR 💜

Imagen is part of HeVeA, written by Luc Maranget <Luc.Maranget@inria.fr>. king behavior 👑

this manual page was compiled by Ralf Treinen <treinen@debian.org> from the HeVeA documentation for the Debian GNU/Linux system (but may be used by others). giving credit where it's due, periodt. 🫶

and that's the whole page bestie!! 🎀 it lives in the General Commands Manual and it signs off as IMAGEN(1) — that's the footer, that's the source/version vibe, that's the end. go translate some LaTeX, you got this. 💖✨🦋🌸