summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/animate/README
blob: 062b762410cc1a8946cc79c8a2c7866fd53f7d74 (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
                             =====================
                              The animate Package
                             =====================

Author:

    Alexander Grahn


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


Usage:

    \usepackage[<package options>]{animate}

    * Package options: width=<h-size>, height=<v-size>, totalheight=<v-size>,
                       keepaspectratio, scale=<factor>, nomouse,
                       autopause, autoplay, autoresume, controls, final, draft,
                       buttonsize=<size>, buttonbg=<colour>, buttonfg=<colour>,
                       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, buttonsize=<size>, buttonbg=<colour>,
                       buttonfg=<colour>, 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>]


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


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.


License:

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

      http://mirrors.ctan.org/help/Catalogue/licenses.lppl.html

    for the details of that license.