summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/source/latex/animate
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2016-07-30 23:09:29 +0000
committerKarl Berry <karl@freefriends.org>2016-07-30 23:09:29 +0000
commit6bc76ff170ee1e2992b12073207cc9a412e6bfe9 (patch)
tree404a279ace7643cc6c074fd275ca1f7b52132890 /Master/texmf-dist/source/latex/animate
parent8c5e9b1d37d90dd67dded3aa0d5fb7cad45230d4 (diff)
animate (28jul16)
git-svn-id: svn://tug.org/texlive/trunk@41770 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/source/latex/animate')
-rw-r--r--Master/texmf-dist/source/latex/animate/animate.tex23
1 files changed, 11 insertions, 12 deletions
diff --git a/Master/texmf-dist/source/latex/animate/animate.tex b/Master/texmf-dist/source/latex/animate/animate.tex
index 61e21831386..0021a4565f5 100644
--- a/Master/texmf-dist/source/latex/animate/animate.tex
+++ b/Master/texmf-dist/source/latex/animate/animate.tex
@@ -12,7 +12,8 @@
\usepackage{pst-3dplot}
\usepackage{pst-node,pst-plot,pst-tools,pst-text,pst-ode}
\usepackage{media9}
-\usepackage[buttonbg=0.9]{animate}
+%\usepackage[buttonbg=0.9]{animate}
+\usepackage[buttonbg=0.9,method=widget]{animate}
\usepackage{intcalc}
\usepackage{graphicx}
\graphicspath{{files/}}
@@ -54,7 +55,7 @@
\makeatother
\fi
-\def\keywords{include portable PDF animation animated PDF animating embed animated graphics LaTeX pdfLaTeX LuaLaTeX PSTricks pgf TikZ LaTeX-picture MetaPost inline graphics vector graphics animated GIF LaTeX dvips ps2pdf dvipdfmx XeLaTeX JavaScript Adobe Reader PDF-XChange Viewer}
+\def\keywords{include portable PDF animation animated PDF animating embed animated graphics LaTeX pdfLaTeX LuaLaTeX PSTricks pgf TikZ LaTeX-picture MetaPost inline graphics vector graphics animated GIF LaTeX dvips ps2pdf dvipdfmx XeLaTeX JavaScript Acrobat Reader PDF-XChange Viewer Foxit Reader}
\hypersetup{
pdftitle={The animate Package},
pdfsubject={Documentation},
@@ -90,7 +91,7 @@
\def\@anim@sanitizeColon{}\def\@anim@sanitizeJS{}\def\@anim@endsanitize{}
\expandafter\parsedate\@anim@version\relax %set current date to package date
\makeatother
-\author{Alexander Grahn \animategraphics[autoplay,loop,height=1.8ex,nomouse]{8}{bye_}{0}{3}\protect\footnote{Animated GIF taken from \href{http://www.phpBB.com}{phpBB} forum software and burst into a set of EPS files using \href{http://www.imagemagick.org}{ImageMagick} before embedding.} \protect\footnote{Animations may run slowly if viewed in the Adobe Reader browser plugin.}\\[1ex]\includegraphics[height=2.7ex]{mailto}}
+\author{Alexander Grahn \animategraphics[autoplay,loop,height=1.8ex,nomouse]{8}{bye_}{0}{3}\protect\footnote{Animated GIF taken from \href{http://www.phpBB.com}{phpBB} forum software and burst into a set of EPS files using \href{http://www.imagemagick.org}{ImageMagick} before embedding.} \protect\footnote{Animations may run slowly if viewed in the Acrobat Reader browser plugin.}\\[1ex]\includegraphics[height=2.7ex]{mailto}}
\maketitle
\endgroup
\begin{abstract}
@@ -112,7 +113,7 @@ The user interacts with the animation either through optional animation controls
Package `animate' supports the usual PDF making workflows, i.\,e. pdf\LaTeX{}, Lua\LaTeX{}, \LaTeX{} $\rightarrow$ \verb+dvips+ $\rightarrow$ \verb+ps2pdf+/Distiller and \pXepLaTeX{} $\rightarrow$ \verb+(x)dvipdfmx+.
-The final PDF can be viewed in current Adobe Readers on all supported platforms (except mobile devices) or in PDF-XChange Viewer.
+PDF files with animations can be viewed in Acrobat Reader (except on mobile devices), in PDF-XChange Viewer (with option `\verb+method=widget+' or `\verb+method=ocg+') and in Foxit Reader.
\section{Requirements}
\begin{trivlist}
@@ -120,7 +121,7 @@ The final PDF can be viewed in current Adobe Readers on all supported platforms
\item pdf\TeX{}, version $\ge1.20$ or Lua\TeX{} for direct PDF output
\item Ghostscript, version $\ge9.15$ or Adobe Distiller for PS to PDF conversion
\item dvipdfmx, version $\ge20080607$ for DVI to PDF conversion
-\item Adobe Reader, version $\ge7$ or PDF-XChange Viewer (with option `\verb+method=widget+' or `\verb+method=ocg+')
+\item Acrobat Reader (version $\ge7$), PDF-XChange Viewer, Foxit Reader
\end{trivlist}
\section{Installation}
@@ -316,7 +317,7 @@ Animation widget will not respond to mouse clicks. Unless the JavaScript interfa
\begin{verbatim}
method=icon | widget | ocg
\end{verbatim}
-The package implements three different animation methods. The `\verb+icon+' method is the default one for the pdf\LaTeX, \XeLaTeX{} and \verb+dvipdfmx+ workflows, and `\verb+widget+` for the \verb+dvips+ route. The `\verb+icon+' method usually gives the best animation performance (achievable frame rate). Forcing `\verb+icon+' in the case of \verb+dvips+ unfortunately leads to dead `hyperref'-inserted links in the final PDF; it should be enabled only if the `hyperref' package is \emph{not} used. This is for technical reasons, more specifically, due to a limitation of the `\verb+pdfmark+' Postscript operator. The `\verb+ocg+' method is an alternative animation method based on Optional Content Groups (OCGs, also known as PDF Layers). In rare cases (standalone animations without animation controls) it may lead to better animation performance than the other two methods. Moreover, it allows overlaying animations with other typeset material, that is, playing animations in the page background.
+The package implements three different animation methods. The `\verb+icon+' method is the default method and usually gives the best performance in terms of animation frame rate. `\verb+widget+' and `\verb+ocg+' are alternative animation methods. In rare cases (standalone animations without animation controls) method `\verb+ocg+' may lead to a better animation performance than the other two. Moreover, it allows overlaying animations with other typeset material, that is, playing animations in the page background.
\begin{verbatim}
measure
\end{verbatim}
@@ -1264,18 +1265,16 @@ dt dt Tm nT mul { % pop
\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 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, Acrobat 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 Animations may run very slowly if viewed in the Adobe Reader web-browser plugin. Instead, open the PDF locally in the Reader application for best results.
+ \item Animations may run very slowly if viewed in the Acrobat Reader web-browser plugin. Instead, open the PDF locally in the Reader application for best results.
- \item The Adobe Reader setting `Use page cache' (menu `Edit' $\rightarrow$ `Preferences' $\rightarrow$ `Startup') should be \emph{dis}abled for version 7, while remaining \emph{en}abled beginning with version 8 (menu `Edit' $\rightarrow$ `Preferences' $\rightarrow$ `Page Display' $\rightarrow$ `Rendering').
+ \item The Acrobat Reader setting `Use page cache' (menu `Edit' $\rightarrow$ `Preferences' $\rightarrow$ `Startup') should be \emph{dis}abled for version 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+-D 1200+' on the command line in order to set a sensible DVI resolution. 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 The \verb+dvips+ option `\verb+-Ppdf+' should be avoided entirely or followed by something like `\verb+-D 1200+' on the command line in order to set a sensible DVI resolution. 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, Acrobat Reader gets confused and will not display the frames within the animation widget.
\item Animations do not work if the PDF was produced with Ghostscript versions older than 9.15.
- \item The default animation method (`{\tt icon}') is not supported in PDF-XChange Viewer. Use one of `{\tt method=widget}' or `{\tt method=ocg}' instead.
-
\item If the \LaTeX{} $\rightarrow$ \verb+dvips+ $\rightarrow$ \verb+ps2pdf+/Distiller route is being taken, make sure that the original graphics size (i.\,e. not scaled by any of the `{\tt scale}', `{\tt width}', `{\tt height}' or `{\tt totalheight}' options) does not exceed the page size of the final document. During PS to PDF conversion every graphic of the animation is temporarily moved to the upper left page corner. Those parts of the graphics that do not fit onto the document page will be clipped in the resulting PDF. Fortunately, graphics files for building animations may be resized easily to fit into a given bounding box by means of the `{\tt epsffit}' command line tool:
\quad{\tt epsffit -c <llx> <lly> <urx> <ury> infile.eps outfile.eps}