%^^A%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%%^^A $Id: productbox.dtx 8333 2010-12-29 19:58:06Z gene $
%%^^A%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%\iffalse
%% Purpose:
%% productbox.dtx provides a style file for typesetting a
%% three-dimensional product box. This product box can be rendered
%% as it is standing on a surface and some light is shed onto it.
%% Alternatively it can be typeset as a wireframe to be cut out
%% and glued together. This will lead to a physical product box.
%%
%% Documentation:
%% The documentation can be generated from the original file
%% productbox.dtx with the doc style/package. LaTeX the file
%% productbox.dtx to get the full documentation in pdf format.
%%
%% Prerequisite:
%% This package needs TikZ to be present at least in version 2.0.
%%
%% Author: Gerd Neugebauer
%% Im Lerchelsb\"ohl 5
%% 64521 Gro\ss-Gerau
%% Mail: gene@gerd-neugebauer.de
%%
%% Copyright (C) 2010 Gerd Neugebauer
%%
%% productbox.dtx is distributed in the hope that it will be useful,
%% but WITHOUT ANY WARRANTY. No author or distributor accepts
%% responsibility to anyone for the consequences of using it or for
%% whether it serves any particular purpose or works at all, unless
%% he says so in writing.
%%
%% Everyone is granted permission to copy, modify and redistribute
%% productbox.dtx, provided this copyright notice is preserved and
%% any modifications are indicated.
%%
%\fi
%^^A%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% \title{A \LaTeX\ Style for
% Typesetting a Three-Dimensional Product Box\thanks{This file
% documents \filename\ version \fileversion\
% (from revision \filerevision) as of \filedate.}}
% \author{Gerd Neugebauer\\\small
% Im Lerchelsb\"ohl 5\\\small
% 64521 Gro\ss-Gerau (Germany)\\\small
% Email: \texttt{\href{mailto:gene@gerd-neugebauer.de}{gene@gerd-neugebauer.de}}}
% \date{{\footnotesize Documentation date: \filedate}}
% \hypersetup{pdftitle=A LaTeX Style for Typesetting a Three-Dimensional Product Box}
% \hypersetup{pdfauthor=Gerd Neugebauer}
% \hypersetup{pdfsubject=\filename\ version \fileversion\ as of \filedate}
% \maketitle
%
%^^A%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% \changes{1.0}{2010/12/20}{First public release.}
% \changes{1.1}{2010/12/23}{Simplified user interface added.}
%^^A%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% \DoNotIndex{\ ,\",\',\.,\[,\\,\],\^,\`,\~,\@,\@dottedtocline}
% \DoNotIndex{\@gobble,\@gobbletwo,\@ifnextchar,\@ifstar}
% \DoNotIndex{\@ifundefined,\@namedef,\@nameuse,\@tempdima,\@undefined}
% \DoNotIndex{\CurrentOption,\DeclareOption,\LARGE,\LaTeX,\Large}
% \DoNotIndex{\InputIfFileExists,\EnableCrossrefs,\DocInput}
% \DoNotIndex{\DeleteShortVerb,\CodelineIndex,\MacroFont}
% \DoNotIndex{\RecordChanges,\ProvidesPackage,\NeedsTeXFormat}
% \DoNotIndex{\LoadClass,\OptionNotUsed,\PassOptionsToClass}
% \DoNotIndex{\ProcessOptions,\ProvidesClass,\RequirePackage,\TeX}
% \DoNotIndex{\addcontentsline,\advance}
% \DoNotIndex{\begin,\begingroup,\bf,\bgroup,\egroup}
% \DoNotIndex{\bigskip,\box,\clearpage,\color,\csname}
% \DoNotIndex{\def,\definecolor,\dimen,\divide,\documentclass,\dp}
% \DoNotIndex{\else,\empty,\end,\endcsname,\endgroup,\endinput}
% \DoNotIndex{\expandafter,\fbox,\fi,\framebox}
% \DoNotIndex{\futurelet,\gdef,\global,\gobble,\hbox,\hfil}
% \DoNotIndex{\hfill,\hrule,\hskip,\hspace,\hss,\huge}
% \DoNotIndex{\ifdim,\ifx,\ignorespaces,\immediate,\index,\it}
% \DoNotIndex{\kern,\large,\let,\long,\lower}
% \DoNotIndex{\makebox,\makeindex,\markboth,\mbox,\medskip}
% \DoNotIndex{\newblock,\newcommand,\newcount,\newenvironment,\newfont}
% \DoNotIndex{\newif,\newpage,\nobreak,\noindent,\normalsize,\null}
% \DoNotIndex{\or,\pagestyle,\par,\paragraph,\parbox}
% \DoNotIndex{\parfillskip,\parindent,\parsep,\parskip,\partopsep}
% \DoNotIndex{\relax,\renewcommand,\renewenvironment,\rm,\rule}
% \DoNotIndex{\sbox,\sc,\setcounter,\settowidth,\sf,\sfcode,\sl}
% \DoNotIndex{\small,\space,\string,\symbol}
% \DoNotIndex{\the,\thepage,\thispagestyle}
% \DoNotIndex{\topmargin,\topsep,\tt,\typeout}
% \DoNotIndex{\unitlength,\usecounter,\varepsilon,\vbox}
% \DoNotIndex{\vfill,\vsize,\vskip,\vspace,\vss,\xdef}
% \DoNotIndex{\usetikzlibrary,\usepackage,\tikzfading,\setkeys}
% \DoNotIndex{\setbox,\scalebox}
% \DoNotIndex{\newbox,\ignorespacesafterend,\foreach,\filldraw}
% \DoNotIndex{\fill,\errmessage,\draw,\define@key,\copy,\clip}
%
%^^A%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% \CheckSum{1028}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%% \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 \~}
%%
%^^A%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% \newcommand\TikZ{Ti\textit{k}Z}
%
% \begin{abstract}
% The package \texttt{productbox} provides a style file for
% typesetting a three-dimensional product box. This product box
% can be rendered as it is standing on a surface and some light
% is shed onto it. Alternatively it can be typeset as a wireframe
% to be cut out and glued together. This will lead to a physical
% product box.
% \end{abstract}
%
% \begin{center}%
% \def\PB(#1,#2)#3{
% \draw[xshift=-.2mm,yshift=.2mm] (#1,#2) node[white,opacity=.9]{#3};
% \draw[xshift=.2mm,yshift=-.2mm] (#1,#2) node[black,opacity=.9]{#3};
% \draw (#1,#2) node[blue]{#3};
% }%
% \begin{ProductBox}[mirror=true,flare=true,scale=.6]
% \begin{Front}
% \shade [top color=yellow!20!red,bottom color=yellow!80!red]
% rectangle (88mm,100mm);
% \PB(44mm,85mm){\Huge\bf Product Box}
% \draw (77mm,90mm) node[circle,ball color=white,rotate=330]{\small\bf\fileversion};
% \draw (44mm,75mm) node{A \LaTeX\ package for just another kind of boxes};
%
% \foreach \x in {1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16} {
% \count0=\x \multiply\count0 4
% \draw [red,line width=.2mm]
% (0mm,0 mm) .. controls (88mm,\the\count0 mm) and (\x mm,66mm) ..
% (88mm,\the\count0 mm);
% \draw [xshift=.4mm,white,line width=.2mm,opacity=.5]
% (0mm,0 mm) .. controls (88mm,\the\count0 mm) and (\x mm,66mm) ..
% (88mm,\the\count0 mm);
% }
%
% \clip (0mm,0mm) .. controls (88mm,64mm) and (16mm,66mm) ..
% (88mm,64mm) -- (88mm,100mm) -- (0mm,100mm) -- cycle;
% \draw (4mm,66mm) node [white!30!black,anchor=north west] {
% \begin{minipage}{160mm}\tt\tiny\raggedright
% |\usepackage{productbox}|\\
% | |\\
% | |\\
% |\begin{ProductBox}[scale=.8]|\\
% | \begin{Front}|\\
% | \shade [top color=yellow!20!red,bottom color=yellow!80!red]|\\
% | rectangle (88mm,100mm);|\\
% | \PB(44mm,85mm){\Huge\bf Product Box}|\\
% | \draw (77mm,90mm) node[circle,ball color=white]{\small\bf\fileversion};|\\
% | \draw (44mm,75mm) node{A \LaTeX\ package for just another kind of boxes};|\\
% ||\\
% | \foreach \x in {1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16} {|\\
% | \count0=\x \multiply\count0 4|\\
% | \draw [red,line width=.2mm]|\\
% | (0mm,0 mm) .. controls (88mm,\the\count0 mm) and (\x mm,66mm) ..|\\
% | (88mm,\the\count0 mm);|\\
% | \draw [xshift=.4mm,white,line width=.2mm,opacity=.5]|\\
% | (0mm,0 mm) .. controls (88mm,\the\count0 mm) and (\x mm,66mm) ..|\\
% | (88mm,\the\count0 mm);|\\
% | }|\\
% | \clip (0mm,0mm) .. controls (88mm,64mm) and (16mm,66mm) ..|\\
% | (88mm,64mm) -- (88mm,100mm) -- (0mm,100mm) -- cycle;|\\
% | \end{Front}|\\
% | \begin{Top}|\\
% | \shade [outer color=yellow!20!red,inner color=yellow!80!red]|\\
% | rectangle (88mm,30mm);|\\
% | \PB(44mm,15mm){\huge\bf Product Box}|\\
% | \draw (77mm,20mm)|\\
% | node[circle,ball color=white,rotate=330]{\small\bf\fileversion};|\\
% | \end{Top}|\\
% \end{minipage}};
% \end{Front}
% \begin{Top}
% \shade [outer color=yellow!20!red,inner color=yellow!80!red]
% rectangle (88mm,30mm);
% \PB(44mm,15mm){\huge\bf Product Box}
% \draw (77mm,20mm)
% node[circle,ball color=white,rotate=330]{\small\bf\fileversion};
% \end{Top}
% \begin{Bottom}
% \shade [outer color=yellow!20!red,inner color=yellow!80!red]
% rectangle (88mm,30mm);
% \end{Bottom}
% \begin{Left}
% \fill [top color=yellow!20!red,bottom color=yellow!80!red]
% rectangle (30mm,100mm);
% \PB(15mm,90mm){
% \begin{minipage}{25mm}\centering
% \Large\bf Product Box
% \end{minipage}}
% \draw (15mm,25mm) node {
% \begin{minipage}{25mm}\sf\tiny\raggedright\parskip=.75ex
% Copyright (C) 2010 Gerd Neugebauer
%
% productbox.dtx is distributed in the hope that it will be useful,
% but WITHOUT ANY WARRANTY. No author or distributor accepts
% responsibility to anyone for the consequences of using it or for
% whether it serves any particular purpose or works at all, unless
% he says so in writing.
%
% Everyone is granted permission to copy, modify and redistribute
% productbox.dtx, provided this copyright notice is preserved and
% any modifications are indicated.
% \end{minipage}};
% \end{Left}
% \begin{Right}
% \fill [top color=yellow!20!red,bottom color=yellow!80!red]
% rectangle (30mm,100mm);
% \PB(15mm,90mm){
% \begin{minipage}{25mm}\centering
% \Large\bf Product Box
% \end{minipage}}
% \end{Right}
% \end{ProductBox}
% \end{center}
%
% \newpage
% \tableofcontents
% \newpage
%
% \section{Introduction}
%
% Humans are tied to the physical world. Even in the age of
% software it is desirable to have a physical representation for
% it. In the commercial world the software is sold in product boxes
% containing a CD or DVD and printed documentation.
%
% But even for open source software having a product box provides a
% means to associate a physical object with the more or less
% virtual entity ``software''.
%
% There are many programs around devoted to producing layouts for
% product boxes. Each graphics program can be used for this purpose
% as well. Nevertheless the integration of material from the \TeX\
% world is not that easy.
%
% The \LaTeX\ package |productbox| is an attempt to use the
% possibilities for \LaTeX\ and some packages to provide a means
% for typesetting the faces of a product box and assemble them into
% a three-dimensional image.
%
% Note that this ``image'' is in fact a \textsc{pdf} object. It can
% be scaled without loss of quality\footnote{unless some pixel
% images have been included}. It is also possible to extract
% the text from the product box by cut and paste in an appropriate
% \textsc{pdf} reader.
%
%
% \section{The User Interface}
%
% The \LaTeX\ style |productbox| is based on \TikZ{} at
% \cite{tikz-manual} least in version~2.0. It is best used with a
% \LaTeX\ variant which is able to produce \textsc{pdf}. If no
% proper tool chain is used then some of the effects should not be
% used.
%
% \DescribeEnv{ProductBox}
% The environment |ProductBox| provides the central means for
% producing a product box. The contents is used to define the
% appearance of the faces. Finally the selected type of output is
% produced.
%
% The content of the environment consists mainly of the definition
% of the six faces. Not all of them need to be defined. If one face
% is not defined then it appears as an empty rectangle of white
% color.
%
% Thus you usually want to define the faces. Two approaches are
% provided to define the content of the faces. The simplified
% interface does not really require any knowledge of the underlying
% \TikZ{} package. Just some knowledge of \LaTeX\ is sufficient.
% The extended interface opens the full power to the user. Both
% interface types can be freely intermixed. The tow kinds of
% interfaces are described in section~\ref{sec:simplified}
% and~\ref{sec:extended}.
%
% The environment |ProductBox| can be controlled with a number of
% optional parameters. Those parameters are described in
% section~\ref{sec:options}.
%
%
% \subsection{The Simplified User Interface}\label{sec:simplified}
%
% The simplified user interface is meant for someone not familiar
% with \TikZ. It encapsulates nearly anything and relies on just
% some basic \LaTeX\ experience. As a downside the functionality is
% restricted. Any fancy artwork on the box background can hardly be
% achieved.
%
% The following example shows a complete -- even rather useless --
% definition of a product box with the simplified user interface.
%
% \noindent
% {\advance\textwidth-\fboxsep \advance\textwidth-\fboxsep
% \advance\textwidth-\fboxrule \advance\textwidth-\fboxrule
% \setbox127\hbox\bgroup\begin{minipage}{\textwidth}\footnotesize
% |\begin{ProductBox}|\\
% | \begin{FrontFace}[bottom color=white!30!blue,top color=white]|\\
% | \Huge Product Box|\\
% | \end{FrontFace}|\\
% | \begin{BackFace}[top color=yellow!30!red,bottom color=white]|\\
% | \large Back Face|\\
% | \end{BackFace}|\\
% | \begin{TopFace}[outer color=white!30!red,inner color=white]|\\
% | \large Top Face|\\
% | \end{TopFace}|\\
% | \begin{BottomFace}[outer color=red,inner color=black]|\\
% | \large Bottom Face|\\
% | \end{BottomFace}|\\
% | \begin{LeftFace}[left color=green,right color=yellow]|\\
% | \large Left Face|\\
% | \end{LeftFace}|\\
% | \begin{RightFace}[left color=white,right color=black]|\\
% | \large Right Face|\\
% | \end{RightFace}|\\
% |\end{ProductBox}|
% \end{minipage}\egroup
% \fcolorbox{red!30!black}{yellow!30!white}{\box127}}
%
% \newcommand\simpleSample[1]{%
% \begin{ProductBox}[scale=.25,#1]
% \begin{FrontFace}[bottom color=white!30!blue,top color=white]
% \Huge Product Box
% \end{FrontFace}
% \begin{BackFace}[top color=yellow!30!red,bottom color=white]
% \large Back Face
% \end{BackFace}
% \begin{TopFace}[outer color=white!30!red,inner color=white]
% \large Top Face
% \end{TopFace}
% \begin{BottomFace}[outer color=red,inner color=black]
% \large Bottom Face
% \end{BottomFace}
% \begin{LeftFace}[left color=green,right color=yellow]
% \large Left Face
% \end{LeftFace}
% \begin{RightFace}[left color=white,right color=black]
% \large Right Face
% \end{RightFace}
% \end{ProductBox}%
% }
%
% This code renders as
%
% \begin{center}\simpleSample{}\end{center}
% \newcommand\SampleEnv[1]{\noindent\par
% \fcolorbox{red!30!black}{yellow!30!white}{\begin{minipage}[b]{.98\textwidth}\footnotesize\tt
% \textcolor{blue}{\char92begin}\char123#1\char125\\
% \hspace*{2em}...\\
% \textcolor{blue}{\char92end}\char123#1\char125
% \end{minipage}}\par}
%
% The content of the environment |ProductBox| is simply evaluated.
% It can contain any code you like. Useful for the production of a
% product box are some inner environments. They are called
% |FrontFace|, |BackFace|, |LeftFace|, |RightFace|, |TopFace|, and
% |BottomFace|. They are defined inside the main environment
% only. Those environments can be used to specify the contents of
% the respective faces of the box.
%
% Note that in the three-dimensional rendering will show at most
% three of the faces. It does not hurt to define all of them, even
% if they are not shown at all.
%
% \DescribeEnv{FrontFace}
% The environment |FrontFace| is used to define the content of
% the font face. The environment processes its contents inside a
% |minipage| of the default width 88\,mm reduced by the left and
% right separator width (|faceSep|).
%
% The minipage is centered vertically on the face.
% Usually anything extending the default height of 100\,mm is
% clipped.
%
% \SampleEnv{FrontFace}
%
% \DescribeEnv{BackFace}
% The environment |BackFace| is used to define the content of
% the back face. The environment processes its contents inside a
% |minipage| of the default width 88\,mm reduced by the left and
% right separator width (|faceSep|).
%
% The minipage is centered vertically on the face.
% Usually anything extending the default height of 100\,mm is
% clipped.
%
% \SampleEnv{BackFace}
%
% \DescribeEnv{LeftFace}
% The environment |LeftFace| is used to define the content of
% the left face. The environment processes its contents inside a
% |minipage| of the default width 100\,mm reduced by the left and
% right separator width (|faceSep|).
%
% The minipage is centered vertically on the face.
% Usually anything extending the default height of 30\,mm is
% clipped.
%
% \SampleEnv{LeftFace}
%
% \DescribeEnv{RightFace}
% The environment |RightFace| is used to define the content of
% the right face. The environment processes its contents inside a
% |minipage| of the default width 100\,mm reduced by the left and
% right separator width (|faceSep|).
%
% The minipage is centered vertically on the face.
% Usually anything extending the default height of 30\,mm is
% clipped.
%
% \SampleEnv{RightFace}
%
% \DescribeEnv{TopFace}
% The environment |TopFace| is used to define the content of
% the top face. The environment processes its contents inside a
% |minipage| of the default width 88\,mm reduced by the left and
% right separator width (|faceSep|).
%
% The minipage is centered vertically on the face.
% Usually anything extending the default height of 30\,mm is
% clipped.
%
% \SampleEnv{TopFace}
%
% \DescribeEnv{BottomFace}
% The environment |BottomFace| is used to define the content of
% the bottom face. The environment processes its contents inside a
% |minipage| of the default width 88\,mm reduced by the left and
% right separator width (|faceSep|).
%
% The minipage is centered vertically on the face.
% Usually anything extending the default height of 30\,mm is
% clipped.
%
% \SampleEnv{BottomFace}
%
% \newcommand\Sample[1]{
% \noindent
% \fcolorbox{red!30!black}{yellow!30!white}{\begin{minipage}[b]{.8\textwidth}\footnotesize\tt
% \textcolor{blue}{\char92begin}\char123ProductBox\char125 \\
% \hspace*{2em}\textcolor{blue}{\char92begin}\char123FrontFace\char125\\
% \hspace*{4em}\textcolor{red}{[#1]}\\
% \hspace*{4em}...\\
% \hspace*{2em}\textcolor{blue}{\char92end}\char123FrontFace\char125\\
% \hspace*{2em}...\\
% \textcolor{blue}{\char92end}\char123ProductBox\char125
% \end{minipage}}\hfill
% \begin{minipage}[b]{.18\textwidth}\hfill
% \begin{ProductBox}[front,scale=.2]
% \begin{FrontFace}[#1] \end{FrontFace}
% \end{ProductBox}
% \end{minipage}\medskip\par
% }%
% Any of the face defining environments described above can take an
% optional argument. This argument is used to specify the
% background. In the simplest case you just have one background
% color. This is specified with the keyword |color|.
%
% \Sample{color=yellow}
%
% Colors in \TikZ{} are either one of the named colors or a
% composition of those colors. The notation |red!60!blue| denotes
% the color by mixing 60\% red and 40\% blue.
%
% \Sample{color=red!60!blue}
%
% By mixing in black or white you can come to a lighter or darker
% color.
%
% \Sample{color=red!20!white}
%
% A fading from top to bottom can be specified with two
% colors named |top color| and |bottom color|.
%
% \Sample{top color=red!50!blue,bottom color=yellow}
%
% A fading from left to right can be specified with two
% colors named |left color| and |left color|.
%
% \Sample{left color=red!50!blue,right color=yellow}
%
% The parameter |middle color| can be used in horizontal or
% vertical fading to specifying the color in the middle. Note thta
% it has to be specified after the other colors!
%
% \Sample{top color=red,bottom color=yellow,middle color=blue}
%
% A circular fading can be specified with the color names
% |inner color| and |outer color|.
%
% \Sample{inner color=red,outer color=yellow}
%
%
% \subsection{The Extended User Interface}\label{sec:extended}
%
% The extended user interface allows you to use all features of
% \TikZ. For this purpose another set of face defining environments
% is provided which process their content in a |tikzpicture|
% environment.
%
% The following example shows a complete example of a product box
% with the extended user interface. This example is used below to
% demonstrate the effect of the differnt options.
%
% \noindent
% {\advance\textwidth-\fboxsep \advance\textwidth-\fboxsep
% \advance\textwidth-\fboxrule \advance\textwidth-\fboxrule
% \setbox127\hbox\bgroup\begin{minipage}{.98\textwidth}\footnotesize\raggedright
% |\begin{ProductBox}\sf|\\
% | \begin{Front}|\\
% | \fill [top color=white!30!blue,bottom color=white]|\\
% | rectangle (88mm,100mm);|\\
% | \fill [bottom color=white!40!blue,top color=white!90!blue]|\\
% | (0mm,0mm) -- (44mm,90mm) -- (88mm,0mm) -- cycle;|\\
% | \draw (44mm,40mm) node{\Huge Product Box};|\\
% | \end{Front}|\\
% | \begin{Back}|\\
% | \fill [top color=yellow!30!red,bottom color=white]|\\
% | rectangle (88mm,100mm);|\\
% | \fill [top color=white,bottom color=blue]|\\
% | (0mm,0mm) -- (88mm,100mm) -- (0mm,100mm) --cycle;|\\
% | \draw (44mm,50mm) node{\large Back};|\\
% | \end{Back}|\\
% | \begin{Top}|\\
% | \fill [outer color=white!30!red,inner color=white]|\\
% | rectangle (88mm,30mm);|\\
% | \draw[white,thick] (0mm,5mm) -- (88mm,25mm);|\\
% | \draw (44mm,15mm) node{\large Top};|\\
% | \end{Top}|\\
% | \begin{Bottom}|\\
% | \fill [outer color=red!30!white,inner color=black]|\\
% | rectangle (88mm,30mm);|\\
% | \draw[white] (44mm,15mm) node{\large Bottom};|\\
% | \end{Bottom}|\\
% | \begin{Left}|\\
% | \fill [left color=green,right color=yellow]|\\
% | rectangle (30mm,100mm);|\\
% | \draw (15mm,50mm) node{\large Left};|\\
% | \end{Left}|\\
% | \begin{Right}|\\
% | \fill [top color=green,bottom color=yellow]|\\
% | rectangle (30mm,100mm);|\\
% | \draw (15mm,50mm) node{\large Right};|\\
% | \end{Right}|\\
% |\end{ProductBox}|
% \end{minipage}\egroup
% \fcolorbox{red!30!black}{yellow!30!white}{\box127}}
% \newcommand\sample[1]{%
% \begin{ProductBox}[scale=.25,#1]\sf
% \begin{Front}
% \fill [top color=white!30!blue,bottom color=white]
% rectangle (88mm,100mm);
% \fill [bottom color=white!40!blue,top color=white!90!blue]
% (0mm,0mm) -- (44mm,90mm) -- (88mm,0mm) -- cycle;
% \draw (44mm,40mm) node{\Huge Product Box};
% \end{Front}
% \begin{Back}
% \fill [top color=blue,bottom color=white]
% rectangle (88mm,100mm);
% \fill [top color=white,bottom color=blue]
% (0mm,0mm) -- (88mm,100mm) -- (0mm,100mm) --cycle;
% \draw (44mm,50mm) node{\large Back};
% \end{Back}
% \begin{Top}
% \fill [outer color=white!30!red,inner color=white]
% rectangle (88mm,30mm);
% \draw[white,thick] (0mm,5mm) -- (88mm,25mm);
% \draw (44mm,15mm) node{\large Top};
% \end{Top}
% \begin{Bottom}
% \fill [outer color=red!30!white,inner color=black]
% rectangle (88mm,30mm);
% \draw[white] (44mm,15mm) node{\large Bottom};
% \end{Bottom}
% \begin{Left}
% \fill [left color=green,right color=yellow]
% rectangle (30mm,100mm);
% \draw (15mm,50mm) node{\large Left};
% \end{Left}
% \begin{Right}
% \fill [top color=green,bottom color=yellow]
% rectangle (30mm,100mm);
% \draw (15mm,50mm) node{\large Right};
% \end{Right}
% \end{ProductBox}%
% }
%
% The content of the environment is simply expanded. It may contain
% any code you like -- except an |ProductBox| environment. Useful
% for the production of a product box are some inner environments.
% They are called |Front|, |Back|, |Left|, |Right|, |Top|, and
% |Bottom|. They are defined inside the main
% environment only. Those environments can be used to specify the
% contents of the respective faces of the box.
%
% Note that in the three-dimensional rendering will show at most
% three of the faces. It does not hurt to define all of them, even
% if they are not shown at all.
%
% \DescribeEnv{Front}
% The environment |Front| is used to define the content of
% the font face. The environment processes its contents inside a
% |tikzpicture| of the default size 88\,mm$\times$100\,mm.
% Usually anything outside of this range is clipped.
%
% \SampleEnv{Front}
%
% \DescribeEnv{Back}
% The environment |Back| is used to define the content of
% the back face. The environment processes its contents inside a
% |tikzpicture| of the default size 88\,mm$\times$100\,mm.
% Usually anything outside of this range is clipped.
%
% \SampleEnv{Back}
%
% \DescribeEnv{Left}
% The environment |Left| is used to define the content of
% the left face, i.e. the face left to the front page. The
% environment processes its contents inside a |tikzpicture|
% of the default size 30\,mm$\times$100\,mm. Usually anything
% outside of this range is clipped.
%
% \SampleEnv{Left}
%
% \DescribeEnv{Right}
% The environment |Right| is used to define the content of
% the right face, i.e. the face right to the front page. The
% environment processes its contents inside a |tikzpicture|
% of the default size 30\,mm$\times$100\,mm. Usually anything
% outside of this range is clipped.
%
% \SampleEnv{Right}
%
% \DescribeEnv{Top}
% The environment |Top| is used to define the content of the
% top face. The environment processes its contents inside a
% |tikzpicture| of the default size 88\,mm$\times$30\,mm. Usually
% anything outside of this range is clipped.
%
% \SampleEnv{Top}
%
% \DescribeEnv{Bottom}
% The environment |Bottom| is used to define the content of the
% top face. The environment processes its contents inside a
% |tikzpicture| of the default size 88\,mm$\times$30\,mm. Usually
% anything outside of this range is clipped.
%
% \SampleEnv{Bottom}
%
%
% \subsection{Settings and Options of the Main Environment}\label{sec:options}
%
% The environment |ProductBox| can take some options to
% influence the appearance of the product box. Those options are
% comma separated.
%
% \def\CODE#1{
% \noindent
% \fcolorbox{red!30!black}{yellow!30!white}{\begin{minipage}[b]{.98\textwidth}\footnotesize\tt
% #1
% \end{minipage}\medskip\par
% }}%
% \CODE{\textcolor{blue}{\char92begin}\char123ProductBox\char125[shape=3d]}
%
% The settings are local to the main environment. If an option is not
% set then the fallback from the global settings are used.
%
% \DescribeMacro{\ProductBoxSet}
% The macro |\ProductBoxSet| modifies the global setting of the
% product box style. The arguments are the same as the optional
% arguments of the environment |ProductBox| -- but enclosed
% in braces instead of brackets.
%
% \CODE{\char92ProductBoxSet\char123shape=3d\char125 }
%
% The following options can be used to influence the result of the product
% box.
%
% \newcommand\SAMPLE[1]{
% \noindent
% \fcolorbox{red!30!black}{yellow!30!white}{\begin{minipage}[b]{.45\textwidth}\footnotesize\tt\raggedright
% \def\x{#1}%
% \def\e{}%
% \textcolor{blue}{\char92begin}\char123ProductBox\char125 \ifx\x\e\else\textcolor{red}{[#1]}\fi\\
% \hspace*{2em}\textcolor{blue}{\char92begin}\char123Front\char125\\
% \hspace*{4em}...\\
% \hspace*{2em}\textcolor{blue}{\char92end}\char123Front\char125\\
% \hspace*{2em}\textcolor{blue}{\char92begin}\char123Left\char125\\
% \hspace*{4em}...\\
% \hspace*{2em}\textcolor{blue}{\char92end}\char123Left\char125\\
% \hspace*{2em}...\\
% \textcolor{blue}{\char92end}\char123ProductBox\char125
% \end{minipage}}\hfill
% \begin{minipage}[b]{.53\textwidth}\hfill
% \sample{#1}
% \end{minipage}\medskip\par
% }%
%
% \DescribeMacro{style}
% The box style determines, how the box is drawn. Several rendering
% functions are provided to produce different effects. Any value is
% accepted. Unknown box styles will lead to an error message.
%
% \SAMPLE{style=3D}
%
% \DescribeMacro{3D}
% The box style |3D| is the default. It produces a
% three-dimensional view of the box. The option |3D| is an
% abbreviation for |style=3D|. It can also be written as |3d| or
% |threeD|.
%
% \SAMPLE{}
%
% \DescribeMacro{shadow}
% The option |shadow| controls the drawing of the drop shadow in the
% 3D rendering. It is a boolean value taking the values |true| and
% |false|. The default value is |true|.
%
% The option |shadow| is the abbreviation for |shadow=true|.
%
% \SAMPLE{shadow=false}
%
% \DescribeMacro{mirror}
% The option |mirror| controls the rendering of the mirror effect in
% the 3D rendering. It is a boolean value taking the values |true| and
% |false|. The default value is |false|.
%
% The option |mirror| is the abbreviation for |mirror=true|.
%
% \SAMPLE{mirror=true}
%
% \DescribeMacro{flare}
% The option |flare| controls the rendering of the flare effect in
% the 3D~rendering. The flare is a circular relection of the light
% source in the upper right corner of the front face. The option is
% a boolean value taking the values |true| and |false|. The default
% value is |false|.
%
% The option |flare| is the abbreviation for |flare=true|.
%
% \SAMPLE{flare=true}
%
% \DescribeMacro{flareDiameter}
% The option |flareDiameter| takes a dimension which defines the
% diameter of the flare effect in the 3D~rendering. The default
% value is 24\,mm.
%
% \SAMPLE{flare=true, flareDiameter=60mm}
%
% Internally the 3D rendering uses a |tikzpicture|. You can expand
% your own code either at the beginning or at the end of this
% environment. This can be achieved by overwriting a macro.
%
% \DescribeMacro{ProductBoxThreeDStartHook}
% The macro |ProductBoxThreeDStartHook| contains code to be
% expanded at the beginning of the 3D rendering. Initially it is
% defined as empty.
%
% \noindent
% \fcolorbox{red!30!black}{yellow!30!white}{\begin{minipage}[b]{.49\textwidth}\footnotesize\tt\raggedright
% \textcolor{blue}{\char92renewcommand}\char92ProductBoxThreeDStartHook\char123\\
% \hspace*{2em}\char92 filldraw[yscale=.4,\\
% \hspace*{6em} shift=\char123(30mm,4mm)\char125,\\
% \hspace*{6em} color=white,\\
% \hspace*{6em} inner color=white!70!blue,\\
% \hspace*{6em} outer color=white]\\
% \hspace*{4em} circle (120mm);\\
% \char125\\
% \textcolor{blue}{\char92begin}\char123ProductBox\char125\\
% \hspace*{2em}...\\
% \textcolor{blue}{\char92end}\char123ProductBox\char125
% \end{minipage}}\hfill\hspace*{-4pt}
% \begin{minipage}[b]{.5\textwidth}\hfill
% \renewcommand\ProductBoxThreeDStartHook{
% \filldraw[yscale=.4,
% shift={(30mm,4mm)},
% color=white,
% inner color=white!80!blue,
% outer color=white] circle (120mm);
% }
% \sample{}
% \end{minipage}\hspace*{-3pt}\medskip\par
%
% \DescribeMacro{ProductBoxThreeDEndHook}
% The macro |ProductBoxThreeDEndHook| contains code to be
% expanded at the end of the 3D rendering. Initially it is
% defined as empty.
%
% \DescribeMacro{fold}
% The option |fold| switches to the box style for rendering a
% complete wire frame with all faces in place. The option
% |fold| is an abbreviation for |style=fold|.
%
% \SAMPLE{fold}
%
% The top face is printed on the left and right top ear as well.
% This should avoid a break in the pattern when the box is
% partially opened. The same principle applis for the glue ear on
% the right side and the bottom.
%
% The bottom is formed in a way to maiximize stability without the
% need to glue. In addition numbers are printed on the parts of the
% bottom indicating the sequence in which the parts should be
% closed.
%
% \DescribeMacro{earSize}
% The option |earSize| takes a dimension which defines the
% width of the ears in the fold rendering. The ears around the top
% are this wide. The width of the glueing ear is half of this size.
% The default value is 12\,mm.
%
% \SAMPLE{fold,earSize=30mm}
%
% Note that the ear size must not exceed the width of the left
% face, the width of the front face, and the heiht of the box.
% Otherwise funny effects in the ears will happen.
%
% \DescribeMacro{foldLine}
% The option |foldLine| takes a specification for the line
% surrounding the fold drawing. Usally you want to simply use a
% color like ``gray'' or ``red''. The default is a kind of gray.
%
% \SAMPLE{fold,foldLine=red}
%
% \DescribeMacro{foldOpacity}
% The option |foldOpacity| takes a fraction for the opacity of the line
% surrounding the fold drawing. The default is |0.5|. If you want
% to let the fold lines disappear then use a value of 1.
%
% \SAMPLE{fold,foldOpacity=0}
%
% \DescribeMacro{front}
% The option |front| switches to the box style for rendering the
% front face only. The option |front| is an abbreviation for
% |style=front|.
%
% \SAMPLE{front}
%
% \DescribeMacro{back}
% The option |back| switches to the box style for rendering the
% back face only. The option |back| is an abbreviation for
% |style=back|.
%
% \SAMPLE{back}
%
% \DescribeMacro{left}
% The option |left| switches to the box style for rendering the
% left face only. The option |left| is an abbreviation for
% |style=left|.
%
% \SAMPLE{left}
%
% \DescribeMacro{right}
% The option |right| switches to the box style for rendering the
% right face only. The option |right| is an abbreviation for
% |style=right|.
%
% \SAMPLE{right}
%
% \DescribeMacro{top}
% The option |top| switches to the box style for rendering the
% top face only. The option |top| is an abbreviation for
% |style=top|.
%
% \SAMPLE{top}
%
% \DescribeMacro{bottom}
% The option |bottom| switches to the box style for rendering the
% face only. The option |bottom| is an abbreviation for
% |style=bottom|.
%
% \SAMPLE{bottom}
%
% \DescribeMacro{empty}
% The option |empty| switches to the box style for not rendering
% the box at all. The option |empty| is an abbreviation for
% |style=empty|.
%
% \SAMPLE{empty}
%
% \DescribeMacro{scale}
% The option |scale| controlls the scaling of the whole rendering.
% It is a number where 1. represents the original size.\footnote{The
% examples on the right side are normally rendered with a scale of 0.25.}
%
% \SAMPLE{scale=.1}
%
% \DescribeMacro{view}
% The option |view| takes a name of a view definition and activates
% the appropriate settings. A few views are predefined. The default
% value is |1|.
%
% \SAMPLE{view=1}
%
% \SAMPLE{view=2}
%
% \SAMPLE{view=3}
%
% \DescribeMacro{edgeColor}
% The option |edgeColor| takes a color specification for
% highlighting the inner edges in the 3D rendering.
%
% \DescribeMacro{faceSep}
% The option |faceSep| takes a dimension denoting the additional
% separating whitespace between the outer border and the minipage
% in the simplified interface.
%
% \DescribeMacro{width}
% The option |width| takes a dimension denoting the width of the
% box. The default value is 88\,mm.
%
% \DescribeMacro{height}
% The option |height| takes a dimension denoting the height of the
% box. The default value is 100\,mm.
%
% \DescribeMacro{depth}
% The option |depth| takes a dimension denoting the depth of the
% box. The default value is 30\,mm.
%
% \DescribeMacro{clean}
% The option |clean| controlls the cleaning of the stored faces
% upon entering the main environment. If it is turned off then the
% previously defined faces are still present and do not need to be
% defined again. It is a boolean value taking the values |true| and
% |false|. The default value is |true|.
%
% This option can be used to typeset the same product box with
% differnt parameters. For this purpose the main environment
% |ProductBox| is left empty and the option |clean=false| is added.
%
% \DescribeMacro{clip}
% The option |clip| controls the clipping of the faces to their
% defined size. If it is turned off then the faces can be oversized
% leading to strange effects. It is a boolean value taking the
% values |true| and |false|. The default value is |true|.
%
% \section{Tipps and Tricks}
%
% \subsection{Adjusting the Paper for the Fold Rendering}
%
% When you produce the fold rendering it is usually meant to be cut
% out and glued together. This means that the normal rules for the
% paper layout are not relevant. Instead you want to use the
% complete page for printing the product box.
% Below an example is shown how this goal can be achieved.
%
% \noindent
% {\advance\textwidth-\fboxsep \advance\textwidth-\fboxsep
% \advance\textwidth-\fboxrule \advance\textwidth-\fboxrule
% \setbox127\hbox\bgroup\begin{minipage}{.98\textwidth}\raggedright\footnotesize\tt
% |\documentclass{|\textcolor{red}{\tt report}|}|\\
% |\usepackage[|\textcolor{red}{a4paper}|,|\\
% | landscape,|\\
% | left=|\textcolor{red}{5mm}|,|\\
% | right=|\textcolor{red}{5mm}|,|\\
% | top=|\textcolor{red}{5mm}|,|\\
% | bottom=|\textcolor{red}{5mm}|]{geometry}|\\
% |\usepackage{productbox}|\\
% \textcolor{green}{\itshape\% load any required packages here}\\
% |\pagestyle{empty}|\\
% |\begin{document}|\\
% |\noindent|\\
% |\begin{ProductBox}[style=fold]|\\
% | |\textcolor{green}{\itshape\% include any definitions for the faces here}\\
% |\end{ProductBox}|\\
% |\end{document}|\\
% \end{minipage}\egroup
% \fcolorbox{red!30!black}{yellow!30!white}{\box127}}
%
% The class for typesetting this example is |report|. This can be
% changed to suit your needs. For instance if you are used to a
% document class with other macros and environments predefined you
% can just use it instead.
%
% The example above uses the package |geometry|
% \cite{geormetry-manual} to get rid of any predefined page layout.
% Some parameters (marked in red) can be adjusted. First of all is
% the paper definition. Here the value |a4paper| is used. If you
% want to print onto paper of a different size just use an
% appropriate short name like |letterpaper| or |a3paper|. See the
% documentation of the geometry package for a complete list of
% values.
%
% The values |left|, |right|, |top|, and |bottom| denote the
% margins left on the respective outer side of the paper. They are
% set to 5\,mm in this example to cope with the problem that some
% printers are not able to fill the complete page. They might need
% a small non-printable area at the borders. You can experiment and
% adjust those values to whatever suits your printer.
%
% \section{Known Problems}
%
% This section lists some issues which might lead to undesirable
% results.
%
% \begin{description}
% \item[Nested |ProductBox| environments.] The definition of the
% environment uses some global storage. As a consequence the
% environment |ProductBox| can not be used inside the definition of
% a face. For instance if you want to show a product box on a side
% of another product box can lead to this problem.
%
% In this case you can simply store the inner product box in a box
% register (with |setbox|) and use this bos register instead of a
% direct rendering. This will overcome the restriction.
%
% \item[Free selection of the point of view.] The 3D rendering is
% rather limited in the possibilities of selecting the view.
% Arbitrary rotation about any axis is not implemented (yet). This
% is on the which list for a future release already.
% \end{description}
%
%
% \bibliographystyle{alpha}
% \bibliography{productbox}
%
% \StopEventually
%
% \newpage
% \section{The Documentation Driver}
%
% The documentation driver changes \textsf{productbox.dtx} into a
% self-extracting documentation. Thus it is possible to run
% \LaTeX{} on \textsf{productbox.dtx} to produce the documentation.
%
% The documentation can be adapted in a file named productbox.dcf
% (documentation configuration). This file can contain instructions
% for |docstrip|. Especially useful might be the instruction
%
% |\OnlyDescription|
%
% which suppresses the generation of the implementation description.
%
% \begin{macrocode}
%<*driver>
\documentclass{ltxdoc}
\usepackage{productbox}
\usepackage[colorlinks,citecolor=blue]{hyperref}
\usepackage{graphicx,color}
\RecordChanges
\EnableCrossrefs
\CodelineIndex
\definecolor{darkblue}{rgb}{.4,.4,1.}
\renewcommand\MacroFont{\tt\footnotesize\color{darkblue}}
\parindent=0pt
\parskip=1ex plus .5ex minus .25ex
\InputIfFileExists{productbox.dcf}{}{}
\begin{document}
\DocInput{productbox.dtx}
\end{document}
%</driver>
% \end{macrocode}
%
% \section{The Implementation}
%
% The implementation contains the code of the style.
%
% \subsection{The Version Information}
%
% The following lines define the version information for the class
% file. The information is partially taken from the version control
% system (Subversion).
%
% \begin{macrocode}
%<*style>
\begingroup
\def\ProductBox@VC$#1: #2 #3${#2}
\def\ProductBox@VCdate$#1: #2-#3-#4 #5${#2/#3/#4}
\xdef\fileversion{1.1}
\xdef\filerevision{\ProductBox@VC$Revision: 8333 $}
\xdef\filedate{\ProductBox@VCdate
$Date: 2010-12-29 20:58:06 +0100 (Mi, 29 Dez 2010) $}
\xdef\filename{productbox.dtx}
\endgroup
%</style>
% \end{macrocode}
%
%
% \subsection{Getting Started}
%
% First we have to determine that the right kind of \LaTeX{} is
% running and identify the style file.
%
% \begin{macrocode}
%<*style>
\NeedsTeXFormat{LaTeX2e}
\ProvidesPackage{productbox}[\filedate Another type of boxes...]
% \end{macrocode}
%
% A bunch of packages is loaded to form the base of the work herein.
% \begin{macrocode}
\RequirePackage{keyval}
\RequirePackage{tikz}
\usetikzlibrary{calc}
\usetikzlibrary{fadings}
% \end{macrocode}
%
% \subsection{Option Declarations}
%
% Define the parameters for the keyval package. They are used in
% the main environemnt |Product Box| and in the declaration of
% global options |\ProductBoxSet|.
%
% \subsubsection{General Parameters}
% \begin{macrocode}
\define@key{ProductBox}{scale}{%
\def\ProductBox@scale{#1}}
\define@key{ProductBox}{width}{%
\def\ProductBox@x{#1}}
\define@key{ProductBox}{height}{%
\def\ProductBox@y{#1}}
\define@key{ProductBox}{depth}{%
\def\ProductBox@z{#1}}
\define@key{ProductBox}{clean}[true]{%
\csname ProductBox@clean#1\endcsname}
% \end{macrocode}
%
% \subsubsection{Box Style Parameters}
% \begin{macrocode}
\define@key{ProductBox}{flat}[true]{%
\def\ProductBox@style{flat}}
\define@key{ProductBox}{fold}[true]{%
\def\ProductBox@style{fold}}
\define@key{ProductBox}{3d}[true]{%
\def\ProductBox@style{threeD}}
\define@key{ProductBox}{3D}[true]{%
\def\ProductBox@style{threeD}}
\define@key{ProductBox}{threeD}[true]{%
\def\ProductBox@style{threeD}}
\define@key{ProductBox}{top}[true]{%
\def\ProductBox@style{top}}
\define@key{ProductBox}{bottom}[true]{%
\def\ProductBox@style{bottom}}
\define@key{ProductBox}{front}[true]{%
\def\ProductBox@style{front}}
\define@key{ProductBox}{back}[true]{%
\def\ProductBox@style{back}}
\define@key{ProductBox}{left}[true]{%
\def\ProductBox@style{left}}
\define@key{ProductBox}{right}[true]{%
\def\ProductBox@style{right}}
\define@key{ProductBox}{empty}[true]{%
\def\ProductBox@style{empty}}
\define@key{ProductBox}{style}{%
\def\ProductBox@style{#1}}
% \end{macrocode}
%
% \subsubsection{Parameters for the 3D Rendering}
% \begin{macrocode}
\define@key{ProductBox}{shadow}[true]{%
\csname ProductBox@shadow#1\endcsname}
\define@key{ProductBox}{mirror}[true]{%
\csname ProductBox@mirror#1\endcsname}
\define@key{ProductBox}{flare}[true]{%
\csname ProductBox@flare#1\endcsname}
\define@key{ProductBox}{flareDiameter}{%
\def\ProductBox@flareDiameter{#1}}
\define@key{ProductBox}{edgeColor}{%
\def\productBox@edgeColor{#1}}
\define@key{ProductBox}{view}{%
\@nameuse{ProductBox@View@#1}}
% \end{macrocode}
%
% \subsubsection{Parameters for the Fold Rendering}
% \begin{macrocode}
\define@key{ProductBox}{earSize}{%
\def\ProductBox@earSize{#1}}
\define@key{ProductBox}{foldLine}{%
\def\ProductBox@foldLine{#1}}
\define@key{ProductBox}{foldOpacity}{%
\def\ProductBox@foldOpacity{#1}}
% \end{macrocode}
%
% \subsubsection{Parameters for the Simplified Interface}
% \begin{macrocode}
\define@key{ProductBox}{faceSep}{%
\def\ProductBox@FaceSep{#1}}
% \end{macrocode}
%
% \subsection{Storage for the Faces}
%
% \begin{macro}{\ProductBox@Front}
% The box |\ProductBox@Front| contains the front material.
% \begin{macrocode}
\newbox\ProductBox@Front
% \end{macrocode}
% \end{macro}
%
% \begin{macro}{\ProductBox@Left}
% The box |\ProductBox@Left| contains the left material.
% \begin{macrocode}
\newbox\ProductBox@Left
% \end{macrocode}
% \end{macro}
%
% \begin{macro}{\ProductBox@Top}
% The box |\ProductBox@Top| contains the top material.
% \begin{macrocode}
\newbox\ProductBox@Top
% \end{macrocode}
% \end{macro}
%
% \begin{macro}{\ProductBox@Right}
% The box |\ProductBox@Right| contains the right material.
% \begin{macrocode}
\newbox\ProductBox@Right
% \end{macrocode}
% \end{macro}
%
% \begin{macro}{\ProductBox@Bottom}
% The box |\ProductBox@Bottom| contains the bottom material.
% \begin{macrocode}
\newbox\ProductBox@Bottom
% \end{macrocode}
% \end{macro}
%
% \begin{macro}{\ProductBox@Back}
% The box |\ProductBox@Back| contains the back material.
% \begin{macrocode}
\newbox\ProductBox@Back
% \end{macrocode}
% \end{macro}
%
% \subsection{Settings}
%
% \begin{macro}{\ProductBoxSet}
% The macro |\ProductBoxSet| defines the global parameters used by
% the environment |ProductBox|. They can be overwritten either
% within a group or in the optional parameter of the environment.
% \begin{macrocode}
\newcommand\ProductBoxSet[1]{\setkeys{ProductBox}{#1}}
% \end{macrocode}
% \end{macro}
%
% \subsection{The Main Environment}
%
% \begin{macro}{\ProductBox@style}
% The default style is the 3D rendering.
% \begin{macrocode}
\newcommand\ProductBox@style{threeD}
% \end{macrocode}
% \end{macro}
%
% \begin{macro}{\ProductBox@x}
% The width of the box.
% \begin{macrocode}
\newcommand\ProductBox@x{88mm}
% \end{macrocode}
% \end{macro}
%
% \begin{macro}{\ProductBox@y}
% The height of the box.
% \begin{macrocode}
\newcommand\ProductBox@y{100mm}
% \end{macrocode}
% \end{macro}
%
% \begin{macro}{\ProductBox@z}
% The depth of the box.
% \begin{macrocode}
\newcommand\ProductBox@z{30mm}
% \end{macrocode}
% \end{macro}
%
% \begin{macro}{ifProductBox@clean}
% Indicator that the boxes for the faces should be cleaned.
% \begin{macrocode}
\newif\ifProductBox@clean
% \end{macrocode}
% \end{macro}
%
% \begin{macro}{ifProductBox@active}
% Indicator that we are inside a |ProductBox| environment already.
% \begin{macrocode}
\newif\ifProductBox@active
% \end{macrocode}
% \end{macro}
%
% \begin{macro}{ifProductBox@clip}
% The boolean |ProductBox@clip| determines whether or not the
% additional clipping of the boxes should be enabled.
% \begin{macrocode}
\newif\ifProductBox@clip \ProductBox@cliptrue
% \end{macrocode}
% \end{macro}
%
% \begin{macro}{\ProductBox@FaceSep}
% The horizontal separator of the minipage in the face definitions
% in the simplified interface.
% \begin{macrocode}
\newcommand\ProductBox@FaceSep{1em}
% \end{macrocode}
% \end{macro}
%
% \begin{environment}{ProductBox}
% This is the central environment provided by this style. In the begin code
% only the local environments are initialized and the optional parameters
% are evaluated with the help of the package |keyval|.
% \begin{macrocode}
\newenvironment{ProductBox}[1][]{%
\setkeys{ProductBox}{#1}%
% \end{macrocode}
%
% Next we clean the faces if this is required.
% \changes{1.1}{2010/12/27}{Do not clean the faces upon request.}
% \begin{macrocode}
\ifProductBox@clean
\global\setbox\ProductBox@Front\hbox{}%
\global\setbox\ProductBox@Back\hbox{}%
\global\setbox\ProductBox@Left\hbox{}%
\global\setbox\ProductBox@Right\hbox{}%
\global\setbox\ProductBox@Top\hbox{}%
\global\setbox\ProductBox@Bottom\hbox{}%
\fi
% \end{macrocode}
%
% Next we define the local environments to make sure that they have
% the proper definitions within this environment. Since the
% environment provides an implicit group, the definitions are local
% to this environment.
%
% To suppress any error messages about environments which are
% already defined the start macros are reset to undefined.
% \changes{1.1}{2010/12/23}{Simplified user interface added.}
% \changes{1.1}{2010/12/25}{Suppress error messages.}
% \changes{1.1}{2010/12/26}{Issue an error message for nested
% ProductBox environments.}
% \begin{macrocode}
\ifProductBox@active
\errmessage{Trying to use an environment ProductBox inside the
environment ProductBox. This is not allowed.}%
\else
\ProductBox@activetrue
\fi
\let\Front\undefined \let\endFront\undefined
\let\Back\undefined \let\endBack\undefined
\let\Left\undefined \let\endLeft\undefined
\let\Right\undefined \let\endRight\undefined
\let\Top\undefined \let\endTop\undefined
\let\Bottom\undefined \let\endBottom\undefined
\let\FrontFace\undefined \let\endFrontFace\undefined
\let\BackFace\undefined \let\endBackFace\undefined
\let\LeftFace\undefined \let\endLeftFace\undefined
\let\RightFace\undefined \let\endRightFace\undefined
\let\TopFace\undefined \let\endTopFace\undefined
\let\BottomFace\undefined \let\endBottomFace\undefined
\newenvironment{Front}{\ProductBox@Start\ProductBox@Front
(\ProductBox@x,\ProductBox@y)}{\ProductBox@End}%
\newenvironment{Back}{\ProductBox@Start\ProductBox@Back
(\ProductBox@x,\ProductBox@y)}{\ProductBox@End}%
\newenvironment{Left}{\ProductBox@Start\ProductBox@Left
(\ProductBox@z,\ProductBox@y)}{\ProductBox@End}%
\newenvironment{Right}{\ProductBox@Start\ProductBox@Right
(\ProductBox@z,\ProductBox@y)}{\ProductBox@End}%
\newenvironment{Top}{\ProductBox@Start\ProductBox@Top
(\ProductBox@x,\ProductBox@z)}{\ProductBox@End}%
\newenvironment{Bottom}{\ProductBox@Start\ProductBox@Bottom(
\ProductBox@x,\ProductBox@z)}{\ProductBox@End}%
\newenvironment{FrontFace}[1][white]{\ProductBox@StartFace\ProductBox@Front
{\ProductBox@x}{\ProductBox@y}{##1}}{\ProductBox@EndFace}%
\newenvironment{BackFace}[1][white]{\ProductBox@StartFace\ProductBox@Back
{\ProductBox@x}{\ProductBox@y}{##1}}{\ProductBox@EndFace}%
\newenvironment{LeftFace}[1][white]{\ProductBox@StartFace\ProductBox@Left
{\ProductBox@z}{\ProductBox@y}{##1}}{\ProductBox@EndFace}%
\newenvironment{RightFace}[1][white]{\ProductBox@StartFace\ProductBox@Right
{\ProductBox@z}{\ProductBox@y}{##1}}{\ProductBox@EndFace}%
\newenvironment{TopFace}[1][white]{\ProductBox@StartFace\ProductBox@Top
{\ProductBox@x}{\ProductBox@z}{##1}}{\ProductBox@EndFace}%
\newenvironment{BottomFace}[1][white]{\ProductBox@StartFace\ProductBox@Bottom
{\ProductBox@x}{\ProductBox@z}{##1}}{\ProductBox@EndFace}%
\ignorespacesafterend
}{%
% \end{macrocode}
% Check that the box style is defined or issue an appropriate error
% message.
% \begin{macrocode}
\@ifundefined{ProductBox@style@\ProductBox@style}{%
\errmessage{Box style '\ProductBox@style' for ProductBox is unknown}%
}{%
% \end{macrocode}
% The main activity is performed in the end code. Since the
% flexibility of the environment is one of its design goals, the
% expansion of the macro |\ProductBox@style| is used to invoke the
% macro stored in it. Optionally it is enclosed in a |\scalebox|
% macro to perform the scaling. Thus the implementations of the box
% styles do not need to care about scaling at all.
% \begin{macrocode}
\@ifundefined{ProductBox@scale}{%
\@nameuse{ProductBox@style@\ProductBox@style}}{%
\scalebox{\ProductBox@scale}%
{\@nameuse{ProductBox@style@\ProductBox@style}}
}}%
\ProductBox@activefalse
\ignorespacesafterend
}
% \end{macrocode}
% \end{environment}
%
% \begin{macro}{\ProductBox@Start}
% The macro |\ProductBox@Start| starts the environment storing a face.
% \begin{macrocode}
\def\ProductBox@Start#1(#2){%
\global\setbox#1\hbox\bgroup\begin{tikzpicture}%
\ifProductBox@clip \clip rectangle (#2); \fi
}%
% \end{macrocode}
% \end{macro}
%
% \begin{macro}{\ProductBox@End}
% The macro |\ProductBox@End| ends the environment storing a face.
% \begin{macrocode}
\newcommand\ProductBox@End{\end{tikzpicture}\egroup\ignorespacesafterend}
% \end{macrocode}
% \end{macro}
%
% \begin{macro}{\ProductBox@StartFace}
% The macro |\ProductBox@StartFace| starts the environment storing
% a face in a minipage.
% \begin{macrocode}
\newcommand\ProductBox@StartFace[4]{%
\let\ProductBox@@box#1%
\def\ProductBox@@w{#2}%
\def\ProductBox@@h{#3}%
\def\ProductBox@@args{[#4]}%
\@tempdima=#2
\advance\@tempdima-\ProductBox@FaceSep
\advance\@tempdima-\ProductBox@FaceSep
\setbox#1\hbox\bgroup\begin{minipage}{\the\@tempdima}%
\ignorespaces
}
% \end{macrocode}
% \end{macro}
%
% \begin{macro}{\ProductBox@EndFace}
% This macro ends a face definition and stores the result in the
% internal box |\ProductBox@@box|.
% \begin{macrocode}
\newcommand\ProductBox@EndFace{\end{minipage}\egroup
\global\setbox\ProductBox@@box=\hbox{\begin{tikzpicture}
\ifProductBox@clip \clip rectangle (\ProductBox@@w,\ProductBox@@h); \fi
\expandafter\fill \ProductBox@@args rectangle(\ProductBox@@w,\ProductBox@@h);
\draw (.5*\ProductBox@@w,.5*\ProductBox@@h)
node[inner sep=0pt] {\box\ProductBox@@box};
\end{tikzpicture}}\ignorespacesafterend}
% \end{macrocode}
% \end{macro}
%
% \subsection{Box Styles}
%
% \begin{macro}{\ProductBox@style@empty}
% This macro defines the sytle \emph{empty} for a product box. It
% simply does nothing.
% \changes{1.1}{2010/12/26}{New box style ``empty''.}
% \begin{macrocode}
\newcommand\ProductBox@style@empty{}
% \end{macrocode}
% \end{macro}
%
% \begin{macro}{\ProductBox@style@flat}
% This macro defines the sytle \emph{flat} for a product box.
% \begin{macrocode}
\newcommand\ProductBox@style@flat{%
\par\noindent
\hspace*{\ProductBox@z}\kern1mm \copy\ProductBox@Top\\[1ex]
\copy\ProductBox@Left\kern1mm \copy\ProductBox@Front\kern1mm
\copy\ProductBox@Right\kern1mm \copy\ProductBox@Back\\[1ex]
\hspace*{\ProductBox@z}\kern1mm \copy\ProductBox@Bottom\par
}
% \end{macrocode}
% \end{macro}
%
% \subsubsection{Box Style \texttt{front}}
%
% \begin{macro}{\ProductBox@style@front}
% This macro defines the sytle \emph{front} for a product box. Only this
% one face of the box is shown.
% \begin{macrocode}
\newcommand\ProductBox@style@front{%
\copy\ProductBox@Front
}
% \end{macrocode}
% \end{macro}
%
% \subsubsection{Box Style \texttt{back}}
%
% \begin{macro}{\ProductBox@style@back}
% This macro defines the sytle \emph{back} for a product box. Only this
% one face of the box is shown.
% \begin{macrocode}
\newcommand\ProductBox@style@back{%class
\copy\ProductBox@Back
}
% \end{macrocode}
% \end{macro}
%
% \subsubsection{Box Style \texttt{left}}
%
% \begin{macro}{\ProductBox@style@left}
% This macro defines the sytle \emph{left} for a product box. Only this
% one face of the box is shown.
% \begin{macrocode}
\newcommand\ProductBox@style@left{%
\copy\ProductBox@Left
}
% \end{macrocode}
% \end{macro}
%
% \subsubsection{Box Style \texttt{right}}
%
% \begin{macro}{\ProductBox@style@right}
% This macro defines the sytle \emph{right} for a product box. Only this
% one face of the box is shown.
% \begin{macrocode}
\newcommand\ProductBox@style@right{%
\copy\ProductBox@Right
}
% \end{macrocode}
% \end{macro}
%
% \subsubsection{Box Style \texttt{top}}
%
% \begin{macro}{\ProductBox@style@top}
% This macro defines the sytle \emph{top} for a product box. Only this
% one face of the box is shown.
% \begin{macrocode}
\newcommand\ProductBox@style@top{%
\copy\ProductBox@Top
}
% \end{macrocode}
% \end{macro}
%
% \subsubsection{Box Style \texttt{bottom}}
%
% \begin{macro}{\ProductBox@style@bottom}
% This macro defines the sytle \emph{bottom} for a product box. Only this
% one face of the box is shown.
% \begin{macrocode}
\newcommand\ProductBox@style@bottom{%
\copy\ProductBox@Bottom
}
% \end{macrocode}
% \end{macro}
%
% \subsubsection{Box Style \texttt{fold}}
%
% \begin{macro}{\ProductBox@earSize}
% Parameter for the size of the ears.
% \begin{macrocode}
\newcommand\ProductBox@earSize{12mm}
% \end{macrocode}
% \end{macro}
%
% \begin{macro}{\ProductBox@foldLine}
% The color of the additional lines in the fold rendering.
% \begin{macrocode}
\newcommand\ProductBox@foldLine{white!80!black}
% \end{macrocode}
% \end{macro}
%
% \begin{macro}{\ProductBox@foldOpacity}
% The color of the additional lines in the fold rendering.
% \begin{macrocode}
\newcommand\ProductBox@foldOpacity{.5}
% \end{macrocode}
% \end{macro}
%
% \begin{macro}{\ProductBox@style@fold}
% This macro defines the sytle \emph{fold} for a product box.
% \begin{macrocode}
\newcommand\ProductBox@style@fold{%
\begin{tikzpicture}[sw/.style={anchor=south west,
inner sep=0pt},
se/.style={anchor=south east,
inner sep=0pt},
nw/.style={anchor=north west,
inner sep=0pt},
num/.style={circle,
fill=white!90!black,
fill opacity=.5,
font=\tiny\bfseries\sffamily}]
% \end{macrocode}
% left face
% \begin{macrocode}
\begin{scope}
\clip rectangle (\ProductBox@z,\ProductBox@y);
\draw node[sw]{\copy\ProductBox@Left};
\draw[thin,opacity=\ProductBox@foldOpacity,\ProductBox@foldLine]
rectangle (\ProductBox@z,\ProductBox@y);
\end{scope}
% \end{macrocode}
% front face
% \begin{macrocode}
\begin{scope}[xshift=\ProductBox@z]
\clip rectangle (\ProductBox@x,\ProductBox@y);
\draw node[sw]{\copy\ProductBox@Front};
\draw[thin,opacity=\ProductBox@foldOpacity,\ProductBox@foldLine]
rectangle (\ProductBox@x,\ProductBox@y);
\end{scope}
% \end{macrocode}
% right face
% \begin{macrocode}
\begin{scope}[xshift=\ProductBox@z+\ProductBox@x]
\clip rectangle (\ProductBox@z,\ProductBox@y);
\draw node[sw]{\copy\ProductBox@Right};
\draw[thin,opacity=\ProductBox@foldOpacity,\ProductBox@foldLine]
rectangle (\ProductBox@z,\ProductBox@y);
\end{scope}
% \end{macrocode}
% back face
% \begin{macrocode}
\begin{scope}[xshift=\ProductBox@x+2*\ProductBox@z]
\clip rectangle (\ProductBox@x,\ProductBox@y);
\draw node[sw]{\copy\ProductBox@Back};
\draw[thin,opacity=\ProductBox@foldOpacity,\ProductBox@foldLine]
rectangle (\ProductBox@x,\ProductBox@y);
\end{scope}
% \end{macrocode}
% top face
% \begin{macrocode}
\begin{scope}[xshift=\ProductBox@z,yshift=\ProductBox@y]
\clip rectangle (\ProductBox@x,\ProductBox@z);
\draw node[sw]{\copy\ProductBox@Top};
\draw[thin,opacity=\ProductBox@foldOpacity,\ProductBox@foldLine]
rectangle (\ProductBox@x,\ProductBox@z);
\end{scope}
% \end{macrocode}
% bottom ear 3 front
% \begin{macrocode}
\begin{scope}[xshift=\ProductBox@z]
\clip
(0mm,0mm) -- (.5*\ProductBox@z,-.5*\ProductBox@z) --
(.5*\ProductBox@z,-\ProductBox@z) --
(\ProductBox@x-.5*\ProductBox@z,-\ProductBox@z) --
(\ProductBox@x-.5*\ProductBox@z,-.5*\ProductBox@z) --
(\ProductBox@x,0mm) -- cycle;
\draw (\ProductBox@x,-\ProductBox@z)
node[se]{\copy\ProductBox@Bottom};
\draw [thin,opacity=\ProductBox@foldOpacity,\ProductBox@foldLine]
(0mm,0mm) -- (.5*\ProductBox@z,-.5*\ProductBox@z) --
(.5*\ProductBox@z,-\ProductBox@z) --
(\ProductBox@x-.5*\ProductBox@z,-\ProductBox@z) --
(\ProductBox@x-.5*\ProductBox@z,-.5*\ProductBox@z) --
(\ProductBox@x,0mm) -- cycle;
\draw (.5*\ProductBox@x,-.75*\ProductBox@z) node[num]{3};
\end{scope}
% \end{macrocode}
% bottom ear 1 back
% \begin{macrocode}
\begin{scope}[xshift=\ProductBox@x+2*\ProductBox@z]
\clip
(0mm,0mm) -- (0mm,-\ProductBox@z) --
(.5*\ProductBox@z,-\ProductBox@z) --
(.5*\ProductBox@z,-.5*\ProductBox@z) --
(\ProductBox@x-.5*\ProductBox@z,-.5*\ProductBox@z) --
(\ProductBox@x-.5*\ProductBox@z,-\ProductBox@z) --
(\ProductBox@x,-\ProductBox@z) -- (\ProductBox@x,0mm) --
cycle;
\draw node[se,rotate=180]{\copy\ProductBox@Bottom};
\draw[thin,opacity=\ProductBox@foldOpacity,\ProductBox@foldLine]
(0mm,0mm) -- (0mm,-\ProductBox@z) --
(.5*\ProductBox@z,-\ProductBox@z) --
(.5*\ProductBox@z,-.5*\ProductBox@z) --
(\ProductBox@x-.5*\ProductBox@z,-.5*\ProductBox@z) --
(\ProductBox@x-.5*\ProductBox@z,-\ProductBox@z) --
(\ProductBox@x,-\ProductBox@z) -- (\ProductBox@x,0mm) --
cycle;
\draw (.25*\ProductBox@z,-.75*\ProductBox@z) node[num]{1};
\draw (\ProductBox@x-.25*\ProductBox@z,-.75*\ProductBox@z)
node[num]{1};
\end{scope}
% \end{macrocode}
% bottom ear 2 right
% \begin{macrocode}
\begin{scope}[xshift=\ProductBox@z+\ProductBox@x]
\clip
(0mm,0mm) -- (\ProductBox@z,0mm) --
(.5*\ProductBox@z,-.5*\ProductBox@z) --
(.5*\ProductBox@z,-\ProductBox@z) -- (0mm,-\ProductBox@z) --
cycle;
\draw (\ProductBox@z,0mm)
node[se,rotate=90]{\copy\ProductBox@Bottom};
\draw[thin,opacity=\ProductBox@foldOpacity,\ProductBox@foldLine]
(0mm,0mm) -- (\ProductBox@z,0mm) --
(.5*\ProductBox@z,-.5*\ProductBox@z) --
(.5*\ProductBox@z,-\ProductBox@z) -- (0mm,-\ProductBox@z) --
cycle;
\draw (.25*\ProductBox@z,-.75*\ProductBox@z) node[num]{2};
\end{scope}
% \end{macrocode}
% bottom ear 2 left
% \begin{macrocode}
\begin{scope}
\clip
(0mm,0mm) -- (\ProductBox@z,0mm) --
(\ProductBox@z,-\ProductBox@z) --
(.5*\ProductBox@z,-\ProductBox@z) --
(.5*\ProductBox@z,-.5*\ProductBox@z) -- cycle;
\draw
node[sw,rotate=270]{\copy\ProductBox@Bottom};
\draw [thin,opacity=\ProductBox@foldOpacity,\ProductBox@foldLine]
(0mm,0mm) -- (\ProductBox@z,0mm) --
(\ProductBox@z,-\ProductBox@z) --
(.5*\ProductBox@z,-\ProductBox@z) --
(.5*\ProductBox@z,-.5*\ProductBox@z) -- cycle;
\draw (.75*\ProductBox@z,-.75*\ProductBox@z) node[num]{2};
\end{scope}
% \end{macrocode}
% glue ear
% \begin{macrocode}
\begin{scope}[xshift=2*\ProductBox@x+2*\ProductBox@z]
\clip
(0mm,0mm) -- (\ProductBox@earSize/2,\ProductBox@earSize/4) --
(\ProductBox@earSize/2,\ProductBox@y-\ProductBox@earSize/4) --
(0mm,\ProductBox@y) -- cycle;
\draw node[sw]{\copy\ProductBox@Left};
\draw[thin,opacity=\ProductBox@foldOpacity,\ProductBox@foldLine]
(0mm,0mm) -- (\ProductBox@earSize/2,\ProductBox@earSize/4) --
(\ProductBox@earSize/2,\ProductBox@y-\ProductBox@earSize/4) --
(0mm,\ProductBox@y) -- cycle;
\end{scope}
% \end{macrocode}
% top ear left
% \begin{macrocode}
\begin{scope}[yshift=\ProductBox@y]
\clip
(0mm,0mm) -- (\ProductBox@earSize/2,\ProductBox@earSize) --
(\ProductBox@z-\ProductBox@earSize/2,\ProductBox@earSize) --
(\ProductBox@z,0mm) -- cycle;
\draw node[nw,rotate=90]{\copy\ProductBox@Top};
\draw[thin,opacity=\ProductBox@foldOpacity,\ProductBox@foldLine]
(0mm,0mm) -- (\ProductBox@earSize/2,\ProductBox@earSize) --
(\ProductBox@z-\ProductBox@earSize/2,\ProductBox@earSize) --
(\ProductBox@z,0mm) -- cycle;
\end{scope}
% \end{macrocode}
% top ear right
% \begin{macrocode}
\begin{scope}[xshift=\ProductBox@x+\ProductBox@z,
yshift=\ProductBox@y]
\clip
(0mm,0mm) -- (\ProductBox@earSize/2,\ProductBox@earSize) --
(\ProductBox@z-\ProductBox@earSize/2,\ProductBox@earSize) --
(\ProductBox@z,0mm) -- cycle;
\draw node[se,rotate=270]{\copy\ProductBox@Top};
\draw[thin,opacity=\ProductBox@foldOpacity,\ProductBox@foldLine]
(0mm,0mm) -- (\ProductBox@earSize/2,\ProductBox@earSize) --
(\ProductBox@z-\ProductBox@earSize/2,\ProductBox@earSize) --
(\ProductBox@z,0mm) -- cycle;
\end{scope}
% \end{macrocode}
% top ear back
% \begin{macrocode}
\begin{scope}[xshift=\ProductBox@z,
yshift=\ProductBox@y+\ProductBox@z]
\clip
(0mm,0mm) -- (\ProductBox@earSize/2,\ProductBox@earSize) --
(\ProductBox@x-\ProductBox@earSize/2,\ProductBox@earSize) --
(\ProductBox@x,0mm) -- cycle;
\draw (0mm,\ProductBox@y)
node[se,rotate=180]{\copy\ProductBox@Back};
\draw[thin,opacity=\ProductBox@foldOpacity,\ProductBox@foldLine]
(0mm,0mm) -- (\ProductBox@earSize/2,\ProductBox@earSize) --
(\ProductBox@x-\ProductBox@earSize/2,\ProductBox@earSize) --
(\ProductBox@x,0mm) -- cycle;
\end{scope}
\end{tikzpicture}}
% \end{macrocode}
% \end{macro}
%
% \subsubsection{Box Style \texttt{threeD}}
%
% \begin{macro}{\ProductBoxThreeDStartHook}
% A hook to add some code at the beginning.
% \begin{macrocode}
\newcommand\ProductBoxThreeDStartHook{}
% \end{macrocode}
% \end{macro}
%
% \begin{macro}{\ProductBoxThreeDEndHook}
% A hook to add some code at the end.
% \begin{macrocode}
\newcommand\ProductBoxThreeDEndHook{}
% \end{macrocode}
% \end{macro}
%
% \begin{macro}{\ifProductBox@shadow}
% The boolean |ProductBox@shadow| determines whether or not the
% shadow in the 3D rendering is shown.
% \begin{macrocode}
\newif\ifProductBox@shadow \ProductBox@shadowtrue
% \end{macrocode}
% \end{macro}
%
% \begin{macro}{\ifProductBox@mirror}
% The boolean |ProductBox@mirror| determines whether or not the
% mirror effect in the 3D rendering is shown.
% \begin{macrocode}
\newif\ifProductBox@mirror
% \end{macrocode}
% \end{macro}
%
% \begin{macro}{\ifProductBox@flare}
% The boolean |ProductBox@flare| determines whether or not the
% flare effect in the 3D rendering is shown.
% \begin{macrocode}
\newif\ifProductBox@flare
% \end{macrocode}
% \end{macro}
%
% \begin{macro}{\ProductBox@edgeColor}
% The edge color in the 3D rendering.
% \begin{macrocode}
\newcommand\ProductBox@edgeColor{white}
% \end{macrocode}
% \end{macro}
%
% \begin{macro}{\ProductBox@flareDiameter}
% The diameter of the flare.
% \begin{macrocode}
\newcommand\ProductBox@flareDiameter{24mm}
% \end{macrocode}
% \end{macro}
%
% The angle to rotate the box about the z axis.
% \begin{macrocode}
\newcommand\ProductBox@angleZ{8}
% \end{macrocode}
%
% The angle to rotate the box about the x axis.
% \begin{macrocode}
\newcommand\ProductBox@angleX{10}
% \end{macrocode}
%
% \begin{macro}{\ProductBox@style@threeD}
% This macro defines the sytle \emph{threeD} for a product box. The
% faces are placed such the illusion of a three-dimensional box
% appears. In addition a shadow is shown if not disabled.
% \changes{1.1}{2010/12/26}{Fix: The flare is also transformed and clipped.}
% \begin{macrocode}
\newcommand\ProductBox@style@threeD{
\begin{tikzpicture}[sw/.style={anchor=south west,
inner sep=0pt}]
\ProductBoxThreeDStartHook
\ifProductBox@mirror \ProductBox@threeD@mirror \fi
\ifProductBox@shadow \ProductBox@threeD@shadow \fi
\begin{scope}
\fill[white,
yslant=\ProductBox@p@front@yslant,
xscale=\ProductBox@p@front@xscale,
yscale=\ProductBox@p@front@yscale,
anchor=south west]
rectangle (\ProductBox@x,\ProductBox@y);
\draw
node[sw,
yslant=\ProductBox@p@front@yslant,
xscale=\ProductBox@p@front@xscale,
yscale=\ProductBox@p@front@yscale]
{\copy\ProductBox@Front};
\fill[black,
fill opacity=.025,
yslant=\ProductBox@p@front@yslant,
xscale=\ProductBox@p@front@xscale,
yscale=\ProductBox@p@front@yscale,
anchor=south west]
rectangle (\ProductBox@x,\ProductBox@y);
\ifProductBox@flare
\begin{scope}[
yslant=\ProductBox@p@front@yslant,
xscale=\ProductBox@p@front@xscale,
yscale=\ProductBox@p@front@yscale]
\clip rectangle(\ProductBox@x,\ProductBox@y);
\ProductBox@threeD@flare
\end{scope}
\fi
\end{scope}
\begin{scope}[shift={(-\ProductBox@p@left@xscale*\ProductBox@z,
\ProductBox@p@left@yslant
*\ProductBox@p@left@xscale
*\ProductBox@z)}]
\fill[white,
yslant=-\ProductBox@p@left@yslant,
xscale=\ProductBox@p@left@xscale,
yscale=\ProductBox@p@left@yscale,
anchor=south west]
rectangle (\ProductBox@z,\ProductBox@y);
\draw
node[sw,
yslant=-\ProductBox@p@left@yslant,
xscale=\ProductBox@p@left@xscale,
yscale=\ProductBox@p@left@yscale]
{\copy\ProductBox@Left};
\fill[black,
fill opacity=.25,
yslant=-\ProductBox@p@left@yslant,
xscale=\ProductBox@p@left@xscale,
yscale=\ProductBox@p@left@yscale,
anchor=south west]
rectangle (\ProductBox@z,\ProductBox@y);
\end{scope}
\begin{scope}[yshift=\ProductBox@y]
\fill [white,
anchor=south west,
xslant=-\ProductBox@p@top@xslant,
xscale=\ProductBox@p@top@xscale,
yslant=\ProductBox@p@top@yslant,
yscale=\ProductBox@p@top@yscale]
rectangle (\ProductBox@x,\ProductBox@z);
\draw
node[sw,
xslant=-\ProductBox@p@top@xslant,
xscale=\ProductBox@p@top@xscale,
yslant=\ProductBox@p@top@yslant,
yscale=\ProductBox@p@top@yscale]
{\copy\ProductBox@Top};
\fill [black,
fill opacity=.0025,
anchor=south west,
xslant=-\ProductBox@p@top@xslant,
xscale=\ProductBox@p@top@xscale,
yslant=\ProductBox@p@top@yslant,
yscale=\ProductBox@p@top@yscale]
rectangle (\ProductBox@x,\ProductBox@z);
\end{scope}
\begin{scope}[shift={(-\ProductBox@p@left@xscale*\ProductBox@z,
\ProductBox@p@left@yslant*\ProductBox@p@left@xscale*\ProductBox@z)}]
\draw [\ProductBox@edgeColor,
line width=.5mm,
draw opacity=.25,
yslant=-\ProductBox@p@left@yslant,
xscale=\ProductBox@p@left@xscale]
(\ProductBox@z,0mm) --
(\ProductBox@z,\ProductBox@y) --
(0mm,\ProductBox@y);
\end{scope}
\draw [\ProductBox@edgeColor,
line width=.5mm,
draw opacity=.25,
yslant=\ProductBox@p@front@yslant,
xscale=\ProductBox@p@front@xscale,
anchor=south west]
(0mm,\ProductBox@y) -- (\ProductBox@x,\ProductBox@y);
\ProductBoxThreeDEndHook
\end{tikzpicture}}
% \end{macrocode}
% \end{macro}
%
% Parameters and views.
%
% \begin{macrocode}
\newcommand\ProductBox@setFrontParams[3]{%
\def\ProductBox@p@front@yslant{#1}%
\def\ProductBox@p@front@xscale{#2}%
\def\ProductBox@p@front@yscale{#3}%
}
\newcommand\ProductBox@setLeftParams[3]{%
\def\ProductBox@p@left@yslant{#1}%
\def\ProductBox@p@left@xscale{#2}%
\def\ProductBox@p@left@yscale{#3}%
}
\newcommand\ProductBox@setTopParams[4]{%
\def\ProductBox@p@top@xslant{#1}%
\def\ProductBox@p@top@yslant{#2}%
\def\ProductBox@p@top@xscale{#3}%
\def\ProductBox@p@top@yscale{#4}%
}
\newcommand\ProductBox@setMirrorParams[1]{%
\def\ProductBox@p@mirror@yscale{#1}%
}
\@namedef{ProductBox@View@1}{%
\ProductBox@setFrontParams{.25}{.9090909}{1}%
\ProductBox@setLeftParams{.5}{.6666666}{1}%
\ProductBox@setTopParams{2}{.2265}{1.363}{.3333333}%
\ProductBox@setMirrorParams{.4}}
\@namedef{ProductBox@View@2}{%
\ProductBox@setFrontParams{.15}{.9090909}{1}%
\ProductBox@setLeftParams{.6666666}{.5}{1}%
\ProductBox@setTopParams{1.5}{.12}{1.11}{.333333}%
\ProductBox@setMirrorParams{.4}}
\@namedef{ProductBox@View@3}{%
\ProductBox@setFrontParams{.05}{.95}{1}%
\ProductBox@setLeftParams{.25}{.4}{1}%
\ProductBox@setTopParams{4}{.04}{1.133333}{.1}%
\ProductBox@setMirrorParams{.4}}
\@nameuse{ProductBox@View@1}
% \end{macrocode}
%
% \begin{macro}{\ProductBox@threeD@shadow}
% This macro defines the code to produce the shadow effect for the 3D rendering.
% \begin{macrocode}
\newcommand\ProductBox@threeD@shadow{
\begin{scope}
\foreach \x in {.5,1,1.5,2,2.5,3,4,5,6,8,10} {
\filldraw [black,
line width=\x mm,
rounded corners=2mm,
opacity=.01,
shift={(-1mm,1mm)}]
(0mm,0mm) --
(-\ProductBox@p@top@xslant
*\ProductBox@p@left@xscale
*\ProductBox@z,
\ProductBox@p@top@yscale
*\ProductBox@z) --
(0mm,
\ProductBox@p@top@yscale*\ProductBox@z +
\ProductBox@p@top@xslant
*\ProductBox@p@left@xscale
*\ProductBox@p@top@yslant
*\ProductBox@z) --
cycle;
}
\end{scope}
}
% \end{macrocode}
% \end{macro}
%
% The following fading is used for the mirror effect in the 3D rendering.
% \begin{macrocode}
\tikzfading[name=ProductBoxFade,
top color=transparent!100,
bottom color=transparent!50,
middle color=transparent!100]
% \end{macrocode}
% \begin{macro}{\ProductBox@threeD@mirror}
% This macro defines the code to produce the mirror effect.
% \changes{1.1}{2010/12/27}{Code rewritten to make full use of tranparency.}
% \begin{macrocode}
\newcommand\ProductBox@threeD@mirror{%
\fill
node[anchor=south west,
inner sep=0pt,
yslant=\ProductBox@p@front@yslant,
xscale=\ProductBox@p@front@xscale,
yscale=-\ProductBox@p@mirror@yscale]
{\begin{tikzpicture}
\clip rectangle (\ProductBox@x,
\ProductBox@y*\ProductBox@p@mirror@yscale);
\fill node [scope fading=ProductBoxFade,
yscale=\ProductBox@p@mirror@yscale,
inner sep=0pt]{\copy\ProductBox@Front};
\end{tikzpicture}};
\fill[xshift=-\ProductBox@p@left@xscale*\ProductBox@z,
yshift=\ProductBox@p@top@yscale*\ProductBox@z]
node[anchor=south west,
inner sep=0pt,
yslant=-\ProductBox@p@left@yslant,
xscale=\ProductBox@p@left@xscale,
yscale=-\ProductBox@p@mirror@yscale]
{\begin{tikzpicture}
\clip rectangle (\ProductBox@z,
\ProductBox@y*\ProductBox@p@mirror@yscale);
\fill node [scope fading=ProductBoxFade,
yscale=\ProductBox@p@mirror@yscale,
inner sep=0pt]{\copy\ProductBox@Left};
\end{tikzpicture}};
}
% \end{macrocode}
% \end{macro}
%
% \begin{macro}{\ProductBox@threeD@flare}
% This macro defines the code to produce the flare effect. The
% flare is achieved with overlaying a partially transparent and
% fading circle of white color.
% \begin{macrocode}
\newcommand\ProductBox@threeD@flare{
\fill [white,path fading=ProductBoxFlare]
(.8*\ProductBox@x,.9*\ProductBox@y)
circle(\ProductBox@flareDiameter);
}
% \end{macrocode}
% \end{macro}
%
% The following fading is used for the flare effect in the 3D rendering.
% \begin{macrocode}
\tikzfading[name=ProductBoxFlare,
inner color=transparent!60,
outer color=transparent!100]
% \end{macrocode}
%
% Finally we define some variant names.
% \begin{macrocode}
\@namedef{ProductBox@style@3D}{\ProductBox@style@threeD}
\@namedef{ProductBox@style@3d}{\ProductBox@style@threeD}
%</style>
% \end{macrocode}
% That's all.
%
% \newpage
% \setcounter{IndexColumns}2
% \PrintChanges
% \newpage
% \PrintIndex
% \Finale
\endinput
%
% Local Variables:
% End: