animate (29aug20)

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

5 files changed, 13 insertions, 1 deletions

diff --git a/Master/texmf-dist/doc/latex/animate/ChangeLog b/Master/texmf-dist/doc/latex/animate/ChangeLog
index 6638dbfa3f6..2c474b2b605 100644
--- a/Master/texmf-dist/doc/latex/animate/ChangeLog
+++ b/Master/texmf-dist/doc/latex/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/Master/texmf-dist/doc/latex/animate/README.txt b/Master/texmf-dist/doc/latex/animate/README.txt
index 2b48ee6b98a..eff30cb2c82 100644
--- a/Master/texmf-dist/doc/latex/animate/README.txt
+++ b/Master/texmf-dist/doc/latex/animate/README.txt
@@ -75,6 +75,7 @@ and examples.
 \newframe
 \multiframe{<number of frames>}{[<variables>]}{
     ... repeated (parameterized) material ...
+    \multiframebreak % optional !
 }
 \end{animateinline}
 
diff --git a/Master/texmf-dist/doc/latex/animate/animate.pdf b/Master/texmf-dist/doc/latex/animate/animate.pdf
index de2203afcfa..6e7de8842dd 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/source/latex/animate/animate.tex b/Master/texmf-dist/source/latex/animate/animate.tex
index 14316a68dd3..1cabe9c9fef 100644
--- a/Master/texmf-dist/source/latex/animate/animate.tex
+++ b/Master/texmf-dist/source/latex/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}
diff --git a/Master/texmf-dist/tex/latex/animate/animate.sty b/Master/texmf-dist/tex/latex/animate/animate.sty
index ae65243dba2..dd4fe8959c1 100644
--- a/Master/texmf-dist/tex/latex/animate/animate.sty
+++ b/Master/texmf-dist/tex/latex/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%