new latex package setdeck (LaTeX Set Deck)

git-svn-id: svn://tug.org/texlive/trunk@27997 c570f23f-e606-0410-a88d-b1316a301751

3 files changed, 118 insertions, 0 deletions

diff --git a/Master/texmf-dist/doc/latex/setdeck/README b/Master/texmf-dist/doc/latex/setdeck/README
new file mode 100644
index 00000000000..21dcbbc0d6f
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/setdeck/README
@@ -0,0 +1,42 @@
+Author:  Gwyneth Whieldon
+Institution:  Hood College
+Contact Email:  whieldon@hood.edu or Gwyn.Whieldon@gmail.com
+
+Package Copyright 2012
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU General Public License for more details.
+
+For a copy of the GNU General Public License, see
+<http://www.gnu.org/licenses/>.
+
+
+This is a style file for drawing cards from a Set Deck using TikZ in
+LaTeX.
+
+
+We use the convention
+\setcard{<Number>}{<Shading>}{<Color>}{<Shape>}{<Scaling>}, where
+Number  = 1 (1 card),       2 (2 cards), 3 (3 cards)
+Shading = 1 (plain),          2 (striped),  3 (solid)
+Color =      1 (red),             2 (green),    3 (purple)
+Shape =    1 (diamond),   2 (oval),       3 (squiggle)
+
+
+
+So for example, to typeset a full-size Set card with two striped red
+squiggles, you would use the command \setcard{2}{2}{1}{3}{1}.  To
+typeset a half-sized Set card with three plain green ovals, you could
+use either the command \setcard{3}{1}{2}{2}{0.5} or
+\smallsetcard{3}{1}{2}{2}{0.5}.  The only difference between the two
+commands is the thickness of the lines on the cards.
+
+The command \smallsetcard is designed to be used when displaying
+anything smaller than a half-sized card.
diff --git a/Master/texmf-dist/doc/latex/setdeck/setdeck.pdf b/Master/texmf-dist/doc/latex/setdeck/setdeck.pdf
new file mode 100644
index 00000000000..f2694d08b70
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/setdeck/setdeck.pdf
diff --git a/Master/texmf-dist/doc/latex/setdeck/setdeck.tex b/Master/texmf-dist/doc/latex/setdeck/setdeck.tex
new file mode 100644
index 00000000000..946a727a793
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/setdeck/setdeck.tex
@@ -0,0 +1,76 @@
+\title{LaTeX Set Deck:  Documentation}
+\date{\today}
+\author{Gwyn Whieldon}
+
+
+\documentclass{article}
+
+\usepackage[margin=1.25in, headheight=14pt]{geometry}
+
+\usepackage{setdeck}
+
+
+
+
+
+
+\begin{document}
+
+\maketitle
+
+This document describes a package for typesetting Set cards using TikZ in LaTeX.  We use the conventions:
+
+\begin{center}
+\begin{tabular}{| c | c | c | c | c |}
+\hline
+Coordinate & Number & Shading & Color & Shape \\
+\hline
+1 & 1 & plain & red & diamond \\
+2 & 2 & striped & green & oval \\
+3 & 3 & solid & purple & squiggle \\
+\hline
+\end{tabular}
+\end{center}
+
+To typeset a basic Set card, we use the commands \verb|\setcard| or \verb|\smallsetcard|, with arguments
+
+\verb|\setcard{<Number>}{<Shading>}{<Color>}{<Shape>}{<Scaling>} |.
+
+\vspace{10pt}
+
+So to typeset, for example, the full-sized card with two striped purple diamonds, we use the command \verb|\setcard{2}{2}{3}{1}{1}|, which produces:
+\vspace{10pt}
+\begin{center}
+\setcard{2}{2}{3}{1}{1}
+\end{center}
+
+\vspace{10pt}
+
+For many purposes, this will be too large.  To typeset a more reasonably sized card (let's say, this time, we typeset three solid red squiggles) we might prefer to use \verb|\setcard{3}{3}{1}{3}{0.5}| or \verb|\smallsetcard{3}{3}{1}{3}{0.5}|, which produce (respectively):
+
+\vspace{10pt}
+\begin{center}
+\setcard{3}{3}{1}{3}{0.5}$\;\;\;\;\;\;\;\;\;\;$\smallsetcard{3}{3}{1}{3}{0.5}
+\end{center}
+
+Here is a preview of all cards (produced with \verb|\smallsetcard|) produced by the \verb|setdeck.sty| package:
+
+\vspace{10pt}
+
+\begin{center}
+\foreach \shading in {1,2,3}{
+\foreach \shape in {1,2,3} {
+\smallsetcard{1}{\shading}{1}{\shape}{0.25}\hspace{3pt}\smallsetcard{2}{\shading}{1}{\shape}{0.25}\hspace{3pt}\smallsetcard{3}{\shading}{1}{\shape}{0.25}\hspace{10pt}\smallsetcard{1}{\shading}{2}{\shape}{0.25}\hspace{3pt}\smallsetcard{2}{\shading}{2}{\shape}{0.25}\hspace{3pt}\smallsetcard{3}{\shading}{2}{\shape}{0.25}\hspace{10pt}\smallsetcard{1}{\shading}{3}{\shape}{0.25}\hspace{3pt}\smallsetcard{2}{\shading}{3}{\shape}{0.25}\hspace{3pt}\smallsetcard{3}{\shading}{3}{\shape}{0.25}
+
+\vspace{5pt}
+
+}
+\vspace{15pt}
+}
+\end{center}
+				
+
+\end{document}
+
+
+