summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/animate
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2020-08-30 03:01:16 +0000
committerNorbert Preining <norbert@preining.info>2020-08-30 03:01:16 +0000
commitc6a1b1f6422e10f363a9de80c4f103f0c155d8bb (patch)
tree1389e67a96950e5a44d635efc31a6bb4f7528511 /macros/latex/contrib/animate
parent84ead792ae29b5dcefb36517d42178c278b8cb9b (diff)
CTAN sync 202008300301
Diffstat (limited to 'macros/latex/contrib/animate')
-rw-r--r--macros/latex/contrib/animate/ChangeLog3
-rw-r--r--macros/latex/contrib/animate/README.md1
-rw-r--r--macros/latex/contrib/animate/animate.pdfbin3898615 -> 3883925 bytes
-rw-r--r--macros/latex/contrib/animate/animate.sty3
-rw-r--r--macros/latex/contrib/animate/animate.tex7
5 files changed, 13 insertions, 1 deletions
diff --git a/macros/latex/contrib/animate/ChangeLog b/macros/latex/contrib/animate/ChangeLog
index 6638dbfa3f..2c474b2b60 100644
--- a/macros/latex/contrib/animate/ChangeLog
+++ b/macros/latex/contrib/animate/ChangeLog
@@ -1,3 +1,6 @@
+2020-08-29
+ * new: \multiframebreak for terminating \multiframe loop
+
2020-08-04
* fix: typesetting failure with `latex-dev'
diff --git a/macros/latex/contrib/animate/README.md b/macros/latex/contrib/animate/README.md
index 3d76e4ab20..3252779d44 100644
--- a/macros/latex/contrib/animate/README.md
+++ b/macros/latex/contrib/animate/README.md
@@ -60,6 +60,7 @@ export
\newframe
\multiframe{<number of frames>}{[<variables>]}{
... repeated (parameterized) material ...
+ \multiframebreak % optional !
}
\end{animateinline}
````
diff --git a/macros/latex/contrib/animate/animate.pdf b/macros/latex/contrib/animate/animate.pdf
index de2203afcf..6e7de8842d 100644
--- a/macros/latex/contrib/animate/animate.pdf
+++ b/macros/latex/contrib/animate/animate.pdf
Binary files differ
diff --git a/macros/latex/contrib/animate/animate.sty b/macros/latex/contrib/animate/animate.sty
index ae65243dba..dd4fe8959c 100644
--- a/macros/latex/contrib/animate/animate.sty
+++ b/macros/latex/contrib/animate/animate.sty
@@ -13,7 +13,7 @@
\NeedsTeXFormat{LaTeX2e}
-\def\@anim@version{2020/08/04}
+\def\@anim@version{2020/08/29}
\ProvidesPackage{animate}
[\@anim@version\space PDF & SVG animations from files and inline graphics]
@@ -2333,6 +2333,7 @@
\@anim@updatevars% update variables
\fi%
\global\advance\@anim@mulframecnt by \@ne%
+ \def\multiframebreak{\global\@anim@mulframecnt=#1}%
\ignorespaces%
#3% execute loop body
\unskip%
diff --git a/macros/latex/contrib/animate/animate.tex b/macros/latex/contrib/animate/animate.tex
index 14316a68dd..1cabe9c9fe 100644
--- a/macros/latex/contrib/animate/animate.tex
+++ b/macros/latex/contrib/animate/animate.tex
@@ -235,6 +235,11 @@ and the environment
\newframe
\multiframe{<number of frames>}{[<variables>]}{
... repeated (parameterized) material ...
+ \multiframebreak % optional!
+}
+\newframe*[...] % some \newframe variant required
+\multiframe{...}{...}{ % between two \multiframes
+ ...
}
\end{animateinline}
\end{verbatim}
@@ -249,6 +254,8 @@ The \verb+\multiframe+ command allows the construction of loops around pictures.
\end{verbatim}
\verb+<variable name>+ is a sequence of one or more letters \emph{without} a leading backslash\footnote{This is different from {\tt\string\multido} (package `multido') where variable names have a leading `{\tt\textbackslash}' in the declaration.}. The first (and possibly only) letter of the variable name determines the type of the variable. There are three different types: integers (`\verb+i+', `\verb+I+'), reals (`\verb+n+', `\verb+N+', `\verb+r+', `\verb+R+') and dimensions or \LaTeX{} lengths (`\verb+d+', `\verb+D+'). Upon first execution of the loop body, the variable takes the value \verb+<initial value>+. Each further iteration increments the variable by \verb+<increment>+. Negative increments must be preceded by `\verb+-+'. Here are some examples: `\verb:i=1+2:', `\verb:Rx=10.0+-2.25:', `\verb:dim=20pt+1ex:'. Within the loop body, variables are expanded to their current value by prepending a backslash to the variable name, that is \verb+\i+, \verb+\Rx+ and \verb+\dim+ according to the previous examples. \verb+\multiframe+ must be surrounded by \verb+\begin{animateinline}+ and \verb+\end{animateinline}+ or by any of the \verb+\newframe+ variants. Two consecutive \verb+\multiframe+ commands must be separated by one of the \verb+\newframe+ variants.
+\verb+\multiframebreak+ can be called to terminate a \verb+\multiframe+ loop prematurely, usually as part of a conditional statement. This command should preferably be placed near the end of the loop body in order not to produce an empty animation frame.
+
By default, the animation is built frame by frame in the order of inclusion of the embedded material. However, extended control of the order of appearance, superposition and repetition of the material is available through the `\verb+timeline+' option (see Section~\ref{sect:timeline}).
\myparagraph*{Sets of graphics files}