\documentclass[a4paper,11pt]{article} \renewcommand\floatpagefraction{.99} \renewcommand\textfraction{.0} %\usepackage{lucidabr} \usepackage{xspace,colortbl} \usepackage[screen,panelleft,gray,paneltoc]{pdfscreen} \def\pdfscreen{\texttt{pdfscreen}\xspace} \overlay{logo.pdf} \begin{document} \title{\color{section0}\Huge Manual} \author{\color{section1}\Large C.~V.~Radhakrishnan\\ {\small\href{mailto:cvr@river-valley.com} {\color{section1}\texttt{cvr@river-valley.com}}}} \maketitle \vfill \begin{abstract} \noindent \pdfscreen package helps to redesign the pdf output of your normal documents fit to be read in a computer monitor while retaining the freedom to format it for conventional printing. This has been brought about by redefining the margins and page height/\allowbreak width and related dimensions to fit into that of the computer screen. By changing the options to \verb+print+ you can switch the package to format the document in the conventional way as your class file dictates. \end{abstract} \vfill \section{Setup}\label{setup} \emblema{logo.pdf} \overlay{button.pdf} An elaborate manual is not needed for using \pdfscreen, since it is nothing but an extension of the \verb+hyperref.sty+ of \href{mailto:sebastian.rahtz@oucs.ac.uk}{Sebastian Rahtz}. The primary aim of the package is to change the dimensions of the width and height of the page so as to provide an ideal dimension that is fit for screen viewing rather than printing. As such, all those dimensions that control the page shape are redefined to result the desired screen size. The preamble portion requires the package loading command as given below: \begin{verbatim} \usepackage[screen,panelleft]{pdfscreen} \end{verbatim} There is no need to specify the \verb+\usepackage{hyperref}+ with its options, since \verb+hyperref+ is loaded by the \pdfscreen. As in the case of \verb+hyperref.sty+, package loading command has to be given as the last item in the preamble. \subsection{Options}\label{options} The following options are available: \begin{enumerate} \item \verb+screen+ -- generates the screen version \item \verb+print+ -- generates the print that looks like your \verb+dvi+ \item \verb+panelleft+ -- navigation panel in the left side \item \verb+panelright+ -- navigation panel in the right side \item \verb+nopanel+ -- suppresses the panel \item \verb+paneltoc+ -- table of contents in the panel \item \textbf{Color schemes}: There are six color schemes -- bluelace, blue, gray, orange, palegreen and chocolate -- available for panel and buttons that you can give as an option to the package. Default is blue. \item \textbf{Foreign language support}: Not all the foreign languages are supported. Only 15 European languages are supported at the moment. However, all the language names as you give in the \verb+babel+ package can be given here as an option. If the language is not supported, the package will default to English. I may request users to send me the translation of the button text in the navigation panel in your language, if it is not supported. \item \verb+nocfg+ -- an option to suppress the configuration file (see \autoref{cfg}), if you don't want to use its specifications. \end{enumerate} \subsection{Other parameters to be passed}\label{parameters} Few more parameters are to be passed on to the \pdfscreen to make it more functional. They are: \begin{enumerate} \item \verb+\emblema{...}+ -- the name of the graphic file that appears on the navigation panel. \item \verb+\urlid{...}+ -- your \textsc{url}. \item \verb+\screensize{height}{width}+ -- screen dimensions. The default screen dimensions are 6.5in and 8in, being the height and width respectively. There are no restrictions on the screen dimensions. Unlike previous versions, the user is free to choose any dimension. The default width of the panel is 15\% of the width of the screen. \end{enumerate} \subsection{Packages needed to run \pdfscreen} The following packages are needed for smooth compilation (grab the latest from \textsc{ctan}: \begin{enumerate} \item \verb+hyperref.sty+ \item \verb+comment.sty+ \item \verb+fancybox.sty+ \item \verb+truncate.sty+ \end{enumerate} \section{Navigation Panel} \overlayempty The design of the navigation panel is left entirely to the imagination of the user. One can create a panel as per his taste. A newer command, \verb+\panel+ has been added and a default panel is also supplied, which is nothing but a box with navigation buttons vertically arranged. There is also a command: \begin{verbatim} \addButton{length}{button text string} \end{verbatim} which you can use to generate buttons of your choice. Here is an example of how to produce a Next Page button: \begin{verbatim} \Acrobatmenu{NextPage}{\addButton{1.25in}{Next Page}} \end{verbatim} This will generate the following navigation button \begin{center} \Acrobatmenu{NextPage}{\addButton{1.25in}{Next Page}} \end{center} and clicking this will take you to the next page. In the same way, you can build buttons with images too, for which the command, \begin{verbatim} \imageButton{width}{height}{graphic file name} \end{verbatim} will be useful. \begin{center} \href{http://www.tug.org}{\imageButton{.75in}{!}{tex}} \end{center} \clearpage The \textsc{tug} image button is generated by: \begin{verbatim} \href{http://www.tug.org}{\imageButton{.5in}{!}{tex.png}} \end{verbatim} Clicking this button will take you to \url{http://www.tug.org}, the \TeX{} Users Group web site. The navigation panel can be positioned at user's will either to the left side or right side. To see different types of output click the buttons in \autoref{fig2}. \begin{figure}\footnotesize\fboxsep 10pt \colorbox{panelbackground}{% \begin{minipage}{.9\linewidth} \color{orange} \begin{flushleft} \def\pba#1{\begin{minipage}[c][18pt][c]{75pt}#1\end{minipage}} \def\pbb#1{$\Rightarrow$\fboxsep3pt\colorbox{white} {\begin{minipage}[c]{.7\linewidth} \footnotesize\ttfamily\color{section0}#1 \end{minipage}} } \definecolor{buttonbackground}{rgb}{.902,.902,.980} \definecolor{buttonshadow}{rgb}{.412,.412,.412} \pba{\href{left.pdf}{\addButton{1in}{Left Panel}}} \pbb{\string\usepackage[screen,panelleft]\{pdfscreen\}}\\[2pt] \pba{\href{right.pdf}{\addButton{1in}{Right Panel}}} \pbb{\string\usepackage[screen,panelright]\{pdfscreen\}}\\[2pt] \pba{\href{nopanel.pdf}{\addButton{1in}{No Panel}}} \pbb{\string\usepackage[screen,nopanel]\{pdfscreen\}}\\[2pt] \pba{\href{portrait.pdf}{\addButton{1in}{Portrait}}} \pbb{Apart from the package loading command the following is also needed\hfill\break \string\screensize\{height\}\{width\}}\\[2pt] \pba{\href{square.pdf}{\addButton{1in}{Square}}} \pbb{Height and width are same for \string\screensize{} command}\\[2pt] \pba{\href{widepanel.pdf}{\addButton{1in}{Wide Panel}}} \pbb{\string\panelwidth=dimension\hfill\break \string\marginsize\{.5in\}\{panelwidth+.5in\}\{.5in\}\{.5in\} in case you prefer right panel}\\[2pt] \pba{\href{print.pdf}{\addButton{1in}{Print version}}} \pbb{\string\usepackage[print]\{pdfscreen\}} \end{flushleft} \end{minipage}} \caption{Different types of panel positioning\label{fig2}} \end{figure} Width of the panel can be changed by explicitly giving in the preamble of the document like \verb+\panelwidth=+. When you change the panel width (the default is 15\% of the screen width), the margins have also to be supplied. The following command will do the job for you: %\clearpage \begin{verbatim} \marginsize{left}{right}{top}{bottom} \end{verbatim} The default values for all the margins are 0.5in on each side when you choose \verb+nopanel+ option. If you choose the \verb+panelright+, the panel width will be added to the right margin and vice versa if \verb+panelleft+ is chosen. The margin computation for \verb+panelleft+ option with a panel width of 2in will be (assuming that your left margin without panel is 0.5in): \begin{verbatim} \marginsize{2.5in}{.5in}{.5in}{.5in} \end{verbatim} You can define your own panel which is nothing but a vertical box with whatever stuff you want to fit into. The navigation panel of this document is made up of the following code given in \autoref{fig1}. \begin{figure}\footnotesize \begin{minipage}{.9\linewidth} \color{green} \begin{verbatim} \panelwidth=1.3in \def\panel{\colorbox{panelbackground} {\begin{minipage}[t][\paperheight][b]{\panelwidth} \centering\null\vspace*{12pt} \includegraphics[width=.75in]{univ}\par\vfill \begin{flushleft} \InputIfFileExists{\jobname.toc}{}{\AtEndDocument{\TOC}} \end{flushleft}\par\vfill \href{\@urlid}{\addButton{.85in}{\@Panelhomepagename}}\par\vfill \Acrobatmenu{FirstPage}{\addButton{.85in} {\FBlack\@Paneltitlepagename}}\par\vfill \Acrobatmenu{FirstPage}{\addButton{.2in} {\FBlack\scalebox{.8}[1.4]{\btl\btl}}}\hspace{-3pt} \Acrobatmenu{PrevPage}{\addButton{.2in} {\FBlack\scalebox{.8}[1.4]{\btl}}}\hspace{-3pt} \Acrobatmenu{NextPage}{\addButton{.2in} {\LBlack\scalebox{.8}[1.4]{\rtl}}}\hspace{-3pt} \Acrobatmenu{LastPage}{\addButton{.2in} {\LBlack\scalebox{.8}[1.4]{\rtl\rtl}}}\par\vfill \Acrobatmenu{GoBack}{\addButton{.85in} {\@Panelgobackname}}\par\vfill \Acrobatmenu{FullScreen}{\addButton{.85in}{Full Screen}}\par\vfill \Acrobatmenu{Close}{\addButton{.85in}{\@Panelclosename}}\par\vfill \Acrobatmenu{Quit}{\addButton{.85in}{\@Panelquitname}}\par \null\vspace*{12pt} \end{minipage}}} \end{verbatim} \caption{Code for navigation panel\label{fig1}} \end{minipage} \end{figure} \clearpage \section{Other facilities} \subsection{Configuration file}\label{cfg} You can keep a configuration file called \verb+pdfscreen.cfg+ in which you can provide your own translation of button text if your language is unsupported by the package, newer color schemes if you dislike the schemes offered, your \textsc{url} id, affiliation and division names, date argument, graphic file name of your logo/\allowbreak emblem. I would suggest to use a configuration file, in which you can give all your site specific requirements, that has another advantage of eliminating the clustered look at the preamble of the document. A typical configuration file is supplied with the package. \subsection{Background} The background of the screen area can be overlayed with a graphic file with the command \verb+\overlay{graphic file name}+. Alternatively, you can specify a background color by saying \verb+\backgroundcolor{color}+ where \verb+color+ is a predefined color with the commands provided by the \verb+color.sty+. The background of the panel can also be provided by a graphic file with the command \verb+\paneloverlay{graphic file}+. If you do not specify an overlay graphic for the panel, the panelbackground color will take effect. You can redefine the panelbackground color to your choice, if you find the default color distasteful, or else you can specify the same in the \verb+pdfscreen.cfg+ file. \verb+\overlayempty+ and \verb+\paneloverlayempty+ commands help you to suppress the overlays at any stage. \subsection{Table of contents in the panel} The package option \verb+paneltoc+ will allow you to have the table of contents in the navigation panel. In an article, only section headings are shown in the panel toc. Users are requested to use this option with caution, since it is prone to blow up the list and verbatim environments spanning multiple pages. However, a manual intervention with a \verb+\clearpage+ command at the appropriate location can ease you to a certain extent. \newpage \section{Slides} A slide environment is available which can be entered as \begin{verbatim} \begin{slide} . . . slide material . . . \end{slide} \end{verbatim} This is a box spanning the width and height of the text area, within which the material will be vertically centered. \subsection{Fonts} All the font attributes have been redefined to make them larger than the usual size inside the slide environment. However, if you want to revert to the original size, you will have to add the word \verb+real+ before the font size command, i.e., for \verb+\normalsize+, use \verb+\realnormalsize+; for \verb+\large+ it is \verb+\reallarge+ and so forth. \subsection{Post-processing} The postprocessor \emph{viz.}, \verb+PPower4+ can be applied to the pdf generated with this package, so that incremental additions to the pages are possible. \verb+PPower4+ is available at \href{ftp://ftp.dante.de/support/PPower4}{\textsc{ctan}}. You may need Java Virtual Machine running in your system to work with \verb+PPower4+. I have not tried the \TeX{}Power package by \href{mailto:Stephan.Lehmke@cs.uni-dortmund.de}{Stephan Lehmke} with \verb+pdfscreen+, but I would recommend this for effecting incremental builds. \clearpage \noindent{\begin{slide} \color{section0} \begin{center} \Large\itshape The objectives of the slide option are: \end{center} \sffamily \rightmargin\leftmargin \begin{itemize} \rightmargin\leftmargin \itshape \item to devise a method for easier technical presentation. \item to help the mix of mathematical formulae with text and graphics which the present day \textsc{wysiwyg} tools fail to accomplish. \item to exploit the platform independence of \TeX{} so that presentation documents become portable. \item to offer the freedom and possibilities of using various backgrounds and other embellishments that a user can imagine to have in his presentation. \end{itemize} \end{slide}} \newpage \section{Page Transition} \begin{itemize} \item You can exploit the page transition facilities in the Acrobat. Specify your choice by using the command\\ \verb+\pagedissolve{+\textless\emph{option}\textgreater\verb+}+% \item A list of page dissolve options and keys are given in \autoref{tab1}. \end{itemize} The page dissolve options are taken from the well known book, \emph{Web Publishing with Acrobat/PDF} by Thomas Merz will largely help to know the options for \verb+\pagedissolve+ function. \definecolor{gray9}{rgb}{1,.894,.769} \subsubsection*{Keys for page transitions} \def\dash{\noalign{\vskip1.5pt}\hline\noalign{\vskip1.5pt}} \begin{table}[b] \sffamily\itshape\footnotesize \setlength\arrayrulewidth{0pt} \begin{tabular}{@{}p{.15\linewidth}p{.8\linewidth}@{}} \rowcolor{section1}Key & Explanation\\\dash \rowcolor{gray9} /Split & Two lines sweep across the screen to reveal the new page similar to opening a curtain.\\\dash \rowcolor{buttondisable} /Blinds & Similar to /Split, but with several lines resembling ``Venetian blinds''\\\dash \rowcolor{gray9} /Box & A box enlarges from the center of the old page to reveal the new one.\\\dash \rowcolor{buttondisable} /Wipe & A single line ``wipes'' across the old page to reveal the new one.\\\dash \rowcolor{gray9} /Dissolve & The old page ``dissolves'' to reveal the new one.\\\dash \rowcolor{buttondisable} /Glitter& Similar to /Dissolve, except the effect sweeps from one edge to another.\\\dash \rowcolor{gray9} /R (Replace) & The old page is simply replaced with the new one without any special effect. This is the default. \end{tabular} \caption{Keys for page transition\label{tab1}} \end{table} For some of the transitions, additional parameters may be specified. The code given below results in a split effect with the lines moving horizontally (/H) from the inner parts of the page to the outer parts (/O). The duration of the effect is two seconds (/D): \begin{verbatim} /S /Split /D 2 /Dm /H /M /O \end{verbatim} All supported parameters for page dissolve, along with the kind of transition on which the parameters may be applied are given in \autoref{tab2}. \begin{table} \sffamily\itshape\footnotesize \setlength\arrayrulewidth{0pt} \begin{tabular}{@{}p{.15\linewidth}p{.8\linewidth}@{}} \rowcolor{section1}Key & Explanation\\ \dash \rowcolor{gray9} /D & Duration of the transition effect in seconds (applies to all effects)\\ \dash \rowcolor{buttondisable} /Di\hfill\break (Direction) & Direction of the movement (multiples of 90$^\circ$ only). Values increase in a counterclockwise fashion, 0$^\circ$ points to the right (for /Wipe and /Glitter).\\\dash \rowcolor{gray9} /Dm\hfill\break (Dimension) & Possible values are /H or /V for a horizontal or vertical effect, respectively (for /Split and /Blinds).\\\dash \rowcolor{buttondisable} /M \hfill\break (Motion) & Specifies whether the effect is performed from the center out or the edges in. Possible values are /I for in and /O for out (for /Split and /Box). \end{tabular} \caption{Additional parameters for page transitions\label{tab2}} \end{table} \section{Acknowledgements} The development of this package was funded by the University of Auckland, New Zealand (\href{mailto:j.hillas.auckland.ac.nz}{Prof. John Hillas} of Department of Economics made available the funds, to whom I owe much gratitude). I owe much thanks to \href{mailto:sebastian.rahtz@oucs.ac.uk}{Sebastian Rahtz} for his patient replies to my incessant queries. The design of the side navigation panel is due to \href{mailto:kaveh@focal.demon.co.uk}{Kaveh Bazargan} of Focal Image Ltd., London and it was at his goading that I started writing this package. The current version (v1.3) is a complete rewrite and therefore it may be possible that the documents compiled with older versions may break down, though every effort has been made to keep the downward compatibility and the old commands and options are still kept in order not to blow up your documents which runs smoothly with previous versions. I firmly believe that the code demands further optimization and may have bugs that will show up during exhaustive usage. I request you to send me the bug reports as and when they exhibit their ugly faces. My special thanks are for all those users who deploy \verb+pdfscreen.sty+ for their document preparation, and for their kind words of appreciation. \pdfscreen works well with the much used package, \verb+exerquiz.sty+ of \href{mailto:dpstory@uakron.edu}{Dr.~Donald P.~Story} (\url{http://www.math.uakron.edu/~dpstory/pdf_demos.html}) without clashes. Feedback on the usage of \TeX{}Power with \pdfscreen is requested from users. My mail id for contact is \href{mailto:cvr@river-valley.com}% {\tt cvr@river-valley.com}. \end{document}