animate v2008/05/09

git-svn-id: svn://tug.org/texlive/trunk@8111 c570f23f-e606-0410-a88d-b1316a301751

11 files changed, 19 insertions, 38 deletions

diff --git a/Master/texmf-dist/doc/latex/animate/README b/Master/texmf-dist/doc/latex/animate/README
index 35347cef7b2..0593e6284db 100644
--- a/Master/texmf-dist/doc/latex/animate/README
+++ b/Master/texmf-dist/doc/latex/animate/README
@@ -14,41 +14,26 @@ Description:
     inline (vector) graphics, such as LaTeX-picture, PSTricks or pgf/TikZ
     generated pictures, or just from typeset text.
 
+    The `animate' package relies on Optional Content Groups (OCG), also known as
+    PDF layers, which is a feature provided by the PDF-1.5 specification. Each
+    frame of an animation is associated with an OCG that is hidden or made
+    visible in a dynamic fashion by means of Adobe Reader's built-in JavaScript
+    engine.
+
     It supports the usual PDF making workflows, i. e.  pdfLaTeX and LaTeX ->
     dvips -> ps2pdf (Ghostscript).
 
     The resulting PDF can be viewed in current Adobe Readers on all supported
     platforms.
 
-    The first release of `animate' was based on the work by Jan Holecek and Petr
-    Sojka:
-
-           http://www.fi.muni.cz/~xholecek/tex/pdfanim.xhtml
-
-    Meanwhile, the package was rewritten to use Optional Content Groups (OCG),
-    aka PDF-Layers. OCG-based animations are fully supported by Adobe Reader 8,
-    but have some performance issues. Playback is usually slower in Reader 8
-    than in previous versions, which is probably a bug.
-
-    The old, non-OCG approach is still available if the package file
-    `animate-noocg.sty' is used instead of `animate.sty'. However, options
-    `autoplay', `autopause' and `autoresume' are not functional in Reader 8.
-    Moreover, the animation position and the play/pause buttons are not properly
-    reset on page change. This is due to usage restrictions that Adobe imposed
-    on some important JavaScript methods in Reader 8.
-
     Note, this file only gives a summary of usage and available package and
     command options. Please refer to the documentation `animate.pdf' in the
     `doc/' directory for details and examples.
 
     Keywords: include portable PDF animated PDF animation animating
-    embed animated
- graphics LaTeX pdfLaTeX PSTricks pgf TikZ MetaPost
-    LaTeX-picture
- inline graphics vector graphics animated GIF LaTeX
-    dvips ps2pdf
- JavaScript Adobe Reader
-
+    embed animated graphics LaTeX pdfLaTeX PSTricks pgf TikZ MetaPost
+    LaTeX-picture inline graphics vector graphics animated GIF LaTeX
+    dvips ps2pdf JavaScript Adobe Reader
 
 
 Usage:
@@ -86,7 +71,7 @@ Requirements:
   e-TeX
   pdfTeX, version >= 1.20
   Ghostscript, version >= 8.31 or Adobe Distiller
-  Adobe Reader, version >= 6, but not 8
+  Adobe Reader, version >= 6
 
 
 Installation:
