summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/animate/animate.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/latex/animate/animate.tex')
-rwxr-xr-xMaster/texmf-dist/doc/latex/animate/animate.tex14
1 files changed, 8 insertions, 6 deletions
diff --git a/Master/texmf-dist/doc/latex/animate/animate.tex b/Master/texmf-dist/doc/latex/animate/animate.tex
index cf4a5b2cea8..c45cbe9ae8e 100755
--- a/Master/texmf-dist/doc/latex/animate/animate.tex
+++ b/Master/texmf-dist/doc/latex/animate/animate.tex
@@ -127,7 +127,7 @@ step
useocg
poster[=first | none | last]
\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.
+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+'.
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+.
@@ -242,7 +242,7 @@ viewport=<llx> <lly> <urx> <ury>
\begin{verbatim}
trim=<left> <bottom> <right> <top>
\end{verbatim}
-(\verb+\animategraphics+ only, requires package `graphicx'.) Crops the graphics at the edges. The four lengths specify the amount to be removed from or, if negative values have been provided, to be added to each side of the graphics.
+(\verb+\animategraphics+ only, requires package `graphicx'.) Crops graphics at the edges. The four lengths specify the amount to be removed from or, if negative values have been provided, to be added to each side of the graphics.
\begin{verbatim}
controls
\end{verbatim}
@@ -282,7 +282,7 @@ end={<end text>}
\begin{verbatim}
timeline=<timeline file>
\end{verbatim}
-\verb+<timeline file>+ is a plain text file whose contents determines the order of appearance of the embedded material during the animation. In addition, it allows to freely reorder, repeat and overlay the material at any point of the animation. This may greatly reduce the file size of the resulting PDF, as objects that do not change between several or all frames, such as coordinate axes or labels, can be embedded once and re-used in other frames of the animation.
+\verb+<timeline file>+ is a plain text file whose contents determines the order of appearance of the embedded material during the animation. It allows to freely rearrange, repeat and overlay the material at any point of the animation. This may greatly reduce the file size of the resulting PDF, as objects that do not change between several or all frames, such as coordinate axes or labels, can be embedded once and re-used in other frames of the animation.
If a timeline is associated with the animation, the graphics files or inline graphics embedded by \verb+\animategraphics+ and `\verb+animateinline+' no longer represent the actual frames of the animation. Rather, they are a collection of \emph{transparencies} that can be played with at will. In order to identify the transparencies within the timeline file, they are numbered in the order of their inclusion, starting at zero.
@@ -504,7 +504,7 @@ Fig.~\ref{fig:torus} is an inline graphics example adapted from \cite{gilg05}.
t cos 4 mul
}%
\FPupn\strokewidth{360 #1 sub 360 div 3 mul}%
- \parametricplotThreeD[yPlotpoints=1,linewidth=\strokewidth pt](0,360)(#1,#1){%
+ \parametricplotThreeD[yPlotpoints=1,linewidth=\strokewidth pt](0,360)(#1,#1){%
u cos 2 mul 4 t sin 2 mul add mul
u sin 2 mul 4 t sin 2 mul add mul
t cos 4 mul
@@ -568,14 +568,16 @@ Fig.~\ref{fig:torus} is an inline graphics example adapted from \cite{gilg05}.
\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 If the \LaTeX{} $\rightarrow$ \verb+dvips+ $\rightarrow$ \verb+ps2pdf+/Distiller route is being taken make sure that the original (unscaled) graphics size does not exceed the page size of the final document. During PS to PDF conversion every graphics of the animation is temporarily moved to the lower left page corner. Those parts of the graphics that do not fit onto the document page will be clipped in the resulting PDF. Graphics files used for building an animation may be resized easily using the `{\tt epsffit}' command line tool:
+ \item If the \LaTeX{} $\rightarrow$ \verb+dvips+ $\rightarrow$ \verb+ps2pdf+/Distiller route is being taken make sure that the original (unscaled) graphics size 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 lower left page corner. Those parts of the graphics that do not fit onto the document page will be clipped in the resulting PDF. Graphics files for building an animation may be resized 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}
-{\tt <llx> <lly> <urx> <ury>} are the bounding box coordinates of the document which can be determined using Ghostscript. For a document called `document.ps' the command line (the name of the Ghostscript executable may vary between operating systems) is
+{\tt <llx> <lly> <urx> <ury>} are the bounding box coordinates of the target document. They can be determined using Ghostscript. For a document called `document.ps' the command line is
\quad{\tt gs -dNOPAUSE -q -dBATCH -sDEVICE=bbox document.ps}
+Note that the name of the Ghostscript executable may vary between operating systems.
+
% \item The command {\tt\string\multido} and its relatives from package `multido' as well as {\tt\string\foreach} from the `pgf/TikZ' package do not work \emph{if their loop body} contains {\tt\string\newframe}. Instead, use {\tt\string\whiledo} from package `if\/then' if you wish to construct loops around parameterized {\tt pspicture}\emph{s} or {\tt tikzpicture}\emph{s}. (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 `fp'. Note that {\tt\string\multido} and {\tt\string\foreach} \emph{can} safely be used \emph{within} the code of the frames. For example:
%\small
%\begin{verbatim}