Debian Codegraph @

texmf-dist/source/latex/ha-prosper/HA-prosper.dtx

raw
1 % \iffalse meta-comment
2 %
3 % HA-prosper package by Hendri Adriaens.
4 %
5 % Extract package files and create documentation:
6 % `latex HA-prosper.dtx'
7 % `latex HA-prosper.dtx'
8 % `makeindex -s gind.ist HA-prosper.idx'
9 % `latex HA-prosper.dtx'
10 % `latex HA-prosper.dtx'
11 %
12 % To generate source code documentation as well,
13 % first comment line 57 of this file.
14 %
15 % To finish the installation you have to move the following
16 % files into a directory searched by TeX:
17 % HA-prosper.sty
18 % HA-prosper.cfg
19 %
20 %% ------------------------------------------
21 %% Copyright (C) 2003-2005 by Hendri Adriaens
22 %% ------------------------------------------
23 %%
24 %% This file may be distributed and/or modified under the
25 %% conditions of the LaTeX Project Public License, either version 1.2
26 %% of this license or (at your option) any later version.
27 %% The latest version of this license is in:
28 %%
29 %% http://www.latex-project.org/lppl.txt
30 %%
31 %% and version 1.2 or later is part of all distributions of LaTeX
32 %% version 1999/12/01 or later.
33 %%
34 % \fi
35 %
36 % \iffalse
37 %<*batchfile>
38 \begingroup
39 \input docstrip.tex
40 \keepsilent
41 \preamble
42 \endpreamble
43 \askforoverwritefalse
44 \IfFileExists{.///HA-prosper.sty}{}{
45 \generate{
46 \file{HA-prosper.sty}{\from{HA-prosper.dtx}{program}}
47 \file{HA-prosper.cfg}{\from{HA-prosper.dtx}{config}}
48 }}
49 \endgroup
50 %</batchfile>
51 %<*driver>
52 \documentclass[a4paper]{ltxdoc}
53 \input{HA-prosper.def}
54 \EnableCrossrefs
55 \CodelineIndex
56 % Comment the next line to generate source code documentation.
57 \OnlyDescription
58 \begin{document}
59 \DocInput{HA-prosper.dtx}
60 \end{document}
61 %</driver>
62 % \fi
63 %
64 % \CheckSum{2292}
65 %
66 % \DoNotIndex{\def,\xdef,\edef,\global,\gdef,\let,\if,\fi,\else}
67 % \DoNotIndex{\newcommand,\newenvironment,\renewcommand,\renewenvironment}
68 % \DoNotIndex{\begin,\end,\ifx,\ifnum}
69 %
70 % \CharacterTable
71 % {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
72 % 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
73 % Digits \0\1\2\3\4\5\6\7\8\9
74 % Exclamation \! Double quote \" Hash (number) \#
75 % Dollar \$ Percent \% Ampersand \&
76 % Acute accent \' Left paren \( Right paren \)
77 % Asterisk \* Plus \+ Comma \,
78 % Minus \- Point \. Solidus \/
79 % Colon \: Semicolon \; Less than \<
80 % Equals \= Greater than \> Question mark \?
81 % Commercial at \@ Left bracket \[ Backslash \\
82 % Right bracket \] Circumflex \^ Underscore \_
83 % Grave accent \` Left brace \{ Vertical bar \|
84 % Right brace \} Tilde \~}
85 %
86 %\title{\vspace{-2em}\pf{HA-prosper} package\\\normalsize\emph{Documentation}\\
87 %\vspace{.5em}Version 4.21}
88 %\author{Hendri Adriaens\\
89 %\url{http://stuwww.uvt.nl/~hendri/downloads/haprosper.html}\\Center
90 %for Economic Research\\Tilburg University, the Netherlands}
91 %\maketitle\tableofcontents\listoftables\listoffigures
92 %
93 %\clearpage\section{General information} This manual provides
94 %information about working with the \pf{HA-prosper} package. This
95 %package is a patch for the \pf{prosper} class. Be sure to also study
96 %the documentation of the \pf{prosper} class and the \pf{hyperref}
97 %package. You can find this documentation for instance at the CTAN
98 %site for prosper \cite{prosperCTAN}, at the \pf{prosper} website
99 %\cite{prosper} or in your local \LaTeX\ distribution (for the MiKTeX
100 %distribution \cite{MiKTeX}, the documentation can be found in the
101 %|doc| directory in the MiKTeX root). Information about \pf{prosper}
102 %can also be found at the WikiProsper site \cite{WikiProsper}.
103 %
104 %If you want to start working with \pf{HA-prosper} immediately, have
105 %a look at the examples (see section~\ref{sec:examples}). If you are
106 %interested in how \pf{HA-prosper} actually works, have a look at the
107 %first lines of the source code available in the |Source| directory
108 %of the package or the |source| tree of your \LaTeX\ distribution
109 %which explains how to generate the source code documentation.
110 %
111 %Note that from version 4.1, \pf{HA-prosper} uses the \pf{xkeyval}
112 %package, which is available from CTAN \cite{xkeyvalCTAN} and is
113 %included in the MiKTeX distribution. Do not forget to install this
114 %package. See also section~\ref{sec:req}.
115 %
116 %Do not forget to check the \pf{HA-prosper} website
117 %\cite{HA-prosper} from time to time to see if there are updates
118 %for this package or new styles available. If, \emph{after reading
119 %this manual}, you have questions or comments about
120 %\pf{HA-prosper}, see section~\ref{sec:questions}.
121 %
122 %\subsection{The \pf{powerdot} class}\label{sec:newclass}
123 %This is the last release of the \pf{HA-prosper} package. We
124 %(Christopher Ellison and I) have created a new class called
125 %\pf{powerdot} \cite{powerdot} which has significant improvements
126 %over \pf{prosper} and \pf{HA-prosper} while keeping changes to
127 %presentation sources to a minimum. Over time, the support for
128 %\pf{HA-prosper} via the mailinglist will be minimized and users are
129 %advised to use \pf{powerdot} for new presentations.
130 %
131 %Further, information in this documentation was up to date in 2004,
132 %but might be outdated by now. The reason of not updating this is
133 %that since then all efforts have concentrated on the \pf{powerdot}
134 %class.
135 %
136 %\subsection{Compatibility}
137 %This section discusses compatibility issues between \pf{HA-prosper}
138 %and some other packages. The \pf{HA-prosper} package has been
139 %created and tested in an environment of MiKTeX 2.3 \cite{MiKTeX} and
140 %GhostScript 8.00 \cite{GhostScript} and newer versions of that
141 %software.
142 %
143 %\subsubsection{prosper}
144 %Since \pf{HA-prosper} is a patch for \pf{prosper}, it is important
145 %that you have the right version of \pf{prosper} which is 1.5
146 %(|prosper.cls| version 1.24)\footnote{This package is also
147 %compatible to the CVS version 1.25 of \pf{prosper}, but that
148 %version is still in beta stage and it is advisory not to use it.
149 %If you still want to use version 1.25 because of v\TeX\ support,
150 %delete or comment line 88 of |prosper.cls| then, namely were the
151 %\pf{pstcol} package is loaded, since that causes colors not to be
152 %defined properly.}. This is the CTAN version \cite{prosperCTAN}.
153 %
154 %\subsubsection{ppr-prv}
155 %A very nice package in combination with \pf{HA-prosper} is the
156 %`Prosper Preview' class, \pf{ppr-prv} \cite{ppr-prv}, created by
157 %Mathieu Goutelle \cite{Mathieu}. The aim of this class is to produce
158 %a printable version of the slides written with \pf{prosper} or
159 %\pf{HA-prosper} with two slides (or more at will) per page and a
160 %table of contents on the first page in case you are using
161 %\pf{HA-prosper}. Table~\ref{tab:pprpprvcompat} shows which versions
162 %of \pf{ppr-prv} and \pf{HA-prosper} are compatible. Each row of the
163 %table lists the compatible versions.
164 %\begin{table}[ht]
165 %\centering\caption{Compatible versions of \pf{HA-prosper} and
166 %\pf{ppr-prv}.}\label{tab:pprpprvcompat}
167 %\begin{tabular}{f}
168 %\pf{HA-prosper}&\pf{ppr-prv}&\pf{HA-prosper}&\pf{ppr-prv}\\\hline\hline
169 %3.7x&0.09&3.8&0.10\\\hline
170 %3.9&0.11&4.0&0.12\\\hline
171 %4.11&0.13&4.2&0.13\\\hline\hline
172 %\end{tabular}
173 %\end{table}
174 %
175 %\subsubsection{semcolor/pstcol/pstricks/color/xcolor}
176 %Recently, the incompatibilities of these packages have been solved
177 %and through a modification of \pf{semcolor}, the improved
178 %compatibility is also available to \pf{HA-prosper} users. Check the
179 %documentation of these packages to see whether or not your \LaTeX\
180 %distribution already includes the compatible versions. If so, then
181 %you can use both \pf{pstricks} color commands in your presentation
182 %or style as well as \pf{xcolor} commands.
183 %
184 %\subsubsection{babel}
185 %\pf{HA-prosper} redefines the |itemize| and the |enumerate|
186 %environments at the beginning of the document. This solves a bug
187 %that would otherwise occur when using the \pf{babel} package with
188 %the |french| option. The \pf{prosper} macro
189 %|\NoFrenchBabelItemize| is obsolete in \pf{HA-prosper} and has
190 %no function anymore. The order of loading the packages is
191 %important since \pf{HA-prosper} attempts to redefine some
192 %\pf{babel} macros. In case you want to use \pf{babel}, load
193 %\pf{babel} first and afterwards \pf{HA-prosper}.
194 %
195 %\subsubsection{Miscellaneous}
196 %Older versions of GhostScript might produce ugly display text and
197 %logo's. However, prints are fine in general. Furthermore, it has
198 %been shown that Acrobat Reader 4 \cite{AcroRead} generally does not
199 %display pictures properly.
200 %
201 %Since the |overlays| macro is not recognized by Scientific
202 %WorkPlace \cite{SWP}, this program is not supported. The advice is
203 %to use an editor for creating the slides, for example WinEdt
204 %\cite{WinEdt} or TexNicCenter \cite{TexNicCenter} (free).
205 %
206 %\subsection{Installation}\label{sec:inst}
207 %This package is included in the MiKTeX distribution \cite{MiKTeX}
208 %and in TeXLive \cite{TeXLive} and can be installed for you by
209 %these programs. However, if you downloaded this package from the
210 %\pf{HA-prosper} website \cite{HA-prosper} or from the
211 %\pf{HA-prosper} CTAN directory \cite{HA-prosperCTAN}), then here
212 %are some hints for installing the package into your \LaTeX\
213 %distribution.
214 %
215 %The package includes pre-generated run and doc files, but you can
216 %reproduce them from the source if necessary. See the first lines
217 %of |HA-prosper.dtx| for information how to do this. The files
218 %in |Doc| should go into the |doc| tree of your distribution,
219 %the files in |Run| into the |tex| run tree and the files in
220 %|Source| into the |source| tree. See the documentation of
221 %your \LaTeX\ distribution for information on installing
222 %\pf{HA-prosper} into your \LaTeX\ distribution or the TeX
223 %Frequently Asked Questions \cite{TeXFAQInst}.
224 %
225 %If you choose not to install the package into your \LaTeX\
226 %distribution, you can copy the necessary files (that is, the run
227 %files of \pf{HA-prosper} in the |Run| directory and the
228 %necessary files of the particular style, which can all be found in
229 %the relevant subdirectory of the |Run| directory) into your
230 %working directory.
231 %
232 %\subsection{Document set up}\label{sec:setup}
233 %The structure of a presentation created with \pf{HA-prosper} is
234 %comparable to that of a \pf{prosper} presentation. See the
235 %\pf{prosper} documentation for an overview.
236 %
237 %Do not forget to include
238 %\begin{verbatim}
239 %\usepackage[style,options]{HA-prosper}
240 %\end{verbatim}
241 %directly after the \pf{prosper} document class command to be able
242 %to use the new definitions provided in |HA-prosper.sty|. Here
243 %|style| is the style you want to use, for instance |HA|, and
244 %|options| are any package options which will be described in
245 %section~\ref{sec:new}. A summary of these options can be found in
246 %section~\ref{sec:packageoptions}.
247 %
248 %\DescribeMacro{\HAPsetup}
249 %You can set up certain features like footers and types of stepping
250 %environments globally (holding for the entire presentation, unless
251 %specified otherwise locally) using |\HAPsetup|, for instance
252 %\begin{verbatim}
253 %\HAPsetup{rf={My presentation},trans=Dissolve}
254 %\end{verbatim}
255 %This command can set up the features that you will be discussed in
256 %section~\ref{sec:new}. You can find a summary in
257 %section~\ref{sec:globals}.
258 %
259 %\subsection{Summary of package options}\label{sec:packageoptions}
260 %Table~\ref{tab:packageoptions} contains a summary of all package
261 %options of \pf{HA-prosper}. The numbers in between brackets are
262 %the sections where you can find more information about a specific
263 %option. See section~\ref{sec:setup} how to use these options.
264 %\begin{table}[ht]
265 %\caption{\pf{HA-prosper} package
266 %options.}\label{tab:packageoptions}\makebox[\textwidth][r]{
267 %\begin{tabular}{d}
268 %\hline\hline
269 %|sounds|& Turns on the |sound| key for slide environments (\ref{sec:slide}).\\\hline
270 %|toc|& Creates a table of contents on slides (\ref{sec:toc}).\\\hline
271 %|highlight|& Highlights the current slide in the table of contents (\ref{sec:tochl}).\\\hline
272 %|hlsections|& Highlights the current section on every slide within the section (\ref{sec:tochl}).\\\hline
273 %|portrait|& Creates portrait slides (\ref{sec:portrait}).\\\hline
274 %|notes|& Includes the notes in your presentation (\ref{sec:notes}).\\\hline
275 %|notesonly|& Includes only the notes in your presentation (\ref{sec:notes}).\\\hline
276 %|slidesonly|& Includes only the slides in your presentation (\ref{sec:notes}).\\\hline
277 %|blackslide|& Includes a black slide at the start of the presentation (\ref{sec:blslide}).\\\hline
278 %\hline
279 %\end{tabular}}
280 %\end{table}
281 %
282 %\subsection{Summary of global options}\label{sec:globals}
283 %Table~\ref{tab:hapsetupfeats} lists all the features of
284 %\pf{HA-prosper} that can be set using |\HAPsetup|. The numbers
285 %in between brackets are the sections where you can find more
286 %information about a specific feature. See section~\ref{sec:setup}
287 %how to use these global options.\par
288 %\begin{table}[ht]\caption{Global
289 %\pf{HA-prosper} options for \ci{HAPsetup}.}\label{tab:hapsetupfeats}
290 %\makebox[\textwidth][r]{
291 %\begin{tabular}{e}\hline\hline
292 %|lf|&Left footer (\ref{sec:footers}).&|sound|&Transition sound (\ref{sec:slide}).\\\hline
293 %|rf|&Right footer (\ref{sec:footers}).&|template|&Template for parts (\ref{sec:part}).\\\hline
294 %|sn|&Slide number layout (\ref{sec:footers}).&|stype|&Stepping environment type (\ref{sec:iestep}).\\\hline
295 %|tsnav|&Title slide navigation (\ref{sec:navs}).&|sstart|&Starting overlay (\ref{sec:iestep}).\\\hline
296 %|nsnav|&Normal slide navigation (\ref{sec:navs}).&|iacolor|&Inactive color (\ref{sec:iestep}).\\\hline
297 %|trans|&Transition effect (\ref{sec:slide}).&|counters|&Protect custom counters (\ref{sec:numbering}).\\\hline\hline
298 %\end{tabular}}
299 %\end{table}
300 %The features listed in table~\ref{tab:hapsetupfeats} all have a
301 %default value, which are discussed in the relevant sections. These
302 %values are defined in the file |HA-prosper.cfg|. This file can
303 %be modified. Modifications will have an effect on all
304 %presentations created using \pf{HA-prosper}\footnote{Note that the
305 %defaults saved in the |HA-prosper.cfg| file at the moment of
306 %installation are also saved in |HA-prosper.sty|. In case you
307 %accidentally delete a line in the |HA-prosper.cfg| file, the
308 %predefined defaults in |HA-prosper.sty| will be used.}.
309 %
310 %\subsection{Compilation}\label{sec:compile}
311 %If you use the |pdf| option in the |\documentclass|, compile with
312 %LaTeX2DVI - DVI2PS - PS2PDF to create slides with animations
313 %(incrementally displayed items created by the |itemstep|
314 %environment) that can be projected using for instance Acrobat Reader
315 %\cite{AcroRead}. Notice that \pf{HA-prosper} is build to work with
316 %papertype |letter| in the DVI2PS step (which is the default in the
317 %MiKTeX distribution and which can be achieved by adding |-t letter|
318 %to the command line of |dvips|), but the |Fyma| style supports |A4|
319 %paper as well. See section~\ref{sec:supportt}.
320 %
321 %If you want to print the slides, use the |ps2pdf| option and
322 %compile them with LaTeX2DVI - DVI2PS - PS2PDF and you can print
323 %the slides without animations.
324 %
325 %You can also use the Acrobat Distiller (included in Acrobat
326 %\cite{Acrobat}) to create the PDF from the PS file. This creates
327 %very efficient PDF files. Also see section~\ref{sec:result}. Do
328 %not forget to specify the \pf{prosper} class option `distiller' in
329 %this case to avoid errors when distilling the PS document. For
330 %instance
331 %\begin{verbatim}
332 %\documentclass[pdf,distiller]{prosper}
333 %\end{verbatim}
334 %
335 %If you prefer to use GhostView \cite{GhostView} for printing
336 %purposes, you can of course suffice with LaTeX2DVI - DVI2PS and
337 %print the slides form GhostView\footnote{You might have to shrink
338 %pages to fit the paper when printing the slides.}.
339 %
340 %A nice option for the `documentclass' is `draft'. This is provided
341 %by \pf{prosper} and speeds up the process of compiling and
342 %viewing the presentation by leaving out images. Deleting the
343 %option produces a presentation that includes all images again. See
344 %the \pf{prosper} class documentation for more details.
345 %
346 %\subsection{Upgrade information}
347 %This section contains information how to change your presentation
348 %in case you worked with an earlier version of \pf{HA-prosper}
349 %before and want to upgrade it. The list below contains the hints
350 %for upgrading with a single version step at a time. If you for
351 %instance want to upgrade from version 3.5 to the latest version,
352 %read all the entries in the list starting from the entry right the
353 %entry of version 3.5. If a particular version is not mentioned,
354 %this means that no changes need to be made to adapt the
355 %presentation to that version when starting at the last version
356 %before.
357 %
358 %\begin{itemize}
359 %\item[\fbox{3.0}] From \pf{HA-prosper} version 3.0, the
360 %package is based on the CTAN version of \pf{prosper}. This means
361 %that a separate version of \pf{prosper} is not distributed with
362 %this package anymore. If you used \pf{HA-prosper} before, replace
363 %the old style-file with the new one to upgrade to the latest
364 %version of \pf{HA-prosper} and do not forget to rename or delete
365 %prosper.cls in the working directory. \item[\fbox{3.5}] From
366 %version 3.5 of \pf{HA-prosper} the style definitions (template)
367 %will be loaded by \pf{HA-prosper}, not by \pf{prosper} anymore.
368 %This is done to avoid conflict when trying to use \pf{HA-prosper}
369 %templates with \pf{prosper}. Delete the style from the
370 %|\documentclass| command and put it in the |\usepackage|
371 %command of \pf{HA-prosper} when updating \pf{HA-prosper}. See also
372 %section~\ref{sec:inst}.
373 %\item[\fbox{3.6x}]\begin{itemize} \item When upgrading to
374 %\pf{HA-prosper} version 3.6, you might need to delete the
375 %|.toc| file of an existing presentation first since table
376 %of contents commands have changed and the new \pf{HA-prosper}
377 %is not able to understand the old commands. \item The
378 %|\email| and |\institution| commands have changed.
379 %In earlier version, defining them in the preamble of your
380 %presentation would make them appear on the title slide. Now, you
381 %have to put them inside the |\author| command. See
382 %section~\ref{sec:eia} for an example.
383 %\end{itemize}
384 %\item[\fbox{3.7x}]\begin{itemize} \item Download the full package
385 %to use the latest versions of the styles that are compatible to
386 %this version of \pf{HA-prosper}. \item Rename
387 %|\section| and |\sectionandpart| to
388 %|\tsection| and |\tsectionandpart| respectively.
389 %\end{itemize}
390 %\item[\fbox{3.8}]\begin{itemize} \item Download the full package
391 %to use the latest versions of the styles that are compatible to
392 %this version of \pf{HA-prosper}. \item Rename
393 %|\figureitem| to |\hiddenitem|. See
394 %section~\ref{sec:xitemwait}.\item Change slides that use the
395 %|dualslide| environment to for instance a normal
396 %|slide| and use the |\dualslide| macro to create a
397 %dualslide on that slide. See
398 %section~\ref{sec:dualslide}.\end{itemize}
399 %\item[\fbox{3.9}]
400 %\begin{itemize} \item |\figureitem| and
401 %|\putfigureitem| are no longer supported;
402 %|\putfigure| should be replaced by the more general
403 %|\topbl|, see section~\ref{sec:xitemwait}. \item The
404 %dualslide dimensions have changed a bit, see
405 %section~\ref{sec:dualslide}.\item More optional arguments for the
406 %|itemstep| environment are available now, see
407 %section~\ref{sec:iestep}.
408 %\end{itemize}
409 %\item[\fbox{4.0}]
410 %\begin{itemize} \item
411 %Commands |\TitleSlideNav|, |\NormalSlideNav|, |\LeftFoot|
412 %and |\RightFoot| are obsolete but still supported. You can use
413 %|\HAPsetup| instead, see section~\ref{sec:globals}.
414 %\item Some style commands have changed but backward
415 %compatibility is provided, see section~\ref{sec:styledev}.
416 %\item |\onSlide| and |\OnSlide| are provided but the \pf{prosper}
417 %macros |\fromSlide|, |\FromSlide|, |\untilSlide|, |\UntilSlide|,
418 %|\onlySlide| and |\OnlySlide| still work, see section~\ref{sec:onslide}.
419 %\item Toc behavior has changed a little bit. Empty slide titles
420 %will now produce empty toc entries and empty bookmarks. Deleting
421 %these happens by using respectively |toc=| and |bm=| (see section~\ref{sec:toc}).
422 %\end{itemize}
423 %\item[\fbox{4.1x}]
424 %\begin{itemize}
425 %\item \pf{HA-prosper} now uses \pf{xkeyval} \cite{xkeyvalCTAN}. Install
426 %this package to work with \pf{HA-prosper}.
427 %\item
428 %|\topbl| has been deleted. The macro can be found on the \TeX\ FAQ \cite{TeXFAQTop}.
429 %\item Replace |\item| by |\xitem| (see section~\ref{sec:xitem}).
430 %\item Replace |\hiddenitem| by |\xitemwait| (see section~\ref{sec:xitemwait}).
431 %\item When using |Lakar| style, replace |emptyslide| environments by
432 %|partslide| environments (see section~\ref{sec:wpe}).
433 %\end{itemize}
434 %\item[\fbox{4.2x}] No changes to presentations necessary.
435 %\end{itemize}
436 %
437 %\clearpage\section{New or changed environments and
438 %commands}\label{sec:new} This section describes the new commands
439 %provided by \pf{HA-prosper} and the originally \pf{prosper} commands
440 %that have been extended. The section assumes knowledge of the
441 %\pf{prosper} documentation.
442 %
443 %\subsection{The slide environment}\label{sec:slide}
444 %\DescribeEnv{slide}
445 %A slide is created using the |slide| environment. For instance
446 %\begin{verbatim}
447 %\begin{slide}[trans=Replace]{Sample slide}
448 %...
449 %\end{slide}
450 %\end{verbatim}
451 %The new |slide| environment has four options. They are
452 %listed in table~\ref{tab:slide}.
453 %\begin{table}[ht]
454 %\caption{Slide environment options.}\label{tab:slide}
455 %\makebox[\textwidth][r]{
456 %\begin{tabular}{d}\hline\hline
457 %|toc|&When specified, it will be used for the table of contents. When not\\
458 %&specified, the slide title will be used to create a toc entry (see section~\ref{sec:toc}).\\\hline
459 %|bm|&When specified, it will be used to create a bookmark. If not, the slide\\
460 %&title will be used as a bookmark.\\\hline
461 %|trans|&Slide transition effect (see the \pf{prosper} documentation) Default: |Replace|.\\\hline
462 %|sound|&Specify a sound file to be played when the slide is displayed.\\\hline
463 %\hline
464 %\end{tabular}}
465 %\end{table}
466 %Some remarks need to be made. First of all, when you supply an
467 %empty string as bookmark (so |bm=|), the bookmark will not be
468 %created. A similar thing holds for empty toc strings (|toc=|).
469 %See section~\ref{sec:toc}. The bookmark option is supplied to
470 %provide low level text for creating a bookmark in case you want
471 %the slide title to contain \LaTeX\ commands which might not be
472 %convertable to bookmarks\footnote{Note that the bookmarking
473 %procedure uses \ci{pdfstringdef} of \pf{hyperref} which is able
474 %to process things like \ci{"i}.}. For instance:
475 %\begin{verbatim}
476 %\begin{slide}[bm=Important!]{\red Important!}
477 %\end{verbatim}
478 %
479 %\DescribeSwitch{sounds}
480 %Second, adding transition sounds to a presentation is possible,
481 %but it is important to know that the sounds will not be embedded
482 %in the presentation and hence need to be supplied separately.
483 %Further, the presentation becomes system dependent by using
484 %sounds. It depends on the target machine if the specific sound
485 %file can be played or not. To switch on the use of sounds in your
486 %presentation, use the package option |sounds|, see
487 %section~\ref{sec:packageoptions}.
488 %
489 %The options |trans| and |sound| can be set globally by |\HAPsetup|
490 %(see section~\ref{sec:globals})\footnote{Notice that backward
491 %compatibility for \ci{DefaultTransition} is provided.}. The |sound|
492 %slide option adds the transition sound to all slides within
493 %|\overlays|. For more flexibility, the sound option also has a user
494 %interface to set sounds on pages directly. The sound file
495 %\DescribeMacro{\SlideSound}
496 %|sound.wav| is added using |\SlideSound| as follows.
497 %\begin{verbatim}
498 %\SlideSound{sound.wav}
499 %\end{verbatim}
500 %This code adds a transition sound to the first overlay only:
501 %\begin{verbatim}
502 %\onSlide*{1}{\SlideSound{sound.wav}}
503 %\end{verbatim}
504 %(see also section~\ref{sec:onslide} for the use of |\onSlide|).
505 %
506 %\subsection{Structuring the presentation}\label{sec:toc}
507 %\subsubsection{Building a table of contents}
508 %\DescribeSwitch{toc}
509 %You can include a table of contents on each slide. This can be
510 %used for navigational purposes during the presentation. When
511 %printing the slides, you might decide to leave out the table of
512 %contents. You can request a table of contents by specifying the
513 %option |toc| in the |\usepackage| command for the style
514 %file, like
515 %\begin{verbatim}
516 %\usepackage[toc,HA]{HA-prosper}
517 %\end{verbatim}
518 %(see also the examples in this distribution). \pf{HA-prosper} will
519 %use slide titles by default to produce the table of contents, but
520 %this behavior can be changed (see section~\ref{sec:slide}).
521 %
522 %Some remarks. First of all, the table of contents will of course
523 %only be put on the slides when it has been implemented in the style
524 %that you are using. See section~\ref{sec:supportt}. Second,
525 %\pf{HA-prosper} offers possibilities for style developers to split
526 %the table of contents into two parts the first of which will contain
527 %the sections and the second will contain the content of the current
528 %section.
529 %
530 %Third, if you specify an empty string as toc entry (so |toc=|),
531 %the toc entry will be deleted from the table of contents. This
532 %allows for building an overview of your presentation. Hence the
533 %table of contents can both be used for navigational purposes (like
534 %the bookmarks) and to provide an overview of the presentation.
535 %
536 %Finally, as with a usual table of contents in \LaTeX, you need to
537 %run your presentation at least twice after altering slides or toc
538 %entries. On the first pass, the table of contents will be updated
539 %and on the second run, the new table of contents will be included
540 %in the presentation.
541 %
542 %\subsubsection{Highlighting table of contents entries}\label{sec:tochl}
543 %\DescribeSwitch{highlight}
544 %If you want to highlight the current slide or the slide created by
545 %a |\part| or |\tsectionandpart| command (see section~\ref{sec:pas})
546 %in the table of contents, specify the
547 %|highlight| option, like
548 %\begin{verbatim}
549 %\usepackage[toc,highlight,HA]{HA-prosper}.
550 %\end{verbatim}
551 %Of course, the |highlight| option only takes effect when
552 %also the |toc| option has been specified (and of
553 %course the style you are using should support highlighting and the
554 %table of contents). This |highlight| option can be nice
555 %for both yourself and the audience since everyone can clearly see
556 %on which slide or in which section of the presentation you are.
557 %
558 %\DescribeSwitch{hlsections}
559 %An extra option is the |hlsections| option. This will make the
560 %current section highlighted on every slide within the current
561 %section. This can be especially useful when sections and section
562 %content are split in the style that you use, which would otherwise
563 %result in unclarities about the current section\footnote{Splitting
564 %of the table of contents is often implemented on portrait
565 %templates.}. When the table of contents is not split up, this option
566 %might be left out since in this case, the hierarchical structure of
567 %the table of contents clearly identifies the current section.
568 %
569 %\subsection{Parts and sections}\label{sec:pas}
570 %\subsubsection{tsection}\label{sec:section}
571 %\DescribeMacro{\tsection}
572 %By using the |\tsection|
573 %command, it is possible to divide the table of contents in several
574 %sections. The content of a section will be hidden until you access
575 %a slide inside this section. The section heading in the table of
576 %contents itself refers to the first slide after the section
577 %command. The section command should be used between slides. The
578 %following shows an example.
579 %\begin{verbatim}
580 %\begin{slide}{First slide}
581 %Some text
582 %\end{slide}
583 %
584 %\tsection[Bookmark for section 1]{Section 1}
585 %
586 %\begin{slide}{Second slide}
587 %Some text
588 %\end{slide}
589 %\end{verbatim}
590 %The optional argument of the |\tsection| macro can be used
591 %to specify the string to be used for the bookmark. Notice that all
592 %slides that are met before issuing the first |\tsection|
593 %command will always be displayed in the table of contents.
594 %Exceptions hold for two cases. The first is when issuing an empty
595 %string as toc entry in the |slide| environment (see
596 %section~\ref{sec:slide}). The second is when the style that you
597 %are using implements a split table of contents. In this case, the
598 %content of every new section will replace the content of the old
599 %section when going from the old section to the new section. The
600 %entries before the first section will then be replaced by the
601 %entries of the first section when advancing to that section.
602 %
603 %\DescribeMacro{\tsection*}
604 %Furthermore, |\tsection*| is available. It has the exact same
605 %possibilities as |\tsection|, but this command hides the section
606 %created by |\tsection*| completely until you enter it (for instance
607 %with a hyperlink to a slide, by using bookmarks or by browsing the
608 %slides). This can be useful if you want to include slides in your
609 %presentation, that you don't want to show in the table of contents,
610 %but which you could include into the presentation if you see that
611 %you have some time left. But there are of course other applications
612 %thinkable.
613 %
614 %\subsubsection{part}\label{sec:part}
615 %\DescribeMacro{\part}
616 %The |\part| command lets you identify separate parts in your
617 %presentation. The command |\part{Part I}| produces a normal slide
618 %with horizontally centered the words `Part I'. The argument will
619 %also be used to create a bookmark and a toc entry (if a table of
620 %contents is requested). The |\part| takes the same options as the
621 %|slide| environments (see section~\ref{sec:slide}), but it should be
622 %noted that in case you specify an empty string for the |bm| option,
623 %the part title will be used to create the bookmark.
624 %
625 %An additional option for the |\part| command is the
626 %|template| option. This allows to select a different
627 %template (supplied by the style that you use) for the slide
628 %created by the |\part| command. For instance, the HA-style
629 %supplies the template `wideslide'. You can use that template for
630 %the part to delete the table of contents from that particular
631 %slide. Example:
632 %\begin{verbatim}
633 %\part[template=wideslide,toc=Part number one,bm=The first part]{Part I}
634 %\end{verbatim}
635 %
636 %Note that the option |template| can be set globally for the entire
637 %presentation (see section~\ref{sec:globals}). The default value of
638 %|template| is |slide|.
639 %
640 %\subsubsection{tsectionandpart}\label{sec:secandpart}
641 %\DescribeMacro{\tsectionandpart}
642 %The
643 %|\tsectionandpart| command is a combination of the
644 %|\tsection| command (see section~\ref{sec:section}) and the
645 %|\part| command (see section~\ref{sec:part}). This command
646 %is supplied since issuing the two previous commands after each
647 %other cannot replicate the output of |\tsectionandpart|.
648 %The command has the same optional arguments as the |\part|
649 %command and besides creating a slide, it also creates a section in
650 %the table of contents. The section heading in the table of
651 %contents will now refer to the slide created by the |\part|
652 %command.
653 %
654 %\DescribeMacro{\tsectionandpart*}
655 %Notice that |\tsectionandpart*| produces similar output as
656 %|\tsection*|. Namely, it hides the section in the table of
657 %contents completely until it is accessed by going to any slide
658 %within this section. See also section~\ref{sec:section}. As
659 %|\tsectionandpart|, it also creates a |\part| slide.
660 %
661 %\subsection{Dualslide}\label{sec:dualslide}
662 %\DescribeMacro{\dualslide}
663 %The |\dualslide| macro allows to split content into two
664 %columns. Usage:
665 %\begin{samepage}
666 %\begin{verbatim}
667 %\dualslide[opt1][opt2][opt3]{options}{left}{right}
668 %\end{verbatim}
669 %The parameters are explained in
670 %table~\ref{tab:dspars}.\end{samepage}\par
671 %\begin{table}[ht]\centering
672 %\caption{Dualslide parameters.}\label{tab:dspars}
673 %\begin{tabular}{d}
674 %\hline\hline
675 %|opt1|& Any \pf{PSTricks} options to change the style of the\\
676 %&(optional) left frame. Example: |linestyle=dotted|.\\\hline
677 %|opt2|& Idem for the line in between the two columns.\\\hline
678 %|opt3|& Idem for the right column.\\\hline
679 %|options|& Options for the dualslide, see table~\ref{tab:dsoptions}.\\\hline
680 %|left|& The content for the left column.\\\hline
681 %|right|& The content for the right column.\\\hline\hline
682 %\end{tabular}
683 %\end{table}
684 %\begin{table}[ht]
685 %\caption{Dualslide options.}\label{tab:dsoptions}
686 %\makebox[\textwidth][r]{
687 %\begin{tabular}{d}
688 %\hline\hline
689 %|lineheight|& If |lineheight| is specified, a line of the specified height will be created\\
690 %&using \ci{psline} in between the two columns. Example: |lineheight=6cm|.\\\hline
691 %|lfrheight|& Creates a frame of the specified height around the left column.\\\hline
692 %|rfrheight|& Creates a frame of the specified height around the right column.\\\hline
693 %|frsep|& Space between text and the frames. Default: |1.5mm|.\\\hline
694 %|colsep|& Space between the two columns. Default: |0.06|\ci{linewidth}.\\\hline
695 %|lcolwidth|& Width of the left column. Default: |0.47|\ci{linewidth}.\\\hline
696 %|rcolwidth|& Width of the right column. Default: |0.47|\ci{linewidth}.\\\hline
697 %|topsep|& The extra space (additional to \ci{baselineskip}) between text above\\
698 %&the columns and the text within the columns. Default: |0cm|.\\\hline
699 %|bottomsep|& Idem for the bottom of the columns. Default: |0cm|.\\\hline
700 %|indent|&Horizontal indent left to the left column. Default: |0cm|.\\\hline\hline
701 %\end{tabular}}
702 %\end{table}
703 %The dimensions described in table~\ref{tab:dsoptions} are
704 %represented graphically in figure~\ref{fig:dsldim}.
705 %\begin{figure}[ht]
706 %\centering\caption{Dualslide dimensions.}\label{fig:dsldim}
707 %\pspicture(0,.5)(13,10.5)
708 %\psline(0,0.5)(0,10)
709 %\rput[tl](.05,9.95){Top}
710 %\psframe[dimen=middle](1,9)(7,2)
711 %\psline{C-C}(8.5,9)(11,9)
712 %\psline{C-C}(8.5,2)(8.5,9)
713 %\psline{C-C}(8.5,2)(11,2)
714 %\qdisk(1.7,8.3){.1cm}
715 %\psset{linestyle=dashed}
716 %\psline{C-C}(1.7,8.3)(6.3,8.3)
717 %\psline{C-C}(1.7,8.3)(1.7,3)
718 %\psline{C-C}(6.3,5)(6.3,8.3)
719 %\psline{C-C}(11,9)(12,9)
720 %\psline{C-C}(11,2)(12,2)
721 %\psline{C-C}(11,7)(12,7)
722 %\psline{C-C}(9.2,8.3)(12,8.3)
723 %\psline{C-C}(9.2,8.3)(9.2,3)
724 %\rput[tl](1.75,8.25){Left column text}
725 %\rput[tl](9.25,8.25){Right column text}
726 %\rput[tl](.05,1){Bottom}
727 %\psset{linestyle=dotted,dotsep=2pt}
728 %\psline(0,8.3)(1.7,8.3)
729 %\psline(0,9.6)(1,9.6)
730 %\psline(0,2)(1,2)
731 %\psline(0,1.1)(1,1.1)
732 %\psset{linestyle=solid}
733 %\psline{<->}(.2,8.33)(.2,9.57)
734 %\psline{<->}(4,8.33)(4,8.97)
735 %\psline{<->}(1.73,7)(6.27,7)
736 %\psline{<->}(1.03,6.5)(1.67,6.5)
737 %\psline{<->}(0.03,5.5)(1.67,5.5)
738 %\psline{<->}(6.33,7.4)(9.17,7.4)
739 %\psline{<->}(8.53,6.5)(9.17,6.5)
740 %\psline{<->}(6.33,6.5)(6.97,6.5)
741 %\psline{<->}(10.7,8.33)(10.7,8.97)
742 %\psline{<->}(7.3,8.97)(7.3,2.03)
743 %\psline{<->}(.2,1.13)(.2,1.97)
744 %\psline{->}(1.7,9.3)(1.7,8.45)
745 %\psline{<-}(9.23,7)(11,7)
746 %\cput(4,6.6){\small 1}
747 %\cput(11.1,6.6){\small 2}
748 %\cput(8,7){\small 3}
749 %\cput(7.7,3){\small 4}
750 %\cput(4.4,8.65){\small 5}
751 %\cput(1.35,6.1){\small 5}
752 %\cput(8.85,6.1){\small 5}
753 %\cput(11.1,8.65){\small 5}
754 %\cput(6.65,6.1){\small 5}
755 %\cput(0.6,8.95){\small 6}
756 %\cput(0.6,5.1){\small 7}
757 %\cput(0.6,1.55){\small 8}
758 %\cput(1.7,9.6){\small 9}
759 %\endpspicture
760 %\begin{center}
761 %\begin{tabular}{c p{4cm}cl}
762 %\multicolumn{4}{c}{Meaning of the numbers}\\\hline
763 %1&|lcolwidth|&5&|frsep|\\
764 %2&|rcolwidth|&6&|topsep|\\
765 %3&|colsep|&7&|indent|\\
766 %4&|lfrheight|, |rfrheight|,&8&|bottomsep|\\
767 %&|lineheight|&9&Reference point
768 %\end{tabular}
769 %\end{center}
770 %\end{figure}
771 %Important to notice is that the |\dualslide| macro uses the
772 %current cursor position as the reference point to position the
773 %first line of text of the left column (see also
774 %figure~\ref{fig:dsldim}). This means that optional frames can
775 %extend to the text on the previous line. Use for instance
776 %|topsep=0.3cm| in that case to add extra space between the
777 %two lines of text. The default value of |topsep| is based
778 %on the situation that there is no text on top of the two columns.
779 %In that case, it is best to locate the first line of text of the
780 %left column at the same spot as text that is not created by
781 %|\dualslide| on other slides. The setting
782 %|topsep=0cm| does exactly this. However, with a combination
783 %of |topsep| and |indent| you can change this
784 %behavior and position the first line of text of the left column
785 %anywhere you want.
786 %
787 %The dualslide macro computes the height of the construction to
788 %position text below the construction correctly. The computation is
789 %done by taking the maximum height of |lfrheight|,
790 %|rfrheight|, |lineheight| (if requested) and the
791 %left and right column content. Hence when frames nor a line is
792 %requested, |bottomsep| is the vertical space between the
793 %lowest line of text in the columns and the text below the columns
794 %(additional to |\baselineskip|).
795 %
796 %Furthermore, if none of the optional arguments has been specified,
797 %|dualslide| will use the \pf{PSTricks} defaults for
798 %creating frames and the line. Two exceptions:
799 %|linewidth=.25pt| and |linecolor=HAP@framecolor| by
800 %default, but these can of course again be changed using the
801 %optional arguments. When only |opt1| has been specified,
802 %this is used globally for both frames and the line. When both
803 %|opt1| and |opt2| have been specified, |opt1|
804 %will be used for both frames and |opt2| will be used for
805 %the line. In case you want to change the properties of the right
806 %frame only, call for instance
807 %\begin{verbatim}
808 %\dualslide[ ][ ][linecolor=red]{rfrheight=6cm}{left content}{right content}
809 %\end{verbatim}
810 %
811 %More examples can be found in the example files of \pf{HA-prosper},
812 %see section~\ref{sec:examples}. Also have a look at
813 %section~\ref{sec:animating} for information about animating content.
814 %The commands described there can also be used to animated content in
815 %the two columns.
816 %
817 %\subsection{Animating content}\label{sec:animating}
818 %\subsubsection{itemstep and enumstep}\label{sec:iestep}
819 %\DescribeEnv{itemstep}
820 %\DescribeEnv{enumstep}
821 %The |itemstep| and |enumstep| environments are based
822 %on the |itemize| and |enumerate| environments
823 %respectively, but with these environments, items will be displayed
824 %incrementally. Available options can be found in
825 %table~\ref{tab:iestepopts}.
826 %\begin{table}[ht]
827 %\caption{Itemstep and enumstep
828 %options.}\label{tab:iestepopts}
829 %\makebox[\textwidth][r]{
830 %\begin{tabular}{d}
831 %\hline\hline
832 %|sstart|& Starts the stepping environment on overlay |sstart|. Default: 1.\\\hline
833 %|iacolor|& Inactive color, used for inactive items. Default: lightgray.\\\hline
834 %|stype|& Type of stepping environment. Default: 0. Possible:\\
835 %&0 -- items appear one by one, but remain active;\\
836 %&1 -- items appear one by one, but turn inactive when moving to the next item;\\
837 %&2 -- all items are displayed and only one is active at a time.\\
838 %\hline\hline
839 %\end{tabular}}
840 %\end{table}
841 %These environments can be nested into each other and lower level
842 %environments inherit options from higher level environments. The
843 %|sstart| option has effect only in the highest level stepping
844 %environment (which can be embedded in an |itemize| or |enumerate|
845 %environment). The items of an |itemize| environment, which is nested
846 %in a stepping environment, will inherit the state (active or not)
847 %from the item in the stepping environment to which the
848 %(sub)environment(s) belong to. If |itemize| or |enumerate| is used
849 %at the top level, all items are active on all overlays. Find an
850 %example below (for the meaning of |\xitem|, refer to
851 %section~\ref{sec:xitem}).
852 %\begin{verbatim}
853 %\overlays{6}{
854 %\begin{slide}{xitem example}
855 %Some text.
856 % \begin{itemstep}[sstart=2,stype=0,iacolor=gray]
857 % \xitem item 1
858 % \begin{enumstep}[stype=1] % inherits iacolor!
859 % \xitem item 1.1
860 % \xitem item 1.2
861 % \end{enumstep}
862 % \xitem item 2
863 % \xitem item 3
864 % \end{itemstep}
865 %\end{slide}
866 %}
867 %\end{verbatim}
868 %See section~\ref{sec:examples} for more examples and section
869 %\ref{sec:xitemwait} for a tool for these environments. The
870 %options for the stepping environments can also be set globally
871 %using the |\HAPsetup| macro (see section~\ref{sec:globals}).
872 %
873 %Note that the use of type 1 or 2 stepping environments requires
874 %the definition of the color |HAP@textc| by the template
875 %that you use. See section~\ref{sec:styledev}.
876 %
877 %\subsubsection{xitem}\label{sec:xitem}
878 %\DescribeMacro{\xitem}
879 %\pf{HA-prosper} defines a new command, |\xitem|, to be used within
880 %|itemize|, |enumerate|, |itemstep| and |enumstep| environments.
881 %Within |itemstep| and |enumstep| environments it will take care of
882 %the animation effect discussed in section~\ref{sec:iestep}. Within
883 %|itemize| and |enumerate| environments it will just display the
884 %content. Defining this command is necessary since redefining |\item|
885 %would damage macros and environments using |\item| (for instance
886 %|center|, |flushright|, |flushleft|).
887 %
888 %The |\xitem| macro also has a version in which it takes an optional
889 %value $n$ by doing |\xitem<n>|. This value is the extra number of
890 %overlays that the item should remain active in a stepping
891 %environment and is ignored in an |itemize| or |enumerate|
892 %environment. This optional argument can be useful when you want to
893 %add content to the current item on a later overlay. Notice that this
894 %can make several items active at a particular overlay. To avoid
895 %this, add |\xitemwait| before the next item. See the example below
896 %and section~\ref{sec:xitemwait}.
897 %\begin{verbatim}
898 %\overlays{3}{
899 %\begin{slide}{xitem example}
900 %\begin{itemstep}[stype=1]
901 % \xitem<1> Yes?
902 % \onSlide{2-}{No!}
903 % \xitemwait
904 % \xitem Because...
905 %\end{itemstep}
906 %\end{slide}
907 %}
908 %\end{verbatim}
909 %
910 %Note that a possibly unfamiliar syntax has been chosen for
911 %|\xitem<n>|. This done to easily support the other optional argument
912 %that comes with |\xitem| since it is an extension of the standard
913 %|\item|. The optional argument allows you to overwrite the item
914 %label, for instance |\xitem[a]| or |\xitem<1>[b]|. See your favorite
915 %\LaTeX\ manual for more information about the latter.
916 %
917 %\subsubsection{xitemwait}\label{sec:xitemwait}
918 %\DescribeMacro{\xitemwait}
919 %The command |\xitemwait| tells \pf{HA-prosper} to wait for one
920 %overlay before passing on to the next item in a stepping
921 %environment. The optional argument $n$ tells \pf{HA-prosper} to wait
922 %$n$ overlays before passing on to the next item. Example:
923 %\begin{verbatim}
924 %\overlays{5}{
925 %\begin{slide}{xitemwait example}
926 % \begin{itemstep}
927 % \xitem 1
928 % \xitem 2
929 % \xitemwait[2]
930 % \xitem 3
931 % \end{itemstep}
932 %\end{slide}
933 %}
934 %\end{verbatim}
935 %This might come in handy to animate custom content using |\onSlide|
936 %(see section~\ref{sec:onslide}) in dualslides
937 %(section~\ref{sec:dualslide}) in combination with stepping
938 %environments (section~\ref{sec:iestep}). Outside stepping
939 %environments, the macro has no effect.
940 %
941 %\subsubsection{onSlide and OnSlide}\label{sec:onslide}
942 %\DescribeMacro{\onSlide}
943 %The macro
944 %|\onSlide{overlays}{material}| displays |material| on the
945 %overlays listed in |overlays|. This can be a comma delimited
946 %list and the syntax explained in table~\ref{tab:osnot} can be
947 %used ($x$ and $y$ are positive integers with $y\geq x$).
948 %\begin{table}[ht]\centering
949 %\caption{Notation for \ci{onSlide}, \ci{onSlide*} and
950 %\ci{OnSlide}.}\label{tab:osnot}
951 %\begin{tabular}{d}\hline\hline
952 %$x$&Display material only on overlay $x$.\\\hline
953 %-$x$&Display material until and including overlay $x$.\\\hline
954 %$x$-&Display material from and including overlay $x$.\\\hline
955 %$x$-$y$&Display material from $x$ until $y$, including $x$ and $y$.\\\hline
956 %\hline
957 %\end{tabular}
958 %\end{table}
959 %When used inside an |itemstep| or |enumstep| environment, there is
960 %extra syntax available. This syntax follows the same rules as
961 %explained in table~\ref{tab:osnot}, but now $x$ and $y$ can start
962 %with a |+| sign. This sign can be used to animate content relative
963 %to the preceding |\xitem| in an |itemstep| or |enumstep|
964 %environment. Suppose that for instance the preceding |\xitem| of
965 %|\onSlide{+1-+2}{...}| will be displayed on overlay 6. Then the
966 %material of |\onSlide| will be displayed from overlay 7 to 8. Since
967 %this construct is relative, it is very easy to add to or delete
968 %items from the list without having to adapt all of the |\onSlide|
969 %commands that you used. See another example below.
970 %\begin{verbatim}
971 %\overlays{4}{
972 %\begin{slide}{onSlide example}
973 %\begin{itemstep}
974 % \xitem item 1
975 % \xitem item 2
976 % \begin{itemize}
977 % \xitem item 3 \onSlide{+1-}{and item 4}
978 % \end{itemize}
979 % \xitemwait
980 % \xitem item 5
981 %\end{itemstep}
982 %\end{slide}
983 %}
984 %\end{verbatim}
985 %
986 %The |\onSlide| macro collects and generalizes all the
987 %functionality of the \pf{prosper} macros |\onlySlide|,
988 %|\untilSlide| and |\fromSlide|. This macro advances the
989 %cursor position even if the material is not displayed. The stared
990 %version |\onSlide*| does not advance the cursor position in
991 %case the material is not displayed and collects the functionality
992 %of the \pf{prosper} macros |\onlySlide*|, |\untilSlide*| and
993 %|\fromSlide*|. Note that these macros can be nested into each
994 %other, which allows for the creation of more parsimonious
995 %structures (which will also become more complex). For instance,
996 %\begin{verbatim}
997 %\onSlide{-3,5-6,8,10-}{One}\onSlide{-2,6,8,10-}{Two}\onSlide{2,8,10-}{Three}
998 %\end{verbatim}
999 %and
1000 %\begin{verbatim}
1001 %\onSlide{-3,5-6,8,10-}{One\onSlide{-2,6-}{Two\onSlide{2,8-}{Three}}}
1002 %\end{verbatim}
1003 %produce the same output. The following example demonstrates the
1004 %difference between |\onSlide| and |\onSlide*|:
1005 %\begin{verbatim}
1006 %\onSlide{1}{One}\onSlide{2}{Two}\onSlide{3-}{Three}\par
1007 %\onSlide*{1}{One}\onSlide*{2}{Two}\onSlide*{3-}{Three}
1008 %\end{verbatim}
1009 %
1010 %\DescribeMacro{\OnSlide}
1011 %The macro |\OnSlide{overlays}| also accepts the same syntax as the
1012 %|\onSlide| macro and can be used to display or not all of the
1013 %following material on a slide after the |\OnSlide| macro. This macro
1014 %collects the functionality of the \pf{prosper} macros |\OnlySlide|,
1015 %|\UntilSlide| and |\FromSlide|.
1016 %Example:
1017 %\begin{verbatim}
1018 %\OnSlide{3-} All of this material will be displayed as from overlay 3.
1019 %\end{verbatim}
1020 %
1021 %\subsection{Numbering on overlays}\label{sec:numbering}
1022 %Mathieu Goutelle \cite{Mathieu} contributed a patch for the
1023 %|\overlays| macro which makes it possible to number equations,
1024 %tables and figures on overlays. This patch has been extended such
1025 %that you can also protect custom counters on overlays. For general
1026 %information about numbering, see your favorite \LaTeX\ book for
1027 %more information.
1028 %
1029 %The |counters| option for |\HAPsetup| (section~\ref{sec:globals})
1030 %can be used to list the counters that should be protected. For instance,
1031 %\begin{verbatim}
1032 %\newtheorem{mytheorem}{Theorem}
1033 %\newtheorem{myproof}{Proof}
1034 %\HAPsetup{counters={mytheorem,myproof}}
1035 %\end{verbatim}
1036 %in your preamble, will let you safely do
1037 %\begin{verbatim}
1038 %\overlays{3}{
1039 %\begin{slide}{Proof}
1040 % \begin{myproof}
1041 % Suppose that:
1042 % \begin{equation}
1043 % x^2+y^2=z^2
1044 % \end{equation}
1045 % then\dots
1046 % \end{myproof}
1047 %\end{slide}
1048 %}
1049 %\end{verbatim}
1050 %The counters |figure|, |equation| and |table| are protected
1051 %on overlays by default. The |counters| option for |\HAPsetup|
1052 %lists the additional counters that should be protected. Notice that
1053 %the counter that you want to protect needs to exist when issuing
1054 %|\HAPsetup| to set the protected counters.
1055 %
1056 %\subsection{Portrait slides}\label{sec:portrait}
1057 %\DescribeSwitch{portrait}
1058 %If a template supports portrait slides, you can access these by
1059 %specifying the |portrait| option in the |\usepackage| command
1060 %like
1061 %\begin{verbatim}
1062 %\usepackage[toc,portrait,HA]{HA-prosper}.
1063 %\end{verbatim}
1064 %When requesting portrait slides, a template will give an error if
1065 %it does not support portrait slides. See
1066 %section~\ref{sec:supportt} for the templates that support portrait
1067 %slides. When using portrait slides, the |hlsections| option might
1068 %be useful for you, see section~\ref{sec:tochl}.
1069 %
1070 %\subsection{Notes}\label{sec:notes}
1071 %\DescribeEnv{notes}
1072 %The \pf{HA-prosper} package provides a way to make notes in
1073 %your presentation. To include notes in the presentation that go
1074 %with a slide, start a |notes| environment after this slide.
1075 %For instance
1076 %\begin{verbatim}
1077 %\begin{slide}{First slide}
1078 %...
1079 %\end{slide}
1080 %
1081 %\begin{notes}{Notes for the first slide}
1082 %These are the notes for the first slide.
1083 %\end{notes}
1084 %\end{verbatim}
1085 %
1086 %\DescribeSwitch{slidesonly}
1087 %\DescribeSwitch{notesonly}
1088 %\DescribeSwitch{notes}
1089 %An additional option in the |\usepackage| command provides a
1090 %way to control the printing of notes and slides. Include at most
1091 %one of the following options.
1092 %\begin{itemize}
1093 %\item |slidesonly|: produces the slides only. This is the
1094 %default option. Use this to create the presentation that you want
1095 %to project. \item |notesonly|: produces the notes only.
1096 %\item |notes|: includes the notes in the presentation.
1097 %\end{itemize}
1098 %For instance
1099 %\begin{verbatim}
1100 %\usepackage[toc,notesonly,HA]{HA-prosper}
1101 %\end{verbatim}
1102 %
1103 %\textbf{Note}: If you want the notes only, first run the
1104 %presentation at least once with the option `notes' to create
1105 %correct labels for the notes page numbers. Once that is done, run
1106 %the presentation with the `notesonly' option to create the
1107 %notes\footnote{In case you use landscape slides, do not forget to
1108 %put Auto-Rotation of pages to `Individually' if you are using the
1109 %Acrobat Distiller to create the PDF. `Collectively by File' will
1110 %rotate will rotate notes to landscape just like the slides.}.
1111 %
1112 %\subsection{Bibliography}\label{sec:bib}
1113 %\DescribeEnv{thebibliography}
1114 %\pf{HA-prosper} redefines the standard \pf{article}
1115 %|thebibliography| environment to suppress the creation of a section
1116 %heading and running headers. All other properties are maintained.
1117 %Now you can do either of the next two (depending whether you are
1118 %using BiB\TeX\ or not):
1119 %\begin{center}
1120 %\begin{tabular}{p{7cm}p{5cm}}
1121 %\begin{verbatim}
1122 %\begin{slide}{slide 1}
1123 %\cite{someone}
1124 %\end{slide}
1125 %\begin{slide}{References}
1126 %\begin{thebibliography}{1}
1127 %\bibitem{someone} Article of someone.
1128 %\end{thebibliography}
1129 %\end{slide}
1130 %\end{verbatim}&
1131 %\begin{verbatim}
1132 %\begin{slide}{slide 1}
1133 %\cite{someone}
1134 %\end{slide}
1135 %\begin{slide}{References}
1136 %\bibliography{YourBib}
1137 %\end{slide}
1138 %\end{verbatim}
1139 %\end{tabular}
1140 %\end{center}
1141 %In case you have a big reference list that you want to spread over
1142 %multiple slides, have a look at the packages \pf{natbib} and
1143 %\pf{bibentry} \cite{natbibCTAN}. Using both packages allows you to
1144 %do:
1145 %\begin{verbatim}
1146 %\begin{slide}{References (1)}
1147 %\nobibliography{YourBib}
1148 %\bibentry{someone1}
1149 %\bibentry{someone2}
1150 %\end{slide}
1151 %\begin{slide}{References (2)}
1152 %\bibentry{someone3}
1153 %\end{slide}
1154 %\end{verbatim}
1155 %Have a look at your favorite \LaTeX\ documentation for more
1156 %information about citations and bibliographies.
1157 %
1158 %\subsection{Bookmarks}\label{sec:bookmarks}
1159 %\pf{HA-prosper} nests bookmarks within sections created by
1160 %|\tsection| and |\tsection*| (see section~\ref{sec:section}) and
1161 %|\tsectionandpart| and |\tsectionandpart*| (see
1162 %section~\ref{sec:secandpart}). On the first pass of a document,
1163 %bookmarks will be written to disk and will be read on the second
1164 %pass to create the bookmarks. This is necessary to identify the
1165 %number of slide bookmarks that should be nested within section
1166 %bookmarks.
1167 %
1168 %Notice that the bookmark of a |\tsection| (or
1169 %|\tsection*|) points to the first slide within the section,
1170 %just as the toc link generated by this section. Furthermore, as
1171 %|\part| does not create a toc section, it does not create a
1172 %bookmarks section. This allows for creating both a flat table of
1173 %contents as well as a flat bookmarks list.
1174 %
1175 %The nesting of bookmarks in sections is fully compatible to the
1176 %nesting of bookmarks of overlays subordinate to the bookmarks of
1177 %the first overlay of a slide. Bookmarks created by section
1178 %commands are open and the bookmarks of slides are closed by
1179 %default. You can change the latter by issuing the \pf{prosper}
1180 %command |\collapsedBookmarksfalse| in the preamble of your
1181 %presentation.
1182 %
1183 %\subsection{Black slide}\label{sec:blslide}
1184 %\DescribeSwitch{blackslide}
1185 %The package option |blackslide| creates a completely black
1186 %slide as the first slide of the presentation. The PDF-file will
1187 %start at page 2 when opened, the first real slide, so the black
1188 %slide will not be revealed. The slide has an embedded target
1189 %called `blackslide'. In the top left corner of the black slide, a
1190 %black button is positioned which performs the Acrobat menu option
1191 %`GoBack' when clicking it. This allows to temporarily stop the
1192 %presentation (for instance, to write something at the blackboard)
1193 %by clicking a hyperlink that points to the target `blackslide'.
1194 %When the writing it done, click in the top left corner of the
1195 %black slide to continue the presentation.
1196 %
1197 %\subsection{Footers}\label{sec:footers} The
1198 %footers can be defined by the |\HAPsetup| command (see
1199 %section~\ref{sec:globals})\footnote{Notice that backward
1200 %compatibility is provided for \ci{LeftFoot} and
1201 %\ci{RightFoot}.}, for instance
1202 %\begin{verbatim}
1203 %\HAPsetup{lf={Left footer},rf={Right footer}}
1204 %\end{verbatim}
1205 %The default values of |lf| and |rf| are empty strings. The
1206 %slide number layout can be specified by the |sn| option. The
1207 %default value of |sn| is\footnote{\ci{thepage}
1208 %contains the number of the current slide, \ci{totalpages} inserts
1209 %the total number of slides in the presentation and
1210 %\ci{ifallPages} is a conditional from \pf{prosper} which is false
1211 %if the \pf{prosper} class option |nototal| is specified by the
1212 %user.}
1213 %\begin{verbatim}
1214 %{-~p.~\thepage\ifallPages/\totalpages\fi}
1215 %\end{verbatim}
1216 % which resembles the standard \pf{prosper} layout.
1217 %\pf{HA-prosper} adds a space in between the text specified by
1218 %|rf| and the text specified by |sn| to create the entire
1219 %right footer. Another example of the slide number layout could be
1220 %\begin{verbatim}
1221 %\HAPsetup{sn={slide~\#\thepage}}.
1222 %\end{verbatim}
1223 %
1224 %\subsection{e-mail, institution and the
1225 %and-command}\label{sec:eia}
1226 %\DescribeMacro{\author}
1227 %\DescribeMacro{\email}
1228 %\DescribeMacro{\institution}
1229 %\pf{HA-prosper} changes the behavior
1230 %of the \pf{prosper} commands |\email| and |\institution|.
1231 %The package does not anymore put them directly onto the title
1232 %page. Instead, you can use them inside the |\author| command to
1233 %use the fonts that the template specifies for the e-mail address
1234 %and the institution. This is done to offer support for the
1235 %|\and| command\footnote{This was not possible in the
1236 %construction used by \pf{prosper}.}. Example:
1237 %\begin{verbatim}
1238 %\author{%
1239 % Me\\
1240 % \institution{My institution}\\
1241 % \email{My e-mail address}
1242 % \and
1243 % You\\
1244 % \institution{Your institution}\\
1245 % \email{Your e-mail address}
1246 %}
1247 %\end{verbatim}
1248 %
1249 %\clearpage\section{Style specific features} This section documents
1250 %several style specific features. Check table~\ref{tab:supportt} in
1251 %section~\ref{sec:supportt} to find which features are supported by
1252 %each template.
1253 %
1254 %\subsection{maketitle}\label{sec:mct}
1255 %\DescribeMacro{\maketitle}
1256 %This adapted command
1257 %replaces the usual |\maketitle| and takes care of defining
1258 %a title slide with a different layout as the first slide, include
1259 %the title on that slide and create the rest of the slides as
1260 %normal slides (unless specified differently by using for instance
1261 %another slide environment, see section~\ref{sec:wpe}).
1262 %
1263 %This command has the same options as the |slide| environment (see
1264 %section~\ref{sec:slide}. By default, the title slide will appear in
1265 %neither the bookmarks list nor the table of contents. You can change
1266 %this by specifying respectively the |bm| option and/or the |toc|
1267 %option (see section~\ref{sec:slide}).
1268 %
1269 %If the |\maketitle| feature is not supported by a style,
1270 %then the |\maketitle| uses a normal slide to display the
1271 %title on.
1272 %
1273 %\subsection{Wideslide and partslide}\label{sec:wpe}
1274 %\DescribeEnv{wideslide}
1275 %A |wideslide| produces a slide with an extended text area in case
1276 %you need to display very wide formulas or figures. In a lot of
1277 %templates, this means that the table of contents will not be
1278 %displayed on a wideslide.
1279 %
1280 %As a remark: the optional arguments possible for the
1281 %|\maketitle| (see section~\ref{sec:mct}) are also available
1282 %for the modified slide environments. So
1283 %\begin{verbatim}
1284 %\begin{wideslide}[toc=Toc slide title,trans=Replace]{Slide title}
1285 %...
1286 %\end{wideslide}
1287 %\end{verbatim}
1288 %creates a |wideslide| which does not have transition
1289 %effects itself and uses `Toc slide title' as the entry for the
1290 %(optional) table of contents. See section~\ref{sec:toc} for more
1291 %information about the optional table of contents.
1292 %
1293 %\DescribeEnv{partslide}
1294 %The |partslide| environment is available in some styles. This
1295 %environment uses a template which has been designed especially for
1296 %use with the |\part| (see section~\ref{sec:part}) and the
1297 %|\sectionandpart| commands (see section~\ref{sec:secandpart}).
1298 %
1299 %See section~\ref{sec:supportt} to find which styles support
1300 %|wideslide| or |partslide| environments.
1301 %
1302 %\subsection{Hidden navigation}\label{sec:navs} If you use Acrobat (Reader)
1303 %to project the slides, it is possible to embed hidden navigational
1304 %components. The navigational components are accessed by clicking
1305 %the logo on a slide (unless stated otherwise in style specific
1306 %documentation). These components are always hidden and hence
1307 %removing their definitions when you want to print the slides is
1308 %not necessary. Using |\HAPsetup| (see
1309 %section~\ref{sec:globals}), you can set the following
1310 %options\footnote{Notice that backward compatibility for
1311 %\ci{TitleSlideNav} and \ci{NormalSlideNav} is provided.}:
1312 %\begin{itemize}
1313 %\item |tsnav|\\
1314 %Navigation possibilities of the logo on the title slide.\\
1315 %For instance: |tsnav=FullScreen|: when starting the
1316 %presentation, you can make the presentation full screen by
1317 %clicking the logo.
1318 %
1319 %\item |nsnav|\\
1320 %Navigation possibilities on all other slides.\\
1321 %For instance: |nsnav=ShowBookmarks| or |nsnav=GoToPage|: the
1322 %former will provide a list of slide titles when viewing the
1323 %presentation in full screen mode. In this case, proper slide
1324 %titles might help you navigate your presentation. The latter will
1325 %show a menu where you can type the slide number of the slide that
1326 %you want to display.
1327 %\end{itemize}
1328 %
1329 %For more possibilities, see the documentation of the
1330 %\pf{hyperref} package.
1331 %
1332 %\subsection{Support table}\label{sec:supportt}
1333 %Table~\ref{tab:supportt} displays an overview of the available
1334 %extra features in the styles. In between brackets you can find
1335 %links to sections explaining the features.
1336 %
1337 %\begin{table}[ht]
1338 %\caption{Available features in styles.}\label{tab:supportt}
1339 %\makebox[\textwidth][r]{
1340 %\begin{tabular}{l}\rlap{
1341 %\pstilt{60}{%
1342 %\begin{tabular}{g}\hline
1343 %\rotateleft{\rnode{c1}{}\hphantom{ TCSTealBlue }} &
1344 %\rotateleft{\rnode{c2}{}\hphantom{TCSTealBlue}\rnode{c0}{}} &
1345 %\rotateleft{\rnode{c3}{}} &
1346 %\rotateleft{\rnode{c4}{}} &
1347 %\rotateleft{\rnode{c5}{}} &
1348 %\rotateleft{\rnode{c6}{}} &
1349 %\rotateleft{\rnode{c7}{}} &
1350 %\rotateleft{\rnode{c8}{}} &
1351 %\rotateleft{\rnode{c9}{}} &
1352 %\rotateleft{\rnode{c10}{}} &
1353 %\rotateleft{\rnode{c11}{}} &
1354 %\rotateleft{\rnode{c12}{}} &
1355 %\rotateleft{\rnode{c13}{}}
1356 %\end{tabular}
1357 %}}\\
1358 %\rput[rt](c0){Styles\hspace{1.5em}}
1359 %\rput[lb](c1){ Features}
1360 %\rput[lt]{60}(c2){ Aggie}
1361 %\rput[lt]{60}(c3){ Capsules}
1362 %\rput[lt]{60}(c4){ CentER}
1363 %\rput[lt]{60}(c5){ Ciment}
1364 %\rput[lt]{60}(c6){ Fyma}
1365 %\rput[lt]{60}(c7){ HA}
1366 %\rput[lt]{60}(c8){ Lakar}
1367 %\rput[lt]{60}(c9){ Simple}
1368 %\rput[lt]{60}(c10){ TCS}
1369 %\rput[lt]{60}(c11){ TCSgrad}
1370 %\rput[lt]{60}(c12){ TCSTealBlue}
1371 %\rput[lt]{60}(c13){ Tycja}
1372 %\hspace{.67em}\begin{tabular}{g}\hline
1373 %table of contents (\ref{sec:toc}) & x & x & x & x & x & x & x & x & x & x & x & x \\
1374 %portrait slides (\ref{sec:portrait}) & x & & & & & x & x & x & & & & x \\
1375 %A4 support & & & & & x & & & & & & & \\
1376 %modified \ci{maketitle} (\ref{sec:mct}) & x & x & x & x & x & x & x & x & x & x & x & x \\
1377 %wideslide environment (\ref{sec:wpe}) & x & x & x & x & x & x & x & x & x & x & x & x \\
1378 %partslide environment (\ref{sec:wpe}) & & x & & x & x & & x & & & & & \\
1379 %tsnav (\ref{sec:navs}) & x & & x & & & & & & x & x & x & \\
1380 %nsnav (\ref{sec:navs}) & x & & x & & & x & & & x & x & x & \\
1381 %\hline
1382 %\end{tabular}
1383 %\end{tabular}}
1384 %\end{table}
1385 %
1386 %Currently only the |Fyma| style supports the |A4| papersize. To use
1387 %it, issue the command |\FymaAFour| in your preamble and use |-t A4|
1388 %in the |dvips| command line to get slides in A4 dimensions.
1389 %
1390 %\clearpage\section{Information for style developers}\label{sec:styledev}
1391 %\subsection{General tools}
1392 %This section provides some information in case you want to develop
1393 %your own style. Remember that this package is still based on
1394 %\pf{prosper}, so for the standard \pf{prosper} features, see the
1395 %\pf{prosper} documentation. Table~\ref{tab:devfeats1} lists
1396 %additional features of \pf{HA-prosper} available to control the
1397 %layout, fonts and colors of your style. The controls in
1398 %table~\ref{tab:devfeats2} are \pf{HA-prosper} internals and should
1399 %only be used in style files. In between brackets you can find links
1400 %to sections explaining the related user interface commands. Do not
1401 %forget to take a look at existing styles since these are the ideal
1402 %starting point to create a new style.
1403 %Note that if you use |\HAP@NSNav| or |\HAP@TSNav| in a style, make
1404 %sure to check whether it has been defined by the user or not.
1405 %
1406 %\begin{table}[ht]\centering
1407 %\caption{\pf{HA-prosper} features for style development.}
1408 %\label{tab:devfeats1}
1409 %\makebox[\textwidth][r]{
1410 %\begin{tabular}{d}
1411 %\hline\hline
1412 %\ci{FontLeftFoot\string{C\string}\string{BW\string}},& This command is used to
1413 %assign a font to the left footer (\ref{sec:footers}). The\\
1414 %& first argument is for color slides, the second for black
1415 %and white ones.\\
1416 %& Default: font: \ci{fontText}; text height: 5pt; line height: 5pt.\\
1417 %\ci{fontLeftFoot\string{xx\string}}& This command writes |xx| in the font
1418 %defined by the former command.\\\hline
1419 %\ci{FontRightFoot\string{C\string}\string{BW\string}},& Idem for right footer (\ref{sec:footers}).\\
1420 %\ci{fontRightFoot\string{xx\string}}& Default: font: \ci{fontText}; text height: 5pt; line height: 5pt.\\\hline
1421 %\ci{FontAuthor\string{C\string}\string{BW\string}},& Idem for author (\ref{sec:eia}).\\
1422 %\ci{fontAuthor\string{xx\string}}& Default: font: \ci{fontText}.\\\hline
1423 %\ci{FontInst\string{C\string}\string{BW\string}},& Idem for institution (\ref{sec:eia}).\\
1424 %\ci{fontInst\string{xx\string}}& Default: font: \ci{fontText}; text height: 7pt; line height: 7pt.\\\hline
1425 %\ci{FontEmail\string{C\string}\string{BW\string}},& Idem for e-mail address (\ref{sec:eia}).\\
1426 %\ci{fontEmail\string{xx\string}}& Default: font: \ci{fontText}; text height: 7pt; line height: 7pt.\\\hline
1427 %\ci{FontToc\string{C\string}\string{BW\string}},& Idem for table of contents (\ref{sec:toc}).\\
1428 %\ci{fontToc\string{xx\string}}& Default: font: \ci{fontText}; text height: 4pt; line height: 6pt.\\\hline
1429 %\hline
1430 %\end{tabular}}
1431 %\end{table}
1432 %
1433 %\begin{table}[ht]
1434 %\caption{Internal \pf{HA-prosper} controls for style development.}\label{tab:devfeats2}
1435 %\makebox[\textwidth][r]{
1436 %\begin{tabular}{d}\hline\hline
1437 %\ci{HAP@PutLF\string{A\string}\string{C\string}}&
1438 %Uses \ci{rput} to position the left footer using anchor |A| and coordinates |C|.\\\hline
1439 %\ci{HAP@PutRF\string{A\string}\string{C\string}}&
1440 %Uses \ci{rput} to position the right footer using anchor |A| and coordinates |C|.\\\hline
1441 %\ci{HAP@NSNav}&Contains argument of \ci{NormalSlideNav}, if defined (\ref{sec:navs}).\\\hline
1442 %\ci{HAP@TSNav}&Contains argument of \ci{TitleSlideNav}, if defined (\ref{sec:navs}).\\\hline
1443 %Color |HAP@textc|&Text color, used for switching back from inactive colors; default: black (\ref{sec:iestep}).\\\hline
1444 %Color |HAP@framecolor|&Color for dualslide frames and lines; default: black (\ref{sec:dualslide}).\\\hline
1445 %\ci{ifHAP@active}&True if item is active, for use with \ci{myitem} (see \pf{prosper} docs and \ref{sec:xitem}).\\\hline
1446 %\ci{ifHAP@highlight}&True if highlighting has been requested by the user (\ref{sec:tochl}).\\\hline
1447 %\ci{ifHAP@portrait}&True if portrait slides have been requested by the user (\ref{sec:portrait}).\\\hline
1448 %\ci{ifHAP@notes}&If's that contain the state of requested notes, slides only or notes only.\\
1449 %\ci{ifHAP@notesonly}&These can take the value 0 or 1 (false or true) and it holds that\\
1450 %\ci{ifHAP@slidesonly}&the sum is equal to one and the product is equal to zero (\ref{sec:notes}).\\
1451 %\hline\hline
1452 %\end{tabular}}
1453 %\end{table}
1454 %
1455 %\subsection{Table of contents typesetting}
1456 %\pf{HA-prosper} uses the macros |\HAP@tocentry| and
1457 %|\HAP@hltocentry| to typeset table of contents entries. The latter
1458 %macro will be used in case the entry needs to be highlighted. By
1459 %default, \pf{HA-prosper} puts the toc entry at hand in a |\parbox|
1460 %to allow for multi-line toc entries. For |\HAP@hltoctext|, the
1461 %latter is inserted in a |\psframebox|. You can redefine the former
1462 %macros to typeset the table of contents for your style in a
1463 %different way. Use |\HAP@toctext| in your definitions. This will at
1464 %run time contain the entry at hand in the markup specified by either
1465 %|\HAP@tline|, |\HAP@tlineonly|, |\HAP@tsection| or
1466 %|\HAP@tsectiononly| depending on the type of table of contents and
1467 %the type of the entry. See for instance the |Fyma| style for an
1468 %alternative table of contents markup. See further
1469 %table~\ref{tab:tocmarkup} for other macros related to typesetting
1470 %the table of contents and section~\ref{sec:toc} for more information
1471 %about the table of contents.
1472 %
1473 %\begin{table}[ht]
1474 %\caption{Table of contents typesetting macros.}\label{tab:tocmarkup}
1475 %\makebox[\textwidth][r]{
1476 %\begin{tabular}{d}\hline\hline
1477 %\ci{HAP@toc}&Command that includes the toc file in \ci{fontToc}.\\\hline
1478 %\ci{HAP@tsections}&Includes sections of the toc file in \ci{fontToc}.\\\hline
1479 %\ci{HAP@tcontent}&Contains the content of the current section.\\\hline
1480 %\ci{ifHAP@toc}&True if a table of contents has been requested by the user.\\\hline
1481 %\ci{HAP@tline}&Layout of a table of contents entry in a full toc.\\\hline
1482 %\ci{HAP@tlineonly}&Layout of a table of contents entry in \ci{HAP@tcontent}.\\\hline
1483 %\ci{HAP@tsection}&Layout of a table of contents section in a full toc.\\\hline
1484 %\ci{HAP@tsectionm}&Section marker, inserted just before creating a section.\\\hline
1485 %\ci{HAP@tsectiononly}&Layout of a table of contents section in \ci{HAP@tsections}.\\\hline
1486 %\ci{HAP@tsectionskip}&Vertical skip above a section; default: 1.5em.\\\hline
1487 %\ci{HAP@titemskip}&Vertical skip in between items, not sections; default: 0.1em.\\\hline
1488 %\ci{HAP@tocentry}&Construct for entry, use \ci{HAP@toctext} inside, see leading text.\\\hline
1489 %\ci{HAP@hltocentry}&Construct for highlighting, use \ci{HAP@toctext} inside, see leading text.\\\hline
1490 %Color |HAP@hcolor|&Color for PostScript frame used for highlighting; default: black.\\\hline
1491 %Color |HAP@htcolor|&Text color for highlighted toc entry; default: white.\\\hline
1492 %\ci{HAP@twidth}&Width of toc, used for \ci{parbox} in \ci{HAP@tocentry} and \ci{HAP@hltocentry}.\\\hline
1493 %\ci{HAP@tborder}&Border size in \ci{psframebox} of \ci{HAP@hltocentry}; default: 0.05cm\\\hline\hline
1494 %\end{tabular}}
1495 %\end{table}
1496 %
1497 %Note that the macros |\HAP@hcolor|, |\HAP@htcolor|, |\HAP@twidth|
1498 %and |\HAP@tborder| are only used in the default definitions of
1499 %|\HAP@tocentry| and |\HAP@hltocentry|. If you decide to redefine the
1500 %latter two macros, defining and using the former four might not be
1501 %necessary. The default toc typesetting uses these macros to provide
1502 %an easy way for style designers to tweak the default markup of the
1503 %table of contents.
1504 %
1505 %\subsection{Reserved commands}
1506 %\pf{HA-prosper} knows a couple of reserved commands. If these
1507 %commands are defined by a style, they will be used by
1508 %\pf{HA-prosper} to create new slide environments. See
1509 %table~\ref{tab:reserved}.
1510 %
1511 %\begin{table}[ht]
1512 %\caption{Reserved commands in \pf{HA-prosper}.} \label{tab:reserved}
1513 %\makebox[\textwidth][r]{
1514 %\begin{tabular}{d}\hline\hline
1515 %\ci{HAPR@normalSlide}&Should contain the layout
1516 %of a standard slide.\\\hline
1517 %\ci{HAPR@wideSlide}&Should contain the layout of a
1518 %wide slide; used for |wideslide| environment (\ref{sec:wpe}).\\\hline
1519 %\ci{HAPR@partSlide}&Should contain the layout of a
1520 %part slide; used for |partslide| environment (\ref{sec:wpe}).\\\hline
1521 %\ci{HAPR@titleSlide}&Should contain the layout of a
1522 %title slide; used to create title slide,\\
1523 %&which will be embedded in the \ci{maketitle} command (\ref{sec:mct}).\\\hline
1524 %\hline
1525 %\end{tabular}}
1526 %\end{table}
1527 %
1528 %Note that |\HAPR@normalSlide| is used to switch back to after
1529 %creating a special slide environment like |wideslide|. If this
1530 %command has not been defined in your style, then \pf{HA-prosper}
1531 %will not be able to define the environments mentioned in
1532 %section~\ref{sec:wpe} for you. As a last note: don't forget the
1533 %power of the \pf{PSTricks} package for designing styles.
1534 %
1535 %\clearpage\section{Miscellaneous issues}
1536 %
1537 %\subsection{Examples}\label{sec:examples}
1538 %Examples that use the \pf{HA-prosper} package are contained in the
1539 %|HAPIntroduction.tex|, |HAPBigtest.tex| and |HAPDualslide.tex|
1540 %files in this distribution. The examples assume that you have the
1541 %|HA| style. More examples can be found at the \pf{HA-prosper} website
1542 %\cite{HA-prosper}.
1543 %
1544 %Do not forget to take a look at the documentation of the
1545 %\pf{prosper} class, the \pf{hyperref} package and the
1546 %\pf{PSTricks} package to fully understand the possibilities of
1547 %slides created by \pf{HA-prosper}.
1548 %
1549 %\subsection{Required packages}\label{sec:req}
1550 %The most important requirements of the \pf{prosper} class are:
1551 %\begin{multicols}{2}
1552 %\begin{itemize}\setlength{\itemsep}{0pt}
1553 %\item \pf{seminar},
1554 %\item \pf{hyperref},
1555 %\item \pf{pstricks},
1556 %\item \pf{graphicx}.
1557 %\end{itemize}
1558 %\end{multicols}
1559 %The most important requirements of the \pf{HA-prosper} package
1560 %are:
1561 %\begin{multicols}{2}\raggedright
1562 %\begin{itemize}\setlength{\itemsep}{0pt}
1563 %\item \pf{prosper} (|prosper.cls| version 1.24),
1564 %\item \pf{xkeyval} \cite{xkeyvalCTAN},
1565 %\item \pf{xcomment},
1566 %\item \pf{verbatim}.
1567 %\end{itemize}
1568 %\end{multicols}
1569 %
1570 %\subsection{Resulting PDF}\label{sec:result}
1571 %The PDF produced by PS2PDF (GhostScript) is usually very big.
1572 %Unfortunately, it includes a copy of the logos on the slides every
1573 %time they appear. In case this logo is a rendered picture, the PDF
1574 %will become very big. There is not much you can do about that.
1575 %However, you can compress a generic presentation PDF file very
1576 %much (often even to 10\% of the original size) using for instance
1577 %WinZip. And you could of course delete the logo or replace it by a
1578 %non-rendered picture, for instance created by \pf{PSTricks}, see
1579 %the \pf{PSTricks} website \cite{PSTricks}. Compare for example
1580 %the |HA| style and the |Lakar| style.
1581 %
1582 %Another possibility is to use `Reduce file size' in the file menu
1583 %of Acrobat (available from version 6). You can also use the PDF
1584 %Optimizer in this version of Acrobat (Tools - PDF Optimizer).
1585 %Using this option, you can compress the pictures inside the
1586 %presentation and make the presentation considerably smaller. Hint:
1587 %do not use JPEG or JPEG2000 for the compression of images. Even at
1588 %the highest level of quality, this produces poor results for
1589 %projecting purposes. Instead, use the ZIP compression. Also, do
1590 %not downsize the resolution lower than 300 pixels per inch (for
1591 %retaining printing quality).
1592 %
1593 %However, to get the most efficient PDF document, use the Acrobat
1594 %Distiller to convert the PS file into a PDF file. Do not forget to
1595 %include the `distiller' option in the document class in this case
1596 %(see section~\ref{sec:compile}).
1597 %
1598 %\subsection{Credits}
1599 %I want to thank the following people for their contribution(s).
1600 %\begin{itemize}
1601 %\item\textbf{Style contributors}\\
1602 %Chris Ellison: |TCS|, |TCSgrad| and |TCSTealBlue| styles.\\
1603 %Jack Stalnaker: |Aggie| style.\\
1604 %Laurent Jacques \cite{Laurent}: |Fyma| style.\\
1605 %Mathieu Goutelle \cite{Mathieu}: |Capsules| and |Ciment| styles.
1606 %\item\textbf{Bug reports}\\
1607 %Bugs have been detected and reported by Chris Ellison, Victor
1608 %Francisco Fonte, Johan Joubert, Fr\'ed\'eric Mayot, and Johan
1609 %Segers.
1610 %\item\textbf{Contributions and ideas}\\
1611 %A lot of thanks go Mathieu Goutelle \cite{Mathieu}, Herbert Vo\ss\
1612 %\cite{Herbert}, Murali Krishna Ganapathy \cite{Murali} and Laurent
1613 %Jacques for great help, code contributions and/or ideas for improvements.
1614 %\end{itemize}
1615 %
1616 %\subsection{Questions}\label{sec:questions}
1617 %If you have questions, please first consult the documentation of
1618 %the package that could possibly answer your question. Probably,
1619 %you can find the answer in the documentation of either the
1620 %\pf{HA-prosper} package, \pf{prosper} class, the \pf{hyperref}
1621 %package or the \pf{PSTricks} package. Also have a look at
1622 %WikiProsper \cite{WikiProsper} for a \pf{prosper} FAQ,
1623 %\pf{prosper} open questions, known \pf{prosper} bugs,
1624 %etcetera.
1625 %
1626 %If you cannot solve the problem yourself, or if you have comments or
1627 %requests for additional features, you may try to post a message to
1628 %the \pf{HA-prosper} mailinglist \cite{HAprospermaillist}. Do not
1629 %forget to include a \emph{minimal} example when you want help with
1630 %an error message.
1631 %
1632 %The use of the mailinglist will be supported as long as possible,
1633 %but as stated in section~\ref{sec:newclass} most effort will be done
1634 %to help \pf{powerdot} users and the \pf{HA-prosper} mailinglist may
1635 %disappear over time.
1636 %
1637 %
1638 %{\small
1639 %\begin{thebibliography}{[00]}
1640 %
1641 %\bibitem{Acrobat}
1642 %Acrobat.
1643 %\newblock \url{http://www.adobe.com/products/acrobat}.
1644 %
1645 %\bibitem{AcroRead}
1646 %{Acrobat Reader}.
1647 %\newblock \url{http://www.adobe.com/products/acrobat/readstep2.html}.
1648 %
1649 %\bibitem{GhostScript}
1650 %{AFPL GhostScript}.
1651 %\newblock \url{http://www.cs.wisc.edu/~ghost}.
1652 %
1653 %\bibitem{GhostView}
1654 %GhostView.
1655 %\newblock \url{http://www.cs.wisc.edu/~ghost/gsview}.
1656 %
1657 %\bibitem{HAprospermaillist}
1658 %{HA-prosper mailinglist}.
1659 %\newblock \url{http://listserv.surfnet.nl/archives/ha-prosper.html}.
1660 %
1661 %\bibitem{HA-prosperCTAN}
1662 %{HA-prosper on CTAN}.
1663 %\newblock
1664 % \url{http://www.ctan.org/tex-archive/macros/latex/contrib/ha-prosper}.
1665 %
1666 %\bibitem{HA-prosper}
1667 %{HA-prosper website}.
1668 %\newblock \url{http://stuwww.uvt.nl/~hendri/downloads/haprosper.html}.
1669 %
1670 %\bibitem{Herbert}
1671 %{Herbert Vo\ss}.
1672 %\newblock \url{http://www.perce.de}.
1673 %
1674 %\bibitem{Laurent}
1675 %{Laurent Jacques}.
1676 %\newblock \url{http://www.fyma.ucl.ac.be/~ljacques}.
1677 %
1678 %\bibitem{Mathieu}
1679 %{Mathieu Goutelle}.
1680 %\newblock \url{http://webperso.easyconnect.fr/goutelle}.
1681 %
1682 %\bibitem{MiKTeX}
1683 %MiKTeX.
1684 %\newblock \url{http://www.miktex.org}.
1685 %
1686 %\bibitem{Murali}
1687 %{Murali Krishna Ganapathy}.
1688 %\newblock \url{http://www.cs.uchicago.edu/people/gmkrishn}.
1689 %
1690 %\bibitem{natbibCTAN}
1691 %{Natbib on CTAN}.
1692 %\newblock
1693 % \url{http://www.ctan.org/tex-archive/macros/latex/contrib/natbib}.
1694 %
1695 %\bibitem{powerdot}
1696 %{powerdot on CTAN}.
1697 %\newblock
1698 % \url{http://www.ctan.org/tex-archive/macros/latex/powerdot}.
1699 %
1700 %\bibitem{ppr-prv}
1701 %{ppr-prv}.
1702 %\newblock
1703 % \url{http://www.ctan.org/tex-archive/macros/latex/contrib/ppr-prv}.
1704 %
1705 %\bibitem{prosperCTAN}
1706 %{Prosper on CTAN}.
1707 %\newblock
1708 % \url{http://www.ctan.org/tex-archive/macros/latex/contrib/prosper}.
1709 %
1710 %\bibitem{prosper}
1711 %{Prosper website}.
1712 %\newblock \url{http://prosper.sourceforge.net}.
1713 %
1714 %\bibitem{PSTricks}
1715 %{PSTricks website}.
1716 %\newblock \url{http://www.pstricks.de}.
1717 %
1718 %\bibitem{SWP}
1719 %{Scientific WorkPlace}.
1720 %\newblock \url{http://www.mackichan.com}.
1721 %
1722 %\bibitem{TeXFAQInst}
1723 %{TeX FAQ (Installing packages)}.
1724 %\newblock \url{http://www.tex.ac.uk/cgi-bin/texfaq2html?label=instpackages}.
1725 %
1726 %\bibitem{TeXFAQTop}
1727 %{TeX FAQ (Top-aligning imported graphics)}.
1728 %\newblock \url{http://www.tex.ac.uk/cgi-bin/texfaq2html?label=topgraph}.
1729 %
1730 %\bibitem{TeXLive}
1731 %{TeXLive}.
1732 %\newblock \url{http://www.tug.org/texlive}.
1733 %
1734 %\bibitem{TexNicCenter}
1735 %TeXnicCenter.
1736 %\newblock \url{http://www.toolscenter.org}.
1737 %
1738 %\bibitem{WikiProsper}
1739 %WikiProsper.
1740 %\newblock \url{http://wikiprosper.bbclone.de}.
1741 %
1742 %\bibitem{WinEdt}
1743 %WinEdt.
1744 %\newblock \url{http://www.winedt.com}.
1745 %
1746 %\bibitem{xkeyvalCTAN}
1747 %{xkeyval on CTAN}.
1748 %\newblock
1749 % \url{http://www.ctan.org/tex-archive/macros/latex/xkeyval}.
1750 %
1751 %\end{thebibliography}}
1752 %
1753 %\subsection{Copyright}
1754 %Copyright \copyright\ 2003-2005 by Hendri Adriaens. All rights reserved.\\
1755 %
1756 %This program may be distributed and/or modified under the
1757 %conditions of the \LaTeX\ Project Public License, either version
1758 %1.2 of this license or (at your option) any later version. The
1759 %latest version of this license is in
1760 %\url{http://www.latex-project.org/lppl.txt} and version 1.2 or
1761 %later is part of all distributions of \LaTeX\
1762 %version 1999/12/01 or later.\\
1763 %
1764 %\subsection{Version history}
1765 %This section lists the main changes in this package as from
1766 %version 3.5. Note that each version change also contains solutions
1767 %to known (minor) bugs and improvements in programming and user
1768 %interface.
1769 %
1770 %\begin{itemize}
1771 %\item[\fbox{3.5}] Solved a bug with toc entries in combination with
1772 %highlighting. This bug was mainly caused
1773 %by the \pf{keyval} package not undefining variables when they are
1774 %not used. Thanks to Mathieu Goutelle for the help; added support
1775 %for the |\part| command. Made \pf{HA-prosper} load slide
1776 %style definitions itself at the final stage; changed style names
1777 %to |HAP[name].sty| to identify \pf{HA-prosper} style
1778 %definitions from \pf{prosper} style definitions; made
1779 %\pf{HA-prosper} undefine |\slidetitle| before loading the
1780 %style definitions;
1781 %
1782 %\item[\fbox{3.6}] Improved writing of toc entries; solved an
1783 %inconsistency in writing definitions between |seminar| and
1784 %|latex.ltx|; introduced |\section| and
1785 %|\sectionandpart|; completely changed |notes| environment,
1786 %not using |seminar| note constructions anymore; added support
1787 %for |\and| in |\author|; added |\fontToc|;
1788 %\begin{itemize}
1789 %\item[\fbox{3.61}] Removed redundant grouping;
1790 %\item[\fbox{3.62}] Adapted writing definitions a bit to be more consistent with
1791 %|seminar|;
1792 %\end{itemize}
1793 %
1794 %\item[\fbox{3.7}] Prepared \pf{HA-prosper} for compatibility to the
1795 %|prosper preview| class \cite{ppr-prv}; integrated specific
1796 %style features into \pf{HA-prosper}; recoded |\figureitem|
1797 %command; renamed |\section| to |\tsection|,
1798 %|\sectionandpart| to |\tsectionandpart| to provide
1799 %compatibility to for instance |\bibliography|; restructured
1800 %\pf{HA-prosper} internals;
1801 %\begin{itemize}
1802 %\item[\fbox{3.71}] Solved a small bug writing final toc entry AtEndDocument;
1803 %added |TCS| style by Chris Ellison.
1804 %\end{itemize}
1805 %
1806 %\item[\fbox{3.8}] Added |\tsection*|, |\tsectionandpart*| and
1807 %nesting of bookmarks; created |\dualslide|; added
1808 %|\hiddenitem|, |\putfigure|, |\figureitem| and
1809 %|\putfigureitem|. Revised the documentation; revised the
1810 %examples; added the |\dualslide| example; revised the styles.
1811 %
1812 %\item[\fbox{3.9}] Deleted |\putfigureitem| and |\figureitem|
1813 %and replaced |\putfigure| by the more general |\topbl|;
1814 %improved positioning of bottom text when using |\dualslide|;
1815 %added |indent| option for |\dualslide|; added support for a
1816 %split toc; added package option |hlsections|; added package
1817 %option |blackslide|; solved a bug occurring when
1818 %|\tsectionandpart| was used to create the last slide; added
1819 %|enumstep|; made it possible to nest |itemstep| and
1820 %|enumstep| environments; added |\HAPsetup|, yet only used
1821 %for stepping environments.
1822 %
1823 %\item[\fbox{4.0}] Changed to |.dtx| format and wrote code
1824 %documentation. Added slide options |bm| and |sound|. Added
1825 %default behavior of stepping environments with the |ps2pdf|
1826 %\pf{prosper} option to be type 1, namely all active. Changed
1827 %bookmarking process to a system that allows for deletion of
1828 %bookmarks. Added global control of features through
1829 %|HA-prosper.cfg|. Added |Aggie| style by Jack Stalnaker.
1830 %Made some code more efficient. Added entrance point for
1831 %\pf{ppr-prv} to make redefining macros easier for that class.
1832 %Solved a bug in combination with loading \pf{babel}. Added
1833 %|\onSlide| and |\OnSlide|.
1834 %
1835 %\item[\fbox{4.1}] Moved documentation to |.dtx| file. Added
1836 %package option |counters|. Restored original |\item| and
1837 %created |\xitem|. Changed |\hiddenitem| to |\xitemwait|
1838 %which is a bit more general. Removed a bug in |\onSlide|.
1839 %Rewrote a lot of code. Made \pf{HA-prosper} use \pf{xkeyval}.
1840 %Changed |emptyslide| into more |partslide|. Added |Fyma| style
1841 %by Laurent Jacques.
1842 %
1843 %\begin{itemize}
1844 %\item[\fbox{4.11}] Corrected small bug in \pf{ppr-prv} compatibility
1845 %check. Made \pf{HA-prosper} use original \LaTeX\ macros |\title| and
1846 %|\author|. Added missing `=' in |\HAP@contentsline| definition.
1847 %\end{itemize}
1848 %
1849 %\item[\fbox{4.2}] Improved table of contents typesetting. Added
1850 %|\xitem<n>|. Added |thebibliography| environment. Improved
1851 %positioning of the slide title in the styles. Added handle for state
1852 %of list items. Updated styles. Added |TCSgrad| and |TCSTealBlue|
1853 %styles by Chris Ellison. Added extra syntax for |\onSlide| and
1854 %|\OnSlide| to make displaying material relative to the preceding
1855 %|\xitem|.
1856 %
1857 %\begin{itemize}
1858 %\item[\fbox{4.21}] Added |Capsules| and |Ciment| styles by Mathieu
1859 %Goutelle. Updated for \pf{xkeyval} version 1.4.
1860 %\end{itemize}
1861 %
1862 %\end{itemize}
1863 %
1864 % \StopEventually{\PrintIndex}
1865 %
1866 % \section{Implementation}\label{sec:impl}
1867 %
1868 % \subsection{Preamble and options}
1869 % The start of the file.
1870 % \begin{macrocode}
1871 %<*program>
1872 \NeedsTeXFormat{LaTeX2e}[1995/12/01]
1873 \def\HAP@Version{v4.21}
1874 \ProvidesPackage{HA-prosper}[2004/08/20 \HAP@Version\space Patch for prosper]
1875 \typeout{(c) 2003-2004 Hendri Adriaens, Tilburg, the Netherlands}
1876 \typeout{ }
1877 % \end{macrocode}
1878 % Required packages. Load \pf{xkeyval} safely to avoid problems with
1879 % \pf{pst-key} which redefines |\setkeys| as well as \pf{xkeyval}.
1880 % \begin{macrocode}
1881 \let\HAP@orig@setkeys\setkeys
1882 \RequirePackage{xkeyval}
1883 \let\xsetkeys\setkeys
1884 \RequirePackage{xcomment}
1885 \RequirePackage{verbatim}
1886 % \end{macrocode}
1887 % Check the version of \pf{ppr-prv} for compatibility.
1888 % \begin{macrocode}
1889 \def\PPRPRV@ReqVersion{v. 0.13}
1890 \@ifclassloaded{ppr-prv}{%
1891 \ifx\PPRPRV@ReqVersion\PPRPRV@Version\else
1892 \PackageError{HA-prosper}{HA-prosper \HAP@Version\space and
1893 ppr-prv \PPRPRV@Version\space are incompatible}%
1894 {Read the documentation of HA-prosper.}%
1895 \fi}{}
1896 % \end{macrocode}
1897 % \DescribeSwitch{slidesonly}\DescribeSwitch{notesonly}\DescribeSwitch{notes}
1898 % Define package options using \pf{xkeyval}. We start with the options for notes.
1899 % \begin{macrocode}
1900 \newif\ifHAP@notes
1901 \newif\ifHAP@notesonly
1902 \newif\ifHAP@slidesonly
1903 \DeclareOptionX{notes}{\HAP@slidesonlyfalse\HAP@notestrue\HAP@notesonlyfalse}
1904 \DeclareOptionX{notesonly}{\HAP@notesonlytrue\HAP@slidesonlyfalse\HAP@notesfalse}
1905 \DeclareOptionX{slidesonly}{\HAP@slidesonlytrue\HAP@notesonlyfalse\HAP@notesfalse}
1906 % \end{macrocode}
1907 % \DescribeSwitch{toc}
1908 % Table of contents (toc) option.
1909 % \begin{macrocode}
1910 \newif\ifHAP@toc
1911 \DeclareOptionX{toc}{\HAP@toctrue}
1912 % \end{macrocode}
1913 % \DescribeSwitch{highlight}
1914 % Highlighting of toc entries.
1915 % \begin{macrocode}
1916 \newif\ifHAP@highlight
1917 \DeclareOptionX{highlight}{\HAP@highlighttrue}
1918 % \end{macrocode}
1919 % \DescribeSwitch{hlsections}
1920 % Permanent highlighting of toc sections.
1921 % \begin{macrocode}
1922 \newif\ifHAP@hlsections
1923 \DeclareOptionX{hlsections}{\HAP@hlsectionstrue}
1924 % \end{macrocode}
1925 % \DescribeSwitch{portrait}
1926 % Portrait slides.
1927 % \begin{macrocode}
1928 \newif\ifHAP@portrait
1929 \DeclareOptionX{portrait}{\HAP@portraittrue}
1930 % \end{macrocode}
1931 % \DescribeSwitch{blackslide}
1932 % The black slide.
1933 % \begin{macrocode}
1934 \newif\ifHAP@blackslide
1935 \DeclareOptionX{blackslide}{\HAP@blackslidetrue}
1936 % \end{macrocode}
1937 % \DescribeSwitch{sounds}
1938 % Include sounds.
1939 % \begin{macrocode}
1940 \newif\ifHAP@sounds
1941 \DeclareOptionX{sounds}{\HAP@soundstrue}
1942 % \end{macrocode}
1943 % Default template.
1944 % \begin{macrocode}
1945 \def\HAP@Style@chosen{HA}
1946 \DeclareOptionX*{\let\HAP@Style@chosen\CurrentOption}
1947 % \end{macrocode}
1948 % Default: slides only.
1949 % \begin{macrocode}
1950 \ExecuteOptionsX{slidesonly}
1951 \ProcessOptionsX
1952 % \end{macrocode}
1953 % Reset |\setkeys| to avoid problems for pstricks packages using
1954 % \pf{pst-key}.
1955 % \begin{macrocode}
1956 \let\setkeys\HAP@orig@setkeys
1957 % \end{macrocode}
1958 % \subsection{Main code}
1959 % \subsubsection{Some necessary stuff}
1960 % Temporary boxes, lengths and counters.
1961 % \begin{macrocode}
1962 \newbox\HAP@tba
1963 \newbox\HAP@tbb
1964 \newlength\HAP@tla
1965 \newlength\HAP@tlb
1966 \newlength\HAP@tlc
1967 \newlength\HAP@tld
1968 \newcounter{HAP@tca}
1969 % \end{macrocode}
1970 % Paper sizes for portrait and landscape slides.
1971 % \begin{macrocode}
1972 \ifHAP@portrait
1973 \slidewidth=150mm
1974 \slideheight=222mm
1975 \else
1976 \slidewidth=222mm
1977 \slideheight=150mm
1978 \fi
1979 % \end{macrocode}
1980 % \DescribeEnv{NewSlideStyle}
1981 % This environment needs to be redefined to be able to remember
1982 % the anchor and the position of the main text box on slides.
1983 % The original comes from \pf{prosper}.
1984 % \begin{macrocode}
1985 \renewcommand{\NewSlideStyle}[4][11cm]{%
1986 \setlength{\slideWidth}{#1}%
1987 \global\pslongbox{posit@Box}{\rput[#2](#3)}%
1988 \newslideframe{the#4}{\csname #4\endcsname{##1}}%
1989 \slidepagestyle{GenericPageStyle}%
1990 \slideframe{the#4}%
1991 \gdef\HAP@current@anchor{#2}%
1992 \gdef\HAP@current@pos{#3}%
1993 }
1994 % \end{macrocode}
1995 % \DescribeMacro{\protected@write}
1996 % |Seminar| uses a somewhat different writing macro than |latex.ltx|. The
1997 % |seminar| definition gets inserted at every |\begin{slide}| and is local.
1998 % To assure
1999 % that this writing definition is also used in between slides (e.g.
2000 % for |\tsection|) we need to redefine it once. The main difference
2001 % is in the use of |\immediate| by |seminar| while this is not used
2002 % by |latex.ltx|. This difference would, without this definition, create mixing errors.
2003 % \begin{macrocode}
2004 \def\protected@write#1#2#3{%
2005 \begingroup
2006 #2%
2007 \let\protect\noexpand
2008 \immediate\normal@write#1{#3}%
2009 \endgroup
2010 \if@nobreak\ifvmode\nobreak\fi\fi
2011 }
2012 % \end{macrocode}
2013 % \subsubsection{Support for notes}
2014 % Notes are created on slides, but with an adapted template. We start
2015 % with defining some counters. The first is used to count the number
2016 % of notes with a particular slide.
2017 % \begin{macrocode}
2018 \newcounter{HAP@notes@slide}
2019 % \end{macrocode}
2020 % This counter is used to count the total number of notes.
2021 % \begin{macrocode}
2022 \newcounter{HAP@notes@true}
2023 % \end{macrocode}
2024 % And this is a temp counter to remember the slide that the notes
2025 % belong to.
2026 % \begin{macrocode}
2027 \newcounter{HAP@notes@temp}
2028 % \end{macrocode}
2029 % The template to be used by notes.
2030 % \begin{macrocode}
2031 \def\HAP@notes@frame#1{#1}
2032 \ifHAP@portrait
2033 \def\HAP@notes@template{\NewSlideStyle[8.8cm]{tl}{-0.6,4}{HAP@notes@frame}}
2034 \else
2035 \def\HAP@notes@template{\NewSlideStyle[8.8cm]{tl}{1.2,4}{HAP@notes@frame}}
2036 \fi
2037 % \end{macrocode}
2038 % Start writing a file to store notes page numbers.
2039 % \begin{macrocode}
2040 \ifHAP@notes
2041 \newwrite\HAP@notesout\openout\HAP@notesout\jobname.not\relax
2042 \fi
2043 % \end{macrocode}
2044 % When notes only, use saved page numbers.
2045 % \begin{macrocode}
2046 \ifHAP@notesonly
2047 \begingroup\InputIfFileExists{\jobname.not}{}{}\endgroup
2048 \xcomment{notes}
2049 \fi
2050 % \end{macrocode}
2051 % \begin{environment}{notes}
2052 % This macro defines the notes environment.
2053 % \begin{macrocode}
2054 \def\notes#1{%
2055 \ifHAP@slidesonly\comment\else
2056 % \end{macrocode}
2057 % Count the number of notes with a particular slide. If we are still
2058 % on the same slide, but have a new notes slide, add one to the counter
2059 % for notes slides, otherwise reset that counter.
2060 % \begin{macrocode}
2061 \ifnum\value{slide}=\value{HAP@notes@temp}
2062 \stepcounter{HAP@notes@slide}%
2063 \else
2064 \setcounter{HAP@notes@slide}{1}%
2065 \fi
2066 % \end{macrocode}
2067 % Set the temp counter to the current slide to remember to which slide
2068 % the notes belong.
2069 % \begin{macrocode}
2070 \setcounter{HAP@notes@temp}{\value{slide}}%
2071 \stepcounter{HAP@notes@true}%
2072 % \end{macrocode}
2073 % If not notes only, then the notes page numbers get written to disk
2074 % by using labels. This makes sure that, when using the option |notesonly|
2075 % at the first pass of the presentation, there are no errors, only warnings.
2076 % \begin{macrocode}
2077 \ifHAP@notesonly\else
2078 \protected@write\HAP@notesout{}{\string\newlabel{notes@\number\c@HAP@notes@true}%
2079 {{}{\number\c@HAP@notes@temp-\number\c@HAP@notes@slide}{\relax }{}{}}}%
2080 \fi
2081 % \end{macrocode}
2082 % Save anchor and position of the text box of the previous slide.
2083 % \begin{macrocode}
2084 \xdef\HAP@temp@anchor{\HAP@current@anchor}%
2085 \xdef\HAP@temp@pos{\HAP@current@pos}%
2086 % \end{macrocode}
2087 % Start notes on a portrait slide environment.
2088 % \begin{macrocode}
2089 \HAP@notes@template\HAP@portraittrue
2090 \begin{slide}[toc=,bm=,trans=Replace]{HAP@notitle}\black
2091 \rput[tl](0,1.5){\fontTitle{\black#1}}%
2092 % \end{macrocode}
2093 % Position the notes number using |PSTricks|.
2094 % \begin{macrocode}
2095 \ifHAP@notesonly
2096 \rput[tc](4.4,-10.5){\realpageref{notes@\number\c@HAP@notes@true}}%
2097 \else
2098 \rput[tc](4.4,-10.5){\number\c@HAP@notes@temp-\number\c@HAP@notes@slide}%
2099 \fi
2100 \fi
2101 }
2102 % \end{macrocode}
2103 % Closing the notes environment and restoring the text box position
2104 % and anchor to its original values to be used by the next slide (or note).
2105 % \begin{macrocode}
2106 \def\endnotes{%
2107 \ifHAP@slidesonly\endcomment\else
2108 \end{slide}%
2109 \global\pslongbox{posit@Box}{\rput[\HAP@temp@anchor](\HAP@temp@pos)}%
2110 \gdef\HAP@current@anchor{\HAP@temp@anchor}%
2111 \gdef\HAP@current@pos{\HAP@temp@pos}%
2112 \addtocounter{slide}{-1}%
2113 \fi
2114 }
2115 % \end{macrocode}
2116 % \end{environment}
2117 % \subsubsection{Blackslide option}
2118 % First we create a template for the black slide.
2119 % \begin{macrocode}
2120 \def\HAP@bs@frame#1{%
2121 \psframe[fillstyle=solid,fillcolor=black](-3,-3)(13,13)%
2122 {#1}%
2123 }
2124 % \end{macrocode}
2125 % And we position that.
2126 % \begin{macrocode}
2127 \ifHAP@portrait
2128 \def\HAP@bs@template{\NewSlideStyle[10cm]{tl}{-1.25,5.9}{HAP@bs@frame}}
2129 \else
2130 \def\HAP@bs@template{\NewSlideStyle[10cm]{tl}{-1.87,5.2}{HAP@bs@frame}}
2131 \fi
2132 % \end{macrocode}
2133 % Do not provide blackslide when \pf{ppr-prv} is loaded since it cannot
2134 % be undone by that class. The black slide is a normal slide at the
2135 % start of the presentation, is black and has a black button in the
2136 % top left corner with Acrobat |GoBack| functionality.
2137 % \begin{macrocode}
2138 \ifHAP@blackslide
2139 \ifx\PPRPRV@Version\@undefined
2140 % \end{macrocode}
2141 % Alter PDF starting slide to hide the black slide.
2142 % \begin{macrocode}
2143 \def\@pdfstartpage{2}%
2144 \AtBeginDocument{%
2145 % \end{macrocode}
2146 % Set the template.
2147 % \begin{macrocode}
2148 \HAP@bs@template
2149 \begin{slide}[trans=Replace,toc=,bm=]{HAP@notitle}%
2150 % \end{macrocode}
2151 % Create the button.
2152 % \begin{macrocode}
2153 {\black\hypertarget{blackslide}{\Acrobatmenu{GoBack}%
2154 {\setlength{\fboxsep}{.5cm}\fbox{GoBack}}}}%
2155 \end{slide}%
2156 % \end{macrocode}
2157 % Restore the slide counter to get real slide numbers right.
2158 % \begin{macrocode}
2159 \addtocounter{slide}{-1}%
2160 \HAPR@normalSlide
2161 }
2162 \fi
2163 \fi
2164 % \end{macrocode}
2165 % \DescribeMacro{\HAP@writebm}
2166 % Macro that writes bookmark entries to the |.bm| file so that they
2167 % can be read on the next pass.
2168 % \HAPcmd{\ci{HAP@writebm}\marg{open}\marg{csec}\marg{title}\marg{page}\marg{bsec}}
2169 % |csec| is the current section label and |bsec| is the section label
2170 % of the section that the current slide belongs to for nesting bookmarks.
2171 % These are used to compute the number of bookmarks that should be
2172 % nested within the current bookmark.
2173 % |open| is `+' or `-' to open bookmarks in the PDF or not.
2174 % The other arguments are self-explaining.
2175 % \begin{macrocode}
2176 \def\HAP@writebm#1#2#3#4#5{%
2177 \protected@write\HAP@bmout{}{%
2178 \string\HAPbookmark{#1}{#2}{#3}{#4}{#5}}%
2179 }
2180 % \end{macrocode}
2181 % \DescribeMacro{\HAP@checkbmnumber}
2182 % Based on |pdfmark.def| (|hyperref|). Returns the number of bookmarks
2183 % to be nested within the current bookmark. Notice that the macros
2184 % |HAP_[label]| will contain the numbers of bookmarks to be nested
2185 % within the current bookmark.
2186 % \begin{macrocode}
2187 \def\HAP@checkbmnumber#1{%
2188 \expandafter\ifx\csname HAP_#1\endcsname\relax
2189 0%
2190 \else
2191 \csname HAP_#1\endcsname
2192 \fi
2193 }
2194 % \end{macrocode}
2195 % Temporary counter.
2196 % \begin{macrocode}
2197 \newcounter{HAP@temp@sc}
2198 % \end{macrocode}
2199 % \begin{macro}{\HAP@calcbmnumber}
2200 % Based on |pdfmark.def| (|hyperref|). Computes the number of bookmarks
2201 % to be nested within the current bookmark.
2202 % \begin{macrocode}
2203 \def\HAP@calcbmnumber#1{%
2204 % \end{macrocode}
2205 % Set the number of bookmarks for this section equal to the number
2206 % of slides that we already encountered.
2207 % \begin{macrocode}
2208 \setcounter{HAP@temp@sc}{\HAP@checkbmnumber{#1}}%
2209 % \end{macrocode}
2210 % Add one bookmark to this section.
2211 % \begin{macrocode}
2212 \stepcounter{HAP@temp@sc}%
2213 % \end{macrocode}
2214 % And save the updated number of bookmarks again in the |HAP_[label]|
2215 % macro which will be read later to nest the bookmarks.
2216 % \begin{macrocode}
2217 \expandafter\xdef\csname HAP_#1\endcsname{\number\c@HAP@temp@sc}%
2218 }
2219 % \end{macrocode}
2220 % \end{macro}
2221 % \begin{macro}{\HAPbookmark}
2222 % This is the macro that is written to the |.bm| file. First we
2223 % read the |.bm| file to compute the number of bookmarks to be
2224 % nested within each bookmark.
2225 % \begin{macrocode}
2226 \def\HAPbookmark#1#2#3#4#5{\HAP@calcbmnumber{#5}}%
2227 \InputIfFileExists{\jobname.bm}{}{}%
2228 % \end{macrocode}
2229 % Now we redefine the |\HAPbookmark| macro to create the bookmarks.
2230 % \begin{macrocode}
2231 \def\HAPbookmark#1#2#3#4#5{%
2232 % \end{macrocode}
2233 % Notice the use of |\pdfstringdef| to allow for things like |\"i|
2234 % in bookmarks.
2235 % \begin{macrocode}
2236 \pdfstringdef\HAP@temp@bm{#3}%
2237 \pdfmark{pdfmark=/OUT,
2238 Raw={/Count #1\HAP@checkbmnumber{#2}
2239 /Page #4 /View [/XYZ null null null]
2240 /Title (\HAP@temp@bm)}%
2241 }%
2242 }%
2243 % \end{macrocode}
2244 % We read the |.bm| file again and now the bookmarks will be created.
2245 % \begin{macrocode}
2246 \InputIfFileExists{\jobname.bm}{}{}%
2247 % \end{macrocode}
2248 % After reading the |.bm| file, we rewrite it for the next pass.
2249 % \begin{macrocode}
2250 \newwrite\HAP@bmout\immediate\openout\HAP@bmout\jobname.bm\relax
2251 % \end{macrocode}
2252 % \end{macro}
2253 % \begin{macro}{\SlideSound}
2254 % This macro creates a link to a sound file and sets the open action
2255 % of the current page to play the file. Notice that this will make
2256 % the PDF neither self sustaining nor system independent! This macro
2257 % can be called from the optional arguments of slide environments, but
2258 % can also be called directly for more flexibility.
2259 % \begin{macrocode}
2260 \def\SlideSound#1{%
2261 \ifHAP@sounds
2262 % \end{macrocode}
2263 % Check availability of the sound file in the current directory. Note
2264 % the use of |.///| for the current directory to circumvent a bug in
2265 % MiKTeX. |./| is the standard to denote the current directory but
2266 % MiKTeX (only) still searches the \TeX\ tree when using |./|. This
2267 % bug has been reported to MiKTeX and will hopefully be solved soon.
2268 % \begin{macrocode}
2269 \IfFileExists{.///#1}{}{%
2270 \PackageError{HA-prosper}{The sound file is not in the
2271 current directory. You can go ahead, but any PDF viewer
2272 will complain that the file is missing!}\@ehc
2273 }%
2274 % \end{macrocode}
2275 % Put the link to the media on the slide.
2276 % \begin{macrocode}
2277 \pdfmark{pdfmark=/ANN,
2278 Raw={/Rect [0 0 0 0] /Subtype /Movie
2279 /Title (SlideSound) /Movie << /F (#1) >>}%
2280 }%
2281 % \end{macrocode}
2282 % Play the file when the current slide is displayed.
2283 % \begin{macrocode}
2284 \pdfmark{pdfmark=/PUT,
2285 Raw={{ThisPage} << /AA << /O << /S /Movie
2286 /T (SlideSound) /Operation /Play >> >> >>}%
2287 }%
2288 \fi
2289 }
2290 % \end{macrocode}
2291 % \end{macro}
2292 % \subsubsection{Sectioning the presentation}
2293 % First some counters. The first counter is used for counting slides
2294 % inside sections in the toc.
2295 % \begin{macrocode}
2296 \newcounter{HAP@sc@toc}
2297 % \end{macrocode}
2298 % This counter is used to count sections in the presentation.
2299 % \begin{macrocode}
2300 \newcounter{HAP@sc@pres}
2301 % \end{macrocode}
2302 % This counter is for counting the number of slides in a section.
2303 % \begin{macrocode}
2304 \newcounter{HAP@sc@slides}
2305 % \end{macrocode}
2306 % \DescribeMacro{\tsection}
2307 % This macro creates a section in the table of contents. The stared
2308 % version creates a hidden section. The optional argument is for
2309 % creating a bookmark. The macro uses |\HAP@@tsection| to do the job.
2310 % \begin{macrocode}
2311 \def\tsection{\@ifstar
2312 {\@ifnextchar[{\HAP@@tsection{0}{2}}{\HAP@@tsection{0}{2}[]}}%
2313 {\@ifnextchar[{\HAP@@tsection{0}{1}}{\HAP@@tsection{0}{1}[]}}%
2314 }
2315 % \end{macrocode}
2316 % \begin{macro}{\HAP@@tsection}
2317 % The workhorse for |\tsection|, |\tsectionandpart| and |\part|.
2318 % \HAPcmd{\ci{HAP@@tsection}\marg{page}\marg{type}\oarg{bm}\marg{title}} |page| indicates
2319 % whether the section got a page (1) or not (0). |type| indicates
2320 % the type of section: 0=not a section (to serve |\part|), 1=normal, 2=hidden.
2321 % This indicator is reused by several other macros, like |\pcontentsline|.
2322 % The optional argument |bm| can contain a replacement for the bookmark
2323 % title created by the |title| option.
2324 % \begin{macrocode}
2325 \def\HAP@@tsection#1#2[#3]#4{%
2326 % \end{macrocode}
2327 % Check whether the optional argument is empty. If yes, set it to
2328 % the mandatory argument. This cannot be done by |\tsection| since
2329 % the |\HAP@part| macro needs to access |\@tsection| macro directly.
2330 % \begin{macrocode}
2331 \def\HAP@tempa{#3}%
2332 \ifx\HAP@tempa\@empty
2333 \def\HAP@tempa{#4}%
2334 \fi
2335 % \end{macrocode}
2336 % Step the section counter since we have a new section.
2337 % \begin{macrocode}
2338 \stepcounter{HAP@sc@pres}%
2339 % \end{macrocode}
2340 % Reset the counter for slides in a section.
2341 % \begin{macrocode}
2342 \setcounter{HAP@sc@slides}{0}%
2343 % \end{macrocode}
2344 % Step this counter to get correct bookmarks.
2345 % \begin{macrocode}
2346 \stepcounter{trueSlideCounter}%
2347 % \end{macrocode}
2348 % Add an entry to the |.toc| file.
2349 % \begin{macrocode}
2350 \HAP@contentsline{#2}{#4}{\number\c@trueSlideCounter}{\number\c@HAP@sc@pres}%
2351 % \end{macrocode}
2352 % Write a bookmark.
2353 % \begin{macrocode}
2354 \HAP@writebm{}{section.\number\c@HAP@sc@pres}{\HAP@tempa}%
2355 {\number\c@trueSlideCounter}{}%
2356 % \end{macrocode}
2357 % Reset the main slide counter.
2358 % \begin{macrocode}
2359 \addtocounter{trueSlideCounter}{-1}%
2360 }
2361 % \end{macrocode}
2362 % \end{macro}
2363 % \subsubsection{part and tsectionandpart}
2364 % An optional key for |\part| and |\tsectionandpart|.
2365 % \begin{macrocode}
2366 \define@key{HAP@keys@slide}{template}{\def\HAP@templatekey{#1}}
2367 % \end{macrocode}
2368 % \DescribeMacro{\part}
2369 % This macro uses |\HAP@part|. The entry `0' indicates that this
2370 % macro does not produce a section. See also the |\tsection| macro.
2371 % \begin{macrocode}
2372 \def\part{\@ifnextchar[{\HAP@part{0}}{\HAP@part{0}[]}}
2373 % \end{macrocode}
2374 % \DescribeMacro{\tsectionandpart}
2375 % Creates a |\tsection| and a |\part|. The stared version creates
2376 % a hidden section and part.
2377 % \begin{macrocode}
2378 \def\tsectionandpart{\@ifstar
2379 {\@ifnextchar[{\HAP@part{2}}{\HAP@part{2}[]}}%
2380 {\@ifnextchar[{\HAP@part{1}}{\HAP@part{1}[]}}%
2381 }
2382 % \end{macrocode}
2383 % \begin{macro}{\HAP@part}
2384 % The workhorse for |\part| and |\tsectionandpart|.
2385 % \HAPcmd{\ci{HAP@part}\marg{type}\oarg{opt}\marg{title}}
2386 % |type| coincides with the types used by |\tsection|.
2387 % \begin{macrocode}
2388 \def\HAP@part#1[#2]#3{%
2389 % \end{macrocode}
2390 % Grouping is necessary to keep options local.
2391 % \begin{macrocode}
2392 \begingroup
2393 % \end{macrocode}
2394 % Set options.
2395 % \begin{macrocode}
2396 \xsetkeys{HAP@keys@slide,HAP@keys@slidespec}{#2}%
2397 % \end{macrocode}
2398 % Several cases. We start with `not a section'.
2399 % \begin{macrocode}
2400 \ifnum#1=\z@
2401 \ifx\HAP@bmkey\@empty
2402 % \end{macrocode}
2403 % If bookmark entry is empty, overwrite it to use the title.
2404 % \begin{macrocode}
2405 \begin{\HAP@templatekey}[toc=#3,#2,bm=#3]{HAP@notitle}%
2406 \else
2407 % \end{macrocode}
2408 % In all other cases, use the bookmark entry supplied by the user
2409 % if is actually there. By default, use the title.
2410 % \begin{macrocode}
2411 \begin{\HAP@templatekey}[bm=#3,toc=#3,#2]{HAP@notitle}%
2412 \fi
2413 \else
2414 % \end{macrocode}
2415 % It is a section.
2416 % \begin{macrocode}
2417 \ifcase
2418 \ifx\HAP@tockey\@undefined\@ne\fi
2419 \ifx\HAP@tockey\@empty\@ne\fi
2420 \z@
2421 \ifcase
2422 \ifx\HAP@bmkey\@undefined\@ne\fi
2423 \ifx\HAP@bmkey\@empty\@ne\fi
2424 \z@
2425 % \end{macrocode}
2426 % Create the section with the supplied optional arguments.
2427 % \begin{macrocode}
2428 \HAP@@tsection{1}{#1}[\HAP@bmkey]{\HAP@tockey}%
2429 \else
2430 % \end{macrocode}
2431 % Create the section with the title as bookmark since it is absent.
2432 % \begin{macrocode}
2433 \HAP@@tsection{1}{#1}[#3]{\HAP@tockey}%
2434 \fi
2435 \else
2436 \ifcase
2437 \ifx\HAP@bmkey\@undefined\@ne\fi
2438 \ifx\HAP@bmkey\@empty\@ne\fi
2439 \z@
2440 % \end{macrocode}
2441 % Use the title for the toc.
2442 % \begin{macrocode}
2443 \HAP@@tsection{1}{#1}[\HAP@bmkey]{#3}%
2444 \else
2445 % \end{macrocode}
2446 % Use the title for both the toc and the bookmark.
2447 % \begin{macrocode}
2448 \HAP@@tsection{1}{#1}[#3]{#3}%
2449 \fi
2450 \fi
2451 % \end{macrocode}
2452 % For sections, do not create a toc entry or bookmark since that
2453 % is already done by |\HAP@@tsection|, but we do create a slide.
2454 % \begin{macrocode}
2455 \begin{\HAP@templatekey}[#2,toc=,bm=]{HAP@notitle}%
2456 \fi
2457 % \end{macrocode}
2458 % Put the text onto the slide, after \pf{prosper}.
2459 % \begin{macrocode}
2460 \vspace*{1.5cm}%
2461 \begin{center}%
2462 \fontTitle{#3}%
2463 \end{center}%
2464 \end{\HAP@templatekey}%
2465 \endgroup
2466 }
2467 % \end{macrocode}
2468 % \end{macro}
2469 % \subsubsection{Table of contents}
2470 % First some initializations. |\HAP@tempentryb| holds the toc entry
2471 % from one slide to the next to determine at which pages highlighting
2472 % of this entry needs to be created. Versions a--d of |\HAP@tempentry|
2473 % are all used for storing part of a toc entry.
2474 % \begin{macrocode}
2475 \let\HAP@tocentryb\@undefined
2476 % \end{macrocode}
2477 % True if a toc entry is the first inside the toc. Used to determine
2478 % if vertical space needs to be inserted or not.
2479 % \begin{macrocode}
2480 \newif\ifHAP@firstTocEntry
2481 % \end{macrocode}
2482 % Write the toc at the end of the document so that it can be used
2483 % during a pass.
2484 % \begin{macrocode}
2485 \AtEndDocument{%
2486 \ifHAP@toc
2487 \expandafter\newwrite\csname tf@toc\endcsname
2488 \immediate\openout\csname tf@toc\endcsname\jobname.toc\relax
2489 % \end{macrocode}
2490 % When highlighting toc entries, the toc is created with a lag to be able to
2491 % determine the start and stop slide for highlighting and hence the
2492 % final entry has to be written to file at the end of the document.
2493 % \begin{macrocode}
2494 \ifHAP@highlight\ifHAP@notesonly\else
2495 \stepcounter{trueSlideCounter}%
2496 \protected@write\@auxout{}{%
2497 \string\@writefile{toc}{%
2498 \string\pcontentsline{\HAP@tocentrya}{\HAP@tocentryb}%
2499 {\HAP@tocentryc}{\number\c@trueSlideCounter}{\HAP@tocentryd}}%
2500 }%
2501 \fi\fi\fi
2502 }
2503 % \end{macrocode}
2504 % \begin{macro}{\pcontentsline}
2505 % This macro is used in the |.toc| file and creates the actual toc
2506 % entry from a set of inputs.
2507 % \HAPcmd{\ci{pcontentsline}\marg{type}\marg{title}\marg{start}\marg{stop}\marg{secctr}}
2508 % For |type|, see |\tsection|.
2509 % |start| is the starting page of the slide and |stop| is the
2510 % final slide, both used for highlighting toc entries. If no highlighting
2511 % is requested, only |start| is used to create a link to that page. |secctr| is
2512 % the number of the section in the presentation (only used when
2513 % |type| is 1 or 2). This macro does the first rough filtering in
2514 % the decision to display the inputs at a certain slide or not.
2515 % \begin{macrocode}
2516 \def\pcontentsline#1#2#3#4#5{%
2517 % \end{macrocode}
2518 % Not a section.
2519 % \begin{macrocode}
2520 \ifnum#1=\z@
2521 % \end{macrocode}
2522 % For |\HAP@toctype| see the definitions of |\HAP@toc|, |\HAP@tcontent|
2523 % and |\HAP@tsections|. If 1, only sections wanted, hence do nothing.
2524 % Else continue to |\HAP@pcontentsline|.
2525 % \begin{macrocode}
2526 \ifnum\HAP@toctype=\@ne\else
2527 \HAP@pcontentsline{#1}{#2}{#3}{#4}{#5}%
2528 \fi
2529 % \end{macrocode}
2530 % It is a section.
2531 % \begin{macrocode}
2532 \else
2533 % \end{macrocode}
2534 % If 2, hidden section, only set counter for keeping track of the
2535 % section number inside the toc which is necessary for the |hlsections|
2536 % package option.
2537 % \begin{macrocode}
2538 \ifnum\HAP@toctype=\tw@
2539 \setcounter{HAP@sc@toc}{#5}%
2540 \else
2541 % \end{macrocode}
2542 % Else continue to |\HAP@pcontentsline|.
2543 % \begin{macrocode}
2544 \HAP@pcontentsline{#1}{#2}{#3}{#4}{#5}%
2545 \fi
2546 \fi
2547 }
2548 % \end{macrocode}
2549 % \end{macro}
2550 % \begin{macro}{\HAP@pcontentsline}
2551 % Workhorse for |\pcontentsline|.
2552 % \HAPcmd{\ci{HAP@pcontentsline}\marg{type}\marg{title}\marg{start}\marg{stop}\marg{secctr}}
2553 % Takes the same arguments as that macro and is used to divide input
2554 % in all different cases and creates PDF page links from those inputs.
2555 % \begin{macrocode}
2556 \def\HAP@pcontentsline#1#2#3#4#5{%
2557 % \end{macrocode}
2558 % It is not a section.
2559 % \begin{macrocode}
2560 \ifnum#1=\z@
2561 % \end{macrocode}
2562 % Select right typesetting for toc entry.
2563 % \begin{macrocode}
2564 \ifnum\HAP@toctype=\tw@
2565 \def\HAP@toctext{\HAP@tlineonly{#2}}%
2566 \else
2567 \def\HAP@toctext{\HAP@tline{#2}}%
2568 \fi
2569 % \end{macrocode}
2570 % It is a section.
2571 % \begin{macrocode}
2572 \else
2573 % \end{macrocode}
2574 % Set the counter for later use and typeset the section.
2575 % \begin{macrocode}
2576 \setcounter{HAP@sc@toc}{#5}%
2577 \ifnum\HAP@toctype=\@ne
2578 \def\HAP@toctext{\HAP@tsectiononly{#2}}%
2579 \else
2580 \def\HAP@toctext{\HAP@tsection{#2}}%
2581 \fi
2582 \fi
2583 % \end{macrocode}
2584 % Here we end up with some cluster of cases. Basically, we need to
2585 % determine whether or not the toc entry at hand should be displayed
2586 % and if it will be highlighted. Let's go ahead case by case, line by line.
2587 % \begin{macrocode}
2588 \ifcase
2589 % \end{macrocode}
2590 % First, we decide whether or not to display the entry. We display
2591 % the entry at hand on this slide if it is in the current section.
2592 % \begin{macrocode}
2593 \ifnum\value{HAP@sc@pres}=\value{HAP@sc@toc}\@ne\fi
2594 % \end{macrocode}
2595 % Or if it is an entry that occurs before the first section (independent
2596 % of the current toc section), but only if the toc type is 0. If it is not 0
2597 % we only display it when the first section didn't start yet.
2598 % \begin{macrocode}
2599 \ifnum\value{HAP@sc@toc}=\z@\ifnum\HAP@toctype=\z@\@ne\else
2600 \ifnum\value{HAP@sc@pres}=\z@\@ne\fi\fi\fi
2601 % \end{macrocode}
2602 % Or when it is a regular section. Hidden sections (type 2) and
2603 % content of not current sections is not displayed.
2604 % \begin{macrocode}
2605 \ifnum#1=\@ne\@ne\fi
2606 \z@
2607 \else
2608 % \end{macrocode}
2609 % Add extra vertical space between sections and items given that the
2610 % current entry section is not the first entry in the toc. Be careful
2611 % for a possibly split toc. No extra vertical space in that case.
2612 % \begin{macrocode}
2613 \ifHAP@firstTocEntry\else
2614 \ifcase
2615 \ifnum#1=\z@\@ne\fi
2616 \ifnum\HAP@toctype=\@ne\@ne\fi
2617 \z@
2618 \vspace*{\HAP@tsectionskip}%
2619 \else
2620 \vspace*{\HAP@titemskip}%
2621 \fi
2622 \fi
2623 % \end{macrocode}
2624 % Set for the rest of the |.toc| processing.
2625 % \begin{macrocode}
2626 \HAP@firstTocEntryfalse
2627 % \end{macrocode}
2628 % Add a section marker when the current entry is a section.
2629 % \begin{macrocode}
2630 \ifnum#1=\z@\else\HAP@tsectionm\fi
2631 % \end{macrocode}
2632 % Then we come to the point where we start to create the
2633 % toc entries. Now we have to decide how to display the entries.
2634 % \begin{macrocode}
2635 \ifcase
2636 % \end{macrocode}
2637 % If highlighting has been requested
2638 % \begin{macrocode}
2639 \ifHAP@highlight
2640 % \end{macrocode}
2641 % and if the current entry is the active one
2642 % \begin{macrocode}
2643 \ifnum\value{trueSlideCounter}<#3\space\else
2644 \ifnum\value{trueSlideCounter}<#4\@ne\fi\fi
2645 % \end{macrocode}
2646 % or the section is the current section and section highlighting
2647 % has been requested, then we highlight the entry.
2648 % \begin{macrocode}
2649 \ifHAP@hlsections\ifnum#1=\z@\else
2650 \ifnum\value{HAP@sc@pres}=\value{HAP@sc@toc}\@ne\fi\fi\fi
2651 \fi
2652 \z@
2653 \let\HAP@tempa\HAP@tocentry
2654 \else
2655 \let\HAP@tempa\HAP@hltocentry
2656 \fi
2657 % \end{macrocode}
2658 % Create the pdf hyperlink to the page.
2659 % \begin{macrocode}
2660 \HAP@pdfpagelink{\HAP@tempa}{#3}%
2661 \par
2662 \fi
2663 }
2664 % \end{macrocode}
2665 % \end{macro}
2666 % \DescribeMacro{\HAP@pdfpagelink}
2667 % This macro creates the page link for |\HAP@pcontentsline| using a PDF annotation.
2668 % \HAPcmd{\ci{HAP@pdfpagelink}\marg{constr}\marg{page}}
2669 % |constr| is the construction to attach the link to.
2670 % |page| is the target page. This code does not use |hyperref|'s
2671 % hypertarget since these can lead to half slides being displayed.
2672 % \begin{macrocode}
2673 \def\HAP@pdfpagelink#1#2{%
2674 \pdfmark[#1]{pdfmark=/LNK,
2675 Raw={/Page #2 /Border [0 0 0] /View [/XYZ null null null]}}%
2676 }
2677 % \end{macrocode}
2678 % \begin{macro}{\HAP@contentsline}
2679 % This macro writes the toc entries to disk or remembers them
2680 % if necessary. \HAPcmd{\ci{HAP@contentsline}\marg{type}\marg{title}\marg{page}\marg{secctr}}
2681 % For the arguments, see |\pcontentsline|.
2682 % \begin{macrocode}
2683 \def\HAP@contentsline#1#2#3#4{%
2684 \ifHAP@toc
2685 \ifHAP@highlight
2686 \ifx\HAP@tocentryb\@undefined\else
2687 % \end{macrocode}
2688 % When highlighting and it is not the first toc entry of the presentation, write it to disk.
2689 % \begin{macrocode}
2690 \protected@write\@auxout{}{%
2691 \string\@writefile{toc}{%
2692 \string\pcontentsline{\HAP@tocentrya}{\HAP@tocentryb}%
2693 {\HAP@tocentryc}{#3}{\HAP@tocentryd}}}%
2694 \fi
2695 % \end{macrocode}
2696 % Remember the current entry. This is done to remember the starting
2697 % page of a slide. Write it when the next slide appears and the final
2698 % page of the current slide is known.
2699 % \begin{macrocode}
2700 \gdef\HAP@tocentrya{#1}%
2701 % \end{macrocode}
2702 % |\protected@xdef| necessary to expand |\@tockey| inputs correctly.
2703 % \begin{macrocode}
2704 \protected@xdef\HAP@tocentryb{#2}%
2705 \xdef\HAP@tocentryc{#3}%
2706 \xdef\HAP@tocentryd{#4}%
2707 \else
2708 % \end{macrocode}
2709 % When not highlighting, write the entry to disk.
2710 % \begin{macrocode}
2711 \protected@write\@auxout{}{%
2712 \string\@writefile{toc}{%
2713 \string\pcontentsline{#1}{#2}{#3}{}%
2714 {\ifnum#1=\z@\else\number\c@HAP@sc@pres\fi}}}%
2715 \fi
2716 \fi
2717 }
2718 % \end{macrocode}
2719 % \end{macro}
2720 % \begin{macro}{\HAP@toc}
2721 % \begin{macro}{\HAP@tsections}
2722 % \begin{macro}{\HAP@tcontent}
2723 % These macros put (part of) the table of contents on slides.
2724 % The latter two allow for splitting of the toc. Notice that
2725 % the actual splitting is handled by |\pcontentsline| using
2726 % |\HAP@toctype| as guidance. The macros use |\HAP@tocinput|
2727 % to perform initializations and then load the |.toc| file.
2728 % The first macro will put the entire toc on slides.
2729 % \begin{macrocode}
2730 \def\HAP@toc{%
2731 \def\HAP@toctype{0}%
2732 % \end{macrocode}
2733 % Load |.toc| file.
2734 % \begin{macrocode}
2735 \HAP@tocinput
2736 }
2737 % \end{macrocode}
2738 % This puts only the sections on slides.
2739 % \begin{macrocode}
2740 \def\HAP@tsections{%
2741 \def\HAP@toctype{1}%
2742 \HAP@tocinput
2743 }
2744 % \end{macrocode}
2745 % This puts only the current section content on slides.
2746 % \begin{macrocode}
2747 \def\HAP@tcontent{%
2748 \def\HAP@toctype{2}%
2749 \HAP@tocinput
2750 }
2751 % \end{macrocode}
2752 % \end{macro}
2753 % \end{macro}
2754 % \end{macro}
2755 % \begin{macro}{\HAP@tocinput}
2756 % Macro performs some initializations and then loads the |.toc| file.
2757 % \begin{macrocode}
2758 \def\HAP@tocinput{%
2759 % \end{macrocode}
2760 % Eliminates space on top of the first toc entry.
2761 % \begin{macrocode}
2762 \HAP@firstTocEntrytrue
2763 % \end{macrocode}
2764 % Reset within |.toc| counter.
2765 % \begin{macrocode}
2766 \setcounter{HAP@sc@toc}{0}%
2767 % \end{macrocode}
2768 % Allow for instance the |babel| package to insert |\select@language|
2769 % into the |.toc| file.
2770 % \begin{macrocode}
2771 \makeatletter
2772 % \end{macrocode}
2773 % Apply |\FontToc| and input |.toc| file for processing.
2774 % \begin{macrocode}
2775 \fontToc{\InputIfFileExists{\jobname.toc}{}{}}%
2776 \makeatother
2777 }
2778 % \end{macrocode}
2779 % \end{macro}
2780 % \subsubsection{Redefining slide definitions}
2781 % We start with optional keys for the new slide environment.
2782 % \begin{macrocode}
2783 \define@key{HAP@keys@slidespec}{bm}{\def\HAP@bmkey{#1}}
2784 \define@key{HAP@keys@slidespec}{toc}{\def\HAP@tockey{#1}}
2785 \define@key{HAP@keys@slide}{trans}{\def\HAP@transkey{#1}}
2786 \define@key{HAP@keys@slide}{sound}{\def\HAP@soundkey{#1}}
2787 % \end{macrocode}
2788 % \begin{environment}{SlideNormal}
2789 % What follows now is adapted code, originally taken from
2790 % \pf{prosper}.
2791 % \begin{macrocode}
2792 \def\SlideNormal{\@ifnextchar[\HAP@SlideNormal{\HAP@SlideNormal[]}}
2793 \def\HAP@SlideNormal[#1]#2{%
2794 % \end{macrocode}
2795 % Set the optional keys using the \pf{xkeyval} package.
2796 % \begin{macrocode}
2797 \xsetkeys{HAP@keys@slide,HAP@keys@slidespec}{#1}%
2798 \stepcounter{trueSlideCounter}%
2799 % \end{macrocode}
2800 % Transition effects.
2801 % \begin{macrocode}
2802 \PDFtransition{\HAP@transkey}%
2803 % \end{macrocode}
2804 % Add transition sounds.
2805 % \begin{macrocode}
2806 \ifx\HAP@soundkey\@undefined\else
2807 \SlideSound{\HAP@soundkey}%
2808 \fi
2809 \begin{slide@seminar}%
2810 % \end{macrocode}
2811 % |\landscapefalse| is defined by |seminar|.
2812 % \begin{macrocode}
2813 \ifHAP@portrait\landscapefalse\fi
2814 % \end{macrocode}
2815 % Slide title empty?
2816 % \begin{macrocode}
2817 \def\HAP@tempa{#2}%
2818 \def\HAP@tempb{HAP@notitle}%
2819 \ifx\HAP@tempa\HAP@tempb
2820 % \end{macrocode}
2821 % This part is used by |\part| related commands and |\maketitle|. It
2822 % allows these macros to delete the toc entry and the bookmark entry.
2823 % Deleting bookmark entries on other slides will mess up the nesting
2824 % of bookmarks into sections. First checking the toc entry.
2825 % \begin{macrocode}
2826 \ifx\HAP@tockey\@undefined\else\ifx\HAP@tockey\@empty\else
2827 \HAP@contentsline{0}{\HAP@tockey}{\number\c@trueSlideCounter}{}%
2828 \fi\fi
2829 % \end{macrocode}
2830 % Check the bookmark entry. If empty, do not create the bookmark.
2831 % \begin{macrocode}
2832 \ifx\HAP@bmkey\@undefined\else\ifx\HAP@bmkey\@empty\else
2833 % \end{macrocode}
2834 % We have a new bookmark in the current section.
2835 % \begin{macrocode}
2836 \stepcounter{HAP@sc@slides}%
2837 % \end{macrocode}
2838 % Write the bookmark to the |.bm| file. The labelling will later on
2839 % be used to compute the number of bookmarks to be nested within
2840 % the current section.
2841 % \begin{macrocode}
2842 \HAP@writebm{}{section.\number\c@HAP@sc@pres.\number\c@HAP@sc@slides}%
2843 {\HAP@bmkey}{\number\c@trueSlideCounter}{section.\number\c@HAP@sc@pres}%
2844 \fi\fi
2845 \else
2846 % \end{macrocode}
2847 % Slide title.
2848 % \begin{macrocode}
2849 \slidetitle{#2}%
2850 % \end{macrocode}
2851 % Empty bookmarks will not be created.
2852 % \begin{macrocode}
2853 \ifx\HAP@bmkey\@undefined
2854 \stepcounter{HAP@sc@slides}%
2855 \HAP@writebm{}{section.\number\c@HAP@sc@pres.\number\c@HAP@sc@slides}%
2856 {#2}{\number\c@trueSlideCounter}{section.\number\c@HAP@sc@pres}%
2857 \else\ifx\HAP@bmkey\@empty\else
2858 \stepcounter{HAP@sc@slides}%
2859 \HAP@writebm{}{section.\number\c@HAP@sc@pres.\number\c@HAP@sc@slides}%
2860 {\HAP@bmkey}{\number\c@trueSlideCounter}{section.\number\c@HAP@sc@pres}%
2861 \fi\fi
2862 % \end{macrocode}
2863 % Create toc entry, unless it is empty, then delete it from the toc.
2864 % \begin{macrocode}
2865 \ifx\HAP@tockey\@undefined
2866 \HAP@contentsline{0}{#2}{\number\c@trueSlideCounter}{}%
2867 \else\ifx\HAP@tockey\@empty\else
2868 \HAP@contentsline{0}{\HAP@tockey}{\number\c@trueSlideCounter}{}%
2869 \fi\fi
2870 \fi
2871 % \end{macrocode}
2872 % Start a box, a minipage and make it raggedright.
2873 % \begin{macrocode}
2874 \begin{posit@Box}%
2875 \begin{minipage}{\slideWidth}%
2876 \raggedright
2877 \@DefMyItem%
2878 % \end{macrocode}
2879 % Set the text font.
2880 % \begin{macrocode}
2881 \ifinColor\@fontTextColor\else\@fontTextBW\fi
2882 }
2883 % \end{macrocode}
2884 % Close all started environments and boxes.
2885 % \begin{macrocode}
2886 \def\endSlideNormal{%
2887 \end{minipage}%
2888 \end{posit@Box}%
2889 \end{slide@seminar}%
2890 }
2891 % \end{macrocode}
2892 % \end{environment}
2893 % \begin{environment}{SlideOverlay}
2894 % Overlay slides are very comparable to |\SlideNormal|, but these
2895 % get nested bookmarks and an overlay. The case |\ifDVItoPStrue|
2896 % which \pf{prosper} specifies, is
2897 % not interesting here since the macro is only called from the
2898 % |Overlays| environment which is called from |\overlays| (see page~\pageref{macro:overlays})
2899 % but only
2900 % |\ifDVItoPSfalse|. There is no useful application of the |Overlays|
2901 % environment when not being called from the |\overlays| macro.
2902 % \begin{macrocode}
2903 \def\SlideOverlay{\@ifnextchar[\HAP@SlideOverlay{\HAP@SlideOverlay[]}}
2904 \def\HAP@SlideOverlay[#1]#2{%
2905 \xsetkeys{HAP@keys@slide,HAP@keys@slidespec}{#1}%
2906 \stepcounter{trueSlideCounter}%
2907 \PDFtransition{\HAP@transkey}%
2908 \ifx\HAP@soundkey\@undefined\else
2909 \SlideSound{\HAP@soundkey}%
2910 \fi
2911 \begin{slide@seminar}%
2912 \ifHAP@portrait\landscapefalse\fi
2913 \def\HAP@tempa{#2}%
2914 \def\HAP@tempb{HAP@notitle}%
2915 \ifx\HAP@tempa\HAP@tempb\else
2916 \ifHAP@firstOverlay
2917 % \end{macrocode}
2918 % This code is used for the first overlay slide created by |\overlays|.
2919 % \begin{macrocode}
2920 \global\HAP@firstOverlayfalse
2921 % \end{macrocode}
2922 % \pf{prosper} option to open bookmarks of overlays.
2923 % \begin{macrocode}
2924 \ifcollapsedBookmarks\def\HAP@tempa{-}\else\def\HAP@tempa{}\fi
2925 % \end{macrocode}
2926 % Create bookmarks, nest them and open them if requested.
2927 % \begin{macrocode}
2928 \ifx\HAP@bmkey\@undefined
2929 \stepcounter{HAP@sc@slides}%
2930 \HAP@writebm{\HAP@tempa}{section.\number\c@HAP@sc@pres.\number\c@HAP@sc@slides}%
2931 {#2}{\number\c@trueSlideCounter}{section.\number\c@HAP@sc@pres}%
2932 \else\ifx\HAP@bmkey\@empty\else
2933 \stepcounter{HAP@sc@slides}%
2934 \HAP@writebm{\HAP@tempa}{section.\number\c@HAP@sc@pres.\number\c@HAP@sc@slides}%
2935 {\HAP@bmkey}{\number\c@trueSlideCounter}{section.\number\c@HAP@sc@pres}%
2936 \fi\fi
2937 % \end{macrocode}
2938 % Create toc entries.
2939 % \begin{macrocode}
2940 \ifx\HAP@tockey\@undefined
2941 \HAP@contentsline{0}{#2}{\number\c@trueSlideCounter}{}%
2942 \else\ifx\HAP@tockey\@empty\else
2943 \HAP@contentsline{0}{\HAP@tockey}{\number\c@trueSlideCounter}{}%
2944 \fi\fi
2945 \else
2946 % \end{macrocode}
2947 % This case relates to the rest of the slides created by |\overlays|.
2948 % Create bookmarks without nesting and no toc entries.
2949 % \begin{macrocode}
2950 \ifx\HAP@bmkey\@undefined
2951 \HAP@writebm{}{overlay}{#2}{\number\c@trueSlideCounter}%
2952 {section.\number\c@HAP@sc@pres.\number\c@HAP@sc@slides}%
2953 \else\ifx\HAP@bmkey\@empty\else
2954 \HAP@writebm{}{overlay}{\HAP@bmkey}{\number\c@trueSlideCounter}%
2955 {section.\number\c@HAP@sc@pres.\number\c@HAP@sc@slides}%
2956 \fi\fi
2957 \fi
2958 \slidetitle{#2}%
2959 \fi
2960 \begin{posit@Box}%
2961 \begin{minipage}{\slideWidth}%
2962 \raggedright
2963 \@DefMyItem%
2964 \ifinColor\@fontTextColor\else\@fontTextBW\fi
2965 {\overlay{1}}%
2966 }
2967 % \end{macrocode}
2968 % Close all started environments and boxes.
2969 % \begin{macrocode}
2970 \def\endSlideOverlay{%
2971 \end{minipage}%
2972 \end{posit@Box}%
2973 \end{slide@seminar}%
2974 \ifDVItoPS\else
2975 \addtocounter{slide}{-1}%
2976 \fi
2977 }
2978 % \end{macrocode}
2979 % \end{environment}
2980 % \DescribeEnv{slide}
2981 % These macros define the |slide| environment.
2982 % \begin{macrocode}
2983 \let\slide=\SlideNormal
2984 \let\endslide=\endSlideNormal
2985 % \end{macrocode}
2986 % \subsubsection{Bibliography}
2987 % \DescribeEnv{thebibliography}
2988 % This section includes a redefined |bibliography| environment which
2989 % does not create a section heading. The original has been taken from
2990 % |article.cls|.
2991 % \begin{macrocode}
2992 \renewenvironment{thebibliography}[1]{%
2993 \list{\@biblabel{\@arabic\c@enumiv}}%
2994 {\settowidth\labelwidth{\@biblabel{#1}}%
2995 \leftmargin\labelwidth
2996 \advance\leftmargin\labelsep
2997 \@openbib@code
2998 \usecounter{enumiv}%
2999 \let\p@enumiv\@empty
3000 \renewcommand\theenumiv{\@arabic\c@enumiv}}%
3001 \sloppy
3002 \clubpenalty4000
3003 \@clubpenalty \clubpenalty
3004 \widowpenalty4000%
3005 \sfcode`\.\@m
3006 }{%
3007 \def\@noitemerr{\@latex@warning{Empty `thebibliography' environment}}%
3008 \endlist
3009 }
3010 % \end{macrocode}
3011 % \subsubsection{Underlying macros for itemize and enumerate}
3012 % First let the \pf{prosper} command |\NoFrenchBabelItemize| do nothing
3013 % anymore since we redefine lists |\AtBeginDocument| always.
3014 % \begin{macrocode}
3015 \let\NoFrenchBabelItemize\relax
3016 \def\HAP@toodeep{\PackageError{HA-prosper}{Items too deeply nested}\@ehd}
3017 % \end{macrocode}
3018 % |\ifHAP@active| indicates state of an item. \pf{HA-prosper} only
3019 % sets it, but does not use it. It can be used in styles.
3020 % \begin{macrocode}
3021 \newif\ifHAP@active
3022 % \end{macrocode}
3023 % |\ifHAP@nested| indicates whether an |itemize| or |enumerate|
3024 % environment is nested in a stepping environment. In that case,
3025 % active state is inherited.
3026 % \begin{macrocode}
3027 \newif\ifHAP@nested
3028 % \end{macrocode}
3029 % Keep a copy of the original |\item|.
3030 % \begin{macrocode}
3031 \let\HAP@orig@item=\item
3032 % \end{macrocode}
3033 % \DescribeMacro{\xitem}
3034 % The |\xitem| macro.
3035 % \begin{macrocode}
3036 \def\xitem{\@ifnextchar<\HAP@xitem{\HAP@xitem<0>}}
3037 % \end{macrocode}
3038 % \DescribeMacro{\HAP@xitem}
3039 % The workhorse for |\xitem|. It can be reset in environments.
3040 % \begin{macrocode}
3041 \def\HAP@xitem<#1>{%
3042 \PackageError{HA-prosper}{Lonely \string\item--perhaps a missing
3043 list environment}\@ehc
3044 }
3045 \AtBeginDocument{%
3046 % \end{macrocode}
3047 % \begin{environment}{HAP@itemize}
3048 % Define the |HAP@itemize| and |HAP@enumerate| environments without a left block indent
3049 % and |topsep| since this creates ugly lists on slides and wastes
3050 % a lot of space.
3051 % Definitions taken mainly from |latex.ltx| and modified.
3052 % \begin{macrocode}
3053 \def\itemize{%
3054 \def\HAP@xitem<##1>{%
3055 % \end{macrocode}
3056 % If not nested, item is active, otherwise, inherit.
3057 % \begin{macrocode}
3058 \ifHAP@nested\else\HAP@activetrue\fi
3059 \HAP@orig@item
3060 }%
3061 \ifnum\@itemdepth>\tw@\HAP@toodeep\else
3062 \advance\@itemdepth\@ne
3063 \edef\@itemitem{labelitem\romannumeral\the\@itemdepth}%
3064 \expandafter
3065 \list
3066 \csname\@itemitem\endcsname{%
3067 % \end{macrocode}
3068 % Setting relevant lengths.
3069 % \begin{macrocode}
3070 \setlength{\itemsep}{\z@}%
3071 \setlength{\parsep}{\z@}%
3072 \setlength{\topsep}{\z@}%
3073 \setlength{\partopsep}{\z@}%
3074 \addtolength{\topsep}{-\parskip}%
3075 \addtolength{\partopsep}{\parskip}%
3076 \ifnum\@itemdepth<2
3077 \settowidth{\HAP@tla}{\labelitemi}%
3078 \addtolength{\HAP@tla}{\labelsep}%
3079 \setlength{\leftmargin}{\HAP@tla}%
3080 \setlength{\itemsep}{.5ex}%
3081 \fi\raggedright
3082 \def\makelabel##1{\hss\llap{##1}}}%
3083 \fi
3084 }
3085 % \end{macrocode}
3086 % End the list.
3087 % \begin{macrocode}
3088 \let\enditemize\endlist
3089 % \end{macrocode}
3090 % \end{environment}
3091 % \begin{environment}{HAP@enumerate}
3092 % For |HAP@enumerate| we do roughly the same thing.
3093 % \begin{macrocode}
3094 \def\enumerate{%
3095 \def\HAP@xitem<##1>{%
3096 \ifHAP@nested\else\HAP@activetrue\fi
3097 \HAP@orig@item
3098 }%
3099 \ifnum\@enumdepth>\tw@\HAP@toodeep\else
3100 \advance\@enumdepth\@ne
3101 \edef\@enumctr{enum\romannumeral\the\@enumdepth}%
3102 \expandafter
3103 \list
3104 \csname label\@enumctr\endcsname{%
3105 \setlength{\itemsep}{\z@}%
3106 \setlength{\parsep}{\z@}%
3107 \setlength{\topsep}{\z@}%
3108 \setlength{\partopsep}{\z@}%
3109 \addtolength{\topsep}{-\parskip}%
3110 \addtolength{\partopsep}{\parskip}%
3111 \ifnum\@enumdepth<2
3112 \settowidth{\HAP@tla}{\labelenumi}%
3113 \addtolength{\HAP@tla}{\labelsep}%
3114 \setlength{\leftmargin}{\HAP@tla}%
3115 \setlength{\itemsep}{.5ex}%
3116 \fi\raggedright
3117 \usecounter\@enumctr\def\makelabel##1{\hss\llap{##1}}}%
3118 \fi
3119 }
3120 % \end{macrocode}
3121 % End the list.
3122 % \begin{macrocode}
3123 \let\endenumerate\endlist
3124 % \end{macrocode}
3125 % \end{environment}
3126 % End of |\AtBeginDocument|.
3127 % \begin{macrocode}
3128 }
3129 % \end{macrocode}
3130 % \subsubsection{Stepping environments}
3131 % Now we define animated lists. We start with the overall depth of a list
3132 % with possibly |itemstep|s and |enumstep|s nested into each other.
3133 % \begin{macrocode}
3134 \newcounter{HAP@listdepth}
3135 % \end{macrocode}
3136 % Optional arguments.
3137 % \begin{macrocode}
3138 \define@key{HAP@keys@step}{sstart}{\def\HAP@Istart{#1}}
3139 \define@key{HAP@keys@step}{stype}{\def\HAP@Itype{#1}}
3140 \define@key{HAP@keys@step}{iacolor}{\def\HAP@Icolor{#1}}
3141 % \end{macrocode}
3142 % \DescribeEnv{itemstep}\DescribeEnv{enumstep}
3143 % These macros generate the animated lists. Taken from
3144 % prosper and heavily modified to allow for multiple types
3145 % of animated lists and nesting of |enumstep| and |itemstep|
3146 % environments.
3147 % \begin{macrocode}
3148 \def\itemstep{\@ifnextchar[{\HAP@stepenv{0}}{\HAP@stepenv{0}[]}}
3149 \def\enumstep{\@ifnextchar[{\HAP@stepenv{1}}{\HAP@stepenv{1}[]}}
3150 % \end{macrocode}
3151 % Closing the environments |itemstep| and |enumstep|.
3152 % \begin{macrocode}
3153 \def\enditemstep{\endHAP@stepenv{0}}
3154 \def\endenumstep{\endHAP@stepenv{1}}
3155 % \end{macrocode}
3156 % \begin{environment}{HAP@stepenv}
3157 % Workhorse for both |itemstep| and |enumstep|. The first
3158 % argument identifies the type of list (0 for |itemstep|)
3159 % and the second contains the optional arguments.
3160 % \begin{macrocode}
3161 \def\HAP@stepenv#1[#2]{%
3162 % \end{macrocode}
3163 % A following environment might be nested. Important for setting active
3164 % state.
3165 % \begin{macrocode}
3166 \HAP@nestedtrue
3167 % \end{macrocode}
3168 % Load the options into macros.
3169 % \begin{macrocode}
3170 \xsetkeys{HAP@keys@step}{#2}%
3171 % \end{macrocode}
3172 % If |dvi2ps|, all items should be active since overlays create
3173 % only one slide.
3174 % \begin{macrocode}
3175 \ifDVItoPS\def\HAP@Itype{0}\fi
3176 % \end{macrocode}
3177 % Start the list.
3178 % \begin{macrocode}
3179 \ifnum#1=\z@
3180 \begin{itemize}%
3181 \else
3182 \begin{enumerate}%
3183 \fi
3184 % \end{macrocode}
3185 % Possibility to let the animated list start at a later overlay.
3186 % Only possible when the overall depth is zero, hence the current
3187 % list is not nested.
3188 % \begin{macrocode}
3189 \ifnum\value{HAP@listdepth}=\z@
3190 \setcounter{item@step}{\HAP@Istart}%
3191 \addtocounter{item@step}{-1}%
3192 \fi
3193 % \end{macrocode}
3194 % Increase list depth. We are one level deeper.
3195 % \begin{macrocode}
3196 \stepcounter{HAP@listdepth}%
3197 % \end{macrocode}
3198 % \begin{macro}{\HAP@xitem}
3199 % Workhorse for |\xitem|.
3200 % \begin{macrocode}
3201 \def\HAP@xitem<##1>{%
3202 % \end{macrocode}
3203 % Next step in the list.
3204 % \begin{macrocode}
3205 \stepcounter{item@step}%
3206 % \end{macrocode}
3207 % Set temp counter to |item@step + input value|.
3208 % \begin{macrocode}
3209 \setcounter{HAP@tca}{\value{item@step}}%
3210 \addtocounter{HAP@tca}{##1}%
3211 \HAP@activetrue
3212 % \end{macrocode}
3213 % If the type is 0, all items remain active, display incrementally.
3214 % \begin{macrocode}
3215 \ifnum\HAP@Itype=\z@
3216 \HAP@textc
3217 \OnSlide{\value{item@step}-}%
3218 \else
3219 % \end{macrocode}
3220 % Else, items can become inactive. If type is 1, display list incrementally.
3221 % \begin{macrocode}
3222 \ifnum\HAP@Itype=\@ne\OnSlide{\value{item@step}-}\fi
3223 \ifcase
3224 % \end{macrocode}
3225 % If |item@step| $\leq$ |overlay number| $\leq$ |item@step + input value|,
3226 % then item is active.
3227 % \begin{macrocode}
3228 \ifnum\value{overlaysCount}<\value{item@step}\@ne\fi
3229 \ifnum\value{overlaysCount}>\value{HAP@tca}\@ne\fi
3230 \z@
3231 \HAP@textc
3232 \else
3233 \csname\HAP@Icolor\endcsname
3234 \HAP@activefalse
3235 \fi
3236 \fi
3237 % \end{macrocode}
3238 % Original |\item|. This allows for doing |\xitem[a]| or |\xitem<1>[b]|.
3239 % \begin{macrocode}
3240 \HAP@orig@item
3241 }%
3242 % \end{macrocode}
3243 % \end{macro}
3244 % \begin{macrocode}
3245 }
3246 % \end{macrocode}
3247 % Workhorse for |\enditemstep| and |\endenumstep|
3248 % \begin{macrocode}
3249 \def\endHAP@stepenv#1{%
3250 \ifnum#1=\z@
3251 \end{itemize}%
3252 \else
3253 \end{enumerate}%
3254 \fi
3255 % \end{macrocode}
3256 % Decrease list depth.
3257 % \begin{macrocode}
3258 \addtocounter{HAP@listdepth}{-1}%
3259 % \end{macrocode}
3260 % Reset the |item@step| counter for a next list.
3261 % \begin{macrocode}
3262 \ifnum\value{HAP@listdepth}=\z@
3263 \setcounter{item@step}{0}%
3264 \HAP@nestedfalse
3265 \fi
3266 }
3267 % \end{macrocode}
3268 % \end{environment}
3269 % \subsubsection{Maketitle}
3270 % \begin{macro}{\maketitle}
3271 % We start with restoring two macros to the \LaTeX\ original.
3272 % \begin{macrocode}
3273 \def\title#1{\gdef\@title{#1}}
3274 \def\author#1{\gdef\@author{#1}}
3275 % \end{macrocode}
3276 % This code originates from the \pf{prosper} but has been modified
3277 % a lot.
3278 % \begin{macrocode}
3279 \renewcommand{\maketitle}[1][]{%
3280 % \end{macrocode}
3281 % \pf{prosper} comment: Tests whether the 'french' style from B. Gaulle is loaded.
3282 % \begin{macrocode}
3283 \expandafter\ifx\csname frenchTeXmods\endcsname\relax
3284 \else
3285 % \end{macrocode}
3286 % \pf{prosper} comment: Is it an old version affected by the bug.
3287 % \begin{macrocode}
3288 \ifx\@soORI\@undefined
3289 \PackageWarning{prosper}{This page is intentionally left blank
3290 to overcome an incompatibility bug in the seminar class with
3291 the old (< 1999/11/23) B. Gaulle's 'french' package.}%
3292 \begin{center}%
3293 {\black\small
3294 \textsf{prosper} class: page intentionally left blank to overcome
3295 an incompatibility bug between B. Gaulle 'french' package and
3296 the seminar class.}%
3297 \end{center}%
3298 \clearpage \setcounter{page}{0}%
3299 \fi\fi
3300 % \end{macrocode}
3301 % Allow for optional arguments in |\maketitle| command.
3302 % \begin{macrocode}
3303 \begin{slide}[#1]{HAP@notitle}%
3304 \ptsize{10}%
3305 \begin{center}%
3306 \@titleSpacing\par
3307 \normalfont
3308 {\ifinColor\@fontTitleColor\else\@fontTitleBW\fi\@title\par}%
3309 \ifx\@Subtitle\@empty\else
3310 {\ifinColor\@fontSubtitleColor\else\@fontSubtitleBW\fi\@Subtitle\par}%
3311 \fi
3312 \vskip2em
3313 % \end{macrocode}
3314 % Put author in a tabular to allow for the use of the standard |\and| command.
3315 % \begin{macrocode}
3316 {\ifinColor\@fontAuthorColor\else\@fontAuthorBW\fi
3317 \begin{tabular}[t]{c}\@author\end{tabular}\par}%
3318 \vfill
3319 \end{center}%
3320 \end{slide}%
3321 }
3322 % \end{macrocode}
3323 % \end{macro}
3324 % \subsubsection{Overlays}
3325 % This section contains some overlays macros. We start with the
3326 % |Overlays| environment used by the |\overlays| macro.
3327 % \begin{macrocode}
3328 \newif\ifHAP@firstOverlay
3329 \def\Overlays{%
3330 \HAP@firstOverlaytrue
3331 \global\let\slide\SlideOverlay
3332 \global\let\endslide\endSlideOverlay
3333 \setcounter{overlay@page}{\value{slide}}%
3334 }
3335 \def\endOverlays{%
3336 \HAP@firstOverlayfalse
3337 \global\let\slide\SlideNormal
3338 \global\let\endslide\endSlideNormal
3339 \setcounter{slide}{\value{overlay@page}}%
3340 \stepcounter{slide}%
3341 }
3342 % \end{macrocode}
3343 % This patch by Mathieu Goutelle, modified by Hendri Adriaens,
3344 % solves the problem of numbering on overlays. Custom counters
3345 % can be requested to be protected using |\HAPsetup|.
3346 % \begin{macro}{\overlays}\label{macro:overlays}
3347 % This code has been taken from \pf{prosper} and has been modified.
3348 % \begin{macrocode}
3349 \long\def\overlays#1#2{%
3350 \bgroup
3351 \aftergroup\HAP@cleanupOverlay
3352 \InOverlaystrue
3353 \setcounter{limitOverlays}{#1}%
3354 \setcounter{overlaysCount}{1}%
3355 \ifDVItoPS
3356 #2
3357 \else
3358 \begin{Overlays}%
3359 \bgroup
3360 \loop
3361 \@everyOverlay
3362 % \end{macrocode}
3363 % Save current counter values.
3364 % \begin{macrocode}
3365 \HAP@scounters
3366 #2
3367 \ifnum\value{overlaysCount}<\value{limitOverlays}{%
3368 \stepcounter{overlaysCount}%
3369 % \end{macrocode}
3370 % Return the counters to the original setting on every
3371 % overlay to be able to number items correctly.
3372 % \begin{macrocode}
3373 \HAP@rcounters
3374 }%
3375 \repeat
3376 \egroup
3377 \end{Overlays}%
3378 \fi
3379 \egroup
3380 }
3381 % \end{macrocode}
3382 % \end{macro}
3383 % \DescribeMacro{\HAP@cleanupOverlay}
3384 % To be performed after using |\overlays|. Reset the counters to allow
3385 % for reusing the value of the counters, for instance in style files.
3386 % \begin{macrocode}
3387 \def\HAP@cleanupOverlay{%
3388 \InOverlaysfalse
3389 \setcounter{limitOverlays}{0}%
3390 \setcounter{overlaysCount}{0}%
3391 }
3392 % \end{macrocode}
3393 % Let the |\saveCtr| do nothing since this package offers a different
3394 % mechanism to protect counters on overlays.
3395 % \begin{macrocode}
3396 \let\saveCtr\relax
3397 % \end{macrocode}
3398 % The following key saves the input to |\HAP@counterslist|, adds the
3399 % counters |figure|, |table| and |equation| to the list and creates
3400 % backup counters.
3401 % \begin{macrocode}
3402 \define@key{HAP@keys@globalonly}{counters}{%
3403 \def\HAP@counterslist{#1}%
3404 \ifx\HAP@counterslist\@empty
3405 \g@addto@macro\HAP@counterslist{figure,equation,table}%
3406 \else
3407 \g@addto@macro\HAP@counterslist{,figure,equation,table}%
3408 \fi
3409 % \end{macrocode}
3410 % Create backup counters.
3411 % \begin{macrocode}
3412 \@for\HAP@tempa:=\HAP@counterslist\do{%
3413 \@ifundefined{c@\HAP@tempa}{\@nocounterr{\HAP@tempa}}%
3414 {\@ifundefined{c@HAP@oldc@\HAP@tempa}{\newcounter{HAP@oldc@\HAP@tempa}}{}}%
3415 }%
3416 }
3417 % \end{macrocode}
3418 % \DescribeMacro{\HAP@scounters}
3419 % Saves current counter values to the backup counters.
3420 % \begin{macrocode}
3421 \def\HAP@scounters{%
3422 \@for\HAP@tempa:=\HAP@counterslist\do{%
3423 \setcounter{HAP@oldc@\HAP@tempa}{\value{\HAP@tempa}}%
3424 }%
3425 }
3426 % \end{macrocode}
3427 % \DescribeMacro{\HAP@rcounters}
3428 % Resets the actual counters using the backup counters.
3429 % \begin{macrocode}
3430 \def\HAP@rcounters{%
3431 \@for\HAP@tempa:=\HAP@counterslist\do{%
3432 \setcounter{\HAP@tempa}{\value{HAP@oldc@\HAP@tempa}}%
3433 }%
3434 }
3435 % \end{macrocode}
3436 % \subsubsection{Font definitions}
3437 % This section contains some font definitions in the light of \pf{prosper}
3438 % The |\Font...| macros define fonts to be used for certain text elements
3439 % and the |\font...| versions allow to apply the predefined font to
3440 % the text.\par
3441 % \DescribeMacro{\FontLeftFoot}\DescribeMacro{\fontLeftFoot}
3442 % Definitions for the left footer.
3443 % \begin{macrocode}
3444 \def\@fontLFColor{\@fontTextColor\fontsize{5pt}{5pt}\selectfont}
3445 \def\@fontLFBW{\@fontTextBW\fontsize{5pt}{5pt}\selectfont}
3446 \newcommand{\FontLeftFoot}[2]{%
3447 \gdef\@fontLFColor{#1}%
3448 \gdef\@fontLFBW{#2}}
3449 \newcommand{\fontLeftFoot}[1]{{\ifinColor\@fontLFColor\else\@fontLFBW\fi#1}}
3450 % \end{macrocode}
3451 % \DescribeMacro{\FontRightFoot}\DescribeMacro{\fontRightFoot}
3452 % Definitions for the right footer.
3453 % \begin{macrocode}
3454 \def\@fontRFColor{\@fontTextColor\fontsize{5pt}{5pt}\selectfont}
3455 \def\@fontRFBW{\@fontTextBW\fontsize{5pt}{5pt}\selectfont}
3456 \newcommand{\FontRightFoot}[2]{%
3457 \gdef\@fontRFColor{#1}%
3458 \gdef\@fontRFBW{#2}}
3459 \newcommand{\fontRightFoot}[1]{{\ifinColor\@fontRFColor\else\@fontRFBW\fi#1}}
3460 % \end{macrocode}
3461 % \DescribeMacro{\FontAuthor}\DescribeMacro{\fontAuthor}
3462 % Definitions for author.
3463 % \begin{macrocode}
3464 \def\@fontAuthorColor{\@fontTextColor}
3465 \def\@fontAuthorBW{\@fontTextBW}
3466 \newcommand{\FontAuthor}[2]{%
3467 \gdef\@fontAuthorColor{#1}%
3468 \gdef\@fontAuthorBW{#2}}
3469 \newcommand{\fontAuthor}[1]{{\ifinColor\@fontAuthorColor\else\@fontAuthorBW\fi#1}}
3470 % \end{macrocode}
3471 % \DescribeMacro{\FontInst}\DescribeMacro{\fontInst}
3472 % Definitions for institution.
3473 % \begin{macrocode}
3474 \def\@fontInstColor{\@fontTextColor\fontsize{7pt}{7pt}\selectfont}
3475 \def\@fontInstBW{\@fontTextBW\fontsize{7pt}{7pt}\selectfont}
3476 \newcommand{\FontInst}[2]{%
3477 \gdef\@fontInstColor{#1}%
3478 \gdef\@fontInstBW{#2}}
3479 \newcommand{\fontInst}[1]{{\ifinColor\@fontInstColor\else\@fontInstBW\fi#1}}
3480 % \end{macrocode}
3481 % \DescribeMacro{\institution}
3482 % The |\institution| macro does not put text anymore directly onto
3483 % the title slide. Instead, it applies the font settings and can be
3484 % used inside the |\author| macro.
3485 % \begin{macrocode}
3486 \let\institution\fontInst
3487 % \end{macrocode}
3488 % \DescribeMacro{\FontEmail}\DescribeMacro{\fontEmail}
3489 % Definitions for e-mail.
3490 % \begin{macrocode}
3491 \def\@fontEmailColor{\@fontTextColor\fontsize{7pt}{7pt}\selectfont}
3492 \def\@fontEmailBW{\@fontTextBW\fontsize{7pt}{7pt}\selectfont}
3493 \newcommand{\FontEmail}[2]{%
3494 \gdef\@fontEmailColor{#1}%
3495 \gdef\@fontEmailBW{#2}}
3496 \newcommand{\fontEmail}[1]{{\ifinColor\@fontEmailColor\else\@fontEmailBW\fi#1}}
3497 % \end{macrocode}
3498 % \DescribeMacro{\email}
3499 % The |\email| macro does not put text anymore directly onto
3500 % the title slide. Instead, it applies the font settings and can be
3501 % used inside the |\author| macro.
3502 % \begin{macrocode}
3503 \let\email\fontEmail
3504 % \end{macrocode}
3505 % \DescribeMacro{\FontToc}\DescribeMacro{\fontToc}
3506 % Definitions for the table of contents.
3507 % \begin{macrocode}
3508 \def\@fontTocColor{\@fontTextColor\fontsize{4pt}{6pt}\selectfont}
3509 \def\@fontTocBW{\@fontTextBW\fontsize{4pt}{6pt}\selectfont}
3510 \newcommand{\FontToc}[2]{%
3511 \gdef\@fontTocColor{#1}%
3512 \gdef\@fontTocBW{#2}}
3513 \newcommand{\fontToc}[1]{{\ifinColor\@fontTocColor\else\@fontTocBW\fi#1}}
3514 % \end{macrocode}
3515 % \subsubsection{Footers}
3516 % We don't use the seminar page style. It provides not enough flexibility
3517 % for placement of footers.
3518 % \begin{macrocode}
3519 \renewpagestyle{GenericPageStyle}{}{}
3520 % \end{macrocode}
3521 % \DescribeMacro{\HAP@leftfoot}\DescribeMacro{\HAP@rightfoot}
3522 % These macros store the footer texts.
3523 % \begin{macrocode}
3524 \define@key{HAP@keys@globalonly}{lf}{\def\HAP@leftfoot{#1}}
3525 \define@key{HAP@keys@globalonly}{rf}{\def\HAP@rightfoot{#1}}
3526 % \end{macrocode}
3527 % \DescribeMacro{\LeftFoot}\DescribeMacro{\RightFoot}
3528 % Backward compatibility for earlier version of \pf{HA-prosper} which
3529 % where not using the |\HAPsetup| user interface yet.
3530 % \begin{macrocode}
3531 \def\LeftFoot#1{\def\HAP@leftfoot{#1}}
3532 \def\RightFoot#1{\def\HAP@rightfoot{#1}}
3533 % \end{macrocode}
3534 % \DescribeMacro{\HAP@sn}
3535 % Slide number.
3536 % \begin{macrocode}
3537 \define@key{HAP@keys@globalonly}{sn}{\def\HAP@sn{#1}}
3538 % \end{macrocode}
3539 % \DescribeMacro{\HAP@PutLF}
3540 % This can be used to in a template to position the left footer. It
3541 % uses |\rput| and puts the footer in the left footer font.
3542 % \begin{macrocode}
3543 \newcommand{\HAP@PutLF}[2]{%
3544 \rput[#1](#2){\parbox[t]{\slidewidth}{\fontLeftFoot{\HAP@leftfoot}}}%
3545 }
3546 % \end{macrocode}
3547 % \DescribeMacro{\HAP@PutRF}
3548 % Puts the right footer on slides.
3549 % \begin{macrocode}
3550 \newcommand{\HAP@PutRF}[2]{%
3551 \ifx\HAP@sn\@empty
3552 \rput[#1](#2){%
3553 \parbox[t]{\slidewidth}{\hfill\fontRightFoot{\HAP@rightfoot}}}%
3554 \else
3555 \rput[#1](#2){%
3556 \parbox[t]{\slidewidth}{\hfill\fontRightFoot{\HAP@rightfoot~\HAP@sn}}}%
3557 \fi
3558 }
3559 % \end{macrocode}
3560 % \subsubsection{Dualslides}
3561 % This section contains the code to create dualslides.
3562 % We start with a lot of lengths which can be set by the user.
3563 % \begin{macrocode}
3564 \newlength{\HAP@lcolwidth}
3565 \newlength{\HAP@rcolwidth}
3566 \newlength{\HAP@frsep}
3567 \newlength{\HAP@colsep}
3568 \newlength{\HAP@topsep}
3569 \newlength{\HAP@bottomsep}
3570 \newlength{\HAP@indent}
3571 % \end{macrocode}
3572 % Optional arguments. Refer to the manual for a full
3573 % description of the options.
3574 % \begin{macrocode}
3575 \define@key{HAP@keys@dual}{lineheight}{\def\HAP@lineheight{#1}}
3576 \define@key{HAP@keys@dual}{lfrheight}{\def\HAP@lfrheight{#1}}
3577 \define@key{HAP@keys@dual}{rfrheight}{\def\HAP@rfrheight{#1}}
3578 \define@key{HAP@keys@dual}{frsep}{\setlength{\HAP@frsep}{#1}}
3579 \define@key{HAP@keys@dual}{colsep}{\setlength{\HAP@colsep}{#1}}
3580 \define@key{HAP@keys@dual}{lcolwidth}{\setlength{\HAP@lcolwidth}{#1}}
3581 \define@key{HAP@keys@dual}{rcolwidth}{\setlength{\HAP@rcolwidth}{#1}}
3582 \define@key{HAP@keys@dual}{topsep}{\setlength{\HAP@topsep}{#1}}
3583 \define@key{HAP@keys@dual}{bottomsep}{\setlength{\HAP@bottomsep}{#1}}
3584 \define@key{HAP@keys@dual}{indent}{\setlength{\HAP@indent}{#1}}
3585 % \end{macrocode}
3586 % \DescribeMacro{\HAP@maxdim}
3587 % Macro that returns the maximum of two dimensions.
3588 % \begin{macrocode}
3589 \def\HAP@maxdim#1#2{\ifdim#1>#2#1\else#2\fi}
3590 % \end{macrocode}
3591 % \DescribeMacro{\dualslide}\DescribeMacro{\HAP@dualslide}\DescribeMacro{\HAP@@dualslide}
3592 % The |\dualslide| macro is called with
3593 % \HAPcmd{\ci{dualslide}\oarg{opt1}\oarg{opt2}\oarg{opt3}\marg{options}\marg{left}\marg{right}}
3594 % If only |opt1| specified, then |opt2|=|opt1| and |opt3|=|opt1|. If
3595 % |opt1| and |opt2| specified, |opt3|=|opt1|. The macros |\HAP@dualslide|
3596 % and |\HAP@@dualslide| are used to achieve this behavior.
3597 % See for more info on the arguments the manual.
3598 % \begin{macrocode}
3599 \def\dualslide{\@ifnextchar[\HAP@dualslide{\HAP@@@dualslide[][][]}}
3600 \def\HAP@dualslide[#1]{%
3601 \@ifnextchar[{\HAP@@dualslide[#1]}%
3602 {\HAP@@@dualslide[#1][#1][#1]}%
3603 }
3604 \def\HAP@@dualslide[#1][#2]{%
3605 \@ifnextchar[{\HAP@@@dualslide[#1][#2]}%
3606 {\HAP@@@dualslide[#1][#2][#1]}%
3607 }
3608 % \end{macrocode}
3609 % \begin{macro}{\HAP@@@dualslide}
3610 % Workhorse for |\dualslide|. This macro creates the dualslide construct.
3611 % \begin{macrocode}
3612 \long\def\HAP@@@dualslide[#1][#2][#3]#4#5#6{%
3613 % \end{macrocode}
3614 % Set default dimensions.
3615 % \begin{macrocode}
3616 \setlength{\HAP@frsep}{1.5mm}%
3617 \setlength{\HAP@colsep}{.06\linewidth}%
3618 \setlength{\HAP@lcolwidth}{.47\linewidth}%
3619 \setlength{\HAP@rcolwidth}{.47\linewidth}%
3620 \setlength{\HAP@topsep}{0cm}%
3621 \setlength{\HAP@bottomsep}{0cm}%
3622 \setlength{\HAP@indent}{0cm}%
3623 % \end{macrocode}
3624 % Load options.
3625 % \begin{macrocode}
3626 \xsetkeys{HAP@keys@dual}{#4}%
3627 % \end{macrocode}
3628 % The next section computes the height of the dualslide construct.
3629 % We start with left content height.
3630 % \begin{macrocode}
3631 \sbox\HAP@tba{\begin{minipage}{\HAP@lcolwidth}#5\end{minipage}}%
3632 \setlength{\HAP@tlc}{\the\ht\HAP@tba}%
3633 \addtolength{\HAP@tlc}{\the\dp\HAP@tba}%
3634 % \end{macrocode}
3635 % Right content height.
3636 % \begin{macrocode}
3637 \sbox\HAP@tbb{\begin{minipage}{\HAP@rcolwidth}#6\end{minipage}}%
3638 \setlength{\HAP@tld}{\the\ht\HAP@tbb}%
3639 \addtolength{\HAP@tld}{\the\dp\HAP@tbb}%
3640 % \end{macrocode}
3641 % Take the maximum of left and right content.
3642 % \begin{macrocode}
3643 \setlength{\HAP@tlc}{\HAP@maxdim{\HAP@tlc}{\HAP@tld}}%
3644 % \end{macrocode}
3645 % If a left frame is requested, compute max height again.
3646 % \begin{macrocode}
3647 \ifx\HAP@lfrheight\@undefined\else
3648 \setlength{\HAP@tlc}{\HAP@maxdim{\HAP@lfrheight}{\HAP@tlc}}%
3649 \fi
3650 % \end{macrocode}
3651 % If a line is requested, compute max height again.
3652 % \begin{macrocode}
3653 \ifx\HAP@lineheight\@undefined\else
3654 \setlength{\HAP@tlc}{\HAP@maxdim{\HAP@lineheight}{\HAP@tlc}}%
3655 \fi
3656 % \end{macrocode}
3657 % Finally, evaluate the height of the right frame and compute the max again.
3658 % \begin{macrocode}
3659 \ifx\HAP@rfrheight\@undefined\else
3660 \setlength{\HAP@tlc}{\HAP@maxdim{\HAP@rfrheight}{\HAP@tlc}}%
3661 \fi
3662 % \end{macrocode}
3663 % Now we know the height of the construct, create vertical space
3664 % with a |pspicture| on which we position the elements. In between
3665 % creating elements, we compute a bit with lengths to calculate the
3666 % positions of the elements depending on all the inputs. The code
3667 % below contains references to points. These points can be found in
3668 % the picture below, which shows the top part of the dualslide
3669 % construct to be created by |\HAP@@@dualslide|.\par
3670 %\setlength{\unitlength}{.7cm}
3671 %\begin{picture}(14,2)(0,.5)
3672 %\put(0,.5){\line(0,1){2}}
3673 %\put(0,2.5){\line(1,0){6}}
3674 %\put(6,2.5){\line(0,-1){2}}
3675 %\put(7,.5){\line(0,1){2}}
3676 %\put(8,.5){\line(0,1){2}}
3677 %\put(8,2.5){\line(1,0){6}}
3678 %\put(14,2.5){\line(0,-1){2}}
3679 %\dashline{2}(.75,.5)(.75,1.125)(.75,1.75)
3680 %\dashline{2}(.75,1.75)(1.25,1.75)(1.75,1.75)%
3681 %(2.25,1.75)(2.75,1.75)(3.25,1.75)(3.75,1.75)%
3682 %(4.25,1.75)(4.75,1.75)(5.25,1.75)
3683 %\dashline{2}(5.25,.5)(5.25,1.125)(5.25,1.75)
3684 %\dashline{2}(8.75,.5)(8.75,1.125)(8.75,1.75)
3685 %\dashline{2}(8.75,1.75)(9.25,1.75)(9.75,1.75)%
3686 %(10.25,1.75)(10.75,1.75)(11.25,1.75)(11.75,1.75)%
3687 %(12.25,1.75)(12.75,1.75)(13.25,1.75)
3688 %\dashline{2}(13.25,.5)(13.25,1.125)(13.25,1.75)
3689 %\put(.75,1){\circle*{.15}}
3690 %\put(.35,1){|1|}
3691 %\put(5.25,1){\circle*{.15}}
3692 %\put(4.85,1){|2|}
3693 %\put(6,1){\circle*{.15}}
3694 %\put(5.6,1){|3|}
3695 %\put(7,1){\circle*{.15}}
3696 %\put(6.6,1){|4|}
3697 %\put(8.75,1){\circle*{.15}}
3698 %\put(8.35,1){|5|}
3699 %\put(8,1){\circle*{.15}}
3700 %\put(7.6,1){|6|}
3701 %\put(14,1){\circle*{.15}}
3702 %\put(13.6,1){|7|}
3703 %\end{picture}
3704 % \par
3705 % The starting point is |1|.
3706 % \begin{macrocode}
3707 \pspicture(-\HAP@indent,\HAP@topsep)(\linewidth,-\HAP@tlc)%
3708 % \end{macrocode}
3709 % Set defaults for linewidth and color.
3710 % \begin{macrocode}
3711 \psset{unit=1pt,linewidth=.25pt,linecolor=HAP@framecolor}%
3712 % \end{macrocode}
3713 % The next line brings us to point |2|.
3714 % \begin{macrocode}
3715 \setlength{\HAP@tla}{\HAP@lcolwidth}%
3716 % \end{macrocode}
3717 % And the next to point |3|.
3718 % \begin{macrocode}
3719 \addtolength{\HAP@tla}{\HAP@frsep}%
3720 % \end{macrocode}
3721 % Create the left frame.
3722 % \begin{macrocode}
3723 \ifx\HAP@lfrheight\@undefined\else
3724 \psframe[#1](-\HAP@frsep,\HAP@frsep)(\HAP@tla,-\HAP@lfrheight)%
3725 \fi
3726 % \end{macrocode}
3727 % Put the left content.
3728 % \begin{macrocode}
3729 \rput[tl](0,0){\usebox{\HAP@tba}}%
3730 % \end{macrocode}
3731 % We are back at |2| with the next line.
3732 % \begin{macrocode}
3733 \setlength{\HAP@tla}{\HAP@lcolwidth}%
3734 % \end{macrocode}
3735 % This line moves us on to point |4|.
3736 % \begin{macrocode}
3737 \addtolength{\HAP@tla}{.5\HAP@colsep}%
3738 % \end{macrocode}
3739 % Create the line.
3740 % \begin{macrocode}
3741 \ifx\HAP@lineheight\@undefined\else
3742 \psline[#2](\HAP@tla,\HAP@frsep)(\HAP@tla,-\HAP@lineheight)%
3743 \fi
3744 % \end{macrocode}
3745 % And we go further to point |5|.
3746 % \begin{macrocode}
3747 \addtolength{\HAP@tla}{.5\HAP@colsep}%
3748 \setlength{\HAP@tlc}{\HAP@tla}%
3749 % \end{macrocode}
3750 % With the next line, we are at point |6|.
3751 % \begin{macrocode}
3752 \addtolength{\HAP@tla}{-\HAP@frsep}%
3753 \setlength{\HAP@tlb}{\HAP@tla}%
3754 % \end{macrocode}
3755 % And the next two lines give us point |7|.
3756 % \begin{macrocode}
3757 \addtolength{\HAP@tlb}{\HAP@rcolwidth}%
3758 \addtolength{\HAP@tlb}{2\HAP@frsep}%
3759 % \end{macrocode}
3760 % Create the right frame.
3761 % \begin{macrocode}
3762 \ifx\HAP@rfrheight\@undefined\else
3763 \psframe[#3](\HAP@tla,\HAP@frsep)(\HAP@tlb,-\HAP@rfrheight)%
3764 \fi
3765 % \end{macrocode}
3766 % Put the right content.
3767 % \begin{macrocode}
3768 \rput[tl](\HAP@tlc,0){\usebox{\HAP@tbb}}%
3769 \endpspicture\par
3770 }
3771 % \end{macrocode}
3772 % \end{macro}
3773 % \subsubsection{onSlide and OnSlide}
3774 % The macros in this section form a generelization of the following
3775 % macros of \pf{prosper}: |\fromSlide|, |\FromSlide|, |\untilSlide|,
3776 % |\UntilSlide|, |\onlySlide| and |\OnlySlide|. The macros are more
3777 % or less based on these \pf{prosper} macros, but are more general
3778 % and replace all those macros. We start with some counters
3779 % and an if necessary to determine whether material should be
3780 % displayed on the current overlay or not.
3781 % \begin{macrocode}
3782 \newcounter{HAP@onslide@count}
3783 \newcounter{HAP@onslide@end}
3784 \newif\ifHAP@displayMat
3785 \let\HAP@onslide@list\@empty
3786 % \end{macrocode}
3787 % \begin{macro}{\onSlide}
3788 % \HAPcmd{\ci{onSlide}\marg{overlays}\marg{mat}}
3789 % This macro allows for
3790 % comma seperated inputs like |\onSlide{-2,4,6-8,10-}|. |\onSlide|
3791 % has a starred version which doesn't move the cursor in case the
3792 % material is not displayed on the slide.
3793 % \begin{macrocode}
3794 \def\onSlide{\@ifstar{\HAP@onSlide{1}}{\HAP@onSlide{0}}}
3795 \long\def\HAP@onSlide#1#2{%
3796 % \end{macrocode}
3797 % Split the comma seperated list into parts to be read by |\HAP@read|.
3798 % The macro will set |\ifHAP@displayMat| which tells us to display
3799 % the material on the current slide or not.
3800 % \begin{macrocode}
3801 \HAP@split#2,\relax,%
3802 \let\HAP@next\@gobble
3803 \ifDVItoPS
3804 \ifAccumulate
3805 % \end{macrocode}
3806 % Just display the material in case of printing slides.
3807 % \begin{macrocode}
3808 \let\HAP@next\@iden%
3809 \fi
3810 \else
3811 \ifHAP@displayMat
3812 % \end{macrocode}
3813 % We should display it.
3814 % \begin{macrocode}
3815 \let\HAP@next\@iden%
3816 % \end{macrocode}
3817 % Reset |\ifHAP@displayMat| for future use.
3818 % \begin{macrocode}
3819 \HAP@displayMatfalse
3820 \else
3821 % \end{macrocode}
3822 % If no star, move the cursor using \pf{prosper}'s |PSTricks| construct.
3823 % \begin{macrocode}
3824 \ifnum#1=\z@
3825 \let\HAP@next\@on@overlay@one%
3826 \fi
3827 \fi
3828 \fi
3829 % \end{macrocode}
3830 % Put the material on the slide. This can be |\@gobble|.
3831 % \begin{macrocode}
3832 \HAP@next
3833 }
3834 % \end{macrocode}
3835 % \end{macro}
3836 % \begin{macro}{\OnSlide}
3837 % \HAPcmd{\ci{OnSlide}\marg{overlays}}
3838 % This macro also allows for comma seperated lists, but takes only
3839 % one argument and masks or not all the following material.
3840 % \begin{macrocode}
3841 \def\OnSlide#1{%
3842 % \end{macrocode}
3843 % Split the comma seperated list into parts to be read by |\HAP@read|.
3844 % \begin{macrocode}
3845 \HAP@split#1,\relax,%
3846 \ifDVItoPS\else
3847 % \end{macrocode}
3848 % We should display the following material; don't hide it.
3849 % \begin{macrocode}
3850 \ifHAP@displayMat
3851 % \end{macrocode}
3852 % Reset |\ifHAP@displayMat|.
3853 % \begin{macrocode}
3854 \HAP@displayMatfalse
3855 \else
3856 % \end{macrocode}
3857 % Hide it using \pf{prosper}'s |\overlay|.
3858 % \begin{macrocode}
3859 \overlay{1}%
3860 \fi
3861 \fi
3862 }
3863 % \end{macrocode}
3864 % \end{macro}
3865 % \DescribeMacro{\HAP@split}
3866 % Splits the comma seperated list into parts and reads them one by one.
3867 % This is based on \pf{keyval}'s |\KV@do|.
3868 % \begin{macrocode}
3869 \def\HAP@split#1,{%
3870 \ifx\relax#1\@empty\else
3871 \HAP@read#1--\relax
3872 \expandafter\HAP@split
3873 \fi
3874 }
3875 % \end{macrocode}
3876 % \begin{macro}{\HAP@read}
3877 % This macro reads the argument between two commas supplied by |\HAP@split|.
3878 % We distinct 4 cases: $x$, -$x$, $x$- and $x$-$y$ where $x$ and $y$ are positive
3879 % integers with $y\geq x$. We will not check the argument for specification;
3880 % the responsibility is with the user. The macro first sets a range from
3881 % the inputs, then runs over this range to check wether the current
3882 % overlay is inside the range and hence material should be displayed.
3883 % \begin{macrocode}
3884 \def\HAP@read#1-#2-#3\relax{%
3885 \def\HAP@tempa{#1}%
3886 \def\HAP@tempb{#2}%
3887 \def\HAP@tempc{#3}%
3888 \ifx\HAP@tempa\@empty
3889 % \end{macrocode}
3890 % If |#1| empty, we have -$x$. Set the counter to the starting overlay.
3891 % \begin{macrocode}
3892 \setcounter{HAP@onslide@count}{1}%
3893 \else
3894 % \end{macrocode}
3895 % Else, we have something that starts with $x$ or $+x$, but we don't know the
3896 % exact specification yet. Check whether the input starts with a |+|.
3897 % \begin{macrocode}
3898 \HAP@sp\HAP@tempd{#1}%
3899 \ifHAP@plus
3900 % \end{macrocode}
3901 % If a plus sign, make displaying relative to the current |\xitem|.
3902 % \begin{macrocode}
3903 \setcounter{HAP@onslide@count}{\value{item@step}}%
3904 \addtocounter{HAP@onslide@count}{\HAP@tempd}%
3905 \else
3906 \setcounter{HAP@onslide@count}{#1}%
3907 \fi
3908 \fi
3909 \ifx\HAP@tempb\@empty
3910 \ifx\HAP@tempc\@empty
3911 % \end{macrocode}
3912 % If both |#2| and |#3| empty, we have the case $x$ or $+x$.
3913 % \begin{macrocode}
3914 \HAP@sp\HAP@tempd{#1}%
3915 \ifHAP@plus
3916 % \end{macrocode}
3917 % If a plus sign, make displaying relative to the current |\xitem|.
3918 % \begin{macrocode}
3919 \setcounter{HAP@onslide@end}{\value{item@step}}%
3920 \addtocounter{HAP@onslide@end}{\HAP@tempd}%
3921 \else
3922 \setcounter{HAP@onslide@end}{#1}%
3923 \fi
3924 \else
3925 % \end{macrocode}
3926 % If |#2| empty, but |#3| not (has value |-|), we have the case $x$- or $+x$-.
3927 % \begin{macrocode}
3928 \setcounter{HAP@onslide@end}{\value{limitOverlays}}%
3929 \fi
3930 \else
3931 % \end{macrocode}
3932 % If both |#2| and |#3| non-empty, we have the case $x$-$y$ or a
3933 % variation with |+| signs.
3934 % \begin{macrocode}
3935 \HAP@sp\HAP@tempd{#2}%
3936 \ifHAP@plus
3937 % \end{macrocode}
3938 % If a plus sign, make displaying relative to the current |\xitem|.
3939 % \begin{macrocode}
3940 \setcounter{HAP@onslide@end}{\value{item@step}}%
3941 \addtocounter{HAP@onslide@end}{\HAP@tempd}%
3942 \else
3943 \setcounter{HAP@onslide@end}{#2}%
3944 \fi
3945 \fi
3946 % \end{macrocode}
3947 % Check on input.
3948 % \begin{macrocode}
3949 \ifnum\value{HAP@onslide@count}>\value{HAP@onslide@end}%
3950 \@expandtwoargs\in@{,\theslide,}{,\HAP@onslide@list,}%
3951 \ifin@\else
3952 \PackageError{HA-prosper}{Invalid onSlide or OnSlide range or missing overlays
3953 on slide \theslide}{You can go ahead, but material will be missing.}%
3954 % \end{macrocode}
3955 % Add current slide number to a list to avoid multiple errors per slide.
3956 % \begin{macrocode}
3957 \xdef\HAP@onslide@list{%
3958 \HAP@onslide@list
3959 \ifx\HAP@onslide@list\@empty\else,\fi
3960 \theslide
3961 }%
3962 \fi
3963 \else
3964 % \end{macrocode}
3965 % If the current overlay number is in the range, material should be
3966 % displayed.
3967 % \begin{macrocode}
3968 \ifnum\value{HAP@onslide@count}>\value{overlaysCount}\else
3969 \ifnum\value{HAP@onslide@end}<\value{overlaysCount}\else
3970 \HAP@displayMattrue
3971 \fi\fi
3972 \fi
3973 }
3974 % \end{macrocode}
3975 % \end{macro}
3976 % Code to strip the |+| sign from the start of a list of tokens.
3977 % This is necessary since the input to |\HAP@read| can also
3978 % contain |\value{item@step}|. The code is based on the \pf{keyval}
3979 % macro |\KV@@sp@def|.
3980 % \begin{macrocode}
3981 \def\:{\let\@pltoken=+}\:%
3982 \newtoks\HAP@toks@
3983 \newif\ifHAP@plus
3984 \def\HAP@sp#1#2{%
3985 \futurelet\HAP@tempa\HAP@@sp#2\@nil\@nil+\@nil\relax#1}%
3986 \def\HAP@@sp{%
3987 \ifx\HAP@tempa\@pltoken
3988 \HAP@plustrue
3989 \expandafter\HAP@@@sp
3990 \else
3991 \HAP@plusfalse
3992 \expandafter\HAP@@@sp\expandafter+%
3993 \fi
3994 }%
3995 \def\HAP@@@sp+#1\@nil{\HAP@@@@sp#1}%
3996 \def\HAP@@@@sp#1\@nil#2\relax#3{\HAP@toks@{#1}\edef#3{\the\HAP@toks@}}
3997 % \end{macrocode}
3998 % \subsubsection{Miscellaneous}
3999 % \DescribeMacro{\xitemwait}
4000 % Tells \pf{HA-prosper} to wait some overlays before continuing
4001 % incrementally displayed items.
4002 % \begin{macrocode}
4003 \newcommand{\xitemwait}[1][1]{\addtocounter{item@step}{#1}}
4004 % \end{macrocode}
4005 % \DescribeMacro{\HAP@TSNav}
4006 % Entrance point for navigational elements on the title slide. This
4007 % macro takes the value specified by the |tsnav| global key and can
4008 % be used to put navigational components on slides through a style file.
4009 % \begin{macrocode}
4010 \define@key{HAP@keys@globalonly}{tsnav}{\gdef\HAP@TSNav{#1}}
4011 % \end{macrocode}
4012 % \DescribeMacro{\TitleSlideNav}
4013 % Backward compatibility for earlier version of \pf{HA-prosper} which
4014 % where not using the |\HAPsetup| user interface yet.
4015 % \begin{macrocode}
4016 \def\TitleSlideNav#1{\gdef\HAP@TSNav{#1}}
4017 % \end{macrocode}
4018 % \DescribeMacro{\HAP@NSNav}
4019 % Entrance point for navigational elements on normal slides.
4020 % \begin{macrocode}
4021 \define@key{HAP@keys@globalonly}{nsnav}{\gdef\HAP@NSNav{#1}}
4022 % \end{macrocode}
4023 % \DescribeMacro{\NormalSlideNav}
4024 % Backward compatibility for older presentations.
4025 % \begin{macrocode}
4026 \def\NormalSlideNav#1{\gdef\HAP@NSNav{#1}}
4027 % \end{macrocode}
4028 % Simple interface for the total number of slides in the presentation.
4029 % \begin{macrocode}
4030 \def\totalpages{\realpageref{last@page}}
4031 % \end{macrocode}
4032 % \subsection{Postamble and defaults}
4033 % This section of code contains the finalizing elements like loading
4034 % the requested style, setting defaults and creating extra slide environments.
4035 % \subsubsection{Defaults (1)}
4036 % \DescribeMacro{\HAPsetup}
4037 % Allows for setting some options globally.
4038 % \begin{macrocode}
4039 \def\HAPsetup#1{%
4040 \xsetkeys{HAP@keys@globalonly,HAP@keys@slide,HAP@keys@step}{#1}%
4041 }
4042 % \end{macrocode}
4043 % Set global defaults to prevent errors when the user decides to delete
4044 % a line from the |HA-prosper.cfg| file.
4045 % \begin{macrocode}
4046 \HAPsetup{lf=,rf=,trans=\@defaultTransition,template=slide,sstart=1,
4047 stype=0,iacolor=lightgray,tsnav=FullScreen,nsnav=ShowBookmarks,
4048 sn={-~p.~\thepage\ifallPages/\totalpages\fi},counters=
4049 }
4050 % \end{macrocode}
4051 % Load defaults for global options. Refer to section~\ref{sec:config} for
4052 % the |HA-prosper.cfg| file.
4053 % \begin{macrocode}
4054 \input{HA-prosper.cfg}
4055 % \end{macrocode}
4056 % PDF page cropping default.
4057 % \begin{macrocode}
4058 \hypersetup{pdfpagescrop={0 0 595 840}}
4059 % \end{macrocode}
4060 % PDF creator.
4061 % \begin{macrocode}
4062 \AtBeginDocument{\def\@pdfcreator{LaTeX with hyperref and
4063 HA-prosper packages}}
4064 % \end{macrocode}
4065 % Calibration of commands like |\small| to default font sizes.
4066 % \begin{macrocode}
4067 \ptsize{10}
4068 % \end{macrocode}
4069 % \subsubsection{Load the style}
4070 % First undefine |\slidetitle| since it is already defined by \pf{prosper}.
4071 % \begin{macrocode}
4072 \let\slidetitle\@undefined
4073 % \end{macrocode}
4074 % Load the requested style.
4075 % \begin{macrocode}
4076 \IfFileExists{HAP\HAP@[email protected]}{%
4077 \RequirePackage{HAP\HAP@Style@chosen}%
4078 }{\PackageError{HA-prosper}{unknown HA-prosper style file: HAP\HAP@[email protected]}%
4079 {Sorry, no additional help}}
4080 % \end{macrocode}
4081 % \subsubsection{Extra slide definitions}
4082 % \DescribeMacro{\HAPR@normalslide}
4083 % Check that the normal slide template has been defined by the template.
4084 % \begin{macrocode}
4085 \ifx\HAPR@normalSlide\@undefined
4086 \PackageError{HA-prosper}{HA-prosper normal slide is
4087 not defined in your template}%
4088 {Check that your template HAP\HAP@[email protected] supports
4089 normal slides and that it is up to date}%
4090 \else
4091 \HAPR@normalSlide
4092 % \end{macrocode}
4093 % \DescribeMacro{\HAPR@wideslide}
4094 % If |\HAPR@wideslide| defined, use it to create the |wideslide| environment.
4095 % \begin{macrocode}
4096 \ifx\HAPR@wideSlide\@undefined
4097 \else
4098 \def\wideslide{\@ifnextchar[\HAP@wideslide{\HAP@wideslide[]}}%
4099 \def\HAP@wideslide[#1]#2{%
4100 \HAPR@wideSlide
4101 \begin{slide}[#1]{#2}%
4102 }%
4103 \def\endwideslide{\end{slide}\HAPR@normalSlide}%
4104 \fi
4105 % \end{macrocode}
4106 % \DescribeMacro{\HAPR@partslide}
4107 % If |\HAPR@partslide| defined, use it to create the |partslide| environment.
4108 % \begin{macrocode}
4109 \ifx\HAPR@partSlide\@undefined
4110 \else
4111 \def\partslide{\@ifnextchar[\HAP@partslide{\HAP@partslide[]}}%
4112 \def\HAP@partslide[#1]#2{%
4113 \HAPR@partSlide
4114 \begin{slide}[#1]{#2}%
4115 }%
4116 \def\endpartslide{\end{slide}\HAPR@normalSlide}%
4117 \fi
4118 \fi
4119 % \end{macrocode}
4120 % \DescribeMacro{\maketitle}
4121 % If both |\HAPR@normalslide| and |\HAPR@titleslide| defined, use these
4122 % to redefine the |\maketitle| macro which switches back to the normal
4123 % template automatically after creating the title slide on the title template.
4124 % \begin{macrocode}
4125 \ifcase
4126 \ifx\HAPR@normalSlide\@undefined\@ne\fi
4127 \ifx\HAPR@titleSlide\@undefined\@ne\fi
4128 \z@
4129 \let\HAP@orig@maketitle=\maketitle
4130 \def\maketitle{\@ifnextchar[\HAP@maketitle{\HAP@maketitle[]}}%
4131 \newcommand{\HAP@maketitle}[1][]{%
4132 \HAPR@titleSlide\HAP@orig@maketitle[#1]\HAPR@normalSlide
4133 }%
4134 \fi
4135 % \end{macrocode}
4136 % \subsubsection{Defaults (2)}
4137 % Here we check wether certain vital macros have been defined
4138 % by the template and if not, define them. See the section containing
4139 % developers information in the manual for more information
4140 % about a specific macro listed below.
4141 % \begin{macrocode}
4142 \ifx\HAP@tline\@undefined\def\HAP@tline#1{#1}\fi
4143 \ifx\HAP@tlineonly\@undefined\def\HAP@tlineonly#1{#1}\fi
4144 \ifx\HAP@tsection\@undefined\def\HAP@tsection#1{#1}\fi
4145 \ifx\HAP@tsectiononly\@undefined\def\HAP@tsectiononly#1{#1}\fi
4146 \ifx\HAP@tsectionskip\@undefined\def\HAP@tsectionskip{1.5em}\fi
4147 \ifx\HAP@titemskip\@undefined\def\HAP@titemskip{.1em}\fi
4148 \ifx\HAP@tsectionm\@undefined\let\HAP@tsectionm\@empty\fi
4149 \ifx\HAP@twidth\@undefined\def\HAP@twidth{2cm}\fi
4150 \ifx\HAP@tborder\@undefined\def\HAP@tborder{.05cm}\fi
4151 \ifx\HAP@textc\@undefined\newrgbcolor{HAP@textc}{0 0 0}\fi
4152 \ifx\HAP@framecolor\@undefined\newrgbcolor{HAP@framecolor}{0 0 0}\fi
4153 \ifx\HAP@hcolor\@undefined\newrgbcolor{HAP@hcolor}{0 0 0}\fi
4154 \ifx\HAP@htcolor\@undefined\newrgbcolor{HAP@htcolor}{1 1 1}\fi
4155 \ifx\HAP@tocentry\@undefined
4156 \def\HAP@tocentry{%
4157 % \end{macrocode}
4158 % By default, put text in a |\parbox| for multi-line toc entries.
4159 % \begin{macrocode}
4160 \parbox[b]{\HAP@twidth}{\raggedright\HAP@toctext}%
4161 }%
4162 \fi
4163 \ifx\HAP@hltocentry\@undefined
4164 \def\HAP@hltocentry{%
4165 % \end{macrocode}
4166 % By default, put text in |\parbox| and in |\psframebox| to create the frame.
4167 % \begin{macrocode}
4168 \psframebox*[framesep=\HAP@tborder,fillcolor=HAP@hcolor,boxsep=false]%
4169 {\parbox[b]{\HAP@twidth}{\raggedright{\HAP@htcolor\HAP@toctext}}}%
4170 }%
4171 \fi
4172 % \end{macrocode}
4173 % \subsubsection{ppr-prv entrance point}
4174 % Allow \pf{ppr-prv} to redefine \pf{HA-prosper} macros easily.
4175 % \begin{macrocode}
4176 \@ifclassloaded{ppr-prv}{\InputIfFileExists{HAP-ppr-prv.def}{}{}}{}
4177 %</program>
4178 % \end{macrocode}
4179 % \subsection{Default configuration}\label{sec:config}
4180 % The file |HA-prosper.cfg| generated from the code below contains the
4181 % global configuration settings of \pf{HA-prosper}. We start with a small
4182 % preamble.
4183 % \begin{macrocode}
4184 %<*config>
4185 %%
4186 %% Global defaults of HA-prosper.
4187 %% ==============================
4188 %%
4189 %% You can change this file but be careful since it will
4190 %% affect all of your presentations. See for more information
4191 %% the documentation of the HA-prosper package.
4192 %%
4193 \HAPsetup{%
4194 % \end{macrocode}
4195 % Left footer.
4196 % \begin{macrocode}
4197 lf=,
4198 % \end{macrocode}
4199 % Right footer.
4200 % \begin{macrocode}
4201 rf=,
4202 % \end{macrocode}
4203 % Transition, using \pf{prosper} default for backward compatibility.
4204 % \begin{macrocode}
4205 trans=\@defaultTransition,
4206 % \end{macrocode}
4207 % Template for parts.
4208 % \begin{macrocode}
4209 template=slide,
4210 % \end{macrocode}
4211 % Starting overlay of stepping environments.
4212 % \begin{macrocode}
4213 sstart=1,
4214 % \end{macrocode}
4215 % Type of stepping environment.
4216 % \begin{macrocode}
4217 stype=0,
4218 % \end{macrocode}
4219 % Inactive color for stepping environments.
4220 % \begin{macrocode}
4221 iacolor=lightgray,
4222 % \end{macrocode}
4223 % Title slide navigation.
4224 % \begin{macrocode}
4225 tsnav=FullScreen,
4226 % \end{macrocode}
4227 % Normal slide navigation.
4228 % \begin{macrocode}
4229 nsnav=ShowBookmarks,
4230 % \end{macrocode}
4231 % Slide number layout.
4232 % \begin{macrocode}
4233 sn={-~p.~\thepage\ifallPages/\totalpages\fi},
4234 % \end{macrocode}
4235 % Counters that should be protected on overlays.
4236 % \begin{macrocode}
4237 counters=
4238 }
4239 %</config>
4240 % \end{macrocode}
4241 % \Finale
4242 \endinput