animate (22aug18)

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

1 files changed, 20 insertions, 3 deletions

diff --git a/Master/texmf-dist/source/latex/animate/animate.tex b/Master/texmf-dist/source/latex/animate/animate.tex
index fe2ea715b09..d54f2973b91 100644
--- a/Master/texmf-dist/source/latex/animate/animate.tex
+++ b/Master/texmf-dist/source/latex/animate/animate.tex
@@ -140,6 +140,7 @@ to the preamble of the document source, i.\,e. somewhere between \verb+\document
 \begin{verbatim}
 dvipdfmx
 xetex
+export
 autoplay
 autopause
 autoresume
@@ -163,14 +164,30 @@ type=<file ext>
 method=icon | widget | ocg
 poster[=first | <num> | last | none]
 \end{verbatim}
-Except for `\verb+dvipdfmx+' and `\verb+xetex+', the options above are also available (among others) 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. Options without an argument are boolean options and can be negated, with the exception of package-only options `\verb+dvipdfmx+' and `\verb+xetex+', by appending `\verb+=false+'.
+Except for `\verb+dvipdfmx+', `\verb+xetex+' and `\verb+export+', the listed package options are also available (among others) 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. Options without an argument are boolean options and can be negated, with the exception of package-only options `\verb+dvipdfmx+', `\verb+xetex+' and `\verb+export+', by appending `\verb+=false+'.
 
 \begin{animateinline}[autoplay,loop,nomouse]{1}\strut\emph{Important:}\newframe[3]\end{animateinline} Option `\verb+-Ppdf+' should \emph{not} be used with \verb+dvips+ when converting DVI to Postscript. If you cannot do without, put `\verb+-D 1200+' \emph{after} `\verb+-Ppdf+' on the command line. Users of \LaTeX-aware text editors with menu-driven toolchain invocation, such as \TeX{}nicCenter, should check the configuration of the \verb+dvips+ call.
 
-All workflows require the `graphicx' package to be loaded explicitly. For \verb+dvipdfmx+, `\verb+dvipdfmx+' must be set as a document class option, \verb+\documentclass[dvipdfmx,...]{...}+, because this driver cannot be auto-detected by `animate', `graphicx' and other packages.
+All workflows require the `graphicx' package to be loaded explicitly. For \verb+dvipdfmx+, `\verb+dvipdfmx+' must be set as a document class option, as in
+%\verb+\documentclass[dvipdfmx,...]{...}+,
+\begin{verbatim}
+  \documentclass[dvipdfmx,...]{...}
+\end{verbatim}
+because this driver cannot be auto-detected by `animate', `graphicx' and other packages.
 
 Usually, a second \LaTeX{} run is necessary to resolve internally created object references. A warning message will be issued if appropriate.
 
+With option `\verb+export+', animation frames are output as individual pages of a multipage document that can be converted to other file formats, such as animated GIF. The `standalone' document class must be used together with `\verb+export+':
+\begin{verbatim}
+  \documentclass{standalone}
+  \usepackage[export]{animate}
+\end{verbatim}
+or
+\begin{verbatim}
+  \documentclass[export]{standalone}
+  \usepackage{animate}
+\end{verbatim}
+
 %\clearpage
 \section{The user interface}
 Package `animate' provides the command
@@ -464,7 +481,7 @@ When designing the timeline, care should be taken not to include a transparency
 \normalsize
 Also, `animate' finds and warns about transparencies that have never been used in an animation timeline. This may help to avoid dead code in the final PDF.
 
-\clearpage
+%\clearpage
 \section{Programming interface}\label{sect:api}
 The package provides a simple JavaScript programming interface which gives access to the animation objects in a PDF file. A particular animation property or method can be accessed by
 \begin{verbatim}