Debian Codegraph @

texmf-dist/doc/latex/eurion/README.md

raw
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/>