☕ coffee ☕

Coffee stains package for LaTeX

Usage

To use the package, simply place the coffee.sty file in the directory with all of your other .tex files or install it properly (consult your distribution's manual). Then include the following line in the header of your document:

\usepackage{coffee}

Since version 5, there is a convenient command:

\cofeSplash{}

to place a random splash with random parameters on the current page. There is now also a package option to put coffee on every page like

\usepackage[onEveryPage]{coffee}

Since version 6, there is a convenient command:

\cofeBleed{alpha}{scale}{angle}{xoff}{yoff}{bleed}{variety}

to place a variety type splash with random parameters on the current page. There is now also a package option to put a bleeding coffee throughout the pages like

\usepackage[bleed]{coffee}

For more fine grained control, use the original commands:

To place a coffee stain on a page, put one of the following commands in the source code of the relevant page:

\cofeAm{alpha}{scale}{angle}{xoff}{yoff}
\cofeBm{alpha}{scale}{angle}{xoff}{yoff}
\cofeCm{alpha}{scale}{angle}{xoff}{yoff}
\cofeDm{alpha}{scale}{angle}{xoff}{yoff}

where alpha is the transparency factor $\in [0,1]$. The scale factor is scale, and the standard is scale=1. The angle is in degrees $\in [0,360]$. The position relative to the centre of the page is given by x and y offsets xoff and yoff.

Genesis

The latex-coffee package.

by Hanno Rein, Cambridge University

http://hanno-rein.de [email protected]

November, 2010

Updated to TikZ (for compatibility with pdflatex)

by Evan Sultanik, Johns Hopkins University APL

http://www.sultanik.com/ [email protected]

Inspired by several arXiv papers (see eg. 0812.3367v2)

March, 2011

Adding more options and compatible with pdflatex

by Luis Randez, IUMA, University of Zaragoza

http://pcmap.unizar.es/~pilar/ [email protected]

May, 2012

Added placement parameters

by Adrian Robson

http://nepsweb.co.uk/homeapr/

December, 2014

Added random \cofeSplash{} (requires ifthen) and onEveryPage package option

added to github

by Sebastian Schmittner

http://www.thp.uni-koeln.de/~ses/

November, 2018

Added random \cofeBleed{} (requires ifthen) and bleed package option

added to github

by Anthony Mirand

https://anthonymirand.github.io/

License

MIT License, see LICENSE.