added some words to usage().
[swftools.git] / FAQ
blobb6c90d414cdf53ec7aaa64ff798522cf55a5249c
1 1.) What's the cost of swftools?
3     SWFTools is free of charge, and is released under the GPL
4     (http://www.gnu.org/licenses/gpl.html).
6 2.) How to compile/link swftools on Unix/Linux/BSD?
8     Download swftools-0.x.x.tar.gz and t1lib-1.3.1.tar.gz.
10     gzip -d swftools-0.x.x.tar.gz
11     gzip -d t1lib-1.3.1.tar.gz
12     tar -xf t1lib-1.3.1.tar
13     cd t1lib-1.3.1
14     ./configure
15     make 
16     make install
17     cd ..
18     tar -xf swftools-0.x.x.tar
19     cd swftools-0.x.x
20     ./configure
21     make 
22     make install
24 3.) What libraries do I need to compile swftools on Unix/Linux/BSD?
26     You need t1lib and jpeglib to compile pdf2swf.
27     Links:
28         t1lib: 
29          ftp://sunsite.unc.edu/pub/linux/libs/graphics/t1lib-1.3.1.tar.gz
30         t1lib (mirrored here): 
31          http://www.quiss.org/swftools/t1lib-1.3.1.tar.gz
32         jpeglib: 
33          http://www.ijg.org/files/jpegsrc.v6b.tar.gz
35     Furthermore, if you want to compile avi2swf, you need the avifile library:
36         http://avifile.sourceforge.net
37     .
39 4.) when compiling the sourcecode version, configure doesn't find my jpeglib / my t1lib!
41     In case some of your libraries/include files are installed in /usr/local,
42     try the following:
44     rm -f config.cache
45     LDFLAGS="-L/usr/local/lib" CPPFLAGS="-I/usr/local/include" ./configure
47     Furthermore, a new installation of jpeglib (the following assumes it's in
48     /usr/local/lib) often requires doing a
50     ranlib /usr/local/lib/libjpeg.a
51     ldconfig /usr/local/lib
53     If it still doesn't work, try removing the file "config.cache"
54     before running configure again.
56 5.) There are problems during compilation:
57     Error messages complain about "undefined reference to `operator new(unsigned)'"
58     as well as "undefined reference to `__gxx_personality_v0'".
60     Try running configure as
62     LDFLAGS=-lstdc++ ./configure
64 6.) Is there a pdf2swf for Windows?
66     Windows versions of all SWF utilities (except for avi2swf) are in
67         http://www.quiss.org/swftools/swftools-win32.zip
68     .
69     Notice: You need to unzip the Archive to C:\SWFTOOLS to make pdf2swf work-
70     otherwise it won't be able to find it's fonts.
72 7.) The fonts in the SWFs generated by pdf2swf are wrong!
74     Watch the output of pdf2swf closely.
75     You should see something like:
77       WARNING Font Myriad-Roman could not be loaded.
78       WARNING Try putting a TTF version of that font (named "Myriad-Roman.ttf") into /swftools/fonts
80     Provided you actually own the font in question (here: Myriad-Roman.ttf), 
81     you can copy that fonts into your current directory and pass 
82     the "-F ./" (--fontpath ./) option to pdf2swf. 
83     If you use a page in several PDFs, you can also simply copy it
84     to (on Windows) C:\SWFTools\Fonts\, or (on Unix) /usr/local/share/swftools/fonts 
85     to make it work all the time.
87 8.) Can png2swf handle transparency?
89     It supports PNG mode 2 transparency (256 color palettes with alpha) since version 0.4.2. 
90     Mode 6 (32 bit RGBA truecolor) is also supported since version 0.4.4.
92 9.) How to do Flash MX compression with SWFTools?
94     Most tools support the -z flag for outputting compressed SWF.
95     Furthermore you can compress/uncompress SWF files using swfcombine:
97         swfcombine -dz file.swf -o file_new.swf
99     compresses, while
101         swfcombine -d file.swf -o file_new.swf
103     decompresses.
105 10.) avi2swf converts my avi files upside down!
107     Try using the -p (--flip) switch.
109 11.) How to extract images/sounds from myfile.swf using swfextract?
111     First list all extractable items:
113         swfextract myfile.swf
114     
115     The result is something like:
117         Objects in file myfile.swf:
118         3 Shapes: ID(s) 1-3
119         5 MovieClips: ID(s) 4, 5, 8, 10, 12
120         3 JPEGs: ID(s) 69, 116, 447
121         1 PNG: ID(s) 318
122         3 Sounds: ID(s) 28-30
123         10 Frames: ID(s) 0-10
125     Not you can extract a shape using
127         swfextract -i 2 myfile.swf -o shape.swf
129     a sound using
130         
131         swfextract -s 28 myfile.swf -o sound.wav
133     a PNG image file using
134         
135         swfextract -p 318 myfile.swf -o file.png
137     etc.
139 12.) Is there a mailing list for SWFTools?
141     Yes there is. You can subscribe by going to
142     
143     http://mail.nongnu.org/mailman/listinfo/swftools-common