Debian Codegraph @

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

raw
1 % \LaTeX-Main\
2 % !TeX encoding=UTF-8
3 %% The LaTeX package tikzfill - version 1.2.0 (2026/04/23)
4 %% tikzfill.tex: Manual
5 %%
6 %% -------------------------------------------------------------------------------------------
7 %% Copyright (c) 2022-2026 by Prof. Dr. Dr. Thomas F. Sturm <thomas dot sturm at unibw dot de>
8 %% -------------------------------------------------------------------------------------------
9 %%
10 %% This work may be distributed and/or modified under the
11 %% conditions of the LaTeX Project Public License, either version 1.3
12 %% of this license or (at your option) any later version.
13 %% The latest version of this license is in
14 %% http://www.latex-project.org/lppl.txt
15 %% and version 1.3 or later is part of all distributions of LaTeX
16 %% version 2005/12/01 or later.
17 %%
18 %% This work has the LPPL maintenance status `author-maintained'.
19 %%
20 %% This work consists of all files listed in README.md
21 %%
22 % \RequirePackage[check-declarations,enable-debug]{expl3}
23 \documentclass[a4paper,11pt]{article}
24 \usepackage{tikzfill.doc}
25
26 \hypersetup{
27 pdftitle={Manual for the tikzfill package},
28 pdfauthor={Thomas F. Sturm},
29 pdfsubject={TikZ libraries for filling with images and patterns},
30 }
31
32 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
33 \begin{document}
34
35 \begin{tcboutputlisting}
36 % \documentclass[a4paper]{article}
37 % \usepackage{tikzfill}
38 % \usepackage[skins,breakable]{tcolorbox}
39 % \begin{document}
40 \begin{tcolorbox}[
41 spread,
42 blankest,
43 center upper,
44 phantom = \thispagestyle{empty},
45 top = 65mm,
46 fontupper = \bfseries,
47 frame engine = path,
48 frame style = {
49 fill = none,
50 preaction = {
51 fill gea Weihmichl = {
52 scale fixed = 1,
53 xstep = 21mm,
54 ystep equidistance,
55 style 1 = {},
56 style 2 = {fill=black!5},
57 style 3 = {fill=black!10},
58 draw-if-row-col =
59 {11/5,11/6,12/4,12/5,12/6,12/7,12/8,13/3,13/4,13/5,13/6,13/7,13/8},
60 freeze-row,
61 },
62 },
63 fill gea Edenland = {
64 scale fixed = 1,
65 xstep = 21mm,
66 ystep equidistance,
67 init-row< = \TFRowColorLet{mycolor}{red}{blue},
68 prime color 1 = mycolor,
69 draw-if-not-row-col =
70 {11/5,11/6,12/4,12/5,12/6,12/7,12/8,13/3,13/4,13/5,13/6,13/7,13/8},
71 freeze-row,
72 },
73 },
74 ]
75 \Huge The \texttt{tikzfill} package\\[10mm]
76 \Large Manual for version \version\ (\datum)\\[10mm]
77 \large Thomas F.~Sturm
78 \end{tcolorbox}
79 % \end{document}
80 \end{tcboutputlisting}
81 \tcbuselistingtext
82 \tcbinputlisting{title=Cover code,docexample,listing only}
83
84
85 \clearpage
86
87 \begin{center}
88 \begin{tcolorbox}[enhanced,hbox,tikznode,left=8mm,right=8mm,boxrule=0.4pt,
89 colback=white,colframe=black!50!yellow,
90 drop lifted shadow=black!50!yellow,arc is angular,
91 before=\par\vspace*{5mm},after=\par\bigskip]
92 {\bfseries\LARGE The \texttt{tikzfill} package}\\[3mm]
93 {\large Manual for version \version\ (\datum)}
94 \end{tcolorbox}
95 {\large Thomas F.~Sturm%
96 \footnote{Prof.~Dr.~Dr.~Thomas F.~Sturm, Institut f\"{u}r Mathematik und Informatik,
97 University of the Bundeswehr Munich, D-85577 Neubiberg, Germany;
98 email: \href{mailto:[email protected]}{[email protected]}}\par\medskip
99 \normalsize\url{https://www.ctan.org/pkg/tikzfill}\par
100 \url{https://github.com/T-F-S/tikzfill}
101 }
102 \end{center}
103 \bigskip
104 \begin{absquote}
105 \begin{center}\bfseries Abstract\end{center}
106 The |tikzfill| package is a collection of \tikzname\ libraries that provide
107 additional options for filling \tikzname\ paths with images and patterns. The
108 libraries support fillings based on external image files as well as \tikzname\
109 pictures. They also include patterns of hexagons and rhombi.
110
111 In addition, the package offers fillings composed of similar, though not
112 necessarily identical, small pictures arranged on a grid, providing greater
113 flexibility than usual \tikzname\ patterns.
114 \end{absquote}
115
116 \clearpage
117 \tableofcontents
118
119
120 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
121 \clearpage
122 \section{Short Introduction}\label{sec:intro}
123
124 \tikzname\ is a very advanced and comprehensive graphics package for \LaTeX.
125 The package |tikzfill| comprises a collection of libraries for \tikzname\, which
126 add further options to fill \tikzname\ paths with images and patterns.
127
128 For \LaTeX, the provided libraries can be loaded using the preferred
129 \tikzname\ mechanism by
130 \begin{dispListing*}{}
131 \usetikzlibrary{fill.***} % LaTeX (primary choice) and plain TeX
132 \end{dispListing*}
133 where |***| is to be replaced by the actual library name found on the following pages.
134
135 Alternatively, the libraries can be loaded using \LaTeX\ style files
136 \begin{dispListing*}{}
137 \usepackage{tikzfill.***} % LaTeX (secondary choice)
138 \end{dispListing*}
139
140 If you want to load all \tikzname\ libraries of this package, you can use
141 the following \LaTeX\ style file
142 \begin{dispListing*}{}
143 \usepackage{tikzfill} % load all libraries
144 \end{dispListing*}
145
146
147 \begin{myvoid}
148
149 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
150 \clearpage
151 \section{Image and Picture Fill Library}\label{sec:imagefill}%
152
153 \begin{dispListing*}{title=\tikzname\ Library |fill.image|}
154 \usetikzlibrary{fill.image} % LaTeX (primary choice) and plain TeX
155 \usetikzlibrary[fill.image] % ConTeXt
156 \usepackage{tikzfill.image} % LaTeX (secondary choice)
157 \end{dispListing*}
158
159 This library defines options to fill graphs with images or arbitrary pictures.
160
161 Until |tcolorbox| version 5.1.1 (2022/06/24), the code of this library was part
162 of |tcolorbox|. Now, on suggestion of
163 \href{https://github.com/muzimuzhi}{muzimuzhi},
164 it is a separate library usable without |tcolorbox|. Also, the code is
165 completely rewritten with |expl3|.
166
167
168
169 \subsection{Fill Plain}
170 \begin{docTikzKey}{fill plain image}{=\meta{file name}}{no default, initially unset}
171 Fills the current path with an external image referenced by \meta{file name}.
172 The image is put in the center of the path, but it is not resized to fit into
173 the path area.
174 \begin{dispExample*}{sbs,lefthand ratio=0.66,right=2mm,sidebyside gap=5mm,center lower}
175 \begin{tikzpicture}
176 \path[draw,fill plain image=goldshade.png]
177 (2.75,-0.75) -- (3,0) -- (2.75,0.75)
178 \foreach \w in {45,90,...,315}
179 { -- (\w:1.5cm) } -- cycle;
180 \end{tikzpicture}
181 \end{dispExample*}
182 \end{docTikzKey}
183
184
185 \begin{docTikzKey}{fill plain image*}{=\meta{file name}}{no default, initially unset}
186 Fills the current path with an external image referenced by \meta{file name}.
187 The image is put in the center of the path, but it is not resized to fit into
188 the path area.
189 The \meta{graphics options} are given to the underlying \docAuxCommand*{includegraphics} command.
190 \begin{dispExample*}{sbs,lefthand ratio=0.66,right=2mm,sidebyside gap=5mm,center lower}
191 \begin{tikzpicture}
192 \path[draw,
193 fill plain image*={width=2.5cm}{goldshade.png}]
194 (2.75,-0.75) -- (3,0) -- (2.75,0.75)
195 \foreach \w in {45,90,...,315}
196 { -- (\w:1.5cm) } -- cycle;
197 \end{tikzpicture}
198 \end{dispExample*}
199 \end{docTikzKey}
200
201 \enlargethispage*{8mm}
202
203 \begin{docTikzKey}{fill plain picture}{=\meta{graphical code}}{no default, initially unset}
204 Fills the current path with the given \meta{graphical code}.
205 The result is put in the center of the path, but it is not resized to fit into
206 the path area. Note that this is almost identical to the standard |path picture| option.
207 \begin{dispExample*}{sbs,lefthand ratio=0.66,right=2mm,sidebyside gap=5mm,center lower}
208 \begin{tikzpicture}
209 \path[draw,fill plain picture={%
210 \draw[red!50!yellow,line width=2mm]
211 (0,0) circle (8mm);
212 \draw[red,line width=5mm] (-1,-1) -- (1,1);
213 \draw[red,line width=5mm] (-1,1) -- (1,-1);
214 }]
215 (2.75,-0.75) -- (3,0) -- (2.75,0.75)
216 \foreach \w in {45,90,...,315}
217 { -- (\w:1.5cm) } -- cycle;
218 \end{tikzpicture}
219 \end{dispExample*}
220 \end{docTikzKey}
221
222
223 \clearpage
224 \subsection{Fill Stretch}
225 \begin{docTikzKey}{fill stretch image}{=\meta{file name}}{no default, initially unset}
226 Fills the current path with an external image referenced by \meta{file name}.
227 The image is stretched to fill the path area.
228 \begin{dispExample*}{sbs,lefthand ratio=0.66,right=2mm,sidebyside gap=5mm,center lower}
229 \begin{tikzpicture}
230 \path[fill stretch image=goldshade.png]
231 (2.75,-0.75) -- (3,0) -- (2.75,0.75)
232 \foreach \w in {45,90,...,315}
233 { -- (\w:1.5cm) } -- cycle;
234 \end{tikzpicture}
235 \end{dispExample*}
236 \end{docTikzKey}
237
238
239 \begin{docTikzKey}{fill stretch image*}{=\marg{graphics options}\marg{file name}}{no default, initially unset}
240 Fills the current path with an external image referenced by \meta{file name}.
241 The \meta{graphics options} are given to the underlying \docAuxCommand*{includegraphics} command.
242 The image is stretched to fill the path area.
243 \begin{dispExample*}{sbs,lefthand ratio=0.66,right=2mm,sidebyside gap=5mm,center lower}
244 \begin{tikzpicture}
245 \path[fill stretch image*=
246 {angle=90,origin=c}{goldshade.png}]
247 (2.75,-0.75) -- (3,0) -- (2.75,0.75)
248 \foreach \w in {45,90,...,315}
249 { -- (\w:1.5cm) } -- cycle;
250 \end{tikzpicture}
251 \end{dispExample*}
252 \end{docTikzKey}
253
254
255 \begin{docTikzKey}{fill stretch picture}{=\meta{graphical code}}{no default, initially unset}
256 Fills the current path with the given \meta{graphical code}.
257 The result is stretched to fill the path area.
258 \begin{dispExample*}{sbs,lefthand ratio=0.66,right=2mm,sidebyside gap=5mm,center lower}
259 \begin{tikzpicture}
260 \path[draw,fill stretch picture={%
261 \draw[red!50!yellow,line width=2mm]
262 (0,0) circle (8mm);
263 \draw[red,line width=5mm] (-1,-1) -- (1,1);
264 \draw[red,line width=5mm] (-1,1) -- (1,-1);
265 }]
266 (2.75,-0.75) -- (3,0) -- (2.75,0.75)
267 \foreach \w in {45,90,...,315}
268 { -- (\w:1.5cm) } -- cycle;
269 \end{tikzpicture}
270 \end{dispExample*}
271 \end{docTikzKey}
272
273
274 \clearpage
275 \subsection{Fill Overzoom}
276 \begin{docTikzKey}{fill overzoom image}{=\meta{file name}}{no default, initially unset}
277 Fills the current path with an external image referenced by \meta{file name}.
278 The image is zoomed such that the path area fills the image.
279 \begin{dispExample*}{sbs,lefthand ratio=0.66,right=2mm,sidebyside gap=5mm,center lower}
280 \begin{tikzpicture}
281 \path[fill overzoom image=goldshade.png]
282 (2.75,-0.75) -- (3,0) -- (2.75,0.75)
283 \foreach \w in {45,90,...,315}
284 { -- (\w:1.5cm) } -- cycle;
285 \end{tikzpicture}
286 \end{dispExample*}
287 \end{docTikzKey}
288
289
290 \begin{docTikzKey}{fill overzoom image*}{=\marg{graphics options}\marg{file name}}{no default, initially unset}
291 Fills the current path with an external image referenced by \meta{file name}.
292 The \meta{graphics options} are given to the underlying \docAuxCommand*{includegraphics} command.
293 The image is zoomed such that the path area fills the image.
294 \begin{dispExample*}{sbs,lefthand ratio=0.66,right=2mm,sidebyside gap=5mm,center lower}
295 \begin{tikzpicture}
296 \path[fill overzoom image*=
297 {angle=90,origin=c}{goldshade.png}]
298 (2.75,-0.75) -- (3,0) -- (2.75,0.75)
299 \foreach \w in {45,90,...,315}
300 { -- (\w:1.5cm) } -- cycle;
301 \end{tikzpicture}
302 \end{dispExample*}
303 \end{docTikzKey}
304
305
306 \begin{docTikzKey}{fill overzoom picture}{=\meta{graphical code}}{no default, initially unset}
307 Fills the current path with the given \meta{graphical code}.
308 The result is zoomed such that the path area fills the image.
309 \begin{dispExample*}{sbs,lefthand ratio=0.66,right=2mm,sidebyside gap=5mm,center lower}
310 \begin{tikzpicture}
311 \path[draw,fill overzoom picture={%
312 \draw[red!50!yellow,line width=2mm]
313 (0,0) circle (8mm);
314 \draw[red,line width=5mm] (-1,-1) -- (1,1);
315 \draw[red,line width=5mm] (-1,1) -- (1,-1);
316 }]
317 (2.75,-0.75) -- (3,0) -- (2.75,0.75)
318 \foreach \w in {45,90,...,315}
319 { -- (\w:1.5cm) } -- cycle;
320 \end{tikzpicture}
321 \end{dispExample*}
322 \end{docTikzKey}
323
324
325 \clearpage
326 \subsection{Fill Zoom}
327 \begin{docTikzKey}{fill zoom image}{=\meta{file name}}{no default, initially unset}
328 Fills the current path with an external image referenced by \meta{file name}.
329 The image is zoomed such that it fits inside the path area.
330 Typically, some parts of the path area will stay unfilled.
331 \begin{dispExample*}{sbs,lefthand ratio=0.66,right=2mm,sidebyside gap=5mm,center lower}
332 \begin{tikzpicture}
333 \path[draw,fill zoom image=goldshade.png]
334 (2.75,-0.75) -- (3,0) -- (2.75,0.75)
335 \foreach \w in {45,90,...,315}
336 { -- (\w:1.5cm) } -- cycle;
337 \end{tikzpicture}
338 \end{dispExample*}
339 \end{docTikzKey}
340
341
342 \begin{docTikzKey}{fill zoom image*}{=\marg{graphics options}\marg{file name}}{no default, initially unset}
343 Fills the current path with an external image referenced by \meta{file name}.
344 The \meta{graphics options} are given to the underlying \docAuxCommand*{includegraphics} command.
345 The image is zoomed such that it fits inside the path area.
346 Typically, some parts of the path area will stay unfilled.
347 \begin{dispExample*}{sbs,lefthand ratio=0.66,right=2mm,sidebyside gap=5mm,center lower}
348 \begin{tikzpicture}
349 \path[draw,fill zoom image*=
350 {angle=90,origin=c}{goldshade.png}]
351 (2.75,-0.75) -- (3,0) -- (2.75,0.75)
352 \foreach \w in {45,90,...,315}
353 { -- (\w:1.5cm) } -- cycle;
354 \end{tikzpicture}
355 \end{dispExample*}
356 \end{docTikzKey}
357
358
359 \begin{docTikzKey}{fill zoom picture}{=\meta{graphical code}}{no default, initially unset}
360 Fills the current path with the given \meta{graphical code}.
361 The result is zoomed such that it fits inside the path area.
362 Typically, some parts of the path area will stay unfilled.
363 \begin{dispExample*}{sbs,lefthand ratio=0.66,right=2mm,sidebyside gap=5mm,center lower}
364 \begin{tikzpicture}
365 \path[draw,fill zoom picture={%
366 \draw[red!50!yellow,line width=2mm]
367 (0,0) circle (8mm);
368 \draw[red,line width=5mm] (-1,-1) -- (1,1);
369 \draw[red,line width=5mm] (-1,1) -- (1,-1);
370 }]
371 (2.75,-0.75) -- (3,0) -- (2.75,0.75)
372 \foreach \w in {45,90,...,315}
373 { -- (\w:1.5cm) } -- cycle;
374 \end{tikzpicture}
375 \end{dispExample*}
376 \end{docTikzKey}
377
378
379 \clearpage
380 \subsection{Fill Shrink}
381 \begin{docTikzKey}{fill shrink image}{=\meta{file name}}{no default, initially unset}
382 Fills the current path with an external image referenced by \meta{file name}.
383 The image is zoomed such that it fits inside the path area, but it never
384 gets enlarged.
385 Typically, some parts of the path area will stay unfilled.
386 \begin{dispExample*}{sbs,lefthand ratio=0.66,right=2mm,sidebyside gap=5mm,center lower}
387 \begin{tikzpicture}
388 \path[draw,fill shrink image=goldshade.png]
389 (2.75,-0.75) -- (3,0) -- (2.75,0.75)
390 \foreach \w in {45,90,...,315}
391 { -- (\w:1.5cm) } -- cycle;
392 \end{tikzpicture}
393 \end{dispExample*}
394 \end{docTikzKey}
395
396
397 \begin{docTikzKey}{fill shrink image*}{=\meta{file name}}{no default, initially unset}
398 Fills the current path with an external image referenced by \meta{file name}.
399 The \meta{graphics options} are given to the underlying \docAuxCommand*{includegraphics} command.
400 The image is zoomed such that it fits inside the path area, but it never
401 gets enlarged.
402 Typically, some parts of the path area will stay unfilled.
403 \begin{dispExample*}{sbs,lefthand ratio=0.66,right=2mm,sidebyside gap=5mm,center lower}
404 \begin{tikzpicture}
405 \path[draw,
406 fill shrink image*={width=1.5cm}{goldshade.png}]
407 (2.75,-0.75) -- (3,0) -- (2.75,0.75)
408 \foreach \w in {45,90,...,315}
409 { -- (\w:1.5cm) } -- cycle;
410 \end{tikzpicture}
411 \end{dispExample*}
412 \end{docTikzKey}
413
414
415 \begin{docTikzKey}{fill shrink picture}{=\meta{graphical code}}{no default, initially unset}
416 Fills the current path with the given \meta{graphical code}.
417 The result is zoomed such that it fits inside the path area, but it never
418 gets enlarged.
419 Typically, some parts of the path area will stay unfilled.
420 \begin{dispExample*}{sbs,lefthand ratio=0.66,right=2mm,sidebyside gap=5mm,center lower}
421 \begin{tikzpicture}
422 \path[draw,fill shrink picture={%
423 \draw[red!50!yellow,line width=2mm]
424 (0,0) circle (8mm);
425 \draw[red,line width=5mm] (-1,-1) -- (1,1);
426 \draw[red,line width=5mm] (-1,1) -- (1,-1);
427 }]
428 (2.75,-0.75) -- (3,0) -- (2.75,0.75)
429 \foreach \w in {45,90,...,315}
430 { -- (\w:1.5cm) } -- cycle;
431 \end{tikzpicture}
432 \end{dispExample*}
433 \end{docTikzKey}
434
435
436 \clearpage
437 \subsection{Fill Tile}
438 \begin{docTikzKey}{fill tile image}{=\meta{file name}}{no default, initially unset}
439 Fills the current path with a tile pattern using an external image referenced by \meta{file name}.
440 \begin{dispExample*}{sbs,lefthand ratio=0.66,right=2mm,sidebyside gap=5mm,center lower}
441 \begin{tikzpicture}
442 \path[fill tile image=pink_marble.png]
443 (2.75,-0.75) -- (3,0) -- (2.75,0.75)
444 \foreach \w in {45,90,...,315}
445 { -- (\w:1.5cm) } -- cycle;
446 \end{tikzpicture}
447 \end{dispExample*}
448 \end{docTikzKey}
449
450
451 \begin{docTikzKey}{fill tile image*}{=\marg{graphics options}\marg{file name}}{no default, initially unset}
452 Fills the current path with a tile pattern using an external image referenced by \meta{file name}.
453 The \meta{graphics options} are given to the underlying \docAuxCommand*{includegraphics} command.
454 \begin{dispExample*}{sbs,lefthand ratio=0.66,right=2mm,sidebyside gap=5mm,center lower}
455 \begin{tikzpicture}
456 \path[fill tile image*={width=8mm}{pink_marble.png}]
457 (2.75,-0.75) -- (3,0) -- (2.75,0.75)
458 \foreach \w in {45,90,...,315}
459 { -- (\w:1.5cm) } -- cycle;
460 \end{tikzpicture}
461 \end{dispExample*}
462 \end{docTikzKey}
463
464 \begin{docTikzKey}{fill tile picture}{=\meta{graphical code}}{no default, initially unset}
465 Fills the current path with a tile pattern using the given \meta{graphical code}.
466 \begin{dispExample*}{sbs,lefthand ratio=0.66,right=2mm,sidebyside gap=5mm,center lower}
467 \begin{tikzpicture}
468 \path[draw,fill tile picture={%
469 \draw[red!50!yellow,line width=2mm]
470 (0,0) circle (8mm);
471 \draw[red,line width=5mm] (-1,-1) -- (1,1);
472 \draw[red,line width=5mm] (-1,1) -- (1,-1);
473 }]
474 (2.75,-0.75) -- (3,0) -- (2.75,0.75)
475 \foreach \w in {45,90,...,315}
476 { -- (\w:1.5cm) } -- cycle;
477 \end{tikzpicture}
478 \end{dispExample*}
479 \end{docTikzKey}
480
481
482 \begin{docTikzKey}{fill tile picture*}{=\marg{fraction}\marg{graphical code}}{no default, initially unset}
483 Fills the current path with a tile pattern using the given \meta{graphical code}.
484 The graphic is resized by \meta{fraction}.
485 \begin{dispExample*}{sbs,lefthand ratio=0.66,right=2mm,sidebyside gap=5mm,center lower}
486 \begin{tikzpicture}
487 \path[draw,fill tile picture*={0.25}{%
488 \draw[red!50!yellow,line width=2mm]
489 (0,0) circle (8mm);
490 \draw[red,line width=5mm] (-1,-1) -- (1,1);
491 \draw[red,line width=5mm] (-1,1) -- (1,-1);
492 }]
493 (2.75,-0.75) -- (3,0) -- (2.75,0.75)
494 \foreach \w in {45,90,...,315}
495 { -- (\w:1.5cm) } -- cycle;
496 \end{tikzpicture}
497 \end{dispExample*}
498 \end{docTikzKey}
499
500
501 \clearpage
502 \subsection{Filling Options}
503 \begin{docTikzKey}{fill image opacity}{=\meta{fraction}}{no default, initially |1.0|}
504 Sets the fill opacity for the image or picture fill options to the given \meta{fraction}.
505 \begin{dispExample}
506 \begin{tikzpicture}
507 \path[fill stretch image=goldshade.png] (0,0) circle (8mm);
508 \path[fill=red,fill stretch image=goldshade.png,fill image opacity=0.75]
509 (2,0) circle (8mm);
510 \path[fill=red,fill stretch image=goldshade.png,fill image opacity=0.5]
511 (4,0) circle (8mm);
512 \path[fill=red,fill stretch image=goldshade.png,fill image opacity=0.25]
513 (6,0) circle (8mm);
514 \path[fill=red] (8,0) circle (8mm);
515 \end{tikzpicture}
516 \end{dispExample}
517 \end{docTikzKey}
518
519
520 \begin{docTikzKey}{fill image scale}{=\meta{fraction}}{no default, initially |1.0|}
521 Stretches, zooms, overzooms or shrinks the image or picture to the given \meta{fraction} of the
522 width and height of the current path.
523 \begin{dispExample}
524 \begin{tikzpicture}
525 \path[draw,fill zoom image=goldshade.png]
526 (0,0) rectangle +(2,2);
527
528 \path[draw,fill zoom image=goldshade.png,fill image scale=0.75]
529 (3,0) rectangle +(2,2);
530
531 \path[draw,fill zoom image=goldshade.png,fill image scale=1.5]
532 (6,0) rectangle +(2,2);
533 \end{tikzpicture}
534 \end{dispExample}
535 \end{docTikzKey}
536
537
538 \begin{docTikzKey}{fill image options}{=\meta{graphics options}}{no default, initially empty}
539 The \meta{graphics options} are given to the underlying \docAuxCommand*{includegraphics} command
540 for the image fill options. This can be just together with
541 \refKey{/tikz/fill stretch image}, \refKey{/tikz/fill overzoom image}, \refKey{/tikz/fill zoom image},
542 and \refKey{/tikz/fill tile image}.
543 \begin{dispExample*}{sbs,lefthand ratio=0.66,right=2mm,sidebyside gap=5mm,center lower}
544 \begin{tikzpicture}
545 \path[fill image options={width=8mm},
546 fill tile image=pink_marble.png]
547 (2.75,-0.75) -- (3,0) -- (2.75,0.75)
548 \foreach \w in {45,90,...,315}
549 { -- (\w:1.5cm) } -- cycle;
550 \end{tikzpicture}
551 \end{dispExample*}
552 \end{docTikzKey}
553
554
555 \begin{dispExample*}{sbs,lefthand ratio=0.6,center lower,fonttitle=\bfseries,
556 title=Image blending example}
557 \begin{tikzpicture}[every node/.style=
558 {circle,minimum width=2cm}]
559 \node[fill stretch image=blueshade.png]
560 (A) at (120:3cm) {A};
561 \node[fill stretch image=goldshade.png]
562 (B) at (60:3cm) {B};
563 \node[
564 preaction={fill stretch image=blueshade.png},
565 fill stretch image=goldshade.png,
566 fill image opacity=0.5] (C) {C};
567 \path (A) -- node{$+$} (B);
568 \draw[->,very thick] (A)--(C);
569 \draw[->,very thick] (B)--(C);
570 \end{tikzpicture}
571 \end{dispExample*}
572
573
574
575
576
577
578 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
579 \clearpage
580 \section{Hexagon Pattern Library}\label{sec:hexagon}%
581
582 \begin{dispListing*}{title=\tikzname\ Library |fill.hexagon|}
583 \usetikzlibrary{fill.hexagon} % LaTeX (primary choice) and plain TeX
584 \usetikzlibrary[fill.hexagon] % ConTeXt
585 \usepackage{tikzfill.hexagon} % LaTeX (secondary choice)
586 \end{dispListing*}
587
588 Based on |patterns.meta|, this library defines new hexagon patterns to fill graphs.
589
590
591
592 %-------------------------------------------------------------------------------
593 \subsection{Hexagon}
594 The \docValue{hexagon} pattern draws hexagons which may be filled or outlined.
595 A single pattern is one of two different \emph{bands}, called band 0 and band 1.
596
597 \begin{dispExample*}{sbs,lefthand ratio=0.66,right=2mm,sidebyside gap=5mm,center lower}
598 \begin{tikzpicture}
599 \draw[
600 pattern = { hexagon
601 [
602 size = 5mm, angle = 15, line width = 1mm
603 ]},
604 pattern color=red
605 ]
606 (0,0) rectangle (4,4);
607 \end{tikzpicture}
608 \end{dispExample*}
609
610 Both bands together build a uniform combined pattern.
611
612 \begin{dispExample*}{sbs,lefthand ratio=0.66,right=2mm,sidebyside gap=5mm,center lower}
613 \begin{tikzpicture}
614 \draw[
615 preaction = {
616 pattern = { hexagon
617 [
618 size = 5mm, angle = 15, line width = 1mm, band = 1
619 ]},
620 pattern color=blue },
621 pattern = { hexagon
622 [
623 size = 5mm, angle = 15, line width = 1mm, band = 0
624 ]},
625 pattern color=red
626 ]
627 (0,0) rectangle (4,4);
628 \end{tikzpicture}
629 \end{dispExample*}
630
631 \begin{docTikzKey}{pattern hexagon}{=\marg{pattern keys}}{style, no default}
632 Convenience shortcut for setting the combined pattern (in one color).
633
634 \begin{dispExample*}{sbs,lefthand ratio=0.66,right=2mm,sidebyside gap=5mm,center lower}
635 \begin{tikzpicture}
636 \draw[
637 pattern hexagon =
638 {
639 size = 5mm, angle = 15, line width = 1mm
640 },
641 pattern color=red
642 ]
643 (0,0) rectangle (4,4);
644 \end{tikzpicture}
645 \end{dispExample*}
646 \end{docTikzKey}
647
648 \clearpage
649
650 \begin{docPatternKey}[][doc label=size@hex]{size}{=\meta{size}}{no default, initially |8mm|}
651 The given \meta{size} denotes the length of an edge of one hexagonical tile
652 where the (possibly smaller) hexagon is located in.
653 \begin{dispExample*}{sbs,lefthand ratio=0.66,right=2mm,sidebyside gap=5mm,center lower}
654 \begin{tikzpicture}
655 \draw[
656 pattern hexagon =
657 {
658 size = 5mm,
659 },
660 pattern color=red
661 ]
662 (0,0) rectangle (4,4);
663 \end{tikzpicture}
664 \end{dispExample*}
665 \end{docPatternKey}
666
667
668
669 \begin{docPatternKey}[][doc label=fill@hex]{fill}{}{no value, initially set}
670 Sets the hexagons to be filled. |fill| and |draw| are mutually exclusionary.
671 \begin{dispExample*}{sbs,lefthand ratio=0.66,right=2mm,sidebyside gap=5mm,center lower}
672 \begin{tikzpicture}
673 \draw[
674 pattern hexagon =
675 {
676 fill,
677 },
678 pattern color=red
679 ]
680 (0,0) rectangle (4,4);
681 \end{tikzpicture}
682 \end{dispExample*}
683 \end{docPatternKey}
684
685
686 \begin{docPatternKey}[][doc label=draw@hex]{draw}{}{no value, initially unset}
687 Sets the hexagons to be outlined. |fill| and |draw| are mutually exclusionary.
688 \begin{dispExample*}{sbs,lefthand ratio=0.66,right=2mm,sidebyside gap=5mm,center lower}
689 \begin{tikzpicture}
690 \draw[
691 pattern hexagon =
692 {
693 draw,
694 },
695 pattern color=red
696 ]
697 (0,0) rectangle (4,4);
698 \end{tikzpicture}
699 \end{dispExample*}
700 \end{docPatternKey}
701
702
703 \begin{docPatternKey}[][doc label=line width@hex]{line width}{=\meta{length}}{no default, initially |0.4pt|}
704 Sets the \meta{length} value of the line width.
705 This is only relevant, if the hexagons are not filled.
706 \begin{dispExample*}{sbs,lefthand ratio=0.66,right=2mm,sidebyside gap=5mm,center lower}
707 \begin{tikzpicture}
708 \draw[
709 pattern hexagon =
710 {
711 draw, line width = 1mm,
712 },
713 pattern color=red
714 ]
715 (0,0) rectangle (4,4);
716 \end{tikzpicture}
717 \end{dispExample*}
718 \end{docPatternKey}
719
720
721
722 \begin{docPatternKeys}
723 {
724 {
725 doc name = xshift,
726 doc parameter = {=\meta{xshift}},
727 doc description = {no default, initially |0pt|},
728 doc label = xshift@hex
729 },
730 {
731 doc name = yshift,
732 doc parameter = {=\meta{yshift}},
733 doc description = {no default, initially |0pt|},
734 doc label = yshift@hex
735 }
736 }
737 The pattern is shifted by \meta{xshift} and \meta{yshift}.
738 \par
739 Note that for \docValue*{hexagon} is valid, that a pattern is shifted first and rotated afterwards.
740 \begin{dispExample*}{sbs,lefthand ratio=0.66,right=2mm,sidebyside gap=5mm,center lower}
741 \begin{tikzpicture}
742 \draw[
743 preaction={pattern hexagon grid, pattern color=blue},
744 pattern hexagon =
745 {
746 xshift=3mm, yshift=1mm,
747 },
748 pattern color=red
749 ]
750 (0,0) rectangle (4,4);
751 \end{tikzpicture}
752 \end{dispExample*}
753 \end{docPatternKeys}
754
755
756
757 \begin{docPatternKey}[][doc label=angle@hex]{angle}{=\meta{angle}}{no default, initially |0|}
758 The pattern is rotated by the given \meta{angle}.
759 \par
760 Note that for \docValue*{hexagon} is valid, that a pattern is shifted first and rotated afterwards.
761 \begin{dispExample*}{sbs,lefthand ratio=0.66,right=2mm,sidebyside gap=5mm,center lower}
762 \begin{tikzpicture}
763 \draw[
764 pattern hexagon =
765 {
766 angle = 15,
767 },
768 pattern color=red
769 ]
770 (0,0) rectangle (4,4);
771 \end{tikzpicture}
772 \end{dispExample*}
773 \end{docPatternKey}
774
775
776
777 \begin{docPatternKey}[][doc label=pos@hex]{pos}{=\meta{value}}{no default, initially |0.8|}
778 Sets the edge position with a \meta{value} between 0 and 1, where $0$ is
779 the center and $1$ the outer rim of the hexagonical tile. $1$ is a less
780 efficient way to either fill the whole graph or to draw a \docValue*{hexagon grid}.
781
782 \begin{dispExample*}{sbs,lefthand ratio=0.66,right=2mm,sidebyside gap=5mm,center lower}
783 \begin{tikzpicture}
784 \draw[
785 preaction={ pattern hexagon={pos=0.8},
786 pattern color=blue!80!red },
787 preaction={ pattern hexagon={pos=0.6},
788 pattern color=blue!60!red },
789 preaction={ pattern hexagon={pos=0.4},
790 pattern color=blue!40!red },
791 pattern hexagon={pos=0.2},
792 pattern color=blue!20!red,
793 ]
794 (0,0) rectangle (4,4);
795 \end{tikzpicture}
796 \end{dispExample*}
797 \end{docPatternKey}
798
799
800 \clearpage
801
802
803 \begin{docPatternKey}[][doc label=band@hex]{band}{=\meta{number}}{no default, initially |0|}
804 \meta{number} can take 0 or 1 and denotes one of two different bands of the pattern.
805 \begin{dispExample*}{sbs,lefthand ratio=0.66,right=2mm,sidebyside gap=5mm,center lower}
806 \begin{tikzpicture}
807 \draw[
808 preaction = { pattern={hexagon[band=1,draw,
809 line width=1mm]},
810 pattern color=blue },
811 pattern={hexagon[band=0,pos=0.5]},
812 pattern color=red
813 ]
814 (0,0) rectangle (4,4);
815 \end{tikzpicture}
816 \end{dispExample*}
817 \end{docPatternKey}
818
819
820
821 \clearpage
822 %-------------------------------------------------------------------------------
823 \subsection{Hexagon Grid}
824 The \docValue{hexagon grid} pattern draws a grid made of hexagons. It is
825 a single pattern und more efficient than \docValue*{hexagon} with settings |draw,pos=1|.
826
827 \begin{dispExample*}{sbs,lefthand ratio=0.66,right=2mm,sidebyside gap=5mm,center lower}
828 \begin{tikzpicture}
829 \draw[
830 pattern = { hexagon grid
831 [
832 size = 5mm, angle = 15, line width = 1mm
833 ]},
834 pattern color=red
835 ]
836 (0,0) rectangle (4,4);
837 \end{tikzpicture}
838 \end{dispExample*}
839
840
841 \begin{docTikzKey}{pattern hexagon grid}{=\marg{pattern keys}}{style, no default}
842 Convenience shortcut for setting the pattern to \docValue{hexagon grid}:
843 \begin{dispListing}
844 pattern = { hexagon grid [ ... ] }
845 \end{dispListing}
846 \begin{dispExample*}{sbs,lefthand ratio=0.66,right=2mm,sidebyside gap=5mm,center lower}
847 \begin{tikzpicture}
848 \draw[
849 pattern hexagon grid =
850 {
851 size = 5mm, angle = 15, line width = 1mm
852 },
853 pattern color=red
854 ]
855 (0,0) rectangle (4,4);
856 \end{tikzpicture}
857 \end{dispExample*}
858 \end{docTikzKey}
859
860
861
862 \begin{docPatternKey}[][doc label=size@hexgrid]{size}{=\meta{size}}{no default, initially |8mm|}
863 The given \meta{size} denotes the length of an edge of one hexagon.
864 \begin{dispExample*}{sbs,lefthand ratio=0.66,right=2mm,sidebyside gap=5mm,center lower}
865 \begin{tikzpicture}
866 \draw[
867 pattern hexagon grid =
868 {
869 size = 5mm,
870 },
871 pattern color=red
872 ]
873 (0,0) rectangle (4,4);
874 \end{tikzpicture}
875 \end{dispExample*}
876 \end{docPatternKey}
877
878 \clearpage
879
880
881 \begin{docPatternKeys}
882 {
883 {
884 doc name = xshift,
885 doc parameter = {=\meta{xshift}},
886 doc description = {no default, initially |0pt|},
887 doc label = xshift@hexgrid
888 },
889 {
890 doc name = yshift,
891 doc parameter = {=\meta{yshift}},
892 doc description = {no default, initially |0pt|},
893 doc label = yshift@hexgrid
894 }
895 }
896 The pattern is shifted by \meta{xshift} and \meta{yshift}.
897 \par
898 Note that for \docValue*{hexagon grid} is valid, that a pattern is shifted first and rotated afterwards.
899 \begin{dispExample*}{sbs,lefthand ratio=0.66,right=2mm,sidebyside gap=5mm,center lower}
900 \begin{tikzpicture}
901 \draw[
902 preaction={pattern={hexagon grid}, pattern color=blue},
903 pattern hexagon grid =
904 {
905 xshift=3mm, yshift=1mm,
906 },
907 pattern color=red
908 ]
909 (0,0) rectangle (4,4);
910 \end{tikzpicture}
911 \end{dispExample*}
912 \end{docPatternKeys}
913
914
915 \begin{docPatternKey}[][doc label=angle@hexgrid]{angle}{=\meta{angle}}{no default, initially |0|}
916 The pattern is rotated by the given \meta{angle}.
917 \par
918 Note that for \docValue*{hexagon grid} is valid, that a pattern is shifted first and rotated afterwards.
919 \begin{dispExample*}{sbs,lefthand ratio=0.66,right=2mm,sidebyside gap=5mm,center lower}
920 \begin{tikzpicture}
921 \draw[
922 pattern hexagon grid =
923 {
924 angle = 15,
925 },
926 pattern color=red
927 ]
928 (0,0) rectangle (4,4);
929 \end{tikzpicture}
930 \end{dispExample*}
931 \end{docPatternKey}
932
933
934
935 \begin{docPatternKey}[][doc label=line width@hexgrid]{line width}{=\meta{length}}{no default, initially |0.4pt|}
936 Sets the \meta{length} value of the line width.
937 \begin{dispExample*}{sbs,lefthand ratio=0.66,right=2mm,sidebyside gap=5mm,center lower}
938 \begin{tikzpicture}
939 \draw[
940 pattern hexagon grid =
941 {
942 line width = 2mm,
943 },
944 pattern color=red
945 ]
946 (0,0) rectangle (4,4);
947 \end{tikzpicture}
948 \end{dispExample*}
949 \end{docPatternKey}
950
951
952 \clearpage
953 %-------------------------------------------------------------------------------
954 \subsection{Hexagon Cycle}
955 The \docValue{hexagon cycle} pattern draws several hexagon rings in a cyclic manor.
956 A single pattern is one of two different \emph{bands}, called band 0 and band 1.
957
958 \begin{dispExample*}{sbs,lefthand ratio=0.66,right=2mm,sidebyside gap=5mm,center lower}
959 \begin{tikzpicture}
960 \draw[
961 pattern = { hexagon cycle
962 [
963 size = 5mm, angle = 15
964 ]},
965 pattern color=red
966 ]
967 (0,0) rectangle (4,4);
968 \end{tikzpicture}
969 \end{dispExample*}
970
971 Both bands together build a uniform combined pattern.
972
973 \begin{dispExample*}{sbs,lefthand ratio=0.66,right=2mm,sidebyside gap=5mm,center lower}
974 \begin{tikzpicture}
975 \draw[
976 preaction = {
977 pattern = { hexagon cycle
978 [
979 size = 5mm, angle = 15, band = 1
980 ]},
981 pattern color=blue },
982 pattern = { hexagon cycle
983 [
984 size = 5mm, angle = 15, band = 0
985 ]},
986 pattern color=red
987 ]
988 (0,0) rectangle (4,4);
989 \end{tikzpicture}
990 \end{dispExample*}
991
992 \begin{docTikzKey}{pattern hexagon cycle}{=\marg{pattern keys}}{style, no default}
993 Convenience shortcut for setting the combined pattern (in one color).
994
995 \begin{dispExample*}{sbs,lefthand ratio=0.66,right=2mm,sidebyside gap=5mm,center lower}
996 \begin{tikzpicture}
997 \draw[
998 pattern hexagon cycle =
999 {
1000 size = 5mm, angle = 15
1001 },
1002 pattern color=red
1003 ]
1004 (0,0) rectangle (4,4);
1005 \end{tikzpicture}
1006 \end{dispExample*}
1007 \end{docTikzKey}
1008
1009 \clearpage
1010
1011 \begin{docPatternKey}[][doc label=size@hexcycle]{size}{=\meta{size}}{no default, initially |8mm|}
1012 The given \meta{size} denotes the length of an edge of one hexagonical tile
1013 where the (smaller) hexagons are located in.
1014 \begin{dispExample*}{sbs,lefthand ratio=0.66,right=2mm,sidebyside gap=5mm,center lower}
1015 \begin{tikzpicture}
1016 \draw[
1017 pattern hexagon cycle =
1018 {
1019 size = 5mm,
1020 },
1021 pattern color=red
1022 ]
1023 (0,0) rectangle (4,4);
1024 \end{tikzpicture}
1025 \end{dispExample*}
1026 \end{docPatternKey}
1027
1028
1029 \begin{docPatternKeys}
1030 {
1031 {
1032 doc name = xshift,
1033 doc parameter = {=\meta{xshift}},
1034 doc description = {no default, initially |0pt|},
1035 doc label = xshift@hexcycle
1036 },
1037 {
1038 doc name = yshift,
1039 doc parameter = {=\meta{yshift}},
1040 doc description = {no default, initially |0pt|},
1041 doc label = yshift@hexcycle
1042 }
1043 }
1044 The pattern is shifted by \meta{xshift} and \meta{yshift}.
1045 \par
1046 Note that for \docValue*{hexagon cycle} is valid, that a pattern is shifted first and rotated afterwards.
1047 \begin{dispExample*}{sbs,lefthand ratio=0.66,right=2mm,sidebyside gap=5mm,center lower}
1048 \begin{tikzpicture}
1049 \draw[
1050 postaction={pattern={hexagon grid}, pattern color=blue},
1051 pattern hexagon cycle =
1052 {
1053 xshift=3mm, yshift=1mm,
1054 },
1055 pattern color=red
1056 ]
1057 (0,0) rectangle (4,4);
1058 \end{tikzpicture}
1059 \end{dispExample*}
1060 \end{docPatternKeys}
1061
1062
1063 \begin{docPatternKey}[][doc label=angle@hexcycle]{angle}{=\meta{angle}}{no default, initially |0|}
1064 The pattern is rotated by the given \meta{angle}.
1065 \par
1066 Note that for \docValue*{hexagon cycle} is valid, that a pattern is shifted first and rotated afterwards.
1067 \begin{dispExample*}{sbs,lefthand ratio=0.66,right=2mm,sidebyside gap=5mm,center lower}
1068 \begin{tikzpicture}
1069 \draw[
1070 pattern hexagon cycle =
1071 {
1072 angle = 15,
1073 },
1074 pattern color=red
1075 ]
1076 (0,0) rectangle (4,4);
1077 \end{tikzpicture}
1078 \end{dispExample*}
1079 \end{docPatternKey}
1080
1081
1082 \clearpage
1083
1084
1085 \begin{docPatternKey}[][doc label=rings@hexcycle]{rings}{=\meta{number}}{no default, initially |3|}
1086 Sets the \meta{number} of rings as $0, 1, 2, 3, \ldots$
1087
1088 \begin{dispExample*}{sbs,lefthand ratio=0.66,right=2mm,sidebyside gap=5mm,center lower}
1089 \begin{tikzpicture}
1090 \draw[
1091 pattern hexagon cycle =
1092 {
1093 rings = 2,
1094 },
1095 pattern color=red
1096 ]
1097 (0,0) rectangle (4,4);
1098 \end{tikzpicture}
1099 \end{dispExample*}
1100 \end{docPatternKey}
1101
1102
1103 \begin{docPatternKey}[][doc label=gap@hexcycle]{gap}{=\meta{value}}{no default, initially |1|}
1104 Sets the gap between two rings as \meta{value} times the line width of a ring.
1105 \meta{value} has to be greater or equal $0.01$.
1106
1107 \begin{dispExample*}{sbs,lefthand ratio=0.66,right=2mm,sidebyside gap=5mm,center lower}
1108 \begin{tikzpicture}
1109 \draw[
1110 pattern hexagon cycle =
1111 {
1112 gap = 0.5,
1113 },
1114 pattern color=red
1115 ]
1116 (0,0) rectangle (4,4);
1117 \end{tikzpicture}
1118 \end{dispExample*}
1119 \end{docPatternKey}
1120
1121
1122 \begin{docPatternKey}[][doc label=band@hexcycle]{band}{=\meta{number}}{no default, initially |0|}
1123 \meta{number} can take 0 or 1 and denotes one of two different bands of the pattern.
1124 \begin{dispExample*}{sbs,lefthand ratio=0.66,right=2mm,sidebyside gap=5mm,center lower}
1125 \begin{tikzpicture}
1126 \draw[
1127 preaction = { pattern={hexagon cycle[
1128 band=1, gap=0.5 ]}, pattern color=blue },
1129 pattern={hexagon cycle[band=0,rings=2]},
1130 pattern color=red
1131 ]
1132 (0,0) rectangle (4,4);
1133 \end{tikzpicture}
1134 \end{dispExample*}
1135 \end{docPatternKey}
1136
1137
1138
1139 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
1140 \clearpage
1141 \section{Rhombus Pattern Library}\label{sec:rhombus}%
1142
1143 \begin{dispListing*}{title=\tikzname\ Library |fill.rhombus|}
1144 \usetikzlibrary{fill.rhombus} % LaTeX (primary choice) and plain TeX
1145 \usetikzlibrary[fill.rhombus] % ConTeXt
1146 \usepackage{tikzfill.rhombus} % LaTeX (secondary choice)
1147 \end{dispListing*}
1148
1149 Based on |patterns.meta|, this library defines new rhombus patterns to fill graphs.
1150
1151 %-------------------------------------------------------------------------------
1152 \subsection{Rhombus}
1153 The \docValue{rhombus} pattern draws rhombi or diamonds. The rhombi may be
1154 filled or outlined and can be arranged in different \emph{bands}, called band 0, band 1, and band 2.
1155
1156 \begin{dispExample*}{sbs,lefthand ratio=0.66,right=2mm,sidebyside gap=5mm,center lower}
1157 \begin{tikzpicture}
1158 \draw[
1159 pattern = { rhombus
1160 [
1161 size = 8mm, angle = 15
1162 ]},
1163 pattern color=red
1164 ]
1165 (0,0) rectangle (4,4);
1166 \end{tikzpicture}
1167 \end{dispExample*}
1168
1169
1170 \begin{docTikzKey}{pattern rhombus}{=\marg{pattern keys}}{style, no default}
1171 Convenience shortcut for setting the pattern to \docValue{rhombus}:
1172 \begin{dispListing}
1173 pattern = { rhombus [ ... ] }
1174 \end{dispListing}
1175 \begin{dispExample*}{sbs,lefthand ratio=0.66,right=2mm,sidebyside gap=5mm,center lower}
1176 \begin{tikzpicture}
1177 \draw[
1178 pattern rhombus =
1179 {
1180 size = 8mm, angle = 15
1181 },
1182 pattern color=red
1183 ]
1184 (0,0) rectangle (4,4);
1185 \end{tikzpicture}
1186 \end{dispExample*}
1187 \end{docTikzKey}
1188
1189
1190 \begin{docPatternKey}[][doc label=size@rhombus]{size}{=\meta{size}}{no default, initially |10mm|}
1191 The given \meta{size} denotes the length of an edge of one rhombical tile
1192 where the (possibly smaller) rhombus is located in.
1193
1194 \begin{dispExample*}{sbs,lefthand ratio=0.66,right=2mm,sidebyside gap=5mm,center lower}
1195 \begin{tikzpicture}
1196 \draw[
1197 pattern rhombus =
1198 {
1199 size = 5mm,
1200 },
1201 pattern color=red
1202 ]
1203 (0,0) rectangle (4,4);
1204 \end{tikzpicture}
1205 \end{dispExample*}
1206 \end{docPatternKey}
1207
1208 \clearpage
1209
1210 \begin{docPatternKey}[][doc label=fill@rhombus]{fill}{}{no value, initially set}
1211 Sets the rhombi to be filled. |fill| and |draw| are mutually exclusionary.
1212 \begin{dispExample*}{sbs,lefthand ratio=0.66,right=2mm,sidebyside gap=5mm,center lower}
1213 \begin{tikzpicture}
1214 \draw[
1215 pattern rhombus =
1216 {
1217 fill,
1218 },
1219 pattern color=red
1220 ]
1221 (0,0) rectangle (4,4);
1222 \end{tikzpicture}
1223 \end{dispExample*}
1224 \end{docPatternKey}
1225
1226
1227 \begin{docPatternKey}[][doc label=draw@rhombus]{draw}{}{no value, initially unset}
1228 Sets the rhombi to be outlined. |fill| and |draw| are mutually exclusionary.
1229 \begin{dispExample*}{sbs,lefthand ratio=0.66,right=2mm,sidebyside gap=5mm,center lower}
1230 \begin{tikzpicture}
1231 \draw[
1232 pattern rhombus =
1233 {
1234 draw,
1235 },
1236 pattern color=red
1237 ]
1238 (0,0) rectangle (4,4);
1239 \end{tikzpicture}
1240 \end{dispExample*}
1241 \end{docPatternKey}
1242
1243
1244 \begin{docPatternKey}[][doc label=line width@rhombus]{line width}{=\meta{length}}{no default, initially |0.4pt|}
1245 Sets the \meta{length} value of the line width. This is only relevant, if
1246 the rhombi are not filled.
1247
1248 \begin{dispExample*}{sbs,lefthand ratio=0.66,right=2mm,sidebyside gap=5mm,center lower}
1249 \begin{tikzpicture}
1250 \draw[
1251 pattern rhombus =
1252 {
1253 line width = 1mm, draw
1254 },
1255 pattern color=red
1256 ]
1257 (0,0) rectangle (4,4);
1258 \end{tikzpicture}
1259 \end{dispExample*}
1260 \end{docPatternKey}
1261
1262
1263 \begin{docPatternKey}[][doc label=angle@rhombus]{angle}{=\meta{angle}}{no default, initially |-40|}
1264 The pattern is rotated by the given \meta{angle}.
1265 \par
1266 Note that for \docValue*{rhombus} is valid, that a pattern is rotated first and shifted afterwards.
1267 \begin{dispExample*}{sbs,lefthand ratio=0.66,right=2mm,sidebyside gap=5mm,center lower}
1268 \begin{tikzpicture}
1269 \draw[
1270 pattern rhombus =
1271 {
1272 angle = 15,
1273 },
1274 pattern color=red
1275 ]
1276 (0,0) rectangle (4,4);
1277 \end{tikzpicture}
1278 \end{dispExample*}
1279 \end{docPatternKey}
1280
1281 \clearpage
1282
1283 \begin{docPatternKeys}
1284 {
1285 {
1286 doc name = xshift,
1287 doc parameter = {=\meta{xshift}},
1288 doc description = {no default, initially |0pt|},
1289 doc label = xshift@rhombus
1290 },
1291 {
1292 doc name = yshift,
1293 doc parameter = {=\meta{yshift}},
1294 doc description = {no default, initially |0pt|},
1295 doc label = yshift@rhombus
1296 }
1297 }
1298 The pattern is shifted by \meta{xshift} and \meta{yshift}.
1299 \par
1300 Note that for \docValue*{rhombus} is valid, that a pattern is rotated first and shifted afterwards.
1301 \begin{dispExample*}{sbs,lefthand ratio=0.66,right=2mm,sidebyside gap=5mm,center lower}
1302 \begin{tikzpicture}
1303 \draw[
1304 preaction={pattern rhombus, pattern color=blue},
1305 pattern rhombus =
1306 {
1307 xshift=3mm, yshift=1mm,
1308 },
1309 pattern color=red
1310 ]
1311 (0,0) rectangle (4,4);
1312 \end{tikzpicture}
1313 \end{dispExample*}
1314 \end{docPatternKeys}
1315
1316
1317
1318 \begin{docPatternKey}[][doc label=ratio@rhombus]{ratio}{=\meta{value}}{no default, initially |2|}
1319 Sets the \meta{value} of the ratio
1320 between the longer diagonal and the shorter diagonal.
1321 Therefore, $\text{\meta{value}}\ge 1$.
1322
1323 \begin{dispExample*}{sbs,lefthand ratio=0.66,right=2mm,sidebyside gap=5mm,center lower}
1324 \begin{tikzpicture}
1325 \draw[
1326 pattern rhombus =
1327 {
1328 ratio = 4
1329 },
1330 pattern color=red
1331 ]
1332 (0,0) rectangle (4,4);
1333 \end{tikzpicture}
1334 \end{dispExample*}
1335 \end{docPatternKey}
1336
1337
1338
1339 \begin{docPatternKey}[][doc label=pos@rhombus]{pos}{=\meta{value}}{no default, initially |1|}
1340 Sets the edge position with a \meta{value} between 0 and 1, where $0$ is
1341 the center and $1$ the outer rim of the rhombical tile.
1342
1343 \begin{dispExample*}{sbs,lefthand ratio=0.66,right=2mm,sidebyside gap=5mm,center lower}
1344 \begin{tikzpicture}
1345 \draw[
1346 preaction={ pattern rhombus={pos=1},
1347 pattern color=blue },
1348 preaction={ pattern rhombus={pos=0.8},
1349 pattern color=blue!80!red },
1350 preaction={ pattern rhombus={pos=0.6},
1351 pattern color=blue!60!red },
1352 preaction={ pattern rhombus={pos=0.4},
1353 pattern color=blue!40!red },
1354 pattern rhombus={pos=0.2},
1355 pattern color=blue!20!red,
1356 ]
1357 (0,0) rectangle (4,4);
1358 \end{tikzpicture}
1359 \end{dispExample*}
1360 \end{docPatternKey}
1361
1362 \clearpage
1363
1364
1365 \begin{docPatternKey}[][doc label=band@rhombus]{band}{=\meta{number}}{no default, initially |0|}
1366 \meta{number} can take 0, 1, or 2.
1367 Here, 0 and 1 denote one of two different bands of the pattern,
1368 while 2 denotes the combination of both.
1369 \begin{dispExample*}{sbs,lefthand ratio=0.66,right=2mm,sidebyside gap=5mm,center lower}
1370 \begin{tikzpicture}
1371 \draw[
1372 preaction = {
1373 pattern rhombus = {
1374 pos = 0.8, band = 0 },
1375 pattern color=red },
1376 pattern rhombus = {
1377 pos = 0.8, band = 1
1378 },
1379 pattern color=blue
1380 ] (0,0) rectangle (4,4);
1381 \end{tikzpicture}
1382
1383 \begin{tikzpicture}
1384 \draw[
1385 pattern rhombus = {
1386 pos = 0.8, band = 2
1387 },
1388 pattern color=red
1389 ] (0,0) rectangle (4,4);
1390 \end{tikzpicture}
1391 \end{dispExample*}
1392 \end{docPatternKey}
1393
1394
1395 \end{myvoid}
1396
1397 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
1398 \clearpage
1399 \section{Geometric Array Library}\label{sec:geomarray}%
1400
1401 \begin{dispListing*}{title=\tikzname\ Library |fill.geomarray|}
1402 \usetikzlibrary{fill.geomarray} % LaTeX (primary choice) and plain TeX
1403 \usetikzlibrary[fill.geomarray] % ConTeXt
1404 \usepackage{tikzfill.geomarray} % LaTeX (secondary choice)
1405 \end{dispListing*}
1406
1407 The fillings provided by this library consist of similar, though not necessarily
1408 identical, small pictures arranged on a grid. These pictures are conceptually
1409 similar to \tikzname\ pic objects and are referred to as \enquote{items} in the
1410 following. Unlike \tikzname\ tiling patterns, which are fixed in form, these
1411 pictures \emph{may} vary. Note that this flexibility comes at the cost of
1412 increased compilation time.
1413
1414 Since \tikzname\ already uses terms such as grid and pattern, we refer to such a
1415 pattern-like grid of pic-like objects as a \enquote{geometric array} of
1416 \enquote{items}.
1417
1418 Each geometric array consists of rows and columns of items arranged in either a
1419 rectangular or triangular grid. Built-in support is provided for scaling items
1420 from row to row, enabling fading-like effects.
1421
1422 The most common use case is to employ a predefined template (see
1423 Section~\ref{sec:gea-templates}) and adjust its geometry and colors.
1424
1425 \tcbset{gea-example/.style={sbs,lefthand ratio=0.66,right=2mm,sidebyside gap=5mm,center lower}}
1426
1427 \begin{dispExample*}{gea-example}
1428 \begin{tikzpicture}
1429 \draw[ fill gea Edenland = {
1430 scale fixed = 1,
1431 step equi = 10mm,
1432 init-row< = \TFRowColorLet{mycolor}{red}{blue},
1433 prime color 1 = mycolor,
1434 freeze-row,
1435 }]
1436 (0,0) rectangle (4,4);
1437 \end{tikzpicture}
1438 \end{dispExample*}
1439
1440
1441 %-------------------------------------------------------------------------------
1442 \subsection{Base Settings}
1443
1444 \begin{docTikzKeys}
1445 {
1446 {
1447 doc name = fill geomarray,
1448 doc parameter = {=\marg{options}},
1449 doc description = {initially unset},
1450 doc new = 2026-03-18,
1451 }
1452 }
1453 Applies a \tikzname\ |path picture| with geometric array settings
1454 customized by varios \meta{options} to the current
1455 path. Without additional settings, this produces a default filling. Templates
1456 from Section~\ref{sec:gea-templates} apply \refKey{/tikz/fill geomarray}.\par
1457 Note that the following keys are reset by this key:
1458 \refKey{/tikz/geomarray/init},
1459 \refKey{/tikz/geomarray/init-row},\\
1460 \refKey{/tikz/geomarray/init-item}, and
1461 \refKey{/tikz/geomarray/draw-item}.
1462
1463 \begin{dispExample*}{gea-example}
1464 \begin{tikzpicture}
1465 \draw[ fill geomarray ]
1466 (0,0) rectangle (4,4);
1467 \end{tikzpicture}
1468 \end{dispExample*}
1469 \end{docTikzKeys}
1470
1471
1472 \clearpage
1473
1474 \begin{docGeaKeys}
1475 {
1476 {
1477 doc name = triangular,
1478 doc key choices* = {true,false},
1479 doc description = {default \texttt{true}, initially \texttt{false}},
1480 doc new = 2026-03-18,
1481 }
1482 }
1483 Geometric arrays can be either rectangular or triangular grids. Triangular
1484 grids shift every second row by half of a horizontal step.
1485
1486 \begin{dispExample*}{gea-example}
1487 \begin{tikzpicture}
1488 \draw[
1489 fill geomarray = { triangular },
1490 ]
1491 (0,0) rectangle (4,4);
1492 \end{tikzpicture}
1493 \end{dispExample*}
1494 \end{docGeaKeys}
1495
1496
1497 \begin{docGeaKeys}
1498 {
1499 {
1500 doc name = xstep,
1501 doc parameter = {=\marg{length}},
1502 doc description = {initially |10mm|},
1503 doc new = 2026-03-18,
1504 }
1505 }
1506 Sets the horizontal step distance between two columns to \meta{length}.
1507 This value can be used read-only as \docAuxCommand{l_tikzfill_gea_xstep_dim}
1508 for item drawing.
1509
1510 \begin{dispExample*}{gea-example}
1511 \begin{tikzpicture}
1512 \draw[
1513 fill geomarray = { xstep = 7mm },
1514 ]
1515 (0,0) rectangle (4,4);
1516 \end{tikzpicture}
1517 \end{dispExample*}
1518 \end{docGeaKeys}
1519
1520
1521 \begin{docGeaKeys}
1522 {
1523 {
1524 doc name = ystep,
1525 doc parameter = {=\marg{length}},
1526 doc description = {initially |10mm|},
1527 doc new = 2026-03-18,
1528 }
1529 }
1530 Sets the vertical step distance between two rows to \meta{length}.
1531 This value can be used read-only as \docAuxCommand{l_tikzfill_gea_ystep_dim}
1532 for item drawing.
1533
1534 \begin{dispExample*}{gea-example}
1535 \begin{tikzpicture}
1536 \draw[
1537 fill geomarray = { ystep = 7mm },
1538 ]
1539 (0,0) rectangle (4,4);
1540 \end{tikzpicture}
1541 \end{dispExample*}
1542 \end{docGeaKeys}
1543
1544
1545 \clearpage
1546 \begin{docGeaKeys}
1547 {
1548 {
1549 doc name = step,
1550 doc parameter = {=\marg{length}},
1551 doc description = {style},
1552 doc new = 2026-03-20,
1553 }
1554 }
1555 Sets both \refKey{/tikz/geomarray/xstep} and \refKey{/tikz/geomarray/ystep}
1556 to \meta{length}.
1557
1558 \begin{dispExample*}{gea-example}
1559 \begin{tikzpicture}
1560 \draw[
1561 fill geomarray = { step = 7mm },
1562 ]
1563 (0,0) rectangle (4,4);
1564 \end{tikzpicture}
1565 \end{dispExample*}
1566 \end{docGeaKeys}
1567
1568
1569 \begin{docGeaKeys}
1570 {
1571 {
1572 doc name = step half,
1573 doc parameter = {=\marg{length}},
1574 doc description = {style},
1575 doc new = 2026-03-23,
1576 }
1577 }
1578 Sets \refKey{/tikz/geomarray/xstep} to \meta{length} and \refKey{/tikz/geomarray/ystep}
1579 to half of \meta{length}.
1580
1581 \begin{dispExample*}{gea-example}
1582 \begin{tikzpicture}
1583 \draw[
1584 fill geomarray = { step half = 10mm },
1585 ]
1586 (0,0) rectangle (4,4);
1587 \end{tikzpicture}
1588 \end{dispExample*}
1589 \end{docGeaKeys}
1590
1591
1592 \begin{docGeaKeys}
1593 {
1594 {
1595 doc name = step double,
1596 doc parameter = {=\marg{length}},
1597 doc description = {style},
1598 doc new = 2026-03-23,
1599 }
1600 }
1601 Sets \refKey{/tikz/geomarray/xstep} to \meta{length} and \refKey{/tikz/geomarray/ystep}
1602 to double of \meta{length}.
1603
1604 \begin{dispExample*}{gea-example}
1605 \begin{tikzpicture}
1606 \draw[
1607 fill geomarray = { step double = 7mm },
1608 ]
1609 (0,0) rectangle (4,4);
1610 \end{tikzpicture}
1611 \end{dispExample*}
1612 \end{docGeaKeys}
1613
1614
1615 \clearpage
1616 \begin{docGeaKeys}
1617 [
1618 doc description = {style, no value},
1619 ]
1620 {
1621 {
1622 doc name = ystep equidistance,
1623 doc new = 2026-03-18,
1624 },
1625 {
1626 doc name = ystep equidistance*,
1627 doc new = 2026-03-25,
1628 }
1629 }
1630 For rectangular geometric arrays, this sets \refKey{/tikz/geomarray/ystep}
1631 to \refKey{/tikz/geomarray/xstep}. For triangular geometric arrays,
1632 \refKey{/tikz/geomarray/ystep} is set such that the centers of the items
1633 become equidistant. Note that \refKey{/tikz/geomarray/triangular} has
1634 to be set beforehand.\par
1635 \refKey{/tikz/geomarray/ystep equidistance*} switches
1636 rectangular and triangular computation.
1637
1638 \begin{dispExample*}{gea-example}
1639 \begin{tikzpicture}
1640 \draw[
1641 fill gea Furth = {
1642 triangular,
1643 xstep = 7mm,
1644 ystep equidistance,
1645 }]
1646 (0,0) rectangle (4,4);
1647 \end{tikzpicture}
1648 \end{dispExample*}
1649 \end{docGeaKeys}
1650
1651
1652 \begin{docGeaKeys}
1653 [
1654 doc parameter = {=\marg{length}},
1655 doc description = {style},
1656 ]
1657 {
1658 {
1659 doc name = step equi,
1660 doc new = 2026-03-20,
1661 },
1662 {
1663 doc name = step equi*,
1664 doc new = 2026-03-25,
1665 }
1666 }
1667 Sets \refKey{/tikz/geomarray/xstep} to \meta{length}
1668 and applies \refKey{/tikz/geomarray/ystep equidistance}
1669 or \refKey{/tikz/geomarray/ystep equidistance*}, respectively.
1670
1671 \begin{dispExample*}{gea-example}
1672 \begin{tikzpicture}
1673 \draw[
1674 fill gea Bruckberg = { step equi = 7mm },
1675 ]
1676 (0,0) rectangle (4,4);
1677 \end{tikzpicture}
1678 \end{dispExample*}
1679 \end{docGeaKeys}
1680
1681
1682 \begin{docGeaKeys}
1683 [
1684 doc parameter = {=\marg{length}},
1685 doc description = {style},
1686 ]
1687 {
1688 {
1689 doc name = step equi half,
1690 doc new = 2026-03-23,
1691 },
1692 {
1693 doc name = step equi* half,
1694 doc new = 2026-03-23,
1695 }
1696 }
1697 Sets \refKey{/tikz/geomarray/xstep} to \meta{length}
1698 and applies \refKey{/tikz/geomarray/ystep equidistance}
1699 or \refKey{/tikz/geomarray/ystep equidistance*}, respectively,
1700 but halve ystep.
1701
1702 \begin{dispExample*}{gea-example}
1703 \begin{tikzpicture}
1704 \draw[
1705 fill gea Bruckberg = { step equi half = 10mm },
1706 ]
1707 (0,0) rectangle (4,4);
1708 \end{tikzpicture}
1709 \end{dispExample*}
1710 \end{docGeaKeys}
1711
1712
1713 \clearpage
1714 \begin{docGeaKeys}
1715 [
1716 doc parameter = {=\marg{length}},
1717 doc description = {style},
1718 ]
1719 {
1720 {
1721 doc name = step equi double,
1722 doc new = 2026-03-23,
1723 },
1724 {
1725 doc name = step equi* double,
1726 doc new = 2026-03-23,
1727 }
1728 }
1729 Sets \refKey{/tikz/geomarray/xstep} to \meta{length}
1730 and applies \refKey{/tikz/geomarray/ystep equidistance}
1731 or \refKey{/tikz/geomarray/ystep equidistance*}, respectively,
1732 but double ystep.
1733
1734 \begin{dispExample*}{gea-example}
1735 \begin{tikzpicture}
1736 \draw[
1737 fill gea Bruckberg = { step equi double = 7mm },
1738 ]
1739 (0,0) rectangle (4,4);
1740 \end{tikzpicture}
1741 \end{dispExample*}
1742 \end{docGeaKeys}
1743
1744
1745 \begin{docGeaKeys}
1746 {
1747 {
1748 doc name = angle,
1749 doc parameter = {=\marg{angle}},
1750 doc description = {initially |0|},
1751 doc new = 2026-03-18,
1752 }
1753 }
1754 Rotates the whole geometric array by \meta{angle}.
1755
1756 \begin{dispExample*}{gea-example}
1757 \begin{tikzpicture}
1758 \draw[
1759 fill geomarray = { angle = 20 },
1760 ]
1761 (0,0) rectangle (4,4);
1762 \end{tikzpicture}
1763 \end{dispExample*}
1764 \end{docGeaKeys}
1765
1766
1767 \clearpage
1768 \begin{docGeaKeys}
1769 {
1770 {
1771 doc name = scale,
1772 doc parameter = {=\marg{data points}},
1773 doc description = {initially |0/0.9,1/0.9|},
1774 doc new = 2026-03-18,
1775 }
1776 }
1777 Defines a comma-separated list of interpolation \meta{data points} of type
1778 \emph{t}|/|\emph{scale}. The $t$ values must be strictly monotonically
1779 increasing from 0 to 1 (including both endpoints). They represent relative row
1780 positions.\par
1781 The \emph{scale} values are piecewise linearly interpolated and specify the actual scale
1782 of an item in a given row, where $1$ typically denotes full scale (though not
1783 necessarily).\par
1784 During item drawing, \docAuxCommand{l_tikzfill_gea_row_frac_fp} represents the
1785 current relative row position, while \docAuxCommand{l_tikzfill_gea_scale_fp}
1786 represents the interpolated scale value according to the specified interpolation
1787 \meta{data points}.
1788
1789 \begin{dispExample*}{gea-example}
1790 \begin{tikzpicture}
1791 \draw[
1792 fill geomarray = {
1793 step equi = 5mm,
1794 scale = {0/0.5,0.5/0.2,1/1},
1795 },
1796 ]
1797 (0,0) rectangle (4,4);
1798 \end{tikzpicture}
1799 \end{dispExample*}
1800 \end{docGeaKeys}
1801
1802
1803 \begin{docGeaKeys}
1804 {
1805 {
1806 doc name = scale linear,
1807 doc parameter = {=\marg{scale0}\marg{scale1}},
1808 doc description = {initially \texttt{\textbraceleft 0.9\textbraceright\textbraceleft 0.9\textbraceright}},
1809 doc new = 2026-03-23,
1810 }
1811 }
1812 This is a shortcut for setting
1813 \refKey{/tikz/geomarray/scale}|={0/|\meta{scale0}|,1/|\meta{scale1}|}|,
1814 i.e. the scale changes linearly from \meta{scale0} to \meta{scale1}
1815 from the first to the last row of the geometric array.
1816 \begin{dispExample*}{gea-example}
1817 \begin{tikzpicture}
1818 \draw[
1819 fill geomarray = {
1820 scale linear = {0.2}{0.9},
1821 },
1822 ]
1823 (0,0) rectangle (4,4);
1824 \end{tikzpicture}
1825 \end{dispExample*}
1826 \end{docGeaKeys}
1827
1828
1829
1830 \begin{docGeaKeys}
1831 {
1832 {
1833 doc name = scale fixed,
1834 doc parameter = {=\marg{scale}},
1835 doc description = {initially |0.9|},
1836 doc new = 2026-03-18,
1837 }
1838 }
1839 This is a shortcut for setting
1840 \refKey{/tikz/geomarray/scale}|={0/|\meta{scale}|,1/|\meta{scale}|}|,
1841 i.e. a fixed \meta{scale} is used for all rows of the geometric array.
1842 \begin{dispExample*}{gea-example}
1843 \begin{tikzpicture}
1844 \draw[
1845 fill geomarray = { scale fixed = 0.5 },
1846 ]
1847 (0,0) rectangle (4,4);
1848 \end{tikzpicture}
1849 \end{dispExample*}
1850 \end{docGeaKeys}
1851
1852 \clearpage
1853
1854 \begin{docGeaKeys}
1855 [
1856 doc key choices* = {true,false},
1857 doc description = {default \texttt{true}, initially \texttt{false}},
1858 ]
1859 {
1860 {
1861 doc name = xflip,
1862 doc new = 2026-04-14,
1863 },
1864 {
1865 doc name = xflip even,
1866 },
1867 {
1868 doc name = xflip odd,
1869 }
1870 }
1871 For drawing an item in the geometric array, the $x$-value of all coordinates is
1872 multiplied by $-1$, resulting in a reflection across the $y$-axis. This can be
1873 applied to all items or restricted to items in even or odd rows.
1874 \begin{dispExample*}{gea-example}
1875 \begin{tikzpicture}
1876 \draw[
1877 fill gea Hohenthann = {
1878 scale fixed = 1,
1879 step equi* double = 10mm,
1880 style 1 = {draw=white, fill=blue},
1881 text<={\color{yellow}RL},
1882 xflip odd,
1883 }]
1884 (0,0) rectangle (4,4);
1885 \end{tikzpicture}
1886 \end{dispExample*}
1887 \end{docGeaKeys}
1888
1889
1890 \begin{docGeaKeys}
1891 [
1892 doc key choices* = {true,false},
1893 doc description = {default \texttt{true}, initially \texttt{false}},
1894 ]
1895 {
1896 {
1897 doc name = yflip,
1898 doc new = 2026-04-14,
1899 },
1900 {
1901 doc name = yflip even,
1902 },
1903 {
1904 doc name = yflip odd,
1905 }
1906 }
1907 For drawing an item in the geometric array, the $y$-value of all coordinates is
1908 multiplied by $-1$, resulting in a reflection across the $x$-axis. This can be
1909 applied to all items or restricted to items in even or odd rows.
1910 \begin{dispExample*}{gea-example}
1911 \begin{tikzpicture}
1912 \draw[
1913 fill gea Pfettrach = {
1914 step half = 15mm,
1915 style 1 = { fill = red!40 },
1916 style 2 = { fill = red },
1917 text<={\color{yellow}RL},
1918 yflip even,
1919 }]
1920 (0,0) rectangle (4,4);
1921 \end{tikzpicture}
1922 \end{dispExample*}
1923 \end{docGeaKeys}
1924
1925 \clearpage
1926
1927
1928 %-------------------------------------------------------------------------------
1929 \subsection{Custom Creation of Geometric Arrays}
1930
1931 The following pseudocode illustrates how a geometric array is constructed,
1932 including four hook positions for inserting custom code.
1933
1934 \begin{dispListing*}{title=Pseudo code for geometric array creation}
1935 init % (1) initialize before looping
1936 % Usable values:
1937 % \l_tikzfill_gea_xstep_dim \l_tikzfill_gea_ystep_dim
1938 % \l_tikzfill_gea_cols_in \l_tikzfill_gea_rows_int
1939 \loop_over_rows
1940 {
1941 init-row % (2) initialize at begin of a row
1942 % Usable values:
1943 % \l_tikzfill_gea_row_tl
1944 % \l_tikzfill_gea_row_frac_fp \l_tikzfill_gea_scale_fp
1945 \loop_over_columns
1946 {
1947 init-item % (3) initialize before drawing an item
1948 % Usable values:
1949 % \l_tikzfill_gea_col_tl
1950 draw-item % (4) item drawing code
1951 }
1952 }
1953 \end{dispListing*}
1954
1955 Code can be inserted at these four positions using the following options:
1956 \begin{itemize}
1957 \item
1958 The most important position is the last one, addressed by
1959 \refKey{/tikz/geomarray/draw-item}. Here, the actual \tikzname\ drawing code for
1960 the item must be provided.
1961 \item
1962 The first three positions, addressed by
1963 \refKey{/tikz/geomarray/init},\\
1964 \refKey{/tikz/geomarray/init-row}, and \refKey{/tikz/geomarray/init-item},
1965 may contain optional initialization code to prepare for subsequent drawing.
1966 No \tikzname\ drawing code should be placed here; instead, these positions are
1967 intended, for example, for calculations affecting the entire array or a single
1968 row.
1969 \item
1970 In addition to providing fully custom code, a practical and convenient approach
1971 is to apply a template (see Section~\ref{sec:gea-templates}) and adjust only
1972 selected settings at one of the four positions.
1973 \end{itemize}
1974
1975
1976 \begin{docGeaKeys}
1977 [
1978 doc parameter = {=\marg{code}},
1979 ]
1980 {
1981 {
1982 doc name = init,
1983 doc description = {initially empty},
1984 doc new = 2026-03-18,
1985 },
1986 {
1987 doc name = init<,
1988 },
1989 {
1990 doc name = init>,
1991 },
1992 }
1993 This code position is executed before the loop over rows begins. The following
1994 read-only values are available: the grid step sizes
1995 \docAuxCommand{l_tikzfill_gea_xstep_dim} and
1996 \docAuxCommand{l_tikzfill_gea_ystep_dim}, as well as the number of columns and
1997 rows given by \docAuxCommand{l_tikzfill_gea_cols_int} and
1998 \docAuxCommand{l_tikzfill_gea_rows_int} (the actual counts are one greater,
1999 since indexing starts at $0$).
2000 \begin{itemize}
2001 \item \refKey{/tikz/geomarray/init} replaces the contents by \meta{code}.
2002 \item \refKey{/tikz/geomarray/init<} appends \meta{code}.
2003 \item \refKey{/tikz/geomarray/init>} prepends \meta{code}.
2004 \end{itemize}
2005 \end{docGeaKeys}
2006
2007
2008 \clearpage
2009 \begin{docGeaKeys}
2010 [
2011 doc parameter = {=\marg{code}},
2012 ]
2013 {
2014 {
2015 doc name = init-row,
2016 doc description = {initially empty},
2017 doc new = 2026-03-18,
2018 },
2019 {
2020 doc name = init-row<,
2021 },
2022 {
2023 doc name = init-row>,
2024 },
2025 }
2026 This code position is inside the main loop over rows, at the beginning of row
2027 \docAuxCommand{l_tikzfill_gea_row_tl}. Here,
2028 \docAuxCommand{l_tikzfill_gea_row_frac_fp} denotes the relative row position as
2029 a fractional value between $0$ and $1$. The macro
2030 \docAuxCommand{l_tikzfill_gea_scale_fp} represents the current scale value for
2031 the row, as defined by \refKey{/tikz/geomarray/scale}.
2032 \begin{itemize}
2033 \item \refKey{/tikz/geomarray/init-row} replaces the contents by \meta{code}.
2034 \item \refKey{/tikz/geomarray/init-row<} appends \meta{code}.
2035 \item \refKey{/tikz/geomarray/init-row>} prepends \meta{code}.
2036 \end{itemize}
2037 \end{docGeaKeys}
2038
2039
2040 \begin{docGeaKeys}
2041 [
2042 doc parameter = {=\marg{code}},
2043 ]
2044 {
2045 {
2046 doc name = init-item,
2047 doc description = {initially empty},
2048 doc new = 2026-03-18,
2049 },
2050 {
2051 doc name = init-item<,
2052 },
2053 {
2054 doc name = init-item>,
2055 },
2056 }
2057 This code position is inside the inner loop over columns, at the beginning of
2058 column \docAuxCommand{l_tikzfill_gea_col_tl}. Here, final calculations or
2059 settings may be applied before the current item is drawn.
2060 \begin{itemize}
2061 \item \refKey{/tikz/geomarray/init-item} replaces the contents by \meta{code}.
2062 \item \refKey{/tikz/geomarray/init-item<} appends \meta{code}.
2063 \item \refKey{/tikz/geomarray/init-item>} prepends \meta{code}.
2064 \end{itemize}
2065 \end{docGeaKeys}
2066
2067
2068 \begin{docKeys}
2069 [
2070 doc parameter = {=\marg{code}},
2071 doc keypath = tikz/geomarray,
2072 ]
2073 {
2074 {
2075 doc name = draw-item,
2076 doc description = {initially special},
2077 doc new = 2026-03-18,
2078 },
2079 {
2080 doc name = draw-item<,
2081 },
2082 {
2083 doc name = draw-item>,
2084 },
2085 }
2086 This code position contains the \tikzname\ drawing code for the current item.
2087 All previously mentioned read-only values are available for use in drawing. The
2088 center of the item corresponds to the \tikzname\ position $(0,0)$. The style
2089 settings
2090 \docAuxKey[tikz]{fill-gea-style-1} to
2091 \docAuxKey[tikz]{fill-gea-style-9} may be used as drawing options.
2092 \begin{itemize}
2093 \item \refKey{/tikz/geomarray/draw-item} replaces the contents by \meta{code}.
2094 \item \refKey{/tikz/geomarray/draw-item<} appends \meta{code}.
2095 \item \refKey{/tikz/geomarray/draw-item>} prepends \meta{code}.
2096 \end{itemize}
2097 \end{docKeys}
2098
2099
2100 \begin{dispExample*}{gea-example}
2101 \ExplSyntaxOn
2102 \begin{tikzpicture}
2103 \draw[ fill~geomarray = {
2104 scale~fixed = 1.3,
2105 triangular,
2106 ystep = 7mm,
2107 init = \sys_gset_rand_seed:n {1701},
2108 init-item = { \TFDefineRandomColor{mycolor} },
2109 draw-item = {
2110 \path[fill=mycolor,draw=mycolor!50!black]
2111 circle [
2112 x~radius=\fp_to_dim:n {\l_tikzfill_gea_xstep_dim / 2
2113 * \l_tikzfill_gea_scale_fp },
2114 y~radius=\fp_to_dim:n {\l_tikzfill_gea_ystep_dim / 2
2115 * \l_tikzfill_gea_scale_fp },
2116 ];
2117 },
2118 }]
2119 (0,0) rectangle (4,6);
2120 \end{tikzpicture}
2121 \ExplSyntaxOff
2122 \end{dispExample*}
2123
2124
2125 \clearpage
2126
2127 \begin{docKeys}
2128 {
2129 {
2130 doc name = draw-if-row-col,
2131 doc parameter = {=\marg{coordinate list}},
2132 doc keypath = tikz/geomarray,
2133 doc description = {initially unset},
2134 doc new = 2026-04-17,
2135 },
2136 }
2137 Restricts item drawing to those items whose coordinates are contained in the
2138 specified comma-separated \meta{coordinate list} of type \meta{row}/\meta{col}.
2139 The keys \refKey{/tikz/geomarray/init<} and \refKey{/tikz/geomarray/init-item<}
2140 are used to append the corresponding code.
2141 \begin{dispExample*}{gea-example}
2142 % \usepackage{opencolor}
2143 \begin{tikzpicture}
2144 \draw[
2145 preaction = {
2146 fill gea Bruckberg = {
2147 scale fixed = 1, step equi = 7mm,
2148 style 1 = { draw = oc-gray-1 },
2149 freeze-row,
2150 },
2151 },
2152 fill gea Bruckberg = {
2153 scale fixed = 1, step equi = 7mm,
2154 style 1 = {
2155 draw = oc-blue-9,
2156 top color = oc-blue-2,
2157 bottom color = oc-blue-4 },
2158 debug text,
2159 draw-if-row-col = { 4/5, 3/1, 3/4, 6/2 },
2160 }]
2161 (0,0) rectangle (4,6);
2162 \end{tikzpicture}
2163 \end{dispExample*}
2164 \end{docKeys}
2165
2166
2167 \begin{docKeys}
2168 {
2169 {
2170 doc name = draw-if-not-row-col,
2171 doc parameter = {=\marg{coordinate list}},
2172 doc keypath = tikz/geomarray,
2173 doc description = {initially unset},
2174 doc new = 2026-04-20,
2175 },
2176 }
2177 Restricts item drawing to those items whose coordinates are not contained in the
2178 specified comma-separated \meta{coordinate list} of type \meta{row}/\meta{col}.
2179 The keys \refKey{/tikz/geomarray/init<} and \refKey{/tikz/geomarray/init-item<}
2180 are used to append the corresponding code.
2181 \begin{dispExample*}{gea-example}
2182 % \usepackage{opencolor}
2183 \begin{tikzpicture}
2184 \draw[
2185 preaction = { fill = oc-teal-1 },
2186 fill gea Pfettrach = {
2187 scale fixed = 0.96, step half = 10mm,
2188 style 1 = { fill = oc-teal-2 },
2189 style 2 = { fill = oc-teal-4 },
2190 draw-if-not-row-col = { 4/3, 4/4, 5/3, 10/2 },
2191 freeze-row,
2192 }
2193 ]
2194 (0,0) rectangle (4,6);
2195 \node at (1,5) {Hello};
2196 \node at (2.5,2.2) {World};
2197 \end{tikzpicture}
2198 \end{dispExample*}
2199 \end{docKeys}
2200
2201
2202 \clearpage
2203
2204 \begin{docKeys}
2205 [
2206 doc keypath = tikz/geomarray,
2207 doc description = {initially unset},
2208 ]
2209 {
2210 {
2211 doc name = draw-if-row,
2212 doc parameter = {=\marg{row list}},
2213 doc new = 2026-04-21,
2214 },
2215 {
2216 doc name = draw-if-not-row,
2217 doc parameter = {=\marg{row list}},
2218 },
2219 {
2220 doc name = draw-if-even-row,
2221 },
2222 {
2223 doc name = draw-if-odd-row,
2224 },
2225 }
2226 Restricts item drawing to those items whose rows are
2227 \begin{itemize}
2228 \item contained in the specified comma-separated \meta{row list},
2229 \item not contained in the specified comma-separated \meta{row list},
2230 \item even,
2231 \item odd, respectively.
2232 \end{itemize}
2233 The keys \refKey{/tikz/geomarray/init<} and \refKey{/tikz/geomarray/init-row<}
2234 are used to append the corresponding code.
2235 \end{docKeys}
2236
2237
2238 \begin{docKeys}
2239 [
2240 doc keypath = tikz/geomarray,
2241 doc description = {initially unset},
2242 ]
2243 {
2244 {
2245 doc name = draw-if-col,
2246 doc parameter = {=\marg{column list}},
2247 doc new = 2026-04-21,
2248 },
2249 {
2250 doc name = draw-if-not-col,
2251 doc parameter = {=\marg{column list}},
2252 },
2253 {
2254 doc name = draw-if-even-col,
2255 },
2256 {
2257 doc name = draw-if-odd-col,
2258 },
2259 }
2260 Restricts item drawing to those items whose columns are
2261 \begin{itemize}
2262 \item contained in the specified comma-separated \meta{column list},
2263 \item not contained in the specified comma-separated \meta{column list},
2264 \item even,
2265 \item odd, respectively.
2266 \end{itemize}
2267 The keys \refKey{/tikz/geomarray/init<} and \refKey{/tikz/geomarray/init-item<}
2268 are used to append the corresponding code.
2269 \end{docKeys}
2270
2271
2272
2273
2274 \begin{docKeys}
2275 {
2276 {
2277 doc name = draw-if-random,
2278 doc parameter = {=\meta{probability}},
2279 doc keypath = tikz/geomarray,
2280 doc description = {initially unset},
2281 doc new = 2026-04-17,
2282 },
2283 }
2284 Restricts item drawing to random items with given
2285 \mbox{\meta{probability}$\in[0,1]$}.
2286 The keys \refKey{/tikz/geomarray/init<} and \refKey{/tikz/geomarray/init-item<}
2287 are used to append the corresponding code.
2288 \begin{dispExample*}{gea-example}
2289 % \usepackage{opencolor}
2290 \begin{tikzpicture}
2291 \ExplSyntaxOn
2292 \sys_gset_rand_seed:n {1701}
2293 \ExplSyntaxOff
2294 \draw[
2295 preaction = {
2296 fill gea Bruckberg = {
2297 scale fixed = 1, step equi = 7mm,
2298 style 1 = { draw = oc-gray-1 },
2299 freeze-row,
2300 },
2301 },
2302 fill gea Bruckberg = {
2303 scale fixed = 1, step equi = 7mm,
2304 style 1 = {
2305 draw = oc-lime-9,
2306 top color = oc-lime-2,
2307 bottom color = oc-lime-4 },
2308 debug text,
2309 draw-if-random = 0.33,
2310 }]
2311 (0,0) rectangle (4,6);
2312 \end{tikzpicture}
2313 \end{dispExample*}
2314 \end{docKeys}
2315
2316
2317
2318 \clearpage
2319
2320 \begin{docGeaKeys}
2321 [
2322 doc parameter = {=\marg{options}\marg{text}},
2323 ]
2324 {
2325 {
2326 doc name = node,
2327 doc new = 2026-03-26,
2328 },
2329 {
2330 doc name = node<,
2331 },
2332 {
2333 doc name = node>,
2334 },
2335 }
2336 This is a shortcut for drawing a \tikzname\ |node| applying
2337 \refKey{/tikz/geomarray/draw-item},
2338 \refKey{/tikz/geomarray/draw-item<}, or
2339 \refKey{/tikz/geomarray/draw-item>}, respectively.
2340 The node contents are set by \meta{text} and any \tikzname\ \meta{options}
2341 for the node can be applied.
2342 \begin{dispExample*}{gea-example}
2343 \begin{tikzpicture}
2344 \draw[
2345 fill geomarray =
2346 {
2347 node< = {white,draw=yellow,circle}{X}
2348 },
2349 ]
2350 (0,0) rectangle (4,4);
2351 \end{tikzpicture}
2352 \end{dispExample*}
2353 \end{docGeaKeys}
2354
2355
2356
2357 \begin{docGeaKeys}
2358 [
2359 doc parameter = {=\marg{text}},
2360 ]
2361 {
2362 {
2363 doc name = text,
2364 doc new = 2026-03-26,
2365 },
2366 {
2367 doc name = text<,
2368 },
2369 {
2370 doc name = text>,
2371 },
2372 }
2373 This is a shortcut for setting \meta{text} with |\pgftext| applying
2374 \refKey{/tikz/geomarray/draw-item},
2375 \refKey{/tikz/geomarray/draw-item<}, or
2376 \refKey{/tikz/geomarray/draw-item>}, respectively.
2377 In contrast to \refKey{/tikz/geomarray/node}, there are no drawing options, but
2378 \refKey{/tikz/geomarray/text} is much faster.
2379 \begin{dispExample*}{gea-example}
2380 % \usepackage{fontawesome7}
2381 \begin{tikzpicture}
2382 \draw[
2383 preaction = {top color=yellow!20,bottom color=yellow},
2384 fill geomarray =
2385 {
2386 triangular,
2387 text = {\Huge\color{red}\faTriangleExclamation},
2388 angle = 20,
2389 },
2390 ]
2391 (0,0) rectangle (4,4);
2392 \end{tikzpicture}
2393 \end{dispExample*}
2394 \end{docGeaKeys}
2395
2396 \clearpage
2397
2398 \begin{docKeys}
2399 [
2400 doc parameter = {=\marg{path style}},
2401 doc keypath = tikz/geomarray,
2402 ]
2403 {
2404 {
2405 doc name = style 1,
2406 doc description = {initially |fill=red|},
2407 doc new and updated = {2026-03-18}{2026-04-14},
2408 },
2409 {
2410 doc name = style 2,
2411 doc description = {initially |fill=green|},
2412 },
2413 {
2414 doc name = style 3,
2415 doc description = {initially |fill=blue|},
2416 },
2417 {
2418 doc name = style 4,
2419 doc description = {initially |fill=cyan|},
2420 },
2421 {
2422 doc name = style 5,
2423 doc description = {initially |fill=magenta|},
2424 },
2425 {
2426 doc name = style 6,
2427 doc description = {initially |fill=yellow|},
2428 },
2429 {
2430 doc name = style 7,
2431 doc description = {initially |fill=lightgray|},
2432 },
2433 {
2434 doc name = style 8,
2435 doc description = {initially |fill=orange|},
2436 },
2437 {
2438 doc name = style 9,
2439 doc description = {initially |fill=purple|},
2440 },
2441 {
2442 doc name = style 10,
2443 doc description = {initially |fill=lime|},
2444 },
2445 {
2446 doc name = style 11,
2447 doc description = {initially |fill=olive|},
2448 },
2449 {
2450 doc name = style 12,
2451 doc description = {initially |fill=pink|},
2452 },
2453 {
2454 doc name = style 13,
2455 doc description = {initially |fill=teal|},
2456 },
2457 {
2458 doc name = style 14,
2459 doc description = {initially |fill=violet|},
2460 },
2461 {
2462 doc name = style base,
2463 doc description = {initially empty},
2464 },
2465 }
2466 These convenience options generate styles named\\
2467 \docAuxKey[tikz]{fill-gea-style-1}, \docAuxKey[tikz]{fill-gea-style-2},\\
2468 \docAuxKey[tikz]{fill-gea-style-3}, \docAuxKey[tikz]{fill-gea-style-4},\\
2469 \docAuxKey[tikz]{fill-gea-style-5}, \docAuxKey[tikz]{fill-gea-style-6},\\
2470 \docAuxKey[tikz]{fill-gea-style-7}, \docAuxKey[tikz]{fill-gea-style-8},\\
2471 \docAuxKey[tikz]{fill-gea-style-9}, \docAuxKey[tikz]{fill-gea-style-10},\\
2472 \docAuxKey[tikz]{fill-gea-style-11}, \docAuxKey[tikz]{fill-gea-style-12},\\
2473 \docAuxKey[tikz]{fill-gea-style-13}, \docAuxKey[tikz]{fill-gea-style-14},\\
2474 and \docAuxKey[tikz]{fill-gea-style-base}.\\
2475 Styles of this kind are used within templates (see
2476 Section~\ref{sec:gea-templates}) for drawing. The style
2477 \docAuxKey[tikz]{fill-gea-style-1} is also used in the default configuration.
2478 Modifying these styles is the simplest way to customize the appearance.
2479
2480 \begin{dispExample*}{gea-example}
2481 \begin{tikzpicture}
2482 \draw[ fill gea Bruckberg =
2483 {
2484 style 1 =
2485 {
2486 draw = gray,
2487 top color = blue!50,
2488 bottom color = red
2489 },
2490 }]
2491 (0,0) rectangle (4,4);
2492 \end{tikzpicture}
2493 \end{dispExample*}
2494 \end{docKeys}
2495
2496
2497 \begin{docKeys}
2498 [
2499 doc parameter = {=\meta{color}},
2500 doc keypath = tikz/geomarray,
2501 ]
2502 {
2503 {
2504 doc name = prime color 1,
2505 doc description = {initially |red|},
2506 doc new = {2026-04-14},
2507 },
2508 {
2509 doc name = prime color 2,
2510 doc description = {initially |blue|},
2511 },
2512 }
2513 These convenience options assign the specified \meta{color} to the L3 token
2514 lists \docAuxCommand{l_tikzfill_gea_prime_col_i_tl} and
2515 \docAuxCommand{l_tikzfill_gea_prime_col_ii_tl}. The \meta{color} must be a valid
2516 |xcolor| color expression.\\
2517 Some templates (e.g. \refKey{/tikz/fill gea Marktstauden})
2518 use these settings for drawing.
2519 \end{docKeys}
2520
2521
2522
2523 \begin{docKeys}
2524 {
2525 {
2526 doc name = ratio,
2527 doc parameter = {=\meta{fp expr}},
2528 doc keypath = tikz/geomarray,
2529 doc description = {initially |1|},
2530 doc new = {2026-04-14},
2531 }
2532 }
2533 This convenience option assigns the evaluated floating point expression \meta{fp expr} to the L3 token
2534 list \docAuxCommand{l_tikzfill_gea_ratio_tl}.\\
2535 Some templates (e.g. \refKey{/tikz/fill gea Niederhatzkofen})
2536 use this setting for drawing.
2537 \end{docKeys}
2538
2539
2540
2541 \clearpage
2542 \begin{docGeaKeys}
2543 {
2544 {
2545 doc name = debug text,
2546 doc parameter = {\colOpt{=\meta{color}}},
2547 doc description = {default |black|, initially |black|},
2548 doc new = 2026-03-18,
2549 },
2550 {
2551 doc name = debug node,
2552 doc parameter = {\colOpt{=\marg{options}}},
2553 doc description = {default |black|, initially |black|},
2554 doc new = 2026-04-14,
2555 }
2556 }
2557 Prints the row and column numbers in the specified \meta{color}
2558 or with the specified \meta{options}. Note that this
2559 option appends drawing code; therefore, it should be specified after other
2560 drawing settings. It is intended for debugging or for identifying a specific
2561 item.\par
2562 During item drawing, the following values are available (read-only):
2563 \begin{itemize}
2564 \item \docAuxCommand{l_tikzfill_gea_rows_int}: total number of rows minus one.
2565 \item \docAuxCommand{l_tikzfill_gea_cols_int}: total number of columns minus one.
2566 \item \docAuxCommand{l_tikzfill_gea_row_tl}: current row index, with\\
2567 $0\le$\docAuxCommand{l_tikzfill_gea_row_tl}$\le$\docAuxCommand{l_tikzfill_gea_rows_int}.
2568 \item \docAuxCommand{l_tikzfill_gea_col_tl}: current column index, with\\
2569 $0\le$\docAuxCommand{l_tikzfill_gea_col_tl}$\le$\docAuxCommand{l_tikzfill_gea_cols_int}.
2570 \end{itemize}
2571 \refKey{/tikz/geomarray/debug text} displays the current pair consisting of
2572 \docAuxCommand{l_tikzfill_gea_row_tl} and \docAuxCommand{l_tikzfill_gea_col_tl}.\par
2573 Note that at least the first and last row or column may lie partially or entirely
2574 outside the clipping area.\par
2575 \refKey{/tikz/geomarray/debug text} is based on \refKey{/tikz/geomarray/text<},
2576 while
2577 \refKey{/tikz/geomarray/debug node} is based on \refKey{/tikz/geomarray/node<}.
2578 \begin{dispExample*}{gea-example}
2579 \begin{tikzpicture}
2580 \draw[
2581 fill geomarray = { debug text },
2582 ]
2583 (0,0) rectangle (4,4);
2584 \end{tikzpicture}
2585 \end{dispExample*}
2586 \end{docGeaKeys}
2587
2588
2589 \begin{docGeaKeys}
2590 {
2591 {
2592 doc name = freeze-row,
2593 doc description = {experimental},
2594 doc new = 2026-03-18,
2595 }
2596 }
2597 This is an experimental compile-time optimization for geometric arrays in which
2598 each row contains uniform items. For each row, an item is drawn only once into a
2599 box (\enquote{frozen}), and this box is then copied to fill the row.\par
2600 Depending on the complexity of the graphical code, this can reduce compilation
2601 time. However, note the restriction that all items within a row must be uniform.
2602 Also note that applying \refKey{/tikz/geomarray/freeze-row} may shift the
2603 geometric array if the center of an item's enclosing box is not identical to its
2604 origin.
2605 \end{docGeaKeys}
2606
2607
2608
2609 \clearpage
2610 %-------------------------------------------------------------------------------
2611 \subsection{Auxiliary Macros}
2612
2613 \begin{docCommands}
2614 {
2615 {
2616 doc name = TFRowColorLet,
2617 doc parameter = \marg{name}\marg{color1}\marg{color2},
2618 doc new = 2026-03-18,
2619 }
2620 }
2621 Creates a new color with given \meta{name} which mixes the colors
2622 \meta{color1} and \meta{color2}. On the first row, \meta{color1} is used,
2623 on the last row \meta{color2}, and a linear mixture in between.
2624
2625 \begin{dispExample*}{gea-example}
2626 \begin{tikzpicture}
2627 \draw[
2628 fill gea Bruckberg = {
2629 init-row< =
2630 \TFRowColorLet{mycolor}{red}{blue!50!white},
2631 style 1 = {draw=gray, fill=mycolor},
2632 }]
2633 (0,0) rectangle (4,4);
2634 \end{tikzpicture}
2635 \end{dispExample*}
2636 \end{docCommands}
2637
2638
2639
2640 \begin{docCommands}
2641 {
2642 {
2643 doc name = TFRowColorLetSeq,
2644 doc parameter = \marg{name}\marg{comma-list},
2645 doc new = 2026-03-18,
2646 }
2647 }
2648 Creates a new color with given \meta{name} which mixes the colors
2649 given by the \meta{comma-list} from the
2650 first row (first color) to the last row (last color)
2651 and a linear mixture in between.
2652
2653 \begin{dispExample*}{gea-example}
2654 % \usepackage{opencolor}
2655 \begin{tikzpicture}
2656 \draw[
2657 fill gea Essenbach = {
2658 init-row< = \TFRowColorLetSeq{mycolor}
2659 {oc-red-6,oc-blue-6,oc-green-6,oc-yellow-6},
2660 style 1 = {fill=mycolor},
2661 step equi = 5mm,
2662 }]
2663 (0,0) rectangle (4,4);
2664 \end{tikzpicture}
2665 \end{dispExample*}
2666 \end{docCommands}
2667
2668
2669 \begin{docCommands}
2670 {
2671 {
2672 doc name = TFDefineRandomColor,
2673 doc parameter = \marg{name},
2674 doc new = 2026-03-18,
2675 }
2676 }
2677 Defines a random color with given \meta{name}. Random numbers are taken
2678 from the L3 programming layer.
2679 \begin{dispExample*}{gea-example}
2680 \ExplSyntaxOn
2681 \sys_gset_rand_seed:n {1701}
2682 \ExplSyntaxOff
2683 \begin{tikzpicture}
2684 \draw[
2685 fill gea Furth = {
2686 triangular,
2687 step equi = 8mm,
2688 init-item< = \TFDefineRandomColor{mycolor},
2689 style 1 = {ball color=mycolor},
2690 }]
2691 (0,0) rectangle (4,4);
2692 \end{tikzpicture}
2693 \end{dispExample*}
2694 \end{docCommands}
2695
2696
2697 \clearpage
2698 %-------------------------------------------------------------------------------
2699 \subsection{Templates}\label{sec:gea-templates}
2700
2701
2702 \begin{docTikzKeys}
2703 {
2704 {
2705 doc name = fill gea Altdorf,
2706 doc parameter = {=\marg{options}},
2707 doc description = {initially unset},
2708 doc new = 2026-03-18,
2709 }
2710 }
2711 The basic item shape of this template is a rectangle.
2712 \refKey{/tikz/geomarray/style 1} is used for graph drawing.
2713
2714 \begin{dispExample*}{gea-example}
2715 \begin{tikzpicture}
2716 \draw[
2717 fill gea Altdorf = {
2718 init-row< =
2719 \TFRowColorLet{mycolor}{red}{blue},
2720 style 1 =
2721 {draw=gray, fill=mycolor},
2722 }]
2723 (0,0) rectangle (4,4);
2724 \end{tikzpicture}
2725 \end{dispExample*}
2726 \end{docTikzKeys}
2727
2728
2729
2730
2731 \begin{docTikzKeys}
2732 {
2733 {
2734 doc name = fill gea Loeschenbrand,
2735 doc parameter = {=\marg{options}},
2736 doc description = {initially unset},
2737 doc new = 2026-03-20,
2738 }
2739 }
2740 This is a variation of \refKey{/tikz/fill gea Altdorf} where
2741 \refKey{/tikz/geomarray/style 1} and
2742 \refKey{/tikz/geomarray/style 2} are used in a checkerboard pattern.
2743
2744 \begin{dispExample*}{gea-example}
2745 \begin{tikzpicture}
2746 \draw[
2747 fill gea Loeschenbrand = {
2748 scale fixed = 1,
2749 style 1 =
2750 {bottom color=black, top color=black!50},
2751 style 2 =
2752 {bottom color=black!10, top color=white},
2753 angle = -10,
2754 }]
2755 (0,0) rectangle (4,4);
2756 \end{tikzpicture}
2757 \end{dispExample*}
2758 \end{docTikzKeys}
2759
2760
2761 \begin{docTikzKeys}
2762 {
2763 {
2764 doc name = fill gea Ganslberg,
2765 doc parameter = {=\marg{options}},
2766 doc description = {initially unset},
2767 doc new = 2026-03-18,
2768 }
2769 }
2770 This is a variation of \refKey{/tikz/fill gea Altdorf} in which
2771 \refKey{/tikz/geomarray/style 1} and \refKey{/tikz/geomarray/style 2} are used for
2772 odd and even rows, respectively.
2773
2774 \begin{dispExample*}{gea-example}
2775 \begin{tikzpicture}
2776 \draw[
2777 fill gea Ganslberg = {
2778 style 1 =
2779 {bottom color=red, top color=red!50},
2780 style 2 =
2781 {bottom color=blue, top color=blue!50},
2782 }]
2783 (0,0) rectangle (4,4);
2784 \end{tikzpicture}
2785 \end{dispExample*}
2786 \end{docTikzKeys}
2787
2788 \clearpage
2789
2790 \begin{docTikzKeys}
2791 {
2792 {
2793 doc name = fill gea Essenbach,
2794 doc parameter = {=\marg{options}},
2795 doc description = {initially unset},
2796 doc new = 2026-03-18,
2797 }
2798 }
2799 The basic item shape of this template is a rhombus.
2800 \refKey{/tikz/geomarray/style 1} is used for graph drawing.
2801
2802 \begin{dispExample*}{gea-example}
2803 \begin{tikzpicture}
2804 \draw[
2805 fill gea Essenbach = {
2806 init-row< =
2807 \TFRowColorLet{mycolor}{red}{blue},
2808 style 1 =
2809 {draw=gray, fill=mycolor},
2810 }]
2811 (0,0) rectangle (4,4);
2812 \end{tikzpicture}
2813 \end{dispExample*}
2814 \end{docTikzKeys}
2815
2816
2817 \begin{docTikzKeys}
2818 {
2819 {
2820 doc name = fill gea Mirskofen,
2821 doc parameter = {=\marg{options}},
2822 doc description = {initially unset},
2823 doc new = 2026-03-18,
2824 }
2825 }
2826 This is a variation of \refKey{/tikz/fill gea Essenbach} in which
2827 \refKey{/tikz/geomarray/style 1} and \refKey{/tikz/geomarray/style 2} are used for
2828 odd and even rows, respectively.
2829
2830 \begin{dispExample*}{gea-example}
2831 \begin{tikzpicture}
2832 \draw[
2833 fill gea Mirskofen = {
2834 scale fixed = 1,
2835 step equi = 5mm,
2836 init-row< =
2837 \TFRowColorLet{mycolor}{blue!60}{blue!30},
2838 style 1 = {fill=mycolor},
2839 style 2 = {},
2840 angle = 45,
2841 }]
2842 (0,0) rectangle (4,4);
2843 \end{tikzpicture}
2844 \end{dispExample*}
2845 \end{docTikzKeys}
2846
2847
2848 \clearpage
2849 \begin{docTikzKeys}
2850 {
2851 {
2852 doc name = fill gea Pfettrach,
2853 doc parameter = {=\marg{options}},
2854 doc description = {initially unset},
2855 doc new = 2026-03-18,
2856 }
2857 }
2858 The basic item shape of this template is a rhombus divided into two parts.
2859 \refKey{/tikz/geomarray/style 1} and
2860 \refKey{/tikz/geomarray/style 2} are used for the two parts.
2861
2862 \begin{dispExample*}{gea-example}
2863 \begin{tikzpicture}
2864 \draw[
2865 fill gea Pfettrach = {
2866 step half = 10mm,
2867 style 1 = { fill = red!40 },
2868 style 2 = { fill = red },
2869 freeze-row,
2870 }]
2871 (0,0) rectangle (4,4);
2872 \end{tikzpicture}
2873 \end{dispExample*}
2874 \begin{dispExample*}{gea-example}
2875 \ExplSyntaxOn
2876 \sys_gset_rand_seed:n {1701}
2877 \ExplSyntaxOff
2878 \begin{tikzpicture}
2879 \draw[
2880 fill gea Pfettrach = {
2881 scale fixed = 1,
2882 step equi = 7mm,
2883 init-item< = \TFDefineRandomColor{col1}%
2884 \TFDefineRandomColor{col2},
2885 style 1 = { fill = col1 },
2886 style 2 = { fill = col2 },
2887 }]
2888 (0,0) rectangle (4,4);
2889 \end{tikzpicture}
2890 \end{dispExample*}
2891 \end{docTikzKeys}
2892
2893
2894 \begin{docTikzKeys}
2895 {
2896 {
2897 doc name = fill gea Kolmhub,
2898 doc parameter = {=\marg{options}},
2899 doc description = {initially unset},
2900 doc new = 2026-03-18,
2901 }
2902 }
2903 This is a variation of \refKey{/tikz/fill gea Pfettrach} in which
2904 \refKey{/tikz/geomarray/style 1},
2905 \refKey{/tikz/geomarray/style 2},
2906 \refKey{/tikz/geomarray/style 3}, and
2907 \refKey{/tikz/geomarray/style 4},
2908 are used for
2909 odd and even rows, respectively.
2910
2911 \begin{dispExample*}{gea-example}
2912 \begin{tikzpicture}
2913 \draw[
2914 fill gea Kolmhub = {
2915 step = 6mm,
2916 style 1 = { fill = red!40 },
2917 style 2 = { fill = red },
2918 style 3 = { fill = blue!40 },
2919 style 4 = { fill = blue },
2920 freeze-row,
2921 }]
2922 (0,0) rectangle (4,4);
2923 \end{tikzpicture}
2924 \end{dispExample*}
2925 \end{docTikzKeys}
2926
2927
2928 \clearpage
2929 \begin{docTikzKeys}
2930 {
2931 {
2932 doc name = fill gea Bruckberg,
2933 doc parameter = {=\marg{options}},
2934 doc description = {initially unset},
2935 doc new = 2026-03-18,
2936 }
2937 }
2938 The basic item shape of this template is a hexagon.
2939 \refKey{/tikz/geomarray/style 1} is used for graph drawing.
2940
2941 \begin{dispExample*}{gea-example}
2942 % \usepackage{opencolor}
2943 \begin{tikzpicture}
2944 \draw[
2945 preaction = {fill=oc-orange-7},
2946 fill gea Bruckberg = {
2947 scale fixed = 0.97,
2948 step equi = 7mm,
2949 style 1 = {
2950 top color = oc-yellow-6,
2951 bottom color = oc-orange-5 },
2952 }]
2953 (0,0) rectangle (4,4);
2954 \end{tikzpicture}
2955 \end{dispExample*}
2956 \begin{dispExample*}{gea-example}
2957 % \usepackage{opencolor}
2958 % \usepackage{fontawesome7}
2959 \ExplSyntaxOn
2960 \begin{tikzpicture}
2961 \draw[
2962 preaction = {fill=oc-orange-7},
2963 fill~gea~Bruckberg = {
2964 scale~fixed = 1,
2965 step~equi = 7mm,
2966 init< = \sys_gset_rand_seed:n {101},
2967 init-item< = \tl_set:Ne \l_tmpa_tl
2968 {oc-\clist_rand_item:n {red,grape,indigo,cyan,
2969 green,yellow} },
2970 style~1 = {draw=\l_tmpa_tl-4,fill=\l_tmpa_tl-3},
2971 text< = {
2972 \color{\l_tmpa_tl-6}\large
2973 \faIcon{face-\clist_rand_item:n {smile,frown,
2974 grin-beam,meh,tired,laugh,smile-wink}}
2975 },
2976 }]
2977 (0,0) rectangle (4,8);
2978 \end{tikzpicture}
2979 \ExplSyntaxOff
2980 \end{dispExample*}
2981 \end{docTikzKeys}
2982
2983 \clearpage
2984 \begin{docTikzKeys}
2985 {
2986 {
2987 doc name = fill gea Bachhorn,
2988 doc parameter = {=\marg{options}},
2989 doc description = {initially unset},
2990 doc new = 2026-03-18,
2991 }
2992 }
2993 This is a variation of \refKey{/tikz/fill gea Bruckberg} in which
2994 \refKey{/tikz/geomarray/style 1} and \refKey{/tikz/geomarray/style 2} are used for
2995 odd and even rows, respectively.
2996
2997 \begin{dispExample*}{gea-example}
2998 \begin{tikzpicture}
2999 \draw[
3000 preaction = {top color=red!25,bottom color=blue!25},
3001 fill gea Bachhorn = {
3002 scale = {0/0.3,1/0.9},
3003 step equi = 7mm,
3004 style 1 = { draw=gray, fill=red },
3005 style 2 = { draw=gray, fill=blue },
3006 angle = 60,
3007 }]
3008 (0,0) rectangle (4,4);
3009 \end{tikzpicture}
3010 \end{dispExample*}
3011 \end{docTikzKeys}
3012
3013
3014 \begin{docTikzKeys}
3015 {
3016 {
3017 doc name = fill gea Weihmichl,
3018 doc parameter = {=\marg{options}},
3019 doc description = {initially unset},
3020 doc new = 2026-03-18,
3021 }
3022 }
3023 The basic item shape of this template is a hexagon divided into three parts.
3024 \refKey{/tikz/geomarray/style 1},
3025 \refKey{/tikz/geomarray/style 2}, and
3026 \refKey{/tikz/geomarray/style 3}, are used for the three parts.
3027 \begin{dispExample*}{gea-example}
3028 % \usepackage{opencolor}
3029 \begin{tikzpicture}
3030 \draw[
3031 fill gea Weihmichl = {
3032 scale fixed = 1,
3033 step equi = 8mm,
3034 init-row< = \TFRowColorLetSeq{mycolor}{
3035 oc-blue-6,oc-yellow-6,oc-red-6},
3036 style 1 = {fill=mycolor!50!white},
3037 style 2 = {fill=mycolor},
3038 style 3 = {fill=mycolor!50!black},
3039 }]
3040 (0,0) rectangle (4,4);
3041 \end{tikzpicture}
3042 \end{dispExample*}
3043 \end{docTikzKeys}
3044
3045
3046 \begin{docTikzKeys}
3047 {
3048 {
3049 doc name = fill gea Edenland,
3050 doc parameter = {=\marg{options}},
3051 doc description = {initially unset},
3052 doc new = 2026-04-20,
3053 }
3054 }
3055 This is a variation of \refKey{/tikz/fill gea Weihmichl} in which a
3056 prime color, \refKey{/tikz/geomarray/prime color 1}, defines
3057 the individual colors of the three parts. The key \refKey{/tikz/geomarray/style base}
3058 specifies a style applied to all parts.
3059 \begin{dispExample*}{gea-example}
3060 \ExplSyntaxOn
3061 \sys_gset_rand_seed:n {12345}
3062 \ExplSyntaxOff
3063 \begin{tikzpicture}
3064 \draw[ fill gea Edenland = {
3065 scale fixed = 1,
3066 step equi = 10mm,
3067 ystep equidistance,
3068 style base = draw,
3069 init-item< = \TFDefineRandomColor{mycolor},
3070 prime color 1 = mycolor,
3071 }]
3072 (0,0) rectangle (4,4);
3073 \end{tikzpicture}
3074 \end{dispExample*}
3075 \end{docTikzKeys}
3076
3077
3078
3079 \clearpage
3080
3081 \begin{docTikzKeys}
3082 {
3083 {
3084 doc name = fill gea Baumgarten,
3085 doc parameter = {=\marg{options}},
3086 doc description = {initially unset},
3087 doc new = 2026-04-21,
3088 }
3089 }
3090 This template consists of two quadrilaterals arranged in an L-shape.
3091 \refKey{/tikz/geomarray/style 1} and
3092 \refKey{/tikz/geomarray/style 2} are used for the two parts.
3093
3094 \begin{dispExample*}{gea-example}
3095 % \usepackage{opencolor}
3096 \begin{tikzpicture}
3097 \draw[
3098 fill gea Baumgarten = {
3099 scale fixed = 1,
3100 step double = 5mm,
3101 style 1 = { draw, top color=oc-cyan-3,
3102 bottom color=oc-cyan-5 },
3103 style 2 = { draw, top color=oc-indigo-3,
3104 bottom color=oc-indigo-5 },
3105 }]
3106 (0,0) rectangle (4,4);
3107 \end{tikzpicture}
3108 \end{dispExample*}
3109 \end{docTikzKeys}
3110
3111
3112
3113 \begin{docTikzKeys}
3114 {
3115 {
3116 doc name = fill gea Furth,
3117 doc parameter = {=\marg{options}},
3118 doc description = {initially unset},
3119 doc new = 2026-03-18,
3120 }
3121 }
3122 The basic item shape of this template is a circle.
3123 \refKey{/tikz/geomarray/style 1} is used for graph drawing.
3124
3125 \begin{dispExample*}{gea-example}
3126 \begin{tikzpicture}
3127 \draw[
3128 preaction = {fill=blue!25},
3129 fill gea Furth = {
3130 triangular,
3131 step equi = 4mm,
3132 scale = {0/0,1/1.2},
3133 style 1 = { fill=blue },
3134 freeze-row,
3135 }]
3136 (0,0) rectangle (4,4);
3137 \end{tikzpicture}
3138 \end{dispExample*}
3139 \end{docTikzKeys}
3140
3141
3142
3143 \begin{docTikzKeys}
3144 {
3145 {
3146 doc name = fill gea Schatzhofen,
3147 doc parameter = {=\marg{options}},
3148 doc description = {initially unset},
3149 doc new = 2026-03-18,
3150 }
3151 }
3152 This is a variation of \refKey{/tikz/fill gea Furth} in which
3153 \refKey{/tikz/geomarray/style 1} and \refKey{/tikz/geomarray/style 2} are used for
3154 odd and even rows, respectively.
3155
3156 \begin{dispExample*}{gea-example}
3157 % \usepackage{opencolor}
3158 \begin{tikzpicture}
3159 \draw[
3160 fill gea Schatzhofen = {
3161 triangular,
3162 scale fixed=1.2,
3163 step equi = 6mm,
3164 style 1 = { top color=oc-blue-3,
3165 bottom color=oc-blue-9},
3166 style 2 = { top color=oc-teal-3,
3167 bottom color=oc-teal-9},
3168 freeze-row,
3169 }]
3170 (0,0) rectangle (4,4);
3171 \end{tikzpicture}
3172 \end{dispExample*}
3173 \end{docTikzKeys}
3174
3175
3176
3177 \clearpage
3178 \begin{docTikzKeys}
3179 {
3180 {
3181 doc name = fill gea Ergolding,
3182 doc parameter = {=\marg{options}},
3183 doc description = {initially unset},
3184 doc new = 2026-03-24,
3185 }
3186 }
3187 The basic item shape of this template is a tripod.
3188 \refKey{/tikz/geomarray/style 1} is used for graph drawing.
3189
3190 \begin{dispExample*}{gea-example}
3191 % \usepackage{opencolor}
3192 \begin{tikzpicture}
3193 \draw[
3194 fill gea Ergolding = {
3195 step equi = 8mm,
3196 init-row< = \TFRowColorLetSeq{mycolor}{
3197 oc-blue-6,oc-yellow-6,oc-red-6},
3198 style 1 = {draw,fill=mycolor!50!white},
3199 }]
3200 (0,0) rectangle (4,4);
3201 \end{tikzpicture}
3202 \end{dispExample*}
3203 \end{docTikzKeys}
3204
3205
3206 \begin{docTikzKeys}
3207 {
3208 {
3209 doc name = fill gea Hascherkeller,
3210 doc parameter = {=\marg{options}},
3211 doc description = {initially unset},
3212 doc new = 2026-03-24,
3213 }
3214 }
3215 The basic item shape of this template is a tripod divided into three parts.
3216 \refKey{/tikz/geomarray/style 1},
3217 \refKey{/tikz/geomarray/style 2}, and
3218 \refKey{/tikz/geomarray/style 3}, are used for the three parts.
3219 \begin{dispExample*}{gea-example}
3220 \ExplSyntaxOn
3221 \sys_gset_rand_seed:n {42}
3222 \ExplSyntaxOff
3223 \begin{tikzpicture}
3224 \draw[
3225 fill gea Hascherkeller = {
3226 scale fixed = 1,
3227 step equi = 8mm,
3228 init-item< = \TFDefineRandomColor{mycolor},
3229 style 1 = {fill=mycolor!50!white},
3230 style 2 = {fill=mycolor},
3231 style 3 = {fill=mycolor!50!black},
3232 angle=30,
3233 }]
3234 (0,0) rectangle (4,4);
3235 \end{tikzpicture}
3236 \end{dispExample*}
3237 \end{docTikzKeys}
3238
3239
3240 \begin{docTikzKeys}
3241 {
3242 {
3243 doc name = fill gea Klosterholz,
3244 doc parameter = {=\marg{options}},
3245 doc description = {initially unset},
3246 doc new = 2026-04-20,
3247 }
3248 }
3249 This is a variation of \refKey{/tikz/fill gea Hascherkeller} in which a
3250 prime color, \refKey{/tikz/geomarray/prime color 1}, defines
3251 the individual colors of the three parts. The key \refKey{/tikz/geomarray/style base}
3252 specifies a style applied to all parts.
3253 \begin{dispExample*}{gea-example}
3254 % \usepackage{opencolor}
3255 \begin{tikzpicture}
3256 \draw[
3257 fill gea Klosterholz = {
3258 scale fixed = 1,
3259 step equi = 8mm,
3260 init-row< = \TFRowColorLet{mycolor}
3261 {oc-lime-4}{oc-teal-4},
3262 prime color 1 = mycolor,
3263 style base = {draw=oc-gray-8,line join=round},
3264 freeze-row,
3265 }]
3266 (0,0) rectangle (4,4);
3267 \end{tikzpicture}
3268 \end{dispExample*}
3269 \end{docTikzKeys}
3270
3271
3272
3273 \clearpage
3274 \begin{docTikzKeys}
3275 {
3276 {
3277 doc name = fill gea Unterglaim,
3278 doc parameter = {=\marg{options}},
3279 doc description = {initially unset},
3280 doc new = 2026-03-24,
3281 }
3282 }
3283 The basic item shape of this template is an octogon.
3284 \refKey{/tikz/geomarray/style 1} is used for graph drawing.
3285
3286 \begin{dispExample*}{gea-example}
3287 \begin{tikzpicture}
3288 \draw[
3289 preaction = {fill=yellow!70!gray},
3290 fill gea Unterglaim = {
3291 scale fixed = 1,
3292 style 1 =
3293 {draw, top color=blue!50,bottom color=blue},
3294 }]
3295 (0,0) rectangle (4,4);
3296 \end{tikzpicture}
3297 \end{dispExample*}
3298 \end{docTikzKeys}
3299
3300
3301
3302 \begin{docTikzKeys}
3303 {
3304 {
3305 doc name = fill gea Grandsberg,
3306 doc parameter = {=\marg{options}},
3307 doc description = {initially unset},
3308 doc new = 2026-03-20,
3309 }
3310 }
3311 This is a variation of \refKey{/tikz/fill gea Unterglaim} where
3312 \refKey{/tikz/geomarray/style 1} and
3313 \refKey{/tikz/geomarray/style 2} are used in a checkerboard pattern.
3314
3315 \begin{dispExample*}{gea-example}
3316 \begin{tikzpicture}
3317 \draw[
3318 preaction = {fill=black!90},
3319 fill gea Grandsberg = {
3320 scale fixed = 1,
3321 step = 5mm,
3322 init-row< =
3323 \TFRowColorLet{mycolor}{red!60}{blue!30},
3324 style 1 = {draw=black!90,fill=mycolor},
3325 style 2 = {fill=yellow!75!gray},
3326 angle = 45,
3327 }]
3328 (0,0) rectangle (4,4);
3329 \end{tikzpicture}
3330 \end{dispExample*}
3331 \end{docTikzKeys}
3332
3333
3334 \begin{docTikzKeys}
3335 {
3336 {
3337 doc name = fill gea Kottingrohr,
3338 doc parameter = {=\marg{options}},
3339 doc description = {initially unset},
3340 doc new = 2026-03-18,
3341 }
3342 }
3343 This is a variation of \refKey{/tikz/fill gea Unterglaim} in which
3344 \refKey{/tikz/geomarray/style 1} and \refKey{/tikz/geomarray/style 2} are used for
3345 odd and even rows, respectively.
3346
3347 \begin{dispExample*}{gea-example}
3348 \begin{tikzpicture}
3349 \draw[
3350 fill gea Kottingrohr = {
3351 triangular,
3352 scale linear = {0.5}{1},
3353 step = 6mm,
3354 style 1 = {bottom color=red, top color=red!50},
3355 style 2 = {bottom color=blue, top color=blue!50},
3356 }]
3357 (0,0) rectangle (4,4);
3358 \end{tikzpicture}
3359 \end{dispExample*}
3360 \end{docTikzKeys}
3361
3362
3363 \clearpage
3364
3365 \begin{docTikzKeys}
3366 {
3367 {
3368 doc name = fill gea Ostergaden,
3369 doc parameter = {=\marg{options}},
3370 doc description = {initially unset},
3371 doc new = 2026-04-22,
3372 }
3373 }
3374 This template consists of a rectangle with two attached
3375 hexagons.
3376 An optical illusion creates the impression of an octogon.
3377
3378 \refKey{/tikz/geomarray/style 1},
3379 \refKey{/tikz/geomarray/style 2}, and\\
3380 \refKey{/tikz/geomarray/style 3} are used for the three parts.
3381
3382 The ratio between the inner rectangle and the (theoretical)
3383 base rectangle is controlled by
3384 \refKey{/tikz/geomarray/ratio}, which defaults to $2-\sqrt{2}$.
3385 For equal values of \refKey{/tikz/geomarray/xstep} and
3386 \refKey{/tikz/geomarray/ystep}, this default produces the impression of a
3387 regular octagon.
3388
3389 \begin{dispExample*}{gea-example}
3390 % \usepackage{opencolor}
3391 \begin{tikzpicture}
3392 \draw[
3393 fill gea Ostergaden = {
3394 scale fixed = 1,
3395 step equi = 7mm,
3396 style 1 = { draw, top color=oc-red-3,
3397 bottom color=oc-red-4 },
3398 style 2 = { draw, fill=oc-indigo-3 },
3399 style 3 = { draw, fill=oc-blue-3 },
3400 }]
3401 (0,0) rectangle (4,4);
3402 \end{tikzpicture}
3403 \end{dispExample*}
3404
3405
3406 \begin{dispExample*}{gea-example}
3407 % \usepackage{opencolor}
3408 \begin{tikzpicture}
3409 \draw[
3410 fill gea Ostergaden = {
3411 ratio = 1/3,
3412 scale fixed = 1,
3413 step equi = 7mm,
3414 style 1 = { draw, fill=oc-teal-8 },
3415 style 2 = { draw, top color=oc-lime-2,
3416 bottom color=oc-lime-5 },
3417 style 3 = { draw, top color=oc-blue-2,
3418 bottom color=oc-blue-5 },
3419 angle = 45,
3420 }]
3421 (0,0) rectangle (4,4);
3422 \end{tikzpicture}
3423 \end{dispExample*}
3424 \end{docTikzKeys}
3425
3426
3427 \clearpage
3428 \begin{docTikzKeys}
3429 {
3430 {
3431 doc name = fill gea Hohenthann,
3432 doc parameter = {=\marg{options}},
3433 doc description = {initially unset},
3434 doc new = 2026-03-25,
3435 }
3436 }
3437 The basic item shape of this template is an arrow.
3438 \refKey{/tikz/geomarray/style 1} is used for graph drawing.
3439
3440 \begin{dispExample*}{gea-example}
3441 \begin{tikzpicture}
3442 \draw[
3443 fill gea Hohenthann = {
3444 scale fixed = 1,
3445 step equi* double = 7mm,
3446 style 1 = {draw=white,
3447 left color=blue!50,right color=blue},
3448 }]
3449 (0,0) rectangle (4,4);
3450 \end{tikzpicture}
3451 \end{dispExample*}
3452 \end{docTikzKeys}
3453
3454
3455 \begin{docTikzKeys}
3456 {
3457 {
3458 doc name = fill gea Bibelsbach,
3459 doc parameter = {=\marg{options}},
3460 doc description = {initially unset},
3461 doc new = 2026-03-25,
3462 }
3463 }
3464 This is a variation of \refKey{/tikz/fill gea Hohenthann} in which
3465 \refKey{/tikz/geomarray/style 1} and \refKey{/tikz/geomarray/style 2} are used for
3466 odd and even rows, respectively.
3467
3468 \begin{dispExample*}{gea-example}
3469 \begin{tikzpicture}
3470 \draw[
3471 fill gea Bibelsbach = {
3472 scale fixed = 1,
3473 step equi* double = 7mm,
3474 style 1 = {draw=white,
3475 left color=blue!50,right color=blue},
3476 style 2 = {draw=white,
3477 left color=red!50,right color=red},
3478 }]
3479 (0,0) rectangle (4,4);
3480 \end{tikzpicture}
3481 \end{dispExample*}
3482 \end{docTikzKeys}
3483
3484
3485
3486 \begin{docTikzKeys}
3487 {
3488 {
3489 doc name = fill gea Roseneck,
3490 doc parameter = {=\marg{options}},
3491 doc description = {initially unset},
3492 doc new = 2026-03-25,
3493 }
3494 }
3495 This is a variation of \refKey{/tikz/fill gea Hohenthann} in which
3496 \refKey{/tikz/geomarray/style 1} and \refKey{/tikz/geomarray/style 2} are used for
3497 odd and even columns, respectively.
3498
3499 \begin{dispExample*}{gea-example}
3500 \begin{tikzpicture}
3501 \draw[
3502 fill gea Roseneck = {
3503 scale fixed = 1,
3504 step equi* double = 7mm,
3505 style 1 = {draw=white,
3506 left color=blue!50,right color=blue},
3507 style 2 = {draw=white,
3508 left color=red!50,right color=red},
3509 }]
3510 (0,0) rectangle (4,4);
3511 \end{tikzpicture}
3512 \end{dispExample*}
3513 \end{docTikzKeys}
3514
3515
3516 \clearpage
3517 \begin{docTikzKeys}
3518 {
3519 {
3520 doc name = fill gea Altenkofen,
3521 doc parameter = {=\marg{options}},
3522 doc description = {initially unset},
3523 doc new = 2026-03-25,
3524 }
3525 }
3526 This is a variation of \refKey{/tikz/fill gea Hohenthann} in which
3527 \refKey{/tikz/geomarray/style 1} and \refKey{/tikz/geomarray/style 2}
3528 are used are used in a checkerboard pattern.
3529 \begin{dispExample*}{gea-example}
3530 \begin{tikzpicture}
3531 \draw[
3532 fill gea Altenkofen = {
3533 scale fixed = 1,
3534 step equi* double = 7mm,
3535 style 1 = {draw=white,
3536 left color=blue!50,right color=blue},
3537 style 2 = {draw=white,
3538 left color=red!50,right color=red},
3539 }]
3540 (0,0) rectangle (4,4);
3541 \end{tikzpicture}
3542 \end{dispExample*}
3543 \end{docTikzKeys}
3544
3545
3546 \begin{docTikzKeys}
3547 {
3548 {
3549 doc name = fill gea Irlmuehle,
3550 doc parameter = {=\marg{options}},
3551 doc description = {initially unset},
3552 doc new = 2026-03-25,
3553 }
3554 }
3555 This is a variation of \refKey{/tikz/fill gea Hohenthann} in which
3556 \refKey{/tikz/geomarray/style 1},
3557 \refKey{/tikz/geomarray/style 2},
3558 \refKey{/tikz/geomarray/style 3}, and
3559 \refKey{/tikz/geomarray/style 4}
3560 are used are used.
3561 \begin{dispExample*}{gea-example}
3562 \begin{tikzpicture}
3563 \draw[
3564 fill gea Irlmuehle = {
3565 scale fixed = 1,
3566 step equi* double = 7mm,
3567 style 1 = {fill=red},
3568 style 2 = {fill=red!50},
3569 style 3 = {fill=blue},
3570 style 4 = {fill=blue!50},
3571 }]
3572 (0,0) rectangle (4,4);
3573 \end{tikzpicture}
3574 \end{dispExample*}
3575 \end{docTikzKeys}
3576
3577
3578 \clearpage
3579 \begin{docTikzKeys}
3580 {
3581 {
3582 doc name = fill gea Gammelsdorf,
3583 doc parameter = {=\marg{options}},
3584 doc description = {initially unset},
3585 doc new = 2026-03-25,
3586 }
3587 }
3588 The basic item shape of this template is an arrow divided into two parts.
3589 \refKey{/tikz/geomarray/style 1} and
3590 \refKey{/tikz/geomarray/style 2} are used for the two parts.
3591 \begin{dispExample*}{gea-example}
3592 % \usepackage{opencolor}
3593 \begin{tikzpicture}
3594 \draw[
3595 preaction = {fill=oc-teal-9},
3596 fill gea Gammelsdorf = {
3597 step equi* double = 6mm,
3598 init-row< =
3599 \TFRowColorLet{mycolor}{oc-cyan-6}{oc-green-6},
3600 style 1 = {fill=mycolor},
3601 style 2 = {fill=mycolor!50},
3602 }]
3603 (0,0) rectangle (4,4);
3604 \end{tikzpicture}
3605 \end{dispExample*}
3606 \end{docTikzKeys}
3607
3608
3609 \begin{docTikzKeys}
3610 {
3611 {
3612 doc name = fill gea Traich,
3613 doc parameter = {=\marg{options}},
3614 doc description = {initially unset},
3615 doc new = 2026-03-25,
3616 }
3617 }
3618 This is a variation of \refKey{/tikz/fill gea Gammelsdorf} in which
3619 \refKey{/tikz/geomarray/style 1} and \refKey{/tikz/geomarray/style 2}
3620 are used in a checkerboard pattern.
3621 \begin{dispExample*}{gea-example}
3622 % \usepackage{opencolor}
3623 \begin{tikzpicture}
3624 \draw[
3625 fill gea Traich = {
3626 scale fixed = 1,
3627 step equi* = 7mm,
3628 init-row< =
3629 \TFRowColorLet{mycolor}{oc-cyan-6}{oc-green-6},
3630 style 1 = {fill=mycolor},
3631 style 2 = {fill=mycolor!50},
3632 }]
3633 (0,0) rectangle (4,4);
3634 \end{tikzpicture}
3635 \end{dispExample*}
3636 \end{docTikzKeys}
3637
3638
3639
3640 \begin{docTikzKeys}
3641 {
3642 {
3643 doc name = fill gea Winbuerg,
3644 doc parameter = {=\marg{options}},
3645 doc description = {initially unset},
3646 doc new = 2026-03-25,
3647 }
3648 }
3649 This is a variation of \refKey{/tikz/fill gea Gammelsdorf} in which
3650 \refKey{/tikz/geomarray/style 1},
3651 \refKey{/tikz/geomarray/style 2},
3652 \refKey{/tikz/geomarray/style 3}, and
3653 \refKey{/tikz/geomarray/style 4} are used.
3654 \begin{dispExample*}{gea-example}
3655 % \usepackage{opencolor}
3656 \begin{tikzpicture}
3657 \draw[
3658 fill gea Winbuerg = {
3659 scale fixed = 1,
3660 step equi* double = 7mm,
3661 init-row< =
3662 \TFRowColorLet{mycolA}{oc-cyan-6}{oc-green-6}%
3663 \TFRowColorLet{mycolB}{oc-blue-6}{oc-violet-6},
3664 style 1 = {fill=mycolA},
3665 style 2 = {fill=mycolA!50},
3666 style 3 = {fill=mycolB!50},
3667 style 4 = {fill=mycolB},
3668 }]
3669 (0,0) rectangle (4,4);
3670 \end{tikzpicture}
3671 \end{dispExample*}
3672 \end{docTikzKeys}
3673
3674
3675 \clearpage
3676 \begin{docTikzKeys}
3677 {
3678 {
3679 doc name = fill gea Kreuzholzen,
3680 doc parameter = {=\marg{options}},
3681 doc description = {initially unset},
3682 doc new = 2026-03-25,
3683 }
3684 }
3685 This is a variation of \refKey{/tikz/fill gea Gammelsdorf} in which
3686 \refKey{/tikz/geomarray/style 1} up to
3687 \refKey{/tikz/geomarray/style 8} are used.
3688 \begin{dispExample*}{gea-example}
3689 % \usepackage{opencolor}
3690 \begin{tikzpicture}
3691 \draw[
3692 fill gea Kreuzholzen = {
3693 scale fixed = 1,
3694 step equi* double = 6mm,
3695 style 1 = {fill=oc-green-6},
3696 style 2 = {fill=oc-green-2},
3697 style 3 = {fill=oc-lime-2},
3698 style 4 = {fill=oc-lime-6},
3699 style 5 = {fill=oc-orange-9},
3700 style 6 = {fill=oc-orange-6},
3701 style 7 = {fill=oc-red-6},
3702 style 8 = {fill=oc-red-9},
3703 }]
3704 (0,0) rectangle (4,4);
3705 \end{tikzpicture}
3706 \end{dispExample*}
3707 \end{docTikzKeys}
3708
3709
3710 \begin{docTikzKeys}
3711 {
3712 {
3713 doc name = fill gea Grafenhaun,
3714 doc parameter = {=\marg{options}},
3715 doc description = {initially unset},
3716 doc new = 2026-03-25,
3717 }
3718 }
3719 The basic item shape of this template is a hexagon divided into four
3720 pentagons (or two pentagons and two tetragons).
3721 \refKey{/tikz/geomarray/style 1},
3722 \refKey{/tikz/geomarray/style 2},
3723 \refKey{/tikz/geomarray/style 3}, and
3724 \refKey{/tikz/geomarray/style 4}
3725 are used for the four parts.\par
3726 The optimal congruence of the parts is found with
3727 \refKey{/tikz/geomarray/step equi* half}, but other relations between
3728 xstep and ystep also produce pleasing results.
3729
3730 \begin{dispExample*}{gea-example}
3731 % \usepackage{opencolor}
3732 \begin{tikzpicture}
3733 \draw[
3734 fill gea Grafenhaun = {
3735 step equi* half = 12mm,
3736 scale fixed = 1,
3737 style 1 = {draw,fill=oc-red-4},
3738 style 2 = {draw,fill=oc-yellow-4},
3739 style 3 = {draw,fill=oc-orange-4},
3740 style 4 = {draw,fill=oc-pink-4},
3741 }]
3742 (0,0) rectangle (4,4);
3743 \end{tikzpicture}
3744 \end{dispExample*}
3745
3746 \begin{dispExample*}{gea-example}
3747 % \usepackage{opencolor}
3748 \begin{tikzpicture}
3749 \draw[
3750 fill gea Grafenhaun = {
3751 step equi = 10mm,
3752 scale fixed = 1,
3753 init-row< =
3754 \TFRowColorLet{mycolor}{oc-lime-4}{oc-orange-4},
3755 style 1 = {fill=mycolor},
3756 style 2 = {fill=mycolor!75!white},
3757 style 3 = {fill=mycolor!75!gray},
3758 style 4 = {fill=mycolor!75!black},
3759 }]
3760 (0,0) rectangle (4,4);
3761 \end{tikzpicture}
3762 \end{dispExample*}
3763 \end{docTikzKeys}
3764
3765
3766
3767 \clearpage
3768 \begin{docTikzKeys}
3769 {
3770 {
3771 doc name = fill gea Niederhatzkofen,
3772 doc parameter = {=\marg{options}},
3773 doc description = {initially unset},
3774 doc new = 2026-04-17,
3775 }
3776 }
3777 The basic item shape of this template is a hexagon divided into nine parts,
3778 three of which form an inner hexagon surrounded by the remaining six parts. The
3779 styles \refKey{/tikz/geomarray/style 1} to \refKey{/tikz/geomarray/style 9} are
3780 used for these nine parts.
3781
3782 The ratio between the inner and outer hexagon is controlled by
3783 \refKey{/tikz/geomarray/ratio}, which defaults to $\frac{1}{\sqrt{3}}$. Notable
3784 ratio values include:
3785 \begin{itemize}
3786 \item $\rule[-2mm]{0mm}{6mm}\frac{1}{\sqrt{3}}$: all nine parts have equal area.
3787 \item $\rule[-2mm]{0mm}{6mm}\frac13$: intersections are equally spaced.
3788 \item $\rule[-2mm]{0mm}{6mm}\frac12$: triangular structures become visible.
3789 \item $\rule[-2mm]{0mm}{6mm}\frac23$: three hexagonal structures become visible.
3790 \end{itemize}
3791 \begin{dispExample*}{gea-example}
3792 % \usepackage{opencolor}
3793 \begin{tikzpicture}
3794 \draw[
3795 fill gea Niederhatzkofen = {
3796 scale fixed = 1,
3797 step equi = 15mm,
3798 style 1 = {draw, fill=oc-teal-5},
3799 style 2 = {draw, fill=oc-cyan-5},
3800 style 3 = {draw, fill=oc-grape-5},
3801 style 4 = {draw, fill=oc-violet-5},
3802 style 5 = {draw, fill=oc-indigo-5},
3803 style 6 = {draw, fill=oc-blue-5},
3804 style 7 = {draw, fill=oc-yellow-5},
3805 style 8 = {draw, fill=oc-green-5},
3806 style 9 = {draw, fill=oc-lime-5},
3807 }]
3808 (0,0) rectangle (4,4);
3809 \end{tikzpicture}
3810 \end{dispExample*}
3811 \end{docTikzKeys}
3812
3813
3814 \begin{docTikzKeys}
3815 {
3816 {
3817 doc name = fill gea Eggerach,
3818 doc parameter = {=\marg{options}},
3819 doc description = {initially unset},
3820 doc new = 2026-04-23,
3821 }
3822 }
3823 This is a variation of \refKey{/tikz/fill gea Niederhatzkofen} in which
3824 \refKey{/tikz/geomarray/style base}
3825 specifies a style applied to all nine parts.
3826 \begin{dispExample*}{gea-example}
3827 \begin{tikzpicture}
3828 \draw[
3829 fill gea Eggerach = {
3830 scale fixed = 1,
3831 step equi = 15mm,
3832 xflip even,
3833 style base = {draw, top color=red!10,
3834 bottom color=red!50},
3835 angle = 30,
3836 }]
3837 (0,0) rectangle (4,4);
3838 \end{tikzpicture}
3839 \end{dispExample*}
3840 \end{docTikzKeys}
3841
3842
3843 \clearpage
3844 \begin{docTikzKeys}
3845 {
3846 {
3847 doc name = fill gea Marktstauden,
3848 doc parameter = {=\marg{options}},
3849 doc description = {initially unset},
3850 doc new = 2026-04-17,
3851 }
3852 }
3853 This is a variation of \refKey{/tikz/fill gea Niederhatzkofen} in which two
3854 prime colors, \refKey{/tikz/geomarray/prime color 1} and
3855 \refKey{/tikz/geomarray/prime color 2}, define the individual colors of the six
3856 outer and three inner parts. The key \refKey{/tikz/geomarray/style base}
3857 specifies a style applied to all nine parts.
3858 \begin{dispExample*}{gea-example}
3859 % \usepackage{opencolor}
3860 \begin{tikzpicture}
3861 \draw[
3862 fill gea Marktstauden = {
3863 scale fixed = 1,
3864 ratio = 1/3,
3865 step equi = 15mm,
3866 style base = { draw },
3867 prime color 1 = oc-grape-5,
3868 prime color 2 = oc-red-5,
3869 }]
3870 (0,0) rectangle (4,4);
3871 \end{tikzpicture}
3872 \end{dispExample*}
3873
3874 \begin{dispExample*}{gea-example}
3875 % \usepackage{opencolor}
3876 \begin{tikzpicture}
3877 \draw[
3878 fill gea Marktstauden = {
3879 scale fixed = 1,
3880 ratio = 0.5,
3881 step equi = 15mm,
3882 style base = { draw },
3883 prime color 1 = oc-lime-5,
3884 prime color 2 = oc-indigo-5,
3885 }]
3886 (0,0) rectangle (4,4);
3887 \end{tikzpicture}
3888 \end{dispExample*}
3889
3890 \begin{dispExample*}{gea-example}
3891 % \usepackage{opencolor}
3892 \begin{tikzpicture}
3893 \draw[
3894 fill gea Marktstauden = {
3895 scale fixed = 1,
3896 ratio = 2/3,
3897 xflip even,
3898 step equi = 15mm,
3899 style base = { draw },
3900 prime color 1 = oc-red-5,
3901 prime color 2 = oc-yellow-5,
3902 }]
3903 (0,0) rectangle (4,4);
3904 \end{tikzpicture}
3905 \end{dispExample*}
3906
3907 \end{docTikzKeys}
3908
3909
3910
3911 \clearpage
3912 \begin{docKeys}
3913 {
3914 {
3915 doc name = fill gea Alpersdorf,
3916 doc parameter = {=\marg{options}},
3917 doc keypath = tikz,
3918 doc description = {initially unset},
3919 doc new = 2026-04-17,
3920 }
3921 }
3922 The basic item shape of this template is a hexagon divided into fourteen parts.
3923 An optical illusion creates the impression of a decagon.
3924 The styles \refKey{/tikz/geomarray/style 1} to \refKey{/tikz/geomarray/style 14} are used for these fourteen parts.
3925
3926 The option \refKey{/tikz/geomarray/triangular} is applied by default. The key
3927 \refKey{/tikz/geomarray/step equi} produces squares and several equilateral
3928 triangles. When the specialized key
3929 \docAuxKey[tikz/geomarray]{step equi special} is used,
3930 the six vertices of the hexagon lie on a circle.
3931
3932 \begin{dispExample*}{gea-example}
3933 \begin{tikzpicture}
3934 \draw[
3935 fill gea Alpersdorf = {
3936 scale fixed = 1,
3937 step equi = 15mm,
3938 freeze-row,
3939 }]
3940 (0,0) rectangle (4,4);
3941 \end{tikzpicture}
3942 \end{dispExample*}
3943
3944 \begin{dispExample*}{gea-example}
3945 \begin{tikzpicture}
3946 \draw[
3947 fill gea Alpersdorf = {
3948 scale fixed = 1,
3949 step equi special = 15mm,
3950 freeze-row,
3951 }]
3952 (0,0) rectangle (4,4);
3953 \end{tikzpicture}
3954 \end{dispExample*}
3955
3956 \end{docKeys}
3957
3958
3959
3960 \begin{docTikzKeys}
3961 {
3962 {
3963 doc name = fill gea Schwarzberg,
3964 doc parameter = {=\marg{options}},
3965 doc description = {initially unset},
3966 doc new = 2026-04-23,
3967 }
3968 }
3969 This is a variation of \refKey{/tikz/fill gea Alpersdorf} in which
3970 \refKey{/tikz/geomarray/style base}
3971 specifies a style applied to all fourteen parts.
3972 \begin{dispExample*}{gea-example}
3973 \begin{tikzpicture}
3974 \draw[
3975 fill gea Schwarzberg = {
3976 scale fixed = 1,
3977 step equi special = 20mm,
3978 style base = {draw, top color=white,
3979 bottom color=blue!10},
3980 angle = 90,
3981 freeze-row,
3982 }]
3983 (0,0) rectangle (4,4);
3984 \end{tikzpicture}
3985 \end{dispExample*}
3986 \end{docTikzKeys}
3987
3988
3989 \clearpage
3990
3991 \begin{docTikzKeys}
3992 {
3993 {
3994 doc name = fill gea Scheckenhofen,
3995 doc parameter = {=\marg{options}},
3996 doc description = {initially unset},
3997 doc new = 2026-04-17,
3998 }
3999 }
4000 This is a variation of \refKey{/tikz/fill gea Alpersdorf} in which two
4001 prime colors, \refKey{/tikz/geomarray/prime color 1} and
4002 \refKey{/tikz/geomarray/prime color 2}, define the individual colors of the
4003 fourteen parts. The key \refKey{/tikz/geomarray/style base}
4004 specifies a style applied to all parts.
4005 \begin{dispExample*}{gea-example}
4006 % \usepackage{opencolor}
4007 \begin{tikzpicture}
4008 \draw[
4009 fill gea Scheckenhofen = {
4010 scale fixed = 1,
4011 step equi special = 15mm,
4012 init-row< = \TFRowColorLetSeq{mycolor}
4013 {oc-lime-4,oc-red-4,oc-cyan-4},
4014 prime color 1 = mycolor,
4015 prime color 2 = oc-yellow-4,
4016 style base = { draw=black, line width=0.2pt },
4017 angle = 90,
4018 freeze-row,
4019 }]
4020 (0,0) rectangle (4,6);
4021 \end{tikzpicture}
4022 \end{dispExample*}
4023 \end{docTikzKeys}
4024
4025
4026
4027 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
4028 \clearpage
4029 \printindex
4030
4031
4032 \end{document}