Debian Codegraph @

texmf-dist/doc/latex/eurion/eurion.tex

raw
1 \documentclass[a4paper, 11pt]{article}
2 \usepackage[manual]{eurion}
3 \usepackage[hidelinks]{hyperref}
4
5 \title{The \texttt{eurion} package}
6 \author{originalsouth\\\small\texttt{https://github.com/originalsouth/EURion}}
7 \date{v0.1.0 \quad 2026-04-26}
8
9 \begin{document}
10 \maketitle
11
12 \eurion[color=yellow, size=2]%
13 {[shift={(-3cm,-3cm)}]current page.north east}
14 \eurion[color=green, size=2]%
15 {[shift={( 3cm, 3cm)}]current page.south west}
16
17 \section{Overview}
18
19 \texttt{eurion} overlays the \emph{EURion constellation} -- the
20 five-circle anti-photocopy pattern from banknotes -- onto LaTeX
21 document pages. Three placement modes (scatter, corner, manual);
22 configurable color, size, density, rotation, and seed.
23
24 This is a \emph{visual reproduction only}. Modern image-editor
25 anti-copy features rely on Digimarc digital watermarks, not on the
26 EURion constellation alone, so this package will not actually prevent
27 photocopying or scanning.
28
29 \section{Installation}
30
31 Drop \texttt{eurion.sty} next to your \texttt{.tex} file, or into your
32 local \texttt{texmf} tree. The package needs \texttt{tikz},
33 \texttt{eso-pic}, \texttt{xkeyval}, and \texttt{xcolor}.
34
35 \section{Quick start}
36
37 \begin{verbatim}
38 \usepackage{eurion} % scatter mode, default
39 \usepackage[corner=top-right]{eurion} % one mark per corner
40 \usepackage[manual]{eurion} % no auto overlay
41 \eurion[color=orange]{current page.center}
42 \end{verbatim}
43
44 \section{Modes}
45
46 \begin{description}
47 \item[\texttt{scatter}] (default) Pseudo-random tiling at random
48 angles across every page.
49 \item[\texttt{corner}] A single constellation tucked into a chosen
50 corner of every page.
51 \item[\texttt{manual}] No automatic overlay; the user calls
52 \verb|\eurion[opts]{coord}| at the desired locations.
53 \end{description}
54
55 \section{Options}
56
57 \begin{tabular}{@{}lll@{}}
58 \textbf{Key} & \textbf{Values} & \textbf{Default} \\\hline
59 \texttt{mode} & \texttt{scatter} \textbar{} \texttt{corner} \textbar{} \texttt{manual} & \texttt{scatter} \\
60 \texttt{color} & \texttt{yellow} \textbar{} \texttt{green} \textbar{} \texttt{orange} \textbar{} xcolor expr & banknote gold \\
61 \texttt{size} & scale factor (\texttt{1} $\approx$ 1\,mm rings) & \texttt{1} \\
62 \texttt{density} & integer count per page (\texttt{scatter}) & \texttt{20} \\
63 \texttt{rotate} & \texttt{random} \textbar{} \texttt{none} \textbar{} degrees & \texttt{random} \\
64 \texttt{corner} & \texttt{top-left} \textbar{} \texttt{top-right} \textbar{} \texttt{bottom-left} \textbar{} \texttt{bottom-right} & \texttt{top-right} \\
65 \texttt{seed} & integer & \texttt{1} \\
66 \end{tabular}
67
68 \section{The \texttt{\textbackslash eurion} macro}
69
70 In any mode you can drop an extra constellation by hand:
71 \begin{verbatim}
72 \eurion[color=green, size=2, rotate=15]{current page.center}
73 \eurion[color=orange]{[shift={(3cm,-3cm)}]current page.north west}
74 \end{verbatim}
75 The argument is any TikZ coordinate; the macro draws inside its own
76 \texttt{remember picture, overlay} \texttt{tikzpicture}.
77
78 \section{Caveats}
79
80 \begin{itemize}
81 \item \textbf{Color channel only.} Detection software looks for the
82 rings in a color channel; a B\&W print of your PDF will hide the
83 pattern.
84 \item \textbf{Not real anti-copy.} See above; this is decorative.
85 \item \textbf{The exact spec is secret.} Public reproductions
86 disagree on coordinates; this package uses the geometry from
87 Petr Kutalek's PostScript gist.
88 \end{itemize}
89
90 \section{License}
91
92 WTFPL, see the \texttt{LICENSE} file. The author does not endorse this
93 license; it was picked because CTAN requires a license to be selected.
94
95 \section{References}
96
97 \begin{itemize}\setlength{\itemsep}{0pt}
98 \item \url{https://en.wikipedia.org/wiki/EURion_constellation}
99 \item \url{https://www.cl.cam.ac.uk/~mgk25/eurion.pdf}
100 \item \url{https://gist.github.com/petrkutalek/93b7eebf22f4dbcfab8cd80a91fd27a8}
101 \item \url{https://murdoch.is/projects/currency/}
102 \end{itemize}
103
104 \end{document}