texlive[56207] Master/texmf-dist: animate (29aug20)

[commits+karl at tug.org]

Revision: 56207
          http://tug.org/svn/texlive?view=revision&revision=56207
Author:   karl
Date:     2020-08-29 22:13:57 +0200 (Sat, 29 Aug 2020)
Log Message:
-----------
animate (29aug20)

Modified Paths:
--------------
    trunk/Master/texmf-dist/doc/latex/animate/ChangeLog
    trunk/Master/texmf-dist/doc/latex/animate/README.txt
    trunk/Master/texmf-dist/doc/latex/animate/animate.pdf
    trunk/Master/texmf-dist/source/latex/animate/animate.tex
    trunk/Master/texmf-dist/tex/latex/animate/animate.sty

Modified: trunk/Master/texmf-dist/doc/latex/animate/ChangeLog
===================================================================
--- trunk/Master/texmf-dist/doc/latex/animate/ChangeLog	2020-08-29 15:03:51 UTC (rev 56206)
+++ trunk/Master/texmf-dist/doc/latex/animate/ChangeLog	2020-08-29 20:13:57 UTC (rev 56207)
@@ -1,3 +1,6 @@
+2020-08-29
+	* new: \multiframebreak for terminating \multiframe loop 
+
 2020-08-04
 	* fix: typesetting failure with `latex-dev' 
 

Modified: trunk/Master/texmf-dist/doc/latex/animate/README.txt
===================================================================
--- trunk/Master/texmf-dist/doc/latex/animate/README.txt	2020-08-29 15:03:51 UTC (rev 56206)
+++ trunk/Master/texmf-dist/doc/latex/animate/README.txt	2020-08-29 20:13:57 UTC (rev 56207)
@@ -75,6 +75,7 @@
 \newframe
 \multiframe{<number of frames>}{[<variables>]}{
     ... repeated (parameterized) material ...
+    \multiframebreak % optional !
 }
 \end{animateinline}
 

Modified: trunk/Master/texmf-dist/doc/latex/animate/animate.pdf
===================================================================
(Binary files differ)

Modified: trunk/Master/texmf-dist/source/latex/animate/animate.tex
===================================================================
--- trunk/Master/texmf-dist/source/latex/animate/animate.tex	2020-08-29 15:03:51 UTC (rev 56206)
+++ trunk/Master/texmf-dist/source/latex/animate/animate.tex	2020-08-29 20:13:57 UTC (rev 56207)
@@ -235,7 +235,12 @@
 \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 @@
 \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}

Modified: trunk/Master/texmf-dist/tex/latex/animate/animate.sty
===================================================================
--- trunk/Master/texmf-dist/tex/latex/animate/animate.sty	2020-08-29 15:03:51 UTC (rev 56206)
+++ trunk/Master/texmf-dist/tex/latex/animate/animate.sty	2020-08-29 20:13:57 UTC (rev 56207)
@@ -13,7 +13,7 @@
 
 \NeedsTeXFormat{LaTeX2e}
 
-\def\@anim at version{2020/08/04}
+\def\@anim at version{2020/08/29}
 \ProvidesPackage{animate}
 [\@anim at version\space PDF & SVG animations from files and inline graphics]
 
@@ -2333,6 +2333,7 @@
       \@anim at updatevars% update variables
     \fi%
     \global\advance\@anim at mulframecnt by \@ne%
+    \def\multiframebreak{\global\@anim at mulframecnt=#1}%
     \ignorespaces%
     #3% execute loop body
     \unskip%