diff options
author | Karl Berry <karl@freefriends.org> | 2007-05-31 18:44:36 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2007-05-31 18:44:36 +0000 |
commit | 713ffc22df0c37adf8b286626efa889c648b4e94 (patch) | |
tree | bac4aa1700957e24c92c3ec113d74aabc3530928 /Master | |
parent | 15686466853b682d279ae2adb73991b1bb83d77b (diff) |
animate update (25may07)
git-svn-id: svn://tug.org/texlive/trunk@4388 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master')
-rw-r--r-- | Master/texmf-dist/doc/latex/animate/README | 184 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/animate/doc/animate.pdf | bin | 964501 -> 964597 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/animate/doc/animate.tex | 20 | ||||
-rw-r--r-- | Master/texmf-dist/tex/latex/animate/animate.sty | 55 | ||||
-rw-r--r-- | 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[<package options>]{animate} - - -- Package options: autopause, autoplay, autoresume, controls, - buttonsize=<size>, screenbg=<colour>, buttonbg=<colour>, - loop, palindrome, step, poster=[first | none | last] - - - \animategraphics[<options>]{<frame rate>}{<file basename>}{<first>}{<last>} - - \begin{animateinline}[<options>]{<frame rate>} - ... typeset material ... - \newframe[<frame rate>] - ... typeset material ... - \newframe*[<frame rate>] - ... typeset material ... - \end{animateinline} - - -- Command options: width=<width>, height=<height>, depth=<depth>, - scale=<factor>, autopause, autoplay, autoresume, controls, - buttonsize=<size>, screenbg=<colour>, buttonbg=<colour>, - 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[<package options>]{animate}
+
+ -- Package options: autopause, autoplay, autoresume, controls,
+ buttonsize=<size>, screenbg=<colour>, buttonbg=<colour>,
+ loop, palindrome, step, poster=[first | none | last]
+
+
+ \animategraphics[<options>]{<frame rate>}{<file basename>}{<first>}{<last>}
+
+ \begin{animateinline}[<options>]{<frame rate>}
+ ... typeset material ...
+ \newframe[<frame rate>]
+ ... typeset material ...
+ \newframe*[<frame rate>]
+ ... typeset material ...
+ \end{animateinline}
+
+ -- Command options: width=<width>, height=<height>, depth=<depth>,
+ scale=<factor>, autopause, autoplay, autoresume, controls,
+ buttonsize=<size>, screenbg=<colour>, buttonbg=<colour>,
+ 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 Binary files differindex 8d59b124085..1d89bfa140e 100644 --- a/Master/texmf-dist/doc/latex/animate/doc/animate.pdf +++ b/Master/texmf-dist/doc/latex/animate/doc/animate.pdf 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+<frame rate>+ 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+<frame rate>+ 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 <file base\-name>} is the leftmost part of the file name that all members of the sequence have in common. \verb+<first>+ is the number of the first and \verb+<last>+ the number of the last file in the set. \verb+<first>+ and \verb+<last>+ 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 <file base\-name>} is the leftmost part of the file name that all members of the sequence have in common. \verb+<first>+ is the number of the first and \verb+<last>+ 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 <file base\-name>} would be specified as `\verb+frame_+', \verb+<first>+ as `\verb+05+' and \verb+<last>+ 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 <file base\-name>} would be specified as `\verb+frame_+', \verb+<first>+ as `\verb+5+' and \verb+<last>+ 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+<size>+, which must be a valid \TeX{} screenbg=<colour> buttonbg=<colour> \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+<colour>+, 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+<colour>+, 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 @@ <rdf:Description about="http://texlive.dante.de/texlive/Package/animate.zip"> <TPM:Name>animate</TPM:Name> <TPM:Type>Package</TPM:Type> - <TPM:Date>2007/05/10 13:22:00</TPM:Date> + <TPM:Date>2007/05/24 13:47:00</TPM:Date> <TPM:Version></TPM:Version> <TPM:Creator>karl</TPM:Creator> <TPM:Title>The animate package.</TPM:Title> <TPM:Description></TPM:Description> <TPM:Author></TPM:Author> - <TPM:Size>1207149</TPM:Size> + <TPM:Size>1208388</TPM:Size> <TPM:License></TPM:License> <TPM:Build/> - <TPM:RunFiles size="105818"> + <TPM:RunFiles size="106064"> texmf-dist/tex/latex/animate/animate-noocg.sty texmf-dist/tex/latex/animate/animate.sty texmf-dist/tpm/animate.tpm </TPM:RunFiles> - <TPM:DocFiles size="1102570"> + <TPM:DocFiles size="1103136"> texmf-dist/doc/latex/animate/README texmf-dist/doc/latex/animate/doc/animate.pdf texmf-dist/doc/latex/animate/doc/animate.tex |