animate update 2008/05/21

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

3 files changed, 13 insertions, 11 deletions

diff --git a/Master/texmf-dist/doc/latex/animate/README b/Master/texmf-dist/doc/latex/animate/README
index 0593e6284db..79cd33cf01d 100644
--- a/Master/texmf-dist/doc/latex/animate/README
+++ b/Master/texmf-dist/doc/latex/animate/README
@@ -14,14 +14,8 @@ 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).
+    dvips -> ps2pdf (Ghostscript)/Distiller.
 
     The resulting PDF can be viewed in current Adobe Readers on all supported
     platforms.
@@ -42,7 +36,8 @@ Usage:
 
   * Package options: autopause, autoplay, autoresume, controls, final, draft,
                      buttonsize=<size>, buttonbg=<colour>, buttonfg=<colour>,
-                     loop, palindrome, step, poster[=first | none | last]
+                     loop, palindrome, step, poster[=first | none | last],
+                     useocg
 
 
  \animategraphics[<options>]{<frame rate>}{<file basename>}{<first>}{<last>}
@@ -60,7 +55,7 @@ Usage:
                      draft, controls, buttonsize=<size>, buttonbg=<colour>,
                      buttonfg=<colour>, loop, palindrome, step, measure,
                      poster[=first | none | last], begin={<begin text>},
-                     end={<end text>}, timeline=<timeline file>,
+                     end={<end text>}, timeline=<timeline file>, useocg,
                      every=<number>, bb=<llx> <lly> <urx> <ury>,
                      viewport=<llx> <lly> <urx> <ury>,
                      trim=<left> <bottom> <right> <top>
diff --git a/Master/texmf-dist/doc/latex/animate/animate.pdf b/Master/texmf-dist/doc/latex/animate/animate.pdf
index e28f5629c57..0b07e45bab8 100644
--- a/Master/texmf-dist/doc/latex/animate/animate.pdf
+++ b/Master/texmf-dist/doc/latex/animate/animate.pdf
diff --git a/Master/texmf-dist/doc/latex/animate/animate.tex b/Master/texmf-dist/doc/latex/animate/animate.tex
index efee41993f9..acef6dbfa3a 100755
--- a/Master/texmf-dist/doc/latex/animate/animate.tex
+++ b/Master/texmf-dist/doc/latex/animate/animate.tex
@@ -79,7 +79,7 @@ Package `animate' supports the usual PDF making workflows, i.\,e. pdf\LaTeX{} an
 
 The final PDF can be viewed in current Adobe Reader\textsuperscript{\scriptsize\textregistered}s on all supported platforms.
 
-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.
+%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.
 
 \section{Requirements}
 \begin{trivlist}
@@ -113,12 +113,15 @@ buttonsize=<size>
 buttonbg=<colour>
 buttonfg=<colour>
 step
+useocg
 poster[=first | none | last]
 \end{verbatim}
 The same options (among others) are also available as command options and will be explained shortly. However, if used as package options they have global scope, taking effect on all animations in the document. In turn, command options locally override global settings.
 
 If PDF is generated via DVI and Postscript by the command sequence \verb+latex+ $\rightarrow$ \verb+dvips+ $\rightarrow$ \verb+ps2pdf+, the `graphicx' package is required. \emph{Important:} The \verb+dvips+ option `\verb+-Ppdf+' should \emph{not} be set when converting the intermediate DVI into Postscript. If you cannot do without, put `\verb+-X 2400 -Y 2400+' \emph{after} `\verb+-Ppdf+' on the command line. Sometimes, if the same animation sequence made from graphics files is to be embedded multiple times into the document, more compact PDF output may be obtained by passing option `\verb+-dMaxInlineImageSize=0+' (Unix) or `\verb+-dMaxInlineImageSize#0+' (Win/DOS) to \verb+ps2pdf+.
 
+Occasionally, a second (pdf)\LaTeX{} run may be necessary to resolve internally created object references. Appropriate warnings will be issued in such cases.
+
 \section{The user interface}
 Package `animate' provides the command
 \begin{verbatim}
@@ -234,7 +237,11 @@ By default, control button widgets are drawn with black strokes on transparent b
 draft
 final
 \end{verbatim}
-With `\verb+draft+' the animation is not embedded. Instead, a box with the exact dimensions of the animation is inserted. Option `\verb+final+' does the opposite as it forces the animation to be built and embedded. Both options can be used to reduce compilation time during authoring of a document. To get the most out of them it is recommended to set `\verb+draft+' globally as package or class option and to set `\verb+final+' locally as a command option of the animation that is currently worked on. After the document has been finished, the global `\verb+draft+' option can be removed to embed all animations.
+With `\verb+draft+' the animation is not embedded. Instead, a box with the exact dimensions of the animation is inserted. Option `\verb+final+' does the opposite as it forces the animation to be built and embedded. Both options can be used to reduce compilation time during authoring of a document. To get the most out of them it is recommended to set `\verb+draft+' globally as a package or class option and to set `\verb+final+' locally as a command option of the animation that is currently worked on. After the document has been finished, the global `\verb+draft+' option can be removed to embed all animations.
+\begin{verbatim}
+useocg
+\end{verbatim}
+Use an alternative animation method based on Optional Content Groups (OCGs, also known as PDF Layers). May result in less performing animations.
 \begin{verbatim}
 measure
 \end{verbatim}