summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/animate
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/texmf-dist/doc/latex/animate
parent15686466853b682d279ae2adb73991b1bb83d77b (diff)
animate update (25may07)
git-svn-id: svn://tug.org/texlive/trunk@4388 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/animate')
-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
3 files changed, 103 insertions, 101 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}