added MacOSX section.
[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.) How do I compile swftools on Mac OS X?
67
68     First, you need to install all the required libs (jpeg, t1lib, freetype, lame) via Fink.
69     Then, you have to inform configure of where they are:
70
71     ( setenv LDFLAGS "-L/sw/lib" ; setenv CPPFLAGS "-I/sw/include -I/sw/include/lame" ; ./configure )
72     make
73     sudo make install
74
75 7.) Is there a pdf2swf/avi2swf for Windows?
76
77     Windows versions of all SWF utilities are downloadable from
78         http://www.quiss.org/swftools/download.html
79     .
80     (There's a self-extracting .exe version of all versions since 0.6.1, 
81      and a .zip or .rar archive of the newest development snapshot)
82     Notice: For now, the utilities need to be installed to C:\SWFTOOLS to make pdf2swf work-
83     otherwise it won't be able to find its fonts.
84
85 8.) Where's the source code of the Windows version?
86
87     It's the same as the Unix source code. If you want to compile
88     under Windows, it's recommended that you get the CVS version
89     of the sources.
90     You need MingW (http://www.mingw.org) to compile it.
91     When cross-compiling under Linux, e.g. the following generates the Windows .exe files:
92
93     CXX=i386-mingw32msvc-g++ CPP=i386-mingw32msvc-cpp CC=i386-mingw32msvc-gcc \
94     ./configure --host=i586-mingw32msvc && make
95
96 9.) The fonts in the SWFs generated by pdf2swf are wrong!
97
98     Watch the output of pdf2swf closely.
99     You should see something like:
100
101       WARNING Font Myriad-Roman could not be loaded.
102       WARNING Try putting a TTF version of that font (named "Myriad-Roman.ttf") into /swftools/fonts
103
104     Provided you actually own the font in question (here: Myriad-Roman.ttf), 
105     you can copy that fonts into your current directory and pass 
106     the "-F ./" (--fontpath ./) option to pdf2swf. 
107     If you use a page in several PDFs, you can also simply copy it
108     to (on Windows) C:\SWFTools\Fonts\, or (on Unix) /usr/local/share/swftools/fonts 
109     to make it work all the time.
110
111 10.) Can png2swf handle transparency?
112
113     It supports PNG mode 2 transparency (256 color palettes with alpha) since version 0.4.2. 
114     Mode 6 (32 bit RGBA truecolor) is also supported since version 0.4.4.
115
116 11.) How to do Flash MX compression with SWFTools?
117
118     Most tools support the -z flag for outputting compressed SWF.
119     Furthermore you can compress/uncompress SWF files using swfcombine:
120
121         swfcombine -dz file.swf -o file_new.swf
122
123     compresses, while
124
125         swfcombine -d file.swf -o file_new.swf
126
127     decompresses.
128
129 12.) avi2swf converts my avi files upside down!
130
131     Try using the -p (--flip) switch.
132
133 13.) How to extract images/sounds from myfile.swf using swfextract?
134
135     First list all extractable items:
136
137         swfextract myfile.swf
138     
139     The result is something like:
140
141         Objects in file myfile.swf:
142         3 Shapes: ID(s) 1-3
143         5 MovieClips: ID(s) 4, 5, 8, 10, 12
144         3 JPEGs: ID(s) 69, 116, 447
145         1 PNG: ID(s) 318
146         3 Sounds: ID(s) 28-30
147         10 Frames: ID(s) 0-10
148
149     Not you can extract a shape using
150
151         swfextract -i 2 myfile.swf -o shape.swf
152
153     a sound using
154         
155         swfextract -s 28 myfile.swf -o sound.wav
156
157     a PNG image file using
158         
159         swfextract -p 318 myfile.swf -o file.png
160
161     etc.
162
163 14.) Is there a mailing list for SWFTools?
164
165     Yes there is. You can subscribe by going to
166     
167     http://mail.nongnu.org/mailman/listinfo/swftools-common
168
169 15.) Where can I donate?
170
171     You can donate via PayPal by clicking on the "donate" button
172     on http://www.quiss.org/swftools/index.html
173     .
174     Any financial support for this project is most welcome!
175