\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=<dimension>+. 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}

