Generated from configure.in
[swftools.git] / FAQ
1 1.) What's the cost of swftools?
2
3     SWFTools is free of charge, and is released under the GPL
4     (http://www.gnu.org/licenses/gpl.html).
5
6 2.) How to compile/link swftools on Unix/Linux/BSD?
7
8     Download swftools-0.x.x.tar.gz and t1lib-1.3.1.tar.gz.
9
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
23
24 3.) What libraries do I need to compile swftools on Unix/Linux/BSD?
25
26     You need t1lib, freetype and jpeglib to compile pdf2swf.
27     Links:
28         freetype:
29          http://www.freetype.org
30         t1lib: 
31          ftp://sunsite.unc.edu/pub/linux/libs/graphics/t1lib-1.3.1.tar.gz
32         t1lib (mirrored here): 
33          http://www.quiss.org/swftools/t1lib-1.3.1.tar.gz
34         jpeglib: 
35          http://www.ijg.org/files/jpegsrc.v6b.tar.gz
36
37     Furthermore, if you want to compile avi2swf, you need the avifile library:
38         http://avifile.sourceforge.net
39     .
40
41 4.) when compiling the sourcecode version, configure doesn't find my jpeglib / my t1lib!
42
43     In case some of your libraries/include files are installed in /usr/local,
44     try the following:
45
46     rm -f config.cache
47     LDFLAGS="-L/usr/local/lib" CPPFLAGS="-I/usr/local/include" ./configure
48
49     Furthermore, a new installation of jpeglib (the following assumes it's in
50     /usr/local/lib) often requires doing a
51
52     ranlib /usr/local/lib/libjpeg.a
53     ldconfig /usr/local/lib
54
55     If it still doesn't work, try removing the file "config.cache"
56     before running configure again.
57
58 5.) There are problems during compilation:
59     Error messages complain about "undefined reference to `operator new(unsigned)'"
60     as well as "undefined reference to `__gxx_personality_v0'".
61
62     Try running configure as
63
64     LDFLAGS=-lstdc++ ./configure
65
66 6.) Is there a pdf2swf/avi2swf for Windows?
67
68     Windows versions of all SWF utilities are downloadable from
69         http://www.quiss.org/swftools/download.html
70     .
71     (There's a self-extracting .exe version of all versions since 0.6.1, 
72      and a .zip or .rar archive of the newest development snapshot)
73     Notice: For now, the utilities need to be installed to C:\SWFTOOLS to make pdf2swf work-
74     otherwise it won't be able to find its fonts.
75
76 7.) Where's the source code of the Windows version?
77
78     It's the same as the Unix source code. If you want to compile
79     under Windows, it's recommended that you get the CVS version
80     of the sources.
81     You need MingW (http://www.mingw.org) to compile it.
82     When cross-compiling under Linux, e.g. the following generates the Windows .exe files:
83
84     CXX=i386-mingw32msvc-g++ CPP=i386-mingw32msvc-cpp CC=i386-mingw32msvc-gcc \
85     ./configure --host=i586-mingw32msvc && make
86
87 8.) The fonts in the SWFs generated by pdf2swf are wrong!
88
89     Watch the output of pdf2swf closely.
90     You should see something like:
91
92       WARNING Font Myriad-Roman could not be loaded.
93       WARNING Try putting a TTF version of that font (named "Myriad-Roman.ttf") into /swftools/fonts
94
95     Provided you actually own the font in question (here: Myriad-Roman.ttf), 
96     you can copy that fonts into your current directory and pass 
97     the "-F ./" (--fontpath ./) option to pdf2swf. 
98     If you use a page in several PDFs, you can also simply copy it
99     to (on Windows) C:\SWFTools\Fonts\, or (on Unix) /usr/local/share/swftools/fonts 
100     to make it work all the time.
101
102 9.) Can png2swf handle transparency?
103
104     It supports PNG mode 2 transparency (256 color palettes with alpha) since version 0.4.2. 
105     Mode 6 (32 bit RGBA truecolor) is also supported since version 0.4.4.
106
107 10.) How to do Flash MX compression with SWFTools?
108
109     Most tools support the -z flag for outputting compressed SWF.
110     Furthermore you can compress/uncompress SWF files using swfcombine:
111
112         swfcombine -dz file.swf -o file_new.swf
113
114     compresses, while
115
116         swfcombine -d file.swf -o file_new.swf
117
118     decompresses.
119
120 11.) avi2swf converts my avi files upside down!
121
122     Try using the -p (--flip) switch.
123
124 12.) How to extract images/sounds from myfile.swf using swfextract?
125
126     First list all extractable items:
127
128         swfextract myfile.swf
129     
130     The result is something like:
131
132         Objects in file myfile.swf:
133         3 Shapes: ID(s) 1-3
134         5 MovieClips: ID(s) 4, 5, 8, 10, 12
135         3 JPEGs: ID(s) 69, 116, 447
136         1 PNG: ID(s) 318
137         3 Sounds: ID(s) 28-30
138         10 Frames: ID(s) 0-10
139
140     Not you can extract a shape using
141
142         swfextract -i 2 myfile.swf -o shape.swf
143
144     a sound using
145         
146         swfextract -s 28 myfile.swf -o sound.wav
147
148     a PNG image file using
149         
150         swfextract -p 318 myfile.swf -o file.png
151
152     etc.
153
154 13.) Is there a mailing list for SWFTools?
155
156     Yes there is. You can subscribe by going to
157     
158     http://mail.nongnu.org/mailman/listinfo/swftools-common
159
160 14.) Where can I donate?
161
162     I have a PayPal account (http://www.paypal.com). My EMail address is
163     kramm@quiss.org. Any financial support for this project is most welcome!
164