summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/animate/README
blob: 962dc1834653e6a522367c1c66a78e4738f1689c (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
===================================
 The animate Package

 https://github.com/agrahn/animate

 (C) 2007--\today Alexander Grahn
===================================


1. Description
==============

This package provides an interface to create portable, JavaScript driven PDF
animations from sets of (vector) graphics or rasterized image 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, LaTeX -> dvips
-> ps2pdf (Ghostscript)/Distiller and (Xe)LaTeX -> (x)dvipdfmx, LuaLaTeX.

The resulting PDF with animations can be viewed in Acrobat Reader (except on
mobile devices), in PDF-XChange and in Foxit Reader.

Note, this file only gives a summary of usage and available package and
command options. Please refer to the documentation `animate.pdf' for details
and examples.

 * Keywords: include portable PDF animated PDF animation animating
             embed animated graphics LaTeX pdfLaTeX PSTricks pgf TikZ MetaPost
             LaTeX-picture inline graphics vector graphics animated GIF LaTeX
             dvips ps2pdf dvipdfmx XeLaTeX JavaScript Acrobat Reader PDF-XChange
             Foxit Reader


2. Usage
========

\usepackage[<package options>]{animate}

 * Package options: width=<h-size>, height=<v-size>, totalheight=<v-size>,
                    keepaspectratio, scale=<factor>, nomouse,
                    autopause, autoplay, autoresume, controls[=all | none | ...],
                    final, draft,
                    buttonsize=<size>,
                    buttonbg=<colour>, buttonfg=<colour>, buttonalpha=<opacity>,
                    loop, palindrome, step,
                    poster[=first | <num> | last | none],
                    method=icon | widget | ocg, dvipdfmx, xetex,
                    type=[<file ext>]


\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 ...
\newframe
\multiframe{<number of frames>}{[<variables>]}{
    ... repeated (parameterized) material ...
}
\end{animateinline}

 * Command options: width=<h-size>, height=<v-size>, totalheight=<v-size>,
                    keepaspectratio, scale=<factor>, nomouse,
                    autopause, autoplay, autoresume, final, draft,
                    controls[=all | none | ...],
                    buttonsize=<size>,
                    buttonbg=<colour>, buttonfg=<colour>, buttonalpha=<opacity>,
                    loop, palindrome, step, measure,
                    poster[=first | <num> | last | none],
                    begin={<begin text>}, end={<end text>},
                    timeline=<timeline file>,
                    method=icon | widget | ocg,
                    every=<number>, bb=<llx> <lly> <urx> <ury>,
                    viewport=<llx> <lly> <urx> <ury>,
                    trim=<left> <bottom> <right> <top>,
                    label=<label text>, type=[<file ext>]


3. Requirements
===============

 * e-TeX
 * pdfTeX, version >= 1.20, or LuaLaTeX, version >= 0.95
 * Ghostscript, version >= 9.15 or Adobe Distiller
 * dvipdfmx, version >= 20080607
 * Acrobat Reader (version >= 7), PDF-XChange, Foxit Reader


4. Installation
===============

Unzip the file `animate.tds.zip' into the local TDS root directory which can
be found by running

  kpsewhich -var-value TEXMFLOCAL

on the command line.

After installation, update the filename database by running `texhash' on the
command line.

TeXLive and MiKTeX users should run the package manager for installation.


                         * * *

This material is subject to the LaTeX Project Public License. See

  http://mirrors.ctan.org/macros/latex/base/lppl.txt

for the details of that license.