From bb51b61cfc3fcb367f52d31948039a1468fbcf80 Mon Sep 17 00:00:00 2001 From: Norbert Preining Date: Wed, 17 Mar 2021 03:01:06 +0000 Subject: CTAN sync 202103170301 --- macros/latex/contrib/gridpapers/README.md | 113 +++ .../contrib/gridpapers/examples/custom-colors.tex | 18 + .../contrib/gridpapers/examples/dot-grid-10spi.tex | 8 + .../contrib/gridpapers/examples/dot-grid-5spi.tex | 8 + .../contrib/gridpapers/examples/engineer-pad.tex | 8 + .../gridpapers/examples/engineer-paper-8spi.tex | 8 + .../gridpapers/examples/graph-paper-8spi.tex | 8 + .../contrib/gridpapers/examples/graph-paper.tex | 8 + .../gridpapers/examples/grid-with-light-cones.tex | 8 + .../examples/hex-engineer-letterpaper-fullpage.tex | 8 + .../contrib/gridpapers/examples/hex-grid-large.tex | 8 + .../contrib/gridpapers/examples/hex-grid-small.tex | 8 + .../contrib/gridpapers/examples/isometric-grid.tex | 8 + .../gridpapers/examples/plum-graph-paper.tex | 8 + .../examples/precocious-young-engineer.tex | 8 + .../gridpapers/examples/quadrille-10spi.tex | 8 + .../contrib/gridpapers/examples/quadrille-8spi.tex | 8 + .../contrib/gridpapers/examples/red-graph.tex | 8 + .../gridpapers/examples/triangular-grid.tex | 8 + macros/latex/contrib/gridpapers/gridpapers.dtx | 786 +++++++++++++++++++++ macros/latex/contrib/gridpapers/gridpapers.ins | 57 ++ macros/latex/contrib/gridpapers/gridpapers.pdf | Bin 0 -> 220081 bytes 22 files changed, 1110 insertions(+) create mode 100644 macros/latex/contrib/gridpapers/README.md create mode 100644 macros/latex/contrib/gridpapers/examples/custom-colors.tex create mode 100644 macros/latex/contrib/gridpapers/examples/dot-grid-10spi.tex create mode 100644 macros/latex/contrib/gridpapers/examples/dot-grid-5spi.tex create mode 100644 macros/latex/contrib/gridpapers/examples/engineer-pad.tex create mode 100644 macros/latex/contrib/gridpapers/examples/engineer-paper-8spi.tex create mode 100644 macros/latex/contrib/gridpapers/examples/graph-paper-8spi.tex create mode 100644 macros/latex/contrib/gridpapers/examples/graph-paper.tex create mode 100644 macros/latex/contrib/gridpapers/examples/grid-with-light-cones.tex create mode 100644 macros/latex/contrib/gridpapers/examples/hex-engineer-letterpaper-fullpage.tex create mode 100644 macros/latex/contrib/gridpapers/examples/hex-grid-large.tex create mode 100644 macros/latex/contrib/gridpapers/examples/hex-grid-small.tex create mode 100644 macros/latex/contrib/gridpapers/examples/isometric-grid.tex create mode 100644 macros/latex/contrib/gridpapers/examples/plum-graph-paper.tex create mode 100644 macros/latex/contrib/gridpapers/examples/precocious-young-engineer.tex create mode 100644 macros/latex/contrib/gridpapers/examples/quadrille-10spi.tex create mode 100644 macros/latex/contrib/gridpapers/examples/quadrille-8spi.tex create mode 100644 macros/latex/contrib/gridpapers/examples/red-graph.tex create mode 100644 macros/latex/contrib/gridpapers/examples/triangular-grid.tex create mode 100644 macros/latex/contrib/gridpapers/gridpapers.dtx create mode 100644 macros/latex/contrib/gridpapers/gridpapers.ins create mode 100644 macros/latex/contrib/gridpapers/gridpapers.pdf (limited to 'macros/latex/contrib/gridpapers') diff --git a/macros/latex/contrib/gridpapers/README.md b/macros/latex/contrib/gridpapers/README.md new file mode 100644 index 0000000000..a9be615209 --- /dev/null +++ b/macros/latex/contrib/gridpapers/README.md @@ -0,0 +1,113 @@ +# The *gridpapers* package +Make your own quadrille, graph, hex, etc. paper! Uses the [PGF/TikZ](https://en.wikipedia.org/wiki/PGF/TikZ) package for LaTeX, which should be part of any modern TeX installation. All colors and spacing are customizable. + +There are .tex files in the examples/ +directory to help get you started with customization. +Each tex file has an almost-empty body, with a `\usepackage` statement +that you can customize. For example, +examples/engineer-pad.tex looks like this: +```latex +\documentclass{article} +\usepackage[pattern=majmin, colorset=engineer]{gridpapers} +\begin{document} +\thispagestyle{empty} +~ +\end{document} +``` +(The `~` in the body forces a non-empty body, or else latex wouldn't +generate a PDF). + +Note: This package is distinct from a different package with a similar +name, [graphpaper (on CTAN)](https://www.ctan.org/pkg/graphpaper). + +Installation +------------ +If `gridpapers` is already provided in your TeX distribution, skip +this section. You should be able to install `gridpapers` [from the +CTAN](https://www.ctan.org/pkg/gridpapers) via your distribution's +utility (e.g. the TeX Live Utility). Alternatively, you can get the +package from the [source repository on +GitHub](https://github.com/mcnees/LaTeX-Graph-Paper). If you do not +want to do a "full" installation, just copy gridpapers.sty into the +same directory as your LaTeX source. + +Usage +----- + +All the configuration happens via the `\usepackage` command. The +current valid options are: + +* `pattern=`: +Valid pattern names are: +`std,stdeight,majmin,dot,hex,tri,iso,lightcone,ruled,doubleruled`. Default +is `std`. Patterns come with default page geometry (size and margins; +see `geometry`), and default 'fullness' (whether they fill the page or +not; see options `fullpage` and `textarea`). +* `colorset=`: +Valid color preset names are: +`std,precocious,brickred,engineer,plumpad`. Default is `std`. A +preset determines the `majorcolor`, `minorcolor`, and `bgcolor` all at +once. But, you can start from a preset and then override some colors. +* `majorcolor=`: Override the preset "major" color. This can + be a named color, or using the syntax from xcolor to mix colors + together. +* `minorcolor=`: Override the preset "minor" color. As above. +* `bgcolor=`: Override the preset background color. As above. +* `patternsize=`: Override the preset pattern size. The + meaning of this length argument is different for each pattern; see + PDF documentation for full details.. +* `dotsize=`: Controls the size of the dots themselves for + `pattern=dot`. Default: `.7pt` +* `fullpage`: Make the pattern fill the whole page. +* `textarea`: Make the pattern fill only the text area of the + document. At most one of the `fullpage` or `textarea` can be + specified. If one is specified, it will override the default + 'fullness' setting of the pattern. +* `geometry={}`: Page geometry specification, using the + syntax of the geometry package. If the geometry package was loaded + before gridpapers, this option will be ignored. This specification + will override the pattern's default page geometry. + +For example, let's say you want to use the `tri` pattern, which by +default fills the page. But you want it to fill just the textarea of +an A4 page with 2cm margins, and you want the triangles to be .75cm long. +Finally, you like the colors of the `engineer` set, but want a white +background. Then you would write: +```latex +\usepackage[pattern=tri, + patternsize=0.75cm, + textarea, + colorset=engineer, + bgcolor=white, + geometry={a4paper, margin=2cm}]{gridpapers} +``` + +Gallery +------- + +Some example styles: + +![Standard](https://raw.githubusercontent.com/mcnees/LaTeX-Graph-Paper/screenshots/std.jpg "Standard") + +![Quad](https://raw.githubusercontent.com/mcnees/LaTeX-Graph-Paper/screenshots/quad.jpg "Quadrille") + +![Hex](https://raw.githubusercontent.com/mcnees/LaTeX-Graph-Paper/screenshots/hex.jpg "Hex") + +![Dots](https://raw.githubusercontent.com/mcnees/LaTeX-Graph-Paper/screenshots/dot.jpg "Dots") + +![Light cone](https://raw.githubusercontent.com/mcnees/LaTeX-Graph-Paper/screenshots/lightcone.jpg "Light cone") + +![Precocious Engineer](https://raw.githubusercontent.com/mcnees/LaTeX-Graph-Paper/screenshots/rosie.png "Precocious Engineer color scheme") + +![Hex Engineer](https://raw.githubusercontent.com/mcnees/LaTeX-Graph-Paper/screenshots/hexengineer.png "Hex grid with Engineering Pad color scheme") + +Credits +------- + +This package was created by [Robert McNees](http://jacobi.luc.edu/) +with additional contributions from [Leo +C. Stein](http://duetosymmetry.com/), and is maintained by both. This +material is subject to the [LaTeX Project Public License +1.3c](https://www.ctan.org/license/lppl1.3), (c) 2017-2021. The +hexagon pattern code is [due to Philippe +Goutet](https://tex.stackexchange.com/questions/6019/drawing-hexagons/6128#6128). diff --git a/macros/latex/contrib/gridpapers/examples/custom-colors.tex b/macros/latex/contrib/gridpapers/examples/custom-colors.tex new file mode 100644 index 0000000000..1dcc940489 --- /dev/null +++ b/macros/latex/contrib/gridpapers/examples/custom-colors.tex @@ -0,0 +1,18 @@ +\documentclass{article} + +\usepackage{xcolor} + +% See the documentation of the xcolor package to learn about different +% color models for specifying colors +\definecolor{mydeepgreen}{rgb}{0.07, 0.56, 0.04} + +% You can easily mix colors by using the ! syntax from xcolor. Here +% we use it to mix 40% of our color with 60% white. +\usepackage[pattern=majmin, + majorcolor=mydeepgreen, + minorcolor={mydeepgreen!40}]{gridpapers} + +\begin{document} +\thispagestyle{empty} +~ +\end{document} diff --git a/macros/latex/contrib/gridpapers/examples/dot-grid-10spi.tex b/macros/latex/contrib/gridpapers/examples/dot-grid-10spi.tex new file mode 100644 index 0000000000..083928b3f0 --- /dev/null +++ b/macros/latex/contrib/gridpapers/examples/dot-grid-10spi.tex @@ -0,0 +1,8 @@ +\documentclass{article} + +\usepackage[pattern=dot]{gridpapers} + +\begin{document} +\thispagestyle{empty} +~ +\end{document} diff --git a/macros/latex/contrib/gridpapers/examples/dot-grid-5spi.tex b/macros/latex/contrib/gridpapers/examples/dot-grid-5spi.tex new file mode 100644 index 0000000000..6d9bb6a8db --- /dev/null +++ b/macros/latex/contrib/gridpapers/examples/dot-grid-5spi.tex @@ -0,0 +1,8 @@ +\documentclass{article} + +\usepackage[pattern=dot, patternsize=0.2in]{gridpapers} + +\begin{document} +\thispagestyle{empty} +~ +\end{document} diff --git a/macros/latex/contrib/gridpapers/examples/engineer-pad.tex b/macros/latex/contrib/gridpapers/examples/engineer-pad.tex new file mode 100644 index 0000000000..49bb239059 --- /dev/null +++ b/macros/latex/contrib/gridpapers/examples/engineer-pad.tex @@ -0,0 +1,8 @@ +\documentclass{article} + +\usepackage[pattern=majmin, colorset=engineer]{gridpapers} + +\begin{document} +\thispagestyle{empty} +~ +\end{document} diff --git a/macros/latex/contrib/gridpapers/examples/engineer-paper-8spi.tex b/macros/latex/contrib/gridpapers/examples/engineer-paper-8spi.tex new file mode 100644 index 0000000000..6260335d76 --- /dev/null +++ b/macros/latex/contrib/gridpapers/examples/engineer-paper-8spi.tex @@ -0,0 +1,8 @@ +\documentclass{article} + +\usepackage[pattern=majmin, colorset=engineer, bgcolor=white]{gridpapers} + +\begin{document} +\thispagestyle{empty} +~ +\end{document} diff --git a/macros/latex/contrib/gridpapers/examples/graph-paper-8spi.tex b/macros/latex/contrib/gridpapers/examples/graph-paper-8spi.tex new file mode 100644 index 0000000000..5e01e04e8f --- /dev/null +++ b/macros/latex/contrib/gridpapers/examples/graph-paper-8spi.tex @@ -0,0 +1,8 @@ +\documentclass{article} + +\usepackage[pattern=majmin]{gridpapers} + +\begin{document} +\thispagestyle{empty} +~ +\end{document} diff --git a/macros/latex/contrib/gridpapers/examples/graph-paper.tex b/macros/latex/contrib/gridpapers/examples/graph-paper.tex new file mode 100644 index 0000000000..4474fc44ed --- /dev/null +++ b/macros/latex/contrib/gridpapers/examples/graph-paper.tex @@ -0,0 +1,8 @@ +\documentclass{article} + +\usepackage[pattern=std]{gridpapers} + +\begin{document} +\thispagestyle{empty} +~ +\end{document} diff --git a/macros/latex/contrib/gridpapers/examples/grid-with-light-cones.tex b/macros/latex/contrib/gridpapers/examples/grid-with-light-cones.tex new file mode 100644 index 0000000000..04cebdd74f --- /dev/null +++ b/macros/latex/contrib/gridpapers/examples/grid-with-light-cones.tex @@ -0,0 +1,8 @@ +\documentclass{article} + +\usepackage[pattern=lightcone]{gridpapers} + +\begin{document} +\thispagestyle{empty} +~ +\end{document} diff --git a/macros/latex/contrib/gridpapers/examples/hex-engineer-letterpaper-fullpage.tex b/macros/latex/contrib/gridpapers/examples/hex-engineer-letterpaper-fullpage.tex new file mode 100644 index 0000000000..70d925fdd3 --- /dev/null +++ b/macros/latex/contrib/gridpapers/examples/hex-engineer-letterpaper-fullpage.tex @@ -0,0 +1,8 @@ +\documentclass{article} + +\usepackage[pattern=hex, colorset=engineer, fullpage, geometry={letterpaper}]{gridpapers} + +\begin{document} +\thispagestyle{empty} +~ +\end{document} diff --git a/macros/latex/contrib/gridpapers/examples/hex-grid-large.tex b/macros/latex/contrib/gridpapers/examples/hex-grid-large.tex new file mode 100644 index 0000000000..0aaa4b1814 --- /dev/null +++ b/macros/latex/contrib/gridpapers/examples/hex-grid-large.tex @@ -0,0 +1,8 @@ +\documentclass{article} + +\usepackage[pattern=hex]{gridpapers} + +\begin{document} +\thispagestyle{empty} +~ +\end{document} diff --git a/macros/latex/contrib/gridpapers/examples/hex-grid-small.tex b/macros/latex/contrib/gridpapers/examples/hex-grid-small.tex new file mode 100644 index 0000000000..8b532f90bb --- /dev/null +++ b/macros/latex/contrib/gridpapers/examples/hex-grid-small.tex @@ -0,0 +1,8 @@ +\documentclass{article} + +\usepackage[pattern=hex, patternsize=0.0833in]{gridpapers} + +\begin{document} +\thispagestyle{empty} +~ +\end{document} diff --git a/macros/latex/contrib/gridpapers/examples/isometric-grid.tex b/macros/latex/contrib/gridpapers/examples/isometric-grid.tex new file mode 100644 index 0000000000..7e0678d30d --- /dev/null +++ b/macros/latex/contrib/gridpapers/examples/isometric-grid.tex @@ -0,0 +1,8 @@ +\documentclass{article} + +\usepackage[pattern=iso]{gridpapers} + +\begin{document} +\thispagestyle{empty} +~ +\end{document} diff --git a/macros/latex/contrib/gridpapers/examples/plum-graph-paper.tex b/macros/latex/contrib/gridpapers/examples/plum-graph-paper.tex new file mode 100644 index 0000000000..09ef97cbea --- /dev/null +++ b/macros/latex/contrib/gridpapers/examples/plum-graph-paper.tex @@ -0,0 +1,8 @@ +\documentclass{article} + +\usepackage[pattern=majmin, colorset=plumpad]{gridpapers} + +\begin{document} +\thispagestyle{empty} +~ +\end{document} diff --git a/macros/latex/contrib/gridpapers/examples/precocious-young-engineer.tex b/macros/latex/contrib/gridpapers/examples/precocious-young-engineer.tex new file mode 100644 index 0000000000..1e33ba820c --- /dev/null +++ b/macros/latex/contrib/gridpapers/examples/precocious-young-engineer.tex @@ -0,0 +1,8 @@ +\documentclass{article} + +\usepackage[pattern=majmin, colorset=precocious]{gridpapers} + +\begin{document} +\thispagestyle{empty} +~ +\end{document} diff --git a/macros/latex/contrib/gridpapers/examples/quadrille-10spi.tex b/macros/latex/contrib/gridpapers/examples/quadrille-10spi.tex new file mode 100644 index 0000000000..4474fc44ed --- /dev/null +++ b/macros/latex/contrib/gridpapers/examples/quadrille-10spi.tex @@ -0,0 +1,8 @@ +\documentclass{article} + +\usepackage[pattern=std]{gridpapers} + +\begin{document} +\thispagestyle{empty} +~ +\end{document} diff --git a/macros/latex/contrib/gridpapers/examples/quadrille-8spi.tex b/macros/latex/contrib/gridpapers/examples/quadrille-8spi.tex new file mode 100644 index 0000000000..fcc8b91ed7 --- /dev/null +++ b/macros/latex/contrib/gridpapers/examples/quadrille-8spi.tex @@ -0,0 +1,8 @@ +\documentclass{article} + +\usepackage[pattern=stdeight]{gridpapers} + +\begin{document} +\thispagestyle{empty} +~ +\end{document} diff --git a/macros/latex/contrib/gridpapers/examples/red-graph.tex b/macros/latex/contrib/gridpapers/examples/red-graph.tex new file mode 100644 index 0000000000..8113ebca91 --- /dev/null +++ b/macros/latex/contrib/gridpapers/examples/red-graph.tex @@ -0,0 +1,8 @@ +\documentclass{article} + +\usepackage[pattern=majmin, colorset=brickred]{gridpapers} + +\begin{document} +\thispagestyle{empty} +~ +\end{document} diff --git a/macros/latex/contrib/gridpapers/examples/triangular-grid.tex b/macros/latex/contrib/gridpapers/examples/triangular-grid.tex new file mode 100644 index 0000000000..2120eac289 --- /dev/null +++ b/macros/latex/contrib/gridpapers/examples/triangular-grid.tex @@ -0,0 +1,8 @@ +\documentclass{article} + +\usepackage[pattern=tri]{gridpapers} + +\begin{document} +\thispagestyle{empty} +~ +\end{document} diff --git a/macros/latex/contrib/gridpapers/gridpapers.dtx b/macros/latex/contrib/gridpapers/gridpapers.dtx new file mode 100644 index 0000000000..c3584ef59f --- /dev/null +++ b/macros/latex/contrib/gridpapers/gridpapers.dtx @@ -0,0 +1,786 @@ +% \iffalse meta-comment +% +% Copyright (C) 2021 by Robert McNees , Leo C. Stein +% --------------------------------------------------------------------------- +% This work may be distributed and/or modified under the +% conditions of the LaTeX Project Public License, either version 1.3 +% of this license or (at your option) any later version. +% The latest version of this license is in +% http://www.latex-project.org/lppl.txt +% and version 1.3 or later is part of all distributions of LaTeX +% version 2005/12/01 or later. +% +% This work has the LPPL maintenance status `maintained'. +% +% The Current Maintainers of this work are Robert McNees, Leo C. Stein. +% +% This work consists of the files gridpapers.dtx and gridpapers.ins +% and the derived filebase gridpapers.sty. +% +% \fi +% +% \iffalse +%<*driver> +\ProvidesFile{gridpapers.dtx} +% +% +%<*driver> +\documentclass{ltxdoc} +\usepackage[dvipsnames]{xcolor} +\usepackage[pattern=stdeight, textarea, + majorcolor=cornflower!30, minorcolor=cornflower!10, + geometry={margin=1in, left=2in}]{gridpapers}[2021/03/14] +\usepackage{hyperref} +\hypersetup{colorlinks,urlcolor=NavyBlue,citecolor=NavyBlue,linkcolor=NavyBlue, + pdfauthor={Robert McNees and Leo C. Stein}, + pdftitle={The gridpapers package}} +\usepackage{fontawesome} +\definecolor{twitterblue}{RGB}{64,153,255} +\newcommand{\email}[1]{$\langle$\href{mailto:#1}{#1}$\rangle$} +\newcommand{\twitter}[1]{\href{https://twitter.com/#1}{\textcolor{twitterblue}{\faTwitter}\,\tt\textcolor{twitterblue}{@#1}}} +\usepackage{dtxdescribe} +\usepackage[columns=2]{idxlayout} +\EnableCrossrefs +\CodelineIndex +\RecordChanges +\begin{document} + \DocInput{gridpapers.dtx} + \PrintChanges +\end{document} +% +% \fi +% +% \CheckSum{430} +% +% \CharacterTable +% {Upper-case \A\B\C\D\E\F\G\H\I\J\K\L\M\N\O\P\Q\R\S\T\U\V\W\X\Y\Z +% Lower-case \a\b\c\d\e\f\g\h\i\j\k\l\m\n\o\p\q\r\s\t\u\v\w\x\y\z +% Digits \0\1\2\3\4\5\6\7\8\9 +% Exclamation \! Double quote \" Hash (number) \# +% Dollar \$ Percent \% Ampersand \& +% Acute accent \' Left paren \( Right paren \) +% Asterisk \* Plus \+ Comma \, +% Minus \- Point \. Solidus \/ +% Colon \: Semicolon \; Less than \< +% Equals \= Greater than \> Question mark \? +% Commercial at \@ Left bracket \[ Backslash \\ +% Right bracket \] Circumflex \^ Underscore \_ +% Grave accent \` Left brace \{ Vertical bar \| +% Right brace \} Tilde \~} +% +% +% \changes{v1.0.0}{2021/03/13}{Converted to DTX file} +% +% \DoNotIndex{\newcommand,\newenvironment} +% +% \GetFileInfo{gridpapers.sty} +% \title{The \textsf{gridpapers} package} +% \author{Robert McNees\footnote{\email{rmcnees@luc.edu}; \twitter{mcnees}} +% \ and +% Leo C.\ Stein\footnote{\email{leo.stein@gmail.com}; \twitter{duetosymmetry}}} +% \date{\fileversion~from \filedate} +% +% \maketitle +% +% All development happens at the repo: +% \url{https://github.com/mcnees/LaTeX-Graph-Paper}. +% +% \section{Introduction} +% +% Make your own quadrille, graph, hex, etc.\ paper! Uses the PGF/TikZ +% package for \LaTeX, which should be part of any modern \TeX{} +% installation. Lots of preset defaults to get started with ease, yet +% all colors and spacing are customizable. +% +% There are example .tex files in the |examples| directory to +% help get you started with customization. Each tex file has an +% almost-empty body, with a |\usepackage| statement that you can +% customize. For example, engineer-pad.tex looks like this: +% \VerbatimInput[frame=single, +% numbers=left, +% xleftmargin=2em, +% label=engineer-pad.tex]{examples/engineer-pad.tex} +% (The |~| in the body forces a non-empty body, or else latex wouldn't generate a PDF). +% +% \section{Usage} +% +% \subsection{Options} +% +% Your graph paper is configured through a number of key/value options +% to the |\usepackage| command. Let's go through these options. +% +% \DescribeObject{pattern=\marg{name}}\DescribeDefault{std} Which of +% the predefined patterns to use for the page or textarea background. +% The current list of pattern names is: |std|, |stdeight|, |majmin|, +% |dot|, |hex|, |tri|, |iso|, |lightcone|, |ruled|, |doubleruled|. We +% describe each of these patterns in Sec.~\ref{sec:patterns}. +% Patterns come with default page geometry (size and margins; see +% |geometry|), and default `fullness' (whether they fill the page or +% not; see options |fullpage| and |textarea|). +% +% \DescribeObject{colorset=\marg{name}}\DescribeDefault{std} Color +% presets. Valid color preset names are: |std|, |precocious|, +% |brickred|, |engineer|, |plumpad|. A preset determines the +% |majorcolor|, |minorcolor|, and |bgcolor| all at once. But, you can +% start from a preset and then override some colors. +% +% \DescribeObject{majorcolor=\marg{color}} Override the preset +% ``major'' color. This can be a named color, or using the syntax from +% |xcolor| to mix colors together. +% +% \DescribeObject{minorcolor=\marg{color}} Override the preset +% ``minor'' color. As above. +% +% \DescribeObject{bgcolor=\marg{color}} Override the preset background +% color. As above. +% +% \DescribeObject{patternsize=\marg{length}} Override the preset +% pattern size. The meaning of this length argument is different for +% each pattern; see Sec.~\ref{sec:patterns} for more. +% +% \DescribeObject{dotsize=\marg{length}}\DescribeDefault{.7pt} +% Controls the size of the dots themselves for |pattern=dot|. +% +% \DescribeObject{fullpage} Make the pattern fill the whole page. +% +% \DescribeObject{textarea} Make the pattern fill only the text area +% of the document. At most one of the |fullpage| or |textarea| can be +% specified. If one is specified, it will override the default +% `fullness' setting of the pattern. +% +% \DescribeObject{geometry=\marg{geometry spec}} Page geometry +% specification, using the syntax of the |geometry| package. This +% specification will override the pattern's default page geometry. +% However, if the |geometry| package was loaded before |gridpapers|, +% this option will be ignored. +% +% \subsection{Patterns} +% \label{sec:patterns} +% +% The current set of patterns: +% +% \DescribeObject{std} Quadrille, ten squares per inch. The +% |patternsize| option controls the side of a square. Default is +% |patternsize=0.1in|. +% +% \DescribeObject{stdeight} Quadrille, eight squares per inch. The +% |patternsize| option controls the side of a square. Default is +% |patternsize=0.125in|. +% +% \DescribeObject{majmin} Graph paper, eight squares per inch with a +% major grid every half-inch. The |patternsize| option controls the +% side of a small square (the larger squares are four times bigger). +% Default is |patternsize=0.125in|. +% +% \DescribeObject{dot} Grid of dots. The size of an individual dot is +% set by |dotsize|. The |patternsize| option controls the distance +% between dots. Default is |patternsize=0.1in|. +% +% \DescribeObject{hex} Grid of hexagons. The |patternsize| option +% controls the side length of a hexagon. Default is +% |patternsize=0.1666in|. +% +% \DescribeObject{tri} Triangle grid. The |patternsize| option +% controls the side length of a triangle. Default is +% |patternsize=0.25in|. +% +% \DescribeObject{iso} Isometric grid. The |patternsize| option +% controls the side length of a triangle. Default is +% |patternsize=0.25in|. +% +% \DescribeObject{lightcone} A grid with light cones (45° lines) on a +% square grid. The |patternsize| option controls the side of a +% horizontal square (not the tipped squared). Default is +% |patternsize=0.25in|. +% +% \DescribeObject{ruled} Ruled page with bold lines. The +% |patternsize| option controls the vertical distance between lines. +% Default is |patternsize=0.2in|. +% +% \DescribeObject{doubleruled} Ruled page with bold lines alternating +% with light lines. The |patternsize| option controls the vertical +% distance between neighboring lines. Default is +% |patternsize=0.125in|. +% +% \section{Examples} +% +% \subsection{Plenty of customization} +% +% Let's say you want to use the |tri| pattern, which by default fills +% the page. But you want it to fill just the textarea of an A4 page +% with 2cm margins, and you want the triangles to be .75cm +% long. Finally, you like the colors of the engineer set, but want a +% white background. Then you would write: +% \begin{sourceverb}[frame=single] +% \usepackage[pattern=tri, +% patternsize=0.75cm, +% textarea, +% colorset=engineer, +% bgcolor=white, +% geometry={a4paper, margin=2cm}]{gridpapers} +% \end{sourceverb} +% +% \subsection{Custom colors} +% +% Using named or blended custom colors is demonstrated in the example +% file |custom-colors.tex|: +% \VerbatimInput[frame=single, +% numbers=left, +% xleftmargin=2em, +% label=custom-colors.tex]{examples/custom-colors.tex} +% + +% +% \StopEventually{} +% +% \section{Implementation} +% +% \iffalse +%<*package> +% \fi +% +% \begin{macrocode} +\NeedsTeXFormat{LaTeX2e}[1994/06/01] +\ProvidesPackage{gridpapers} + [2021/03/14 v1.0.0 Graph paper backgrounds] + +\RequirePackage{xkeyval} +\RequirePackage{kvoptions} +\RequirePackage{xcolor} +\RequirePackage{tikz} +\usetikzlibrary{patterns.meta,calc} +\RequirePackage{tikzpagenodes} +%% everypage has been superseded -- try to use the new builtin +%% approach, but fall back to everypage-1x if needed +%% This code is roughly taken from the new everypage code +\@ifundefined{AddToHook}{% + \RequirePackage{everypage-1x} +}{% + \newcommand*{\AddEverypageHook}[1]{% + \AddToHook{shipout/background}{\put(1in,-1in){#1}}} +} +\RequirePackage{pagecolor} + +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +%% Option parsing +%% Declare switches for processing the options. + +\newif\ifGP@geometrypreviouslyloaded +\newif\ifGP@fullnessset +\newif\ifGP@fullpage +\newif\ifGP@textarea +\GP@geometrypreviouslyloadedfalse +\GP@fullnesssetfalse +\GP@fullpagefalse +\GP@textareafalse + +\SetupKeyvalOptions{% + family=GP,% + prefix=GPOpt@% +} + +\DeclareStringOption[std]{pattern} +\DeclareStringOption[std]{colorset} + +\DeclareStringOption{majorcolor} +\DeclareStringOption{minorcolor} +\DeclareStringOption{bgcolor} + +\DeclareStringOption{patternsize} +\DeclareStringOption[.7pt]{dotsize} + +\DeclareVoidOption{fullpage}{\GP@fullpagetrue} +\DeclareVoidOption{textarea}{\GP@textareatrue} + +\DeclareStringOption{geometry} + +\ProcessKeyvalOptions* + +%% Can only have one of fullpage or textarea +\ifGP@fullpage + \ifGP@textarea + \PackageError{gridpapers}{% + Can not specify both fullpage and textarea, please remove one option}{} + \fi + \GP@fullnesssettrue +\fi + +\ifGP@textarea + \GP@fullnesssettrue +\fi + +%% We keep track of this to know whether or not we would be overriding +%% a previously-set page geometry +\@ifpackageloaded{geometry} + {\GP@geometrypreviouslyloadedtrue} + {\GP@geometrypreviouslyloadedfalse% + \PassOptionsToPackage{\GPOpt@geometry}{geometry}% + \RequirePackage{geometry}% + } + +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +%% Actual package code +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% + +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +%% Some nice colors. +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +\definecolor{plum}{rgb}{0.36078, 0.20784, 0.4} +\definecolor{chameleon}{rgb}{0.30588, 0.60392, 0.023529} +\definecolor{cornflower}{rgb}{0.12549, 0.29020, 0.52941} +\definecolor{scarlet}{rgb}{0.8, 0, 0} +\definecolor{brick}{rgb}{0.64314, 0, 0} +\definecolor{sunrise}{rgb}{0.80784, 0.36078, 0} +\definecolor{rosiebg}{RGB}{250,247,232} +\definecolor{rosiegrid}{RGB}{186,137,113} + +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +%% The color to use for the null directions when drawing lightcones. +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +\colorlet{lightlines}{scarlet!30} + +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +%% Pre-defined Color schemes +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +%% Here are some pre-defined color schemes for the paper background +%% and the major and minor grid lines. These are switched by using +%% the option colorset=. The allowed values for colorset are in +%% the list below. +\define@choicekey*{GP}{colorset}[\val\nr]% + %% Allowed values for colorset: + {std,precocious,brickred,engineer,plumpad}[std]{% + \ifcase\nr\relax + %% std + \colorlet{minorcolor}{cornflower!30} + \colorlet{majorcolor}{cornflower!50} + \colorlet{bgcolor}{white} + \or + %% precocious + \colorlet{minorcolor}{rosiegrid!50} + \colorlet{majorcolor}{rosiegrid} + \colorlet{bgcolor}{rosiebg} + \or + %% brickred + \colorlet{minorcolor}{brick!35} + \colorlet{majorcolor}{brick!60} + \colorlet{bgcolor}{scarlet!8} + \or + %% engineer + \colorlet{minorcolor}{chameleon!50} + \colorlet{majorcolor}{chameleon!80} + \colorlet{bgcolor}{chameleon!10} + \or + %% plumpad + \colorlet{minorcolor}{cornflower!40} + \colorlet{majorcolor}{cornflower!70} + \colorlet{bgcolor}{plum!10} + \fi +} + +%% Get the specified color set from the options +\def\@setkeyhelper#1#2{% + \setkeys{GP}{#2=#1} +} +\expandafter\@setkeyhelper\expandafter{\GPOpt@colorset}{colorset} + +%% If the user further specified majorcolor, minorcolor, and/or +%% bgcolor, we now override the selected colorset +\ifx\GPOpt@majorcolor\@empty +\else + \colorlet{majorcolor}{\GPOpt@majorcolor} +\fi +\ifx\GPOpt@minorcolor\@empty +\else + \colorlet{minorcolor}{\GPOpt@minorcolor} +\fi +\ifx\GPOpt@bgcolor\@empty +\else + \colorlet{bgcolor}{\GPOpt@bgcolor} +\fi + +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +%% The size parameter -- different meanings for different patterns +%% Will be reset by pattern code +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +\newcommand{\GP@patternsize}{0.1in} + +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +%% This section sets up a routine for filling a shape with +%% hexagons. Uses code from: +%% http://tex.stackexchange.com/questions/6019/drawing-hexagons/6128#6128 +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% + +%% We have to delay this definition until after \GP@patternsize is +%% redefined (by the pattern selection and/or user override) +\newcommand{\GP@declarehexpat}{ +\pgfdeclarepatternformonly + {hexagons}%% name + {\pgfpointorigin}%% lower left + {\pgfpoint{3*\GP@patternsize}{0.866025*2*\GP@patternsize}} + {\pgfpoint{3*\GP@patternsize}{0.866025*2*\GP@patternsize}} + { + \pgfsetlinewidth{0.6pt} + \pgftransformshift{\pgfpoint{0mm}{0.866025*\GP@patternsize}} + \pgfpathmoveto{\pgfpoint{0mm}{0mm}} + \pgfpathlineto{\pgfpoint{0.5*\GP@patternsize}{0mm}} + \pgfpathlineto{\pgfpoint{\GP@patternsize}{-0.866025*\GP@patternsize}} + \pgfpathlineto{\pgfpoint{2*\GP@patternsize}{-0.866025*\GP@patternsize}} + \pgfpathlineto{\pgfpoint{2.5*\GP@patternsize}{0mm}} + \pgfpathlineto{\pgfpoint{3*\GP@patternsize}{0mm}} + \pgfpathmoveto{\pgfpoint{0.5*\GP@patternsize}{0mm}} + \pgfpathlineto{\pgfpoint{\GP@patternsize}{0.866025*\GP@patternsize}} + \pgfpathlineto{\pgfpoint{2*\GP@patternsize}{0.866025*\GP@patternsize}} + \pgfpathlineto{\pgfpoint{2.5*\GP@patternsize}{0mm}} + \pgfusepath{stroke} + } +} + +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +%% This section sets up a routine for filling a shape with +%% triangles. +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% + +%% We have to delay this definition until after \GP@patternsize is +%% redefined (by the pattern selection and/or user override) +\newcommand{\GP@declaretripat}{ +\pgfdeclarepatternformonly + %% Name of the pattern + {triangles} + %% Set the lower left corner of the pattern + {\pgfpointorigin} + %% Set the upper right corner of the pattern + {\pgfpoint{\GP@patternsize}{2*0.8660254*\GP@patternsize}} + %% Declare the size of the pattern blocks + {\pgfpoint{\GP@patternsize}{2*0.8660254*\GP@patternsize}} + %% Draw the pattern + { + \pgfsetlinewidth{0.6pt} + \pgfpathmoveto{\pgfpoint{0mm}{0mm}} + \pgfpathlineto{\pgfpoint{\GP@patternsize}{2*0.8660254*\GP@patternsize}} + \pgfpathlineto{\pgfpoint{0mm}{2*0.8660254*\GP@patternsize}} + \pgfpathmoveto{\pgfpoint{0mm}{0.8660254*\GP@patternsize}} + \pgfpathlineto{\pgfpoint{\GP@patternsize}{0.8660254*\GP@patternsize}} + \pgfpathmoveto{\pgfpoint{0mm}{2*0.8660254*\GP@patternsize}} + \pgfpathlineto{\pgfpoint{\GP@patternsize}{0mm}} + \pgfpathlineto{\pgfpoint{0mm}{0mm}} + \pgfusepath{stroke} + } +} +\newcommand{\GP@declareisopat}{ +\pgfdeclarepatternformonly + %% Name of the pattern + {isometric} + %% Set the lower left corner of the pattern + {\pgfpointorigin} + %% Set the upper right corner of the pattern + {\pgfpoint{2*0.8660254*\GP@patternsize}{\GP@patternsize}} + %% Declare the size of the pattern blocks + {\pgfpoint{2*0.8660254*\GP@patternsize}{\GP@patternsize}} + %% Draw the pattern + { + \pgfsetlinewidth{0.6pt} + \pgfpathmoveto{\pgfpoint{0mm}{0mm}} + \pgfpathlineto{\pgfpoint{2*0.8660254*\GP@patternsize}{\GP@patternsize}} + \pgfpathlineto{\pgfpoint{2*0.8660254*\GP@patternsize}{0mm}} + \pgfpathlineto{\pgfpoint{0mm}{\GP@patternsize}} + \pgfpathlineto{\pgfpoint{0mm}{0mm}} + \pgfpathmoveto{\pgfpoint{0.8660254*\GP@patternsize}{0mm}} + \pgfpathlineto{\pgfpoint{0.8660254*\GP@patternsize}{\GP@patternsize}} + \pgfusepath{stroke} + } +} + +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +%% This section sets up a routine for filling the squares in a +%% grid with null lines. +%% %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +%% TODO Still can't figure out the correct pattern shift!! +\newcommand{\GP@declarelightconepat}{ +\pgfkeys{ + /pgf/pattern keys/myshift/.store in=\myshift, + /pgf/pattern keys/myshift/.initial={(0,0)}, +} +\tikzdeclarepattern{ + name=lightcones, + type=uncolored, + parameters={\myshift}, + bounding box={(0,0) and (\GP@patternsize,\GP@patternsize)}, + tile size={(\GP@patternsize, \GP@patternsize)}, + tile transformation={ + shift=\myshift, + }, + defaults={ + myshift/.store in=\myshift,myshift={(0,0)}, + }, + code={ + %% TODO Make the dashing an option + \tikzset{lightlines/.style={line width=0.4pt,dash=on 0.05cm off 0.05cm phase 0.025cm}} + \draw [lightlines] (0,0) -- (\GP@patternsize,\GP@patternsize); + \draw [lightlines] (0,\GP@patternsize) -- (\GP@patternsize,0); + }, +} +} +%% \pgfdeclarepatternformonly +%% {lightcones}% name +%% {\pgfpointorigin}% lower left +%% {\pgfpoint{\GP@patternsize}{\GP@patternsize}}% upper right +%% {\pgfpoint{\GP@patternsize}{\GP@patternsize}}% tile size +%% {% shape description +%% \pgfsetlinewidth{0.4pt} +%% %% TODO Make an option +%% %Comment out this line for solid lines on light cones, instead of dashes. +%% \pgfsetdash{{0.05cm}{0.05cm}}{0.025cm} +%% \pgfpathmoveto{\pgfpoint{0in}{0in}} +%% \pgfpathlineto{\pgfpoint{\GP@patternsize}{\GP@patternsize}} +%% \pgfpathmoveto{\pgfpoint{0in}{\GP@patternsize}} +%% \pgfpathlineto{\pgfpoint{\GP@patternsize}{0in}} +%% \pgfusepath{stroke} +%% } + +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +%% This section sets up a routine for filling a region with dots +%% Slightly modified version of code added by Leo +%% Stein (@duetosymmetry on Twitter). +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +%% We have to delay this definition until after \GP@patternsize is +%% redefined (by the pattern selection and/or user override) +\newcommand{\GP@declaredotpat}{ +\pgfdeclarepatternformonly + {dotgrid}%% name + {\pgfpoint{-0.5*\GP@patternsize}{-0.5*\GP@patternsize}}%% lower left + {\pgfpoint{0.5*\GP@patternsize}{0.5*\GP@patternsize}}%% upper right + {\pgfpoint{\GP@patternsize}{\GP@patternsize}}%% tile size + {%% shape description + \pgfpathcircle{\pgfqpoint{0pt}{0pt}}{\GPOpt@dotsize} + \pgfusepath{fill} + } +} + +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +%% Begin pattern execution infrastructure +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% + +%% This inner code will be set by the choicekey pattern=... +\newcommand{\GP@innerpatterncode}{} +%% This is the "outer" code to hook into every page +\newcommand{\GP@patterncode}{% No blank lines in this code! +\begin{tikzpicture}[remember picture, overlay] +%% +%% Change "thin" to "very thin" if the lines are too thick. +\tikzset{ + minorgrid/.style={minorcolor, thin}, + majorgrid/.style={majorcolor, thin}, +} +\ifGP@fullpage% +\coordinate (a) at (current page.south west); +\coordinate (b) at (current page.north east); +\else% +\coordinate (a) at (current page text area.south west); +\coordinate (b) at (current page text area.north east); +\fi +%% +\GP@innerpatterncode% +%% +\end{tikzpicture} +} + +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +%% Begin pattern definition code +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% + +\define@boolkey{GP}{patterndefaultfullness}{} +\newcommand{\GP@patterndefaultgeometry}{} +\newcommand{\GP@patterndefaultsize}{} + +%% Pattern-definer-helper +%% The interface is: +%% \GP@setpattern +%% {} +%% {} +%% {} %% NOTE, not tile length +%% {} +\newcommand{\GP@setpattern}[4]{% +\setkeys{GP}{patterndefaultfullness=#1} +\renewcommand{\GP@patterndefaultgeometry}{#2} +\renewcommand{\GP@patterndefaultsize}{#3} +\renewcommand{\GP@innerpatterncode}{#4} +} + +\define@choicekey*{GP}{pattern}[\val\nr]% + %% Allowed values for pattern: + {std,stdeight,majmin,dot,hex,tri,iso,lightcone,ruled,doubleruled}{% + \ifcase\nr\relax + %% std +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +%% Quadrille, ten squares per inch. +%% %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% + \GP@setpattern{false}{letterpaper, margin=0.2in}{0.1in}{% +%% Draw a grid with 10 squares per inch. +\draw[style=minorgrid, shift={(a)}] (0,0) grid [step=\GP@patternsize] (b); +%% +%% Draw a frame around the grid. +\draw[style=majorgrid] (a) rectangle (b); + } + \or + %% stdeight +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +%% Quadrille, eight squares per inch. +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% + \GP@setpattern{false}{letterpaper, margin=0.1875in}{0.125in}{% +%% Draw a grid with 10 squares per inch. +\draw[style=minorgrid, shift={(a)}] (0,0) grid [step=\GP@patternsize] (b); +%% +%% Draw a frame around the grid. +\draw[style=majorgrid] (a) rectangle (b); + } + \or + %% majmin +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +%% Graph paper, eight squares per inch with a major grid +%% every half-inch. +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% + \GP@setpattern{false}{letterpaper, margin=0.25in}{0.125in}{% +%% Draw a grid with 10 squares per inch. +\draw[style=minorgrid, shift={(a)}] (0,0) grid [step=\GP@patternsize] (b); +%% +\draw[style=majorgrid, shift={(a)}] (0,0) grid [step=4*\GP@patternsize] (b); +%% +%% Draw a frame around the grid. +\draw[style=majorgrid] (a) rectangle (b); + } + \or + %% dot +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +%% Dot grid +%% Slightly modified version of code added by Leo +%% Stein (@duetosymmetry). +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% + \GP@setpattern{true}{}{0.1in}{% + \fill [pattern=dotgrid,pattern color=minorcolor] (a) rectangle (b); + } + \or + %% hex +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +%% Hex grid +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% + \GP@setpattern{true}{}{0.1666in}{% + \fill [pattern=hexagons,pattern color=minorcolor] (a) rectangle (b); + } + \or + %% tri +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +%% Triangle grid, adjust triangle size in the preamble +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% + \GP@setpattern{true}{}{0.25in}{% + \fill [pattern=triangles,pattern color=minorcolor] (a) rectangle (b); + } + \or + %% iso +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +%% Isometric grid +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% + \GP@setpattern{true}{}{0.25in}{% + \fill [pattern=isometric, pattern color=minorcolor] (a) rectangle (b); + } + \or + %% lightcone +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +%% A grid with light cones. +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% + \GP@setpattern{false}{letterpaper, margin=.125in}{0.25in}{% +%% Draw a grid with 4 squares per inch. +\draw[style=minorgrid, shift={(a)}] (0,0) coordinate grid [step=\GP@patternsize] (b); +%% +%% Draw a border around the grid. +\draw[style=majorgrid, pattern={lightcones[myshift={(a)}]}, pattern color=lightlines] (a) rectangle (b); + } + \or + %% ruled +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +%% Ruled page with bold lines every 0.2in or 0.25in +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% + \GP@setpattern{false}{letterpaper, body={8in,10.8in}}{0.2in}{% +%% Draw a ruled page with lines every 0.2in +\draw[style=majorgrid, shift={(a)}] (0,0) grid [ystep=\GP@patternsize, xstep=\paperwidth] (b); +%% Draw a frame around the grid. +\draw[style=majorgrid] (a) rectangle (b); + } + \or + %% doubleruled +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +%% Ruled page with bold lines every 0.25in and light lines +%% every 0.125 in. +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% + \GP@setpattern{false}{letterpaper, margin=.25in}{0.125in}{% +%% Draw a ruled pattern with thin lines every 0.125 in and bold lines every 0.25 in. +\draw[style=minorgrid, shift={(a)}] (0,0) grid [ystep=\GP@patternsize, xstep=\paperwidth] (b); +%% +\draw[style=majorgrid, shift={(a)}] (0,0) grid [ystep=2*\GP@patternsize, xstep=\paperwidth] (b); +%% +%% Draw a frame around the grid. +\draw[style=majorgrid] (a) rectangle (b); + } + \fi +} + +%% Use the passed package option to set the above key +\expandafter\@setkeyhelper\expandafter{\GPOpt@pattern}{pattern} + +%% Determine whether or not to (re)set fullpage vs textarea +\ifGP@fullnessset +%% Respect their choice +\else + %% Reset the value of \GP@fullpage based on the pattern's default + %% There's probably a more idiomatic way to do this but I can't + %% figure it out + \ifKV@GP@patterndefaultfullness + \GP@fullpagetrue + \else + \GP@fullpagefalse + \fi +\fi + +%% Determine whether or not to fiddle with the page geometry +\ifGP@geometrypreviouslyloaded +%% Respect their previous choice +\PackageWarning{gridpapers}{'geometry' package was previously loaded, will not use pattern defaults.} +\else + %% Use the pattern's defaults, + \expandafter\geometry\expandafter{\GP@patterndefaultgeometry} + %% And then override with any more specific settings passed by the user + \expandafter\geometry\expandafter{\GPOpt@geometry} +\fi + +%% Determine the correct pattern length +\ifx\GPOpt@patternsize\@empty + % Use the pattern's preferred length + \renewcommand{\GP@patternsize}{\GP@patterndefaultsize} +\else + % Override with the user's choice + \renewcommand{\GP@patternsize}{\GPOpt@patternsize} +\fi + +%% Now that everything has been set up, we can finally define the +%% patterns with the correct lengths. +\GP@declarehexpat +\GP@declaretripat +\GP@declareisopat +\GP@declarelightconepat +\GP@declaredotpat + +%% Set the background color. +\AtBeginDocument{\pagecolor{bgcolor}} +%% Actually hook it in! +\AddEverypageHook{% +\GP@patterncode% +} + +\endinput +% \end{macrocode} +% +% \iffalse +% +% \fi +% +% \Finale +\endinput diff --git a/macros/latex/contrib/gridpapers/gridpapers.ins b/macros/latex/contrib/gridpapers/gridpapers.ins new file mode 100644 index 0000000000..d9a81c8e2a --- /dev/null +++ b/macros/latex/contrib/gridpapers/gridpapers.ins @@ -0,0 +1,57 @@ +%% Copyright (C) 2021 by Robert McNees , Leo C. Stein +%% -------------------------------------------------------------------------- +%% This work may be distributed and/or modified under the +%% conditions of the LaTeX Project Public License, either version 1.3 +%% of this license or (at your option) any later version. +%% The latest version of this license is in +%% http://www.latex-project.org/lppl.txt +%% and version 1.3 or later is part of all distributions of LaTeX +%% version 2005/12/01 or later. +%% +%% This work has the LPPL maintenance status `maintained'. +%% +%% The Current Maintainers of this work are Robert McNees, Leo C. Stein. +%% +%% This work consists of the files gridpapers.dtx and gridpapers.ins +%% and the derived filebase gridpapers.sty. +%% + +\input docstrip.tex +\keepsilent + +\usedir{tex/latex/gridpapers} + +\preamble + +This is a generated file. + +Copyright (C) 2021 by Robert McNees , Leo C. Stein +-------------------------------------------------------------------------- +This work may be distributed and/or modified under the +conditions of the LaTeX Project Public License, either version 1.3 +of this license or (at your option) any later version. +The latest version of this license is in + http://www.latex-project.org/lppl.txt +and version 1.3 or later is part of all distributions of LaTeX +version 2005/12/01 or later. + +\endpreamble + +\generate{\file{gridpapers.sty}{\from{gridpapers.dtx}{package}}} + +\obeyspaces +\Msg{*************************************************************} +\Msg{* *} +\Msg{* To finish the installation you have to move the following *} +\Msg{* file into a directory searched by TeX: *} +\Msg{* *} +\Msg{* gridpapers.sty *} +\Msg{* *} +\Msg{* To produce the documentation run the file gridpapers.dtx *} +\Msg{* through LaTeX. *} +\Msg{* *} +\Msg{* Happy TeXing! *} +\Msg{* *} +\Msg{*************************************************************} + +\endbatchfile diff --git a/macros/latex/contrib/gridpapers/gridpapers.pdf b/macros/latex/contrib/gridpapers/gridpapers.pdf new file mode 100644 index 0000000000..2204f6fd67 Binary files /dev/null and b/macros/latex/contrib/gridpapers/gridpapers.pdf differ -- cgit v1.2.3