don't remove *.a files.
[swftools.git] / pdf2swf / HOWTO_pdf2swf
1 Notice
2
3    This documentation is a little outdated. As with swftools-0.2.1 and
4    above, you can simply do
5    pdf2swf -bl -o document.swf document.pdf
6    to link viewer and preloader.
7    However, the Steps below are still valid for jpeg2swf.
8
9 Step 1: Converting the documents
10
11    Suppose you have an arbitrary pdf file, "document.pdf".
12    Call:
13    pdf2swf -o tmp.swf document.pdf
14    Now, tmp.swf is a Flash Movie generated from document.pdf. Movie means
15    that there are no navigation elements whatsoever. Just frames which
16    get displayed one by one, at a rate of approx. 1/2 frames/second. How
17    to make document browsable is explained below.
18    (You can do the same things described below with jpeg files. Simply
19    use
20    jpeg2swf -o tmp.swf pic1.jpeg pic2.jpeg ...
21    and read on)
22
23 Step 2: Linking a viewer
24
25    Just take a viewer of your choice (e.g. [1]SimpleViewer.swf ) and put
26    it in the same directory where you entered the commands above.
27    Now call:
28    swfcombine -o flashfile.swf SimpleViewer.swf viewport=tmp.swf
29    Now, 'flashfile.swf' is "browsable", i.e. there are some buttons in it
30    for turning pages.
31
32 Step 3: Linking a Preloader
33
34    Depending on the size of your PDFs/SWFs, you may want to have some
35    kind of loading animation displayed while the browser is busy getting
36    the actual document. Assuming you have some file like flashfile.swf
37    above, you furthermore need the file [2]PreLoader.swf and an arbirtary
38    loading animation of your choice. (To get started, try [3]loading.swf,
39    or just convert a "Loading" JPEG picture to swf (jpeg2swf -o
40    loading.swf picture.jpg)) Now use
41    swfcombine -o flashfile.swf PreLoader.swf loader=loading.swf
42    movie=flashfile.swf
43    (Most loaders are smaller than the document they load. They usually
44    need some centering so they appear in the middle of the page to be
45    displayed, not in the upper left corner. Replace the above command
46    with e.g.
47    swfcombine -o flashfile.swf PreLoader.swf -x 3000 -y 3000
48    loader=loading.swf movie=flashfile.swf
49    and try playing around with the values after -x and -y)
50
51 Step 4: Correcting the size and framerate
52
53    Sometimes, the bounding box of the generated flash file is not
54    correct. This happens because when linking a viewer or preloader to
55    the SWFs, the new dimensions are those of the PreLoader and Viewer
56    templates, and not those of your pdf or jpeg files. To fix this, use
57    swfcombine --dummy `swfdump -XY tmp.swf` flashfile.swf -o
58    flashfile.swf
59    (tmp.swf is your 'original' swf, generated like above)
60    You may also want to adjust the framerate of the movie to that of the
61    preloader. (As the preloader is usually the only animated part of e.g.
62    pdf viewers)
63    Use:
64    swfcombine --dummy `swfdump -r loading.swf` flashfile.swf -o
65    flashfile.swf
66
67 Step 5: Embedding the SWF into a html page
68
69    Usually, one wants to put the generated SWFs on his web page. To do
70    so, you have to embed the SWF file into html. If you don't know how to
71    embed SWFs into html pages, it's explained at
72    [4]http://www.macromedia.com/support/flash/ts/documents/tn4150.html .
73    Also, you can simply type
74    swfdump --html flashfile.swf
75    and insert the output into your html document
76
77 Appendix A: Creating your own Viewers
78
79    If you know about Flash, and you want to substitute SimpleViewer from
80    above with something more sophisticated, follow these rules:
81    1. There has to be some rectangle (Movieclip, whatever... ) in your
82    Viewer, named "viewport". (This name is used to reference the object
83    when using swfcombine for merging it with the converted pdfs)
84    2. The First frame should contain an actionscript "Stop" instruction.
85    (Otherwise, the browsing buttons turn pages, but pages get also
86    automatically turned every few seconds)
87    3. Browsing buttons next to the rectangle (which turn pages in the
88    shown pdf) should trigger some Actionsscript events, like
89
90      SetTarget "viewport"
91      NextFrame
92      SetTarget ""
93
94    to set the frame in the to-be-replaced rectangle. (It will be replaced
95    with a MovieClip, therefore a SetTarget is neccessary)
96    It's important that the Target Name ist "viewport", not "/viewport",
97    as the Movie will get inserted into a Movieclip (Sprite).
98      _________________________________________________________________
99
100    [5]Back to the SWFTools Project page
101
102 References
103
104    Visible links
105    1. http://www.quiss.org/swftools/SimpleViewer.swf
106    2. http://www.quiss.org/swftools/PreLoader.swf
107    3. http://www.quiss.org/swftools/loading.swf
108    4. http://www.macromedia.com/support/flash/ts/documents/tn4150.html
109    5. http://www.quiss.org/swftools
110
111
112