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