| 1 |
# eurion.sty |
| 2 |
|
| 3 |
A LaTeX package that overlays the **EURion constellation** — the |
| 4 |
five-circle anti-photocopy pattern from banknotes — onto your document |
| 5 |
pages. Visual reproduction only; this is a stylistic gag, not real |
| 6 |
anti-counterfeiting protection. |
| 7 |
|
| 8 |
## Install |
| 9 |
|
| 10 |
Drop `eurion.sty` next to your `.tex` file, or into your local |
| 11 |
`texmf` tree (`~/texmf/tex/latex/eurion/eurion.sty`). |
| 12 |
|
| 13 |
Requires: `tikz`, `eso-pic`, `xkeyval`, `xcolor` (the last is pulled in |
| 14 |
by `tikz` already). |
| 15 |
|
| 16 |
## Quick start |
| 17 |
|
| 18 |
```latex |
| 19 |
\documentclass{article} |
| 20 |
\usepackage{eurion} % scatter mode, gist-yellow, default density |
| 21 |
\begin{document} |
| 22 |
... your document ... |
| 23 |
\end{document} |
| 24 |
``` |
| 25 |
|
| 26 |
Three layout modes: |
| 27 |
|
| 28 |
| Mode | What it does | |
| 29 |
|-----------|----------------------------------------------------------| |
| 30 |
| `scatter` | Pseudo-random tiling across every page (default). | |
| 31 |
| `corner` | One constellation in a chosen corner of every page. | |
| 32 |
| `manual` | No automatic overlay; you call `\eurion{...}` yourself. | |
| 33 |
|
| 34 |
```latex |
| 35 |
\usepackage[scatter, color=yellow, density=25, seed=42]{eurion} |
| 36 |
\usepackage[corner=top-right, color=green]{eurion} |
| 37 |
\usepackage[manual]{eurion} |
| 38 |
``` |
| 39 |
|
| 40 |
In any mode you can also drop an extra constellation by hand: |
| 41 |
|
| 42 |
```latex |
| 43 |
\eurion[color=orange, size=2, rotate=15]{current page.center} |
| 44 |
\eurion[color=green]{[shift={(3cm,-3cm)}]current page.north west} |
| 45 |
``` |
| 46 |
|
| 47 |
The second argument is any TikZ coordinate; the macro draws inside its |
| 48 |
own `remember picture, overlay` `tikzpicture`. |
| 49 |
|
| 50 |
## Options |
| 51 |
|
| 52 |
| Option | Values | Default | |
| 53 |
|-----------|-----------------------------------------------------------------|------------------| |
| 54 |
| `mode` | `scatter` \| `corner` \| `manual` | `scatter` | |
| 55 |
| `color` | `yellow` \| `green` \| `orange` \| any `xcolor` expression | banknote gold | |
| 56 |
| `size` | scale factor (`1` ≈ 1 mm rings, ≈ 4 mm overall spread) | `1` | |
| 57 |
| `density` | integer constellation count per page (in `scatter`) | `20` | |
| 58 |
| `rotate` | `random` \| `none` \| number of degrees | `random` | |
| 59 |
| `corner` | `top-left` \| `top-right` \| `bottom-left` \| `bottom-right` | `top-right` | |
| 60 |
| `seed` | integer; fixes the scatter pattern (page number is added in) | `1` | |
| 61 |
|
| 62 |
The flags `[scatter]`, `[corner]`, and `[manual]` are accepted as |
| 63 |
shortcuts for `mode=`. Writing `[corner]` alone selects corner mode at |
| 64 |
the default `top-right`; writing `[corner=top-left]` selects the mode |
| 65 |
*and* sets the corner. |
| 66 |
|
| 67 |
## Caveats |
| 68 |
|
| 69 |
- **Color channel only.** Real banknote detectors look for the rings |
| 70 |
in a color channel, not in greyscale. A B&W print or grayscale export |
| 71 |
of your PDF will hide the pattern. |
| 72 |
- **Not real anti-copy.** Modern image-editor blocks (Photoshop, Paint |
| 73 |
Shop Pro) actually rely on Digimarc digital watermarks (CBCDG), not |
| 74 |
on the EURion constellation alone. This package is decorative. |
| 75 |
- **The exact spec is secret.** Three publicly available reproductions |
| 76 |
disagree on exact coordinates; this package uses the geometry from |
| 77 |
Petr Kutalek's PostScript gist. |
| 78 |
|
| 79 |
## Examples |
| 80 |
|
| 81 |
| File | Mode shown | |
| 82 |
|-----------------------|------------| |
| 83 |
| `example.tex` | `scatter` | |
| 84 |
| `example-corner.tex` | `corner` | |
| 85 |
| `example-manual.tex` | `manual` | |
| 86 |
|
| 87 |
Build any of them with `pdflatex example.tex` (or `lualatex` / |
| 88 |
`xelatex`). |
| 89 |
|
| 90 |
## License |
| 91 |
|
| 92 |
WTFPL — see `LICENSE`. The author does not endorse this license; it |
| 93 |
was picked because CTAN distribution requires *some* license to be |
| 94 |
selected, and the WTFPL is the lowest-friction option that satisfies |
| 95 |
that requirement. (CTAN's metadata vocabulary doesn't carry a `wtfpl` |
| 96 |
key, so the catalogue lists it under `other-free`.) |
| 97 |
|
| 98 |
## References |
| 99 |
|
| 100 |
- <https://en.wikipedia.org/wiki/EURion_constellation> |
| 101 |
- Markus Kuhn's original write-up: <https://www.cl.cam.ac.uk/~mgk25/eurion.pdf> |
| 102 |
- Petr Kutalek's `eurionize` shell+PostScript gist (geometry source): |
| 103 |
<https://gist.github.com/petrkutalek/93b7eebf22f4dbcfab8cd80a91fd27a8> |
| 104 |
- Conor Armstrong's Python `eurion` (option-surface inspiration): |
| 105 |
<https://github.com/conorarmstrong/eurion> |
| 106 |
- Steven Murdoch on what *actually* triggers detection: |
| 107 |
<https://murdoch.is/projects/currency/> |