summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/animate/README
blob: 4a24389264e0fddfa5de69d32f349271b8c6b34f (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
                             =====================
                              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.

    The resulting PDF can be viewed in current Adobe Readers on all supported
    platforms.

    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 Adobe Reader


Usage:

    \usepackage[<package options>]{animate}

    * Package options: autopause, autoplay, autoresume, controls, final, draft,
                     buttonsize=<size>, buttonbg=<colour>, buttonfg=<colour>,
                     loop, palindrome, step, poster[=first | none | last],
                     useocg, dvipdfmx, xetex


    \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=<width>, height=<height>, depth=<depth>,
                       scale=<factor>, autopause, autoplay, autoresume, final,
                       draft, controls, buttonsize=<size>, buttonbg=<colour>,
                       buttonfg=<colour>, loop, palindrome, step, measure,
                       poster[=first | none | last], begin={<begin text>},
                       end={<end text>}, timeline=<timeline file>, useocg,
                       every=<number>, bb=<llx> <lly> <urx> <ury>,
                       viewport=<llx> <lly> <urx> <ury>,
                       trim=<left> <bottom> <right> <top>


Requirements:

    e-TeX
    pdfTeX, version >= 1.20
    Ghostscript, version >= 8.31 or Adobe Distiller
    dvipdfmx, version >= 20080607
    Adobe Reader, version >= 7


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.

    MiKTeX users should run the package manager for installation.


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.