summaryrefslogtreecommitdiff
path: root/Master
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2007-05-31 18:44:36 +0000
committerKarl Berry <karl@freefriends.org>2007-05-31 18:44:36 +0000
commit713ffc22df0c37adf8b286626efa889c648b4e94 (patch)
treebac4aa1700957e24c92c3ec113d74aabc3530928 /Master
parent15686466853b682d279ae2adb73991b1bb83d77b (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/README184
-rw-r--r--Master/texmf-dist/doc/latex/animate/doc/animate.pdfbin964501 -> 964597 bytes
-rw-r--r--Master/texmf-dist/doc/latex/animate/doc/animate.tex20
-rw-r--r--Master/texmf-dist/tex/latex/animate/animate.sty55
-rw-r--r--Master/texmf-dist/tpm/animate.tpm8
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
index 8d59b124085..1d89bfa140e 100644
--- a/Master/texmf-dist/doc/latex/animate/doc/animate.pdf
+++ b/Master/texmf-dist/doc/latex/animate/doc/animate.pdf
Binary files 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+<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