fixed handling of big-endian machines.
[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 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
34
35     Furthermore, if you want to compile avi2swf, you need the avifile library:
36         http://avifile.sourceforge.net
37     .
38
39 4.) when compiling the sourcecode version, configure doesn't find my jpeglib / my t1lib!
40
41     In case some of your libraries/include files are installed in /usr/local,
42     try the following:
43
44     rm -f config.cache
45     LDFLAGS="-L/usr/local/lib" CPPFLAGS="-I/usr/local/include" ./configure
46
47     Furthermore, a new installation of jpeglib (the following assumes it's in
48     /usr/local/lib) often requires doing a
49
50     ranlib /usr/local/lib/libjpeg.a
51     ldconfig /usr/local/lib
52
53     If it still doesn't work, try removing the file "config.cache"
54     before running configure again.
55
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'".
59
60     Try running configure as
61
62     LDFLAGS=-lstdc++ ./configure
63
64 6.) Is there a pdf2swf for Windows?
65
66     Windows versions of all SWF utilities are downloadable from
67         http://www.quiss.org/swftools/download.html
68     .
69     Notice: For now, the utilities need to be installed to C:\SWFTOOLS to make pdf2swf work-
70     otherwise it won't be able to find its fonts.
71
72 7.) The fonts in the SWFs generated by pdf2swf are wrong!
73
74     Watch the output of pdf2swf closely.
75     You should see something like:
76
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
79
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.
86
87 8.) Can png2swf handle transparency?
88
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.
91
92 9.) How to do Flash MX compression with SWFTools?
93
94     Most tools support the -z flag for outputting compressed SWF.
95     Furthermore you can compress/uncompress SWF files using swfcombine:
96
97         swfcombine -dz file.swf -o file_new.swf
98
99     compresses, while
100
101         swfcombine -d file.swf -o file_new.swf
102
103     decompresses.
104
105 10.) avi2swf converts my avi files upside down!
106
107     Try using the -p (--flip) switch.
108
109 11.) How to extract images/sounds from myfile.swf using swfextract?
110
111     First list all extractable items:
112
113         swfextract myfile.swf
114     
115     The result is something like:
116
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
124
125     Not you can extract a shape using
126
127         swfextract -i 2 myfile.swf -o shape.swf
128
129     a sound using
130         
131         swfextract -s 28 myfile.swf -o sound.wav
132
133     a PNG image file using
134         
135         swfextract -p 318 myfile.swf -o file.png
136
137     etc.
138
139 12.) Is there a mailing list for SWFTools?
140
141     Yes there is. You can subscribe by going to
142     
143     http://mail.nongnu.org/mailman/listinfo/swftools-common
144