From ec292c03bd7f22b6c53cc292304730e8a07b10b0 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Wed, 8 Dec 2010 00:27:12 +0000 Subject: new mp package threeddice (8dec10) git-svn-id: svn://tug.org/texlive/trunk@20675 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/metapost/threeddice/README | 39 ++++++ .../doc/metapost/threeddice/threeddice-doc.pdf | Bin 0 -> 116376 bytes .../doc/metapost/threeddice/threeddice-doc.tex | 139 +++++++++++++++++++++ 3 files changed, 178 insertions(+) create mode 100644 Master/texmf-dist/doc/metapost/threeddice/README create mode 100644 Master/texmf-dist/doc/metapost/threeddice/threeddice-doc.pdf create mode 100644 Master/texmf-dist/doc/metapost/threeddice/threeddice-doc.tex (limited to 'Master/texmf-dist/doc/metapost/threeddice') diff --git a/Master/texmf-dist/doc/metapost/threeddice/README b/Master/texmf-dist/doc/metapost/threeddice/README new file mode 100644 index 00000000000..147846dc04e --- /dev/null +++ b/Master/texmf-dist/doc/metapost/threeddice/README @@ -0,0 +1,39 @@ +Files: threeddice.mp, threeddice-doc.tex, threeddice-doc.pdf + +Purpose: + + The file threeddice.mp consists of MetaPost code to produce pictures of + dice with one, two, or three faces visible. + +Licence: + + This material is subject to the LaTeX Project Public Licence. See + http://www.ctan.org/tex-archive/help/Catalogue/licenses.lppl.html + for the details of that licence. + +Usage: + + Run mpost on threeddice.mp. If your mpost has version at least 0.9, + this will produce 26 EPS files named die3d-1.mps through + die3d-456.mps. If your mpost is too old the filenames will be threeddice.1 + through threeddice.456. + + The digits indicate which faces are showing. For two digits, the first + digit represents the face on top, the second represents the front face + (visually below the first). For three digits, the first is the face on + top, the second is the face below and left of that, and the third is + below and right. + + These files can be included in a LaTeX document using the graphics or + graphicx package, or in a plain TeX document using miniltx + graphicx, + or the epsf macros. + +Documentation: + + See threeddice-doc.pdf for complete documentation. It may be + regenerated by running mpost of threeddice.mp followed by running + pdflatex (once) on threeddice-doc.tex. + +-- +Dan Luecking +luecking AT-SIGN uark DOT edu diff --git a/Master/texmf-dist/doc/metapost/threeddice/threeddice-doc.pdf b/Master/texmf-dist/doc/metapost/threeddice/threeddice-doc.pdf new file mode 100644 index 00000000000..495bf36731f Binary files /dev/null and b/Master/texmf-dist/doc/metapost/threeddice/threeddice-doc.pdf differ diff --git a/Master/texmf-dist/doc/metapost/threeddice/threeddice-doc.tex b/Master/texmf-dist/doc/metapost/threeddice/threeddice-doc.tex new file mode 100644 index 00000000000..f936b26e282 --- /dev/null +++ b/Master/texmf-dist/doc/metapost/threeddice/threeddice-doc.tex @@ -0,0 +1,139 @@ +\documentclass{article} +\usepackage{graphicx} +\title{The \texttt{threeddice} package} +\author{Dan Luecking} +\date{2010/11/30} +\begin{document} + +\catcode`_=12 +{\catcode`\_=\active \global\let_\sb} + +\maketitle +\section{Introduction} + +Running \texttt{mpost} on \texttt{threeddice.mp} produces 26 figure files. +Six of them are are \texttt{die3d-1.mps}% + \footnote{If your \texttt{mpost} version is less that 0.9, you will + get figure files with names like \texttt{threeddice.1}. You should + update your \TeX{} system.} +through \texttt{die3d-6.mps}. These are pictures of a single die face +with the number of dots indicated by the numerical part. Three of these +would look the same if rotated by multiples of $90$ degrees. The other +three could look different. It is up to the users to perform this +rotation if they want a different view. + +The twelve files with 2-digit numerical part are 3D pictures of dice with +two faces showing, as if your were looking directly at a horizontal +edge. You will have to rotate it $\pm90$ degrees if you want the edge to be +vertical, or $180$ degrees if you prefer the positions of the top and +front face to be exchanged. + +The eight files with 3-digit numerical suffix are 3D pictures of dice with +three faces showing, as if your were looking directly at one of the +corners. They show a top face and a left and right face flanking a +vertical edge. You can get 16 other views by rotating them $\pm120$ +degrees. These rotations put one of the side faces on top. + +\section{Modifications} + +These figures were taken from an actual right handed die, and are all +the permissable views of such a die, apart from size of dots and the +actual orientation of the patterns of dots. As near as I could determine +from internet searches, there are no official standards for the +following. +\begin{itemize} + \item The 2-spot face has dots in opposite corners, but which two + corners? On my die, if the 1-spot is on top, the 2-spot to the + left and the 3-spot to the right (figure + \texttt{die3d-123.mps}), the dots on the 2-spot face are in + upper left and lower right. It seems it could just as well have + been the other two corners. + + \item Similar question for the 3-spot face: three dots in a diagonal + between opposite corners, but which two corners? In the previous + example (figure \texttt{die3d-123.mps}), the diagonal is from + lower left to upper right. + + \item The 6-spot face has two lines of three, parallel to two edges, + but which two edges? In \texttt{die3d-246.mps} the lines of dots are + horizontal, but it seems they could just as well have been + vertical. +\end{itemize} + +If you want some other orientation of these faces you will need to edit +\texttt{threeddice.mp}: for the 2-spot face exchange the definitions of +\texttt{pips2} and \texttt{pips7}; for the 3-spot face exchange +\texttt{pips3} and \texttt{pips8}; for the 6-spot face exchange +\texttt{pips6} and \texttt{pips11}. + +You can also change the size of the dots by giving a different value to +\texttt{dot_diam}. The dice have rounded corners, you can change their +radius by changing \texttt{corner_rad}. The dots are placed so there is +at least \texttt{face_margin} of space between the dots and the straight +edge of the face. You can change this variable as well. + +For other effects, you are on your own. A common requirement is that +faces with fewer dots have larger dots. This is relatively easy to do, +but requires changing the definitions of the 9 picture variables +\texttt{pips1} through \texttt{pips11}. + +Naturally, the \texttt{graphics} and \texttt{graphicx} packages let you +scale these as you want. If you would prefer to change the unscaled +sizes, edit \texttt{threeddice.mp} to change \texttt{die_size} from 1cm to +the desired size. + +Finally, to get views of a left-handed die, simply reflect the views of +the right-handed die. + +\section{Appendix} + +\parindent 0pt +These are the six single faces: + +\bigskip +\includegraphics{die3d-1.mps}\quad +\includegraphics{die3d-2.mps}\quad +\includegraphics{die3d-3.mps}\quad +\includegraphics{die3d-4.mps}\quad +\includegraphics{die3d-5.mps}\quad +\includegraphics{die3d-6.mps} + +\bigskip +\filbreak +The two-faced dice are ugly, so let me first show you the eight +three-faced dice: + +\bigskip +\includegraphics{die3d-123.mps}\quad +\includegraphics{die3d-135.mps}\quad +\includegraphics{die3d-142.mps}\quad +\includegraphics{die3d-154.mps} + +\bigskip +\includegraphics{die3d-246.mps}\quad +\includegraphics{die3d-263.mps}\quad +\includegraphics{die3d-365.mps}\quad +\includegraphics{die3d-456.mps} + +\bigskip +\filbreak +Finally, the twelve two-faced dice: + +\bigskip +\includegraphics{die3d-12.mps}\quad +\includegraphics{die3d-13.mps}\quad +\includegraphics{die3d-14.mps}\quad +\includegraphics{die3d-15.mps}\quad +\includegraphics{die3d-23.mps}\quad +\includegraphics{die3d-24.mps} + +\bigskip +\includegraphics{die3d-26.mps}\quad +\includegraphics{die3d-35.mps}\quad +\includegraphics{die3d-36.mps}\quad +\includegraphics{die3d-45.mps}\quad +\includegraphics{die3d-46.mps}\quad +\includegraphics{die3d-56.mps} + +\filbreak +\end{document} -- cgit v1.2.3