From 713ffc22df0c37adf8b286626efa889c648b4e94 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Thu, 31 May 2007 18:44:36 +0000 Subject: animate update (25may07) git-svn-id: svn://tug.org/texlive/trunk@4388 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/latex/animate/README | 184 ++++++++++----------- .../texmf-dist/doc/latex/animate/doc/animate.pdf | Bin 964501 -> 964597 bytes .../texmf-dist/doc/latex/animate/doc/animate.tex | 20 ++- Master/texmf-dist/tex/latex/animate/animate.sty | 55 +++--- Master/texmf-dist/tpm/animate.tpm | 8 +- 5 files changed, 140 insertions(+), 127 deletions(-) diff --git a/Master/texmf-dist/doc/latex/animate/README b/Master/texmf-dist/doc/latex/animate/README index 432c0e5b31e..fb0e666a0f2 100644 --- a/Master/texmf-dist/doc/latex/animate/README +++ b/Master/texmf-dist/doc/latex/animate/README @@ -1,92 +1,92 @@ - ===================== - The animate Package - ===================== - -Author: - - Alexander Grahn - - -Description: - - This package provides an interface to create portable, JavaScript driven PDF - animations from sets of (vector) graphics files or from inline (vector) - graphics, such as LaTeX-picture, PSTricks or pgf/TikZ generated pictures, - or just from typeset text. - - It supports the usual PDF making workflows, i. e. pdfLaTeX and LaTeX -> - dvips -> ps2pdf (Ghostscript). - - The resulting PDF can be viewed in current Adobe Readers on all supported - platforms. - - The first release of `animate' was based on the work by Jan Holecek and Petr - Sojka: - - http://www.fi.muni.cz/~xholecek/tex/pdfanim.xhtml - - Meanwhile, the package was rewritten to use Optional Content Groups (OCG), - aka PDF-Layers. OCG-based animations are fully supported by Adobe Reader 8, - but have some performance issues. Playback is usually slower in Reader 8 - than in previous versions, which is probably a bug. - - The old, non-OCG approach is still available if the package file - `animate-noocg.sty' is used instead of `animate.sty'. However, options - `autoplay', `autopause' and `autoresume' are not functional in Reader 8. - Moreover, the animation position and the play/pause buttons are not properly - reset on page change. This is due to usage restrictions that Adobe imposed - on some important JavaScript methods in Reader 8. - - Note, this file only gives a summary of usage and available package and - command options. Please refer to the documentation `animate.pdf' in the - `doc/' directory for details and examples. - - Keywords: include, portable, animation, animating, embed, animated, - inline graphics, vector graphics, graphics files, LaTeX, dvips, - ps2pdf, pdfLaTeX, PDF, JavaScript, PSTricks, pgf, TikZ, - LaTeX-picture, Adobe Reader - - -Usage: - - \usepackage[]{animate} - - -- Package options: autopause, autoplay, autoresume, controls, - buttonsize=, screenbg=, buttonbg=, - loop, palindrome, step, poster=[first | none | last] - - - \animategraphics[]{}{}{}{} - - \begin{animateinline}[]{} - ... typeset material ... - \newframe[] - ... typeset material ... - \newframe*[] - ... typeset material ... - \end{animateinline} - - -- Command options: width=, height=, depth=, - scale=, autopause, autoplay, autoresume, controls, - buttonsize=, screenbg=, buttonbg=, - loop, palindrome, step, poster=[first | none | last] - - -Requirements: - - pdfeTeX, version >= 1.20 - Adobe Reader, version >= 6 - - -Installation: - - Put the file animate.sty to a place where TeX can find it. - - -License: - - This material is subject to the LaTeX Project Public License. See - - http://www.ctan.org/tex-archive/help/Catalogue/licenses.lppl.html - - for the details of that license. + ===================== + The animate Package + ===================== + +Author: + + Alexander Grahn + + +Description: + + This package provides an interface to create portable, JavaScript driven PDF + animations from sets of (vector) graphics files or from inline (vector) + graphics, such as LaTeX-picture, PSTricks or pgf/TikZ generated pictures, + or just from typeset text. + + It supports the usual PDF making workflows, i. e. pdfLaTeX and LaTeX -> + dvips -> ps2pdf (Ghostscript). + + The resulting PDF can be viewed in current Adobe Readers on all supported + platforms. + + The first release of `animate' was based on the work by Jan Holecek and Petr + Sojka: + + http://www.fi.muni.cz/~xholecek/tex/pdfanim.xhtml + + Meanwhile, the package was rewritten to use Optional Content Groups (OCG), + aka PDF-Layers. OCG-based animations are fully supported by Adobe Reader 8, + but have some performance issues. Playback is usually slower in Reader 8 + than in previous versions, which is probably a bug. + + The old, non-OCG approach is still available if the package file + `animate-noocg.sty' is used instead of `animate.sty'. However, options + `autoplay', `autopause' and `autoresume' are not functional in Reader 8. + Moreover, the animation position and the play/pause buttons are not properly + reset on page change. This is due to usage restrictions that Adobe imposed + on some important JavaScript methods in Reader 8. + + Note, this file only gives a summary of usage and available package and + command options. Please refer to the documentation `animate.pdf' in the + `doc/' directory for details and examples. + + Keywords: include, portable, PDF, animation, animating, embed, animated, + graphics, LaTeX, pdfLaTeX, PSTricks, pgf, TikZ, LaTeX-picture, + inline graphics, vector graphics, dvips, ps2pdf, JavaScript, + Adobe Reader + + +Usage: + + \usepackage[]{animate} + + -- Package options: autopause, autoplay, autoresume, controls, + buttonsize=, screenbg=, buttonbg=, + loop, palindrome, step, poster=[first | none | last] + + + \animategraphics[]{}{}{}{} + + \begin{animateinline}[]{} + ... typeset material ... + \newframe[] + ... typeset material ... + \newframe*[] + ... typeset material ... + \end{animateinline} + + -- Command options: width=, height=, depth=, + scale=, autopause, autoplay, autoresume, controls, + buttonsize=, screenbg=, buttonbg=, + loop, palindrome, step, poster=[first | none | last] + + +Requirements: + + pdfeTeX, version >= 1.20 + Adobe Reader, version >= 6 + + +Installation: + + Put the file animate.sty to a place where TeX can find it. + + +License: + + This material is subject to the LaTeX Project Public License. See + + http://www.ctan.org/tex-archive/help/Catalogue/licenses.lppl.html + + for the details of that license. diff --git a/Master/texmf-dist/doc/latex/animate/doc/animate.pdf b/Master/texmf-dist/doc/latex/animate/doc/animate.pdf index 8d59b124085..1d89bfa140e 100644 Binary files a/Master/texmf-dist/doc/latex/animate/doc/animate.pdf and b/Master/texmf-dist/doc/latex/animate/doc/animate.pdf differ diff --git a/Master/texmf-dist/doc/latex/animate/doc/animate.tex b/Master/texmf-dist/doc/latex/animate/doc/animate.tex index 59662947087..6090d6b0021 100644 --- a/Master/texmf-dist/doc/latex/animate/doc/animate.tex +++ b/Master/texmf-dist/doc/latex/animate/doc/animate.tex @@ -28,7 +28,7 @@ \parindent0pt \parskip1.2ex -\def\keywords{include, portable, animation, animating, embed, animated, inline graphics, vector graphics, graphics files, LaTeX, dvips, ps2pdf, pdfLaTeX, PDF, JavaScript, PSTricks, pgf, TikZ, LaTeX-picture, Adobe Reader} +\def\keywords{include, portable, PDF, animation, animating, embed, animated, graphics, LaTeX, pdfLaTeX, PSTricks, pgf, TikZ, LaTeX-picture, inline graphics, vector graphics, dvips, ps2pdf, JavaScript, Adobe Reader} \hypersetup{ bookmarksnumbered,linktocpage,breaklinks, pdftitle={The animate Package}, @@ -50,8 +50,10 @@ \maketitle \begin{abstract}\noindent -A \LaTeX{} package for creating portable, JavaScript driven PDF animations from sets of graphics files or inline graphics.\\[0.2\baselineskip] -\emph{Keywords}: \keywords +A \LaTeX{} package for creating portable, JavaScript driven PDF animations from sets of graphics files or inline graphics. +\vskip 0.2\baselineskip + +\raggedright\emph{Keywords}: \keywords \end{abstract} \tableofcontents @@ -115,15 +117,15 @@ and the environment \end{animateinline} \end{verbatim} -While \verb+\animategraphics+ can be used to assemble animations from sets of existing graphics files, the environment `\verb+animateinline+' is intended to create the animation from the typeset material it encloses. This material can be pictures drawn within the \LaTeX{} \verb+picture+ environment or using the advanced capabilities of PSTricks or pgf/TikZ. Even ordinary textual material may be animated in this way. The parameter \verb++ specifies the number of frames per second of the animation. +While \verb+\animategraphics+ can be used to assemble animations from sets of existing graphics files, the environment `\verb+animateinline+' is intended to create the animation from the typeset material it encloses. This material can be pictures drawn within the \LaTeX{} \verb+picture+ environment or using the advanced capabilities of PSTricks or pgf/TikZ. Even ordinary textual material may be animated in this way. The parameter \verb++ specifies the number of frames per second of the animation. The command \verb+\newframe+ terminates a frame and starts the next one. It can be used inside the `\verb+animateinline+' environment only. There is a starred version, \verb+\newframe*+. If placed after a particular frame it causes the animation to pause at that frame. The animation continues normally after clicking it again. Both \verb+\newframe+ variants take an optional argument that allows to change the frame rate in the middle of an animation. -All files of the sequence must be consecutively numbered. {\tt } is the leftmost part of the file name that all members of the sequence have in common. \verb++ is the number of the first and \verb++ the number of the last file in the set. \verb++ and \verb++ must have the same number of digits to ensure proper sorting. If necessary, rename the files with zeros padded to the left. +All files of the sequence must be consecutively numbered. {\tt } is the leftmost part of the file name that all members of the sequence have in common. \verb++ is the number of the first and \verb++ the number of the last file in the set. File names may be simply numbered, such as $0\dots99$. If there are leading zeros, make sure that all file numbers have the same number of digits, such as $0001\dots0100$. There is no file name extension to be specified as parameter. The possible file formats depend on whether \LaTeX{} or pdf\LaTeX{} is used. In the case of \LaTeX{}, files with the extension `\verb+eps+' are searched for at first, followed by `\verb+mps+' (\MP-generated Postscript) and `\verb+ps+'. With pdf\LaTeX{} the searching order is: (1)~`\verb+pdf+', (2)~`\verb+mps+', (3)~`\verb+png+', (4)~`\verb+jpg+', (5)~`\verb+jpeg+', (6)~`\verb+jbig2+' and (7)~`\verb+jb2+'. That is, files capable to store vector graphics are found first. Make sure that all file names have \emph{lower case} extensions. -For example, given the sequence `frame\_05.png' through `frame\_19.png' from a possibly larger set that shall be used to build the animation. Then, {\tt } would be specified as `\verb+frame_+', \verb++ as `\verb+05+' and \verb++ as `\verb+19+'. +For example, given the sequence `frame\_5.png' through `frame\_19.png' from a possibly larger set that shall be used to build the animation. Then, {\tt } would be specified as `\verb+frame_+', \verb++ as `\verb+5+' and \verb++ as `\verb+19+'. The following options to \verb+\animategraphics+ and `\verb+animateinline+' have been provided: \begin{verbatim} @@ -168,7 +170,7 @@ Changes the control button height to \verb++, which must be a valid \TeX{} screenbg= buttonbg= \end{verbatim} -The background of the animation and control button widgets is transparent by default. It can be turned into a solid colour by the parameter \verb++, which is an array of numbers (\emph{without} surrounding brackets) in the range from 0.0 to 1.0. The number of array elements determines the colour model in which the colour is defined: (1) gray value, (3) RGB, (4) CMYK. +The background of the animation and control button widgets is transparent by default. It can be turned into a solid colour by the parameter \verb++, which is an array of space-separated numbers (\emph{without} surrounding brackets) in the range from 0.0 to 1.0. The number of array elements determines the colour model in which the colour is defined: (1) gray value, (3) RGB, (4) CMYK. \begin{verbatim} step \end{verbatim} @@ -306,7 +308,7 @@ Specifies which frame (first, last or none) to display and print if the animatio ... ... create first frame using \somevar(=1.0) ... (\multido _can_ be used here!) - ... + ... \whiledo{\theiter<50}{% do 50 iterations % start new frame \newframe% @@ -319,7 +321,7 @@ Specifies which frame (first, last or none) to display and print if the animatio ... ... create frame using \somevar ... (\multido _can_ be used here!) - ... + ... } \end{animateinline} \end{verbatim} diff --git a/Master/texmf-dist/tex/latex/animate/animate.sty b/Master/texmf-dist/tex/latex/animate/animate.sty index b534464495b..6067ebadf1b 100644 --- a/Master/texmf-dist/tex/latex/animate/animate.sty +++ b/Master/texmf-dist/tex/latex/animate/animate.sty @@ -13,7 +13,7 @@ % Supports LaTeX->dvips->ps2pdf or pdfLaTeX workflows. \NeedsTeXFormat{LaTeX2e} -\ProvidesPackage{animate}[2007/05/10] +\ProvidesPackage{animate}[2007/05/24] \RequirePackage{keyval} \RequirePackage{ifthen} \RequirePackage{ifpdf} @@ -35,20 +35,18 @@ \fi% \fi% \else - %define `?pdfmark' operator; taken from the PDFmark Reference - \AtBeginDocument{% - \ifx\pdfmark\@undefined% (hyperref provides its own - \special{ps: % definition) - /pdfmark where - { pop globaldict /?pdfmark /exec load put } - { - globaldict - begin - /?pdfmark /pop load def - /pdfmark /cleartomark load def - end - } - ifelse + %define `?pdfmark' operator as in file hdvips.def from package `hyperref' + \AtBeginDvi{% + \ifx\pdfmark\@undefined% + \special{! + systemdict /pdfmark known% + {% + userdict /?pdfmark systemdict /exec get put% + }{% + userdict /?pdfmark systemdict /pop get put + userdict /pdfmark systemdict /cleartomark get put% + }% + ifelse% }% \fi% } @@ -126,8 +124,7 @@ \newbox\@anim@@box %stores single frame \newdimen\@anim@tmpdima %length register for occasional use -%creates Form XObject from graphics file, creates an ocg and associates it with -%the XObject; +%creates Form XObject from graphics file \def\@anim@pt{pt} \ifpdf \def\@anim@ximage#1#2#3{%#1:@anim@num, #2:@anim@curframe@zb, #3:filename @@ -158,7 +155,8 @@ } \fi -%creates Form XObject from box contents +%creates Form XObject from box contents and associates it with a newly created +%OCG \ifpdf \newbox\@anim@box %stores all graphics of a sequence \def\@anim@xinline#1#2#3{%#1:@anim@num, #2:@anim@curframe@zb, #3:box number @@ -818,8 +816,8 @@ \def\@anim@first{#4}% \def\@anim@last{#5}% % - %create button faces if necessary \if@anim@controls% + %create button faces if necessary \if@anim@buttonsmade\else% \@anim@makebuttons% \setboolean{@anim@buttonsmade}{true}% @@ -840,11 +838,11 @@ \loop\ifnum\@anim@curframe>\@anim@last\else% %get file name extension of current file \@anim@getext{% - \@anim@base\@anim@pad{\@anim@last}{\the\@anim@curframe}% + \@anim@base\@anim@pad{\@anim@first}{\the\@anim@curframe}% }% %embed graphics \@anim@ximage{\the\@anim@num}{\the\@anim@curframe@zb}{% - \@anim@base\@anim@pad{\@anim@last}{\the\@anim@curframe}\@anim@ext% + \@anim@base\@anim@pad{\@anim@first}{\the\@anim@curframe}\@anim@ext% }% \advance\@anim@curframe by 1% \advance\@anim@curframe@zb by 1% @@ -1306,7 +1304,11 @@ \ifnum10#1<1#2 \@anim@template{0#1}{#2}% \else% - #1% + \ifnum10#1=1#2 + \@anim@template{0#1}{#2}% + \else% + #1% + \fi% \fi% }% @@ -1795,6 +1797,15 @@ else{% \fi% \fi% + \if@anim@step\else% + \if@anim@controls + a#1.playsRight=true;% + \else% + \if@anim@palindrome + a#1.playsRight=true;% + \fi% + \fi% + \fi% \ifx\@anim@poster\@anim@posterframe a#1.actnEndRight();% \else diff --git a/Master/texmf-dist/tpm/animate.tpm b/Master/texmf-dist/tpm/animate.tpm index 36df9123ac7..6bc66c84283 100644 --- a/Master/texmf-dist/tpm/animate.tpm +++ b/Master/texmf-dist/tpm/animate.tpm @@ -3,21 +3,21 @@ animate Package - 2007/05/10 13:22:00 + 2007/05/24 13:47:00 karl The animate package. - 1207149 + 1208388 - + texmf-dist/tex/latex/animate/animate-noocg.sty texmf-dist/tex/latex/animate/animate.sty texmf-dist/tpm/animate.tpm - + texmf-dist/doc/latex/animate/README texmf-dist/doc/latex/animate/doc/animate.pdf texmf-dist/doc/latex/animate/doc/animate.tex -- cgit v1.2.3