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