diff --git a/Master/texmf-dist/doc/latex/animate/doc/animate.pdf b/Master/texmf-dist/doc/latex/animate/animate.pdf
index 15598aabfc6..e28f5629c57 100644
--- a/Master/texmf-dist/doc/latex/animate/doc/animate.pdf
+++ b/Master/texmf-dist/doc/latex/animate/animate.pdf
diff --git a/Master/texmf-dist/doc/latex/animate/doc/animate.tex b/Master/texmf-dist/doc/latex/animate/animate.tex
index ebcf2b338d9..efee41993f9 100644..100755
--- a/Master/texmf-dist/doc/latex/animate/doc/animate.tex
+++ b/Master/texmf-dist/doc/latex/animate/animate.tex
@@ -86,7 +86,7 @@ The `animate' package relies on Optional Content Groups (OCG), also known as PDF
 \item $\varepsilon$-\TeX
 \item pdf\TeX{}, version $\ge1.20$ for direct PDF output
 \item Ghostscript, version $\ge8.31$ or Adobe Distiller for PS to PDF conversion
-\item Adobe Reader, version $\ge6$, but not $8$
+\item Adobe Reader, version $\ge6$
 \end{trivlist}
 
 \section{Installation}
@@ -327,7 +327,6 @@ In this timeline, the transparencies are grouped into two layers. One is reserve
 See the second animation, Fig.~\ref{fig:scarab}, in Section~\ref{sect:examples} for a working example that makes use of the timeline and the layer concept.
 
 \section{Examples}
-{\Large\color{red}{\sc Note:} Examples do not run in Adobe Reader 8!}
 \subsection[Animations from sets of files, using `animategraphics' command]{Animations from sets of files, using {\tt \string\animategraphics} command}\label{sect:examples}
 Animations in this section are made from graphics files that were prepared with \MP. Run `\verb+mpost --tex=latex+' on the files ending in `.mp' in the `doc/files' directory to generate the graphics files. Both examples make use of the `\verb+timeline+' option to reduce the resulting PDF file size.
 
@@ -542,6 +541,14 @@ Fig.~\ref{fig:torus} is an inline graphics example adapted from \cite{gilg05}.
 
 \section{Bugs}\label{sect:bugs}
 \begin{itemize}
+  \item The maximum frame rate that can actually be achieved largely depends on the complexity of the graphics and on the available hardware. Starting with version 8, Adobe Reader appears to be somewhat slower. However, you might want to experiment with the graphical hardware acceleration feature that was introduced in Reader 8. Go to menu `Edit' $\rightarrow$ `Preferences' $\rightarrow$ `Page Display' $\rightarrow$ `Rendering' to see whether hardware acceleration is available. A 2D GPU acceleration check box will be visible if a supported video card has been detected.
+
+  \item The Adobe Reader setting `Use page cache' (menu `Edit' $\rightarrow$ `Preferences' $\rightarrow$ `Startup') should be \emph{dis}abled for versions 6 \& 7, while remaining \emph{en}abled beginning with version 8 (menu `Edit' $\rightarrow$ `Preferences' $\rightarrow$ `Page Display' $\rightarrow$ `Rendering').
+
+  \item The \verb+dvips+ option `\verb+-Ppdf+' should be avoided entirely or followed by something like `\verb+-X 2400 -Y 2400+' on the command line in order to set a sensible DVI resolution. In times of Type-1 fonts, this does \emph{not} degrade the output quality! The configuration file `config.pdf' loaded by option `\verb+-Ppdf+' specifies an excessively high DVI resolution that will be passed on to the final PDF. Eventually, Adobe Reader gets confused and will not display the frames within the animation widget.
+
+  \item Animations do not work if the PDF has been produced with Ghostscript versions older than 8.31. This applies to all versions of ESP Ghostscript that comes with many Linux distributions.
+
   \item The command {\tt\string\multido} and its relatives from package `multido' do not work if the loop body contains {\tt\string\newframe}. Use {\tt\string\whiledo} from package `if\/then' instead. (There is no need to load `if\/then' explicitly; it has already been loaded by `animate'.) A counter must be declared to keep track of the number of iterations. Further variables that take fixed point decimals to be used within the loop body can be defined and incremented by means of the commands \verb+\FPset+ and \verb+\FPeval+ from package `{\tt fp}'. For example:
 \small
 \begin{verbatim}
@@ -574,14 +581,6 @@ Fig.~\ref{fig:torus} is an inline graphics example adapted from \cite{gilg05}.
 \end{verbatim}
 \normalsize
 
-  \item The maximum frame rate that can actually be achieved largely depends on the complexity of the graphics and on the available hardware.
-
-  \item The Adobe Reader setting `Use page cache' (menu `Edit' $\rightarrow$ `Preferences' $\rightarrow$ `Startup') should be \emph{dis}abled.
-
-  \item The \verb+dvips+ option `\verb+-Ppdf+' should be avoided entirely or followed by something like `\verb+-X 2400 -Y 2400+' on the command line in order to set a sensible DVI resolution. In times of Type-1 fonts, this does \emph{not} degrade the output quality! The configuration file `config.pdf' loaded by option `\verb+-Ppdf+' specifies an excessively high DVI resolution that will be passed on to the final PDF. Eventually, Adobe Reader gets confused and will not display the frames within the animation widget.
-
-  \item Animations do not work if the PDF has been produced with Ghostscript versions older than 8.31. This applies to all versions of ESP Ghostscript that comes with many Linux distributions.
-
   \item Animations with complex graphics and/or many frames may cause \LaTeX{} to fail with a `\verb+TeX capacity exceeded+' error. The following steps should fix most of the memory related problems.
   
   MiK\TeX:
@@ -609,9 +608,6 @@ Fig.~\ref{fig:torus} is an inline graphics example adapted from \cite{gilg05}.
   \end{enumerate}
 
   \item Animations should not be placed on \emph{multilayered} slides created with presentation making classes such as Beamer or Powerdot. Although possible, the result might be disappointing. Put animations on flat slides only. (Of course, slides without animations may still have overlays.)
-
-  \item Originally, package `animate' was based on a method suggested by Jan Hole\v{c}ek and Petr Soika~\cite{hol04}, but was rewritten to use Optional Content Groups (OCG). OCG-based animations are fully supported in Adobe Reader 8, but have some performance issues. Playback is usually slower in Reader 8 than in older Reader versions, which is probably a bug. The non-OCG approach performs better in Adobe Reader 8, but package/command options `\verb+autoplay+', `\verb+autopause+' and `\verb+autoresume+' do not work. Moreover, the animation position and the play/pause buttons are not properly reset on page change. This is due to usage restrictions that Adobe imposed on some important JavaScript methods in Reader 8. An old, non-OCG version of the package is still available as `animate-noocg.sty'.
-
 \end{itemize}
 
 \section{Acknowledgements}
diff --git a/Master/texmf-dist/doc/latex/animate/doc/files/bye_0.eps b/Master/texmf-dist/doc/latex/animate/files/bye_0.eps
index 3bb488a0522..3bb488a0522 100644
--- a/Master/texmf-dist/doc/latex/animate/doc/files/bye_0.eps
+++ b/Master/texmf-dist/doc/latex/animate/files/bye_0.eps
diff --git a/Master/texmf-dist/doc/latex/animate/doc/files/bye_1.eps b/Master/texmf-dist/doc/latex/animate/files/bye_1.eps
index c04b8f5a3f0..c04b8f5a3f0 100644
--- a/Master/texmf-dist/doc/latex/animate/doc/files/bye_1.eps
+++ b/Master/texmf-dist/doc/latex/animate/files/bye_1.eps
diff --git a/Master/texmf-dist/doc/latex/animate/doc/files/bye_2.eps b/Master/texmf-dist/doc/latex/animate/files/bye_2.eps
index d9d56f68940..d9d56f68940 100644
--- a/Master/texmf-dist/doc/latex/animate/doc/files/bye_2.eps
+++ b/Master/texmf-dist/doc/latex/animate/files/bye_2.eps
diff --git a/Master/texmf-dist/doc/latex/animate/doc/files/bye_3.eps b/Master/texmf-dist/doc/latex/animate/files/bye_3.eps
index c04b8f5a3f0..c04b8f5a3f0 100644
--- a/Master/texmf-dist/doc/latex/animate/doc/files/bye_3.eps
+++ b/Master/texmf-dist/doc/latex/animate/files/bye_3.eps
diff --git a/Master/texmf-dist/doc/latex/animate/doc/files/exp.mp b/Master/texmf-dist/doc/latex/animate/files/exp.mp
index f719391fecf..f719391fecf 100644..100755
--- a/Master/texmf-dist/doc/latex/animate/doc/files/exp.mp
+++ b/Master/texmf-dist/doc/latex/animate/files/exp.mp
diff --git a/Master/texmf-dist/doc/latex/animate/doc/files/mailto.eps b/Master/texmf-dist/doc/latex/animate/files/mailto.eps
index 313b755df16..313b755df16 100644
--- a/Master/texmf-dist/doc/latex/animate/doc/files/mailto.eps
+++ b/Master/texmf-dist/doc/latex/animate/files/mailto.eps
diff --git a/Master/texmf-dist/doc/latex/animate/doc/files/scarab.mp b/Master/texmf-dist/doc/latex/animate/files/scarab.mp
index bef95226e24..bef95226e24 100644
--- a/Master/texmf-dist/doc/latex/animate/doc/files/scarab.mp
+++ b/Master/texmf-dist/doc/latex/animate/files/scarab.mp
diff --git a/Master/texmf-dist/doc/latex/animate/doc/files/timeline.txt b/Master/texmf-dist/doc/latex/animate/files/timeline.txt
index c0945a66a6b..c0945a66a6b 100644
--- a/Master/texmf-dist/doc/latex/animate/doc/files/timeline.txt
+++ b/Master/texmf-dist/doc/latex/animate/files/timeline.txt