added section about libraries.
[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?
7
8     Download swftools-0.4.2.tar.gz and t1lib-1.3.1.tar.gz.
9
10     gzip -d swftools-0.4.2.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.4.2.tar
19     cd swftools-0.4.2
20     ./configure
21     make 
22     make install
23
24 3.) What libraries do I need to compile swftools?
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/t1llib-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.) 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 (except for avi2swf) are in
67         http://www.quiss.org/swftools/swftools-win32.zip
68     .
69     Notice: You need to unzip the Archive to C:\SWFTOOLS to make pdf2swf work-
70     otherwise it won't be able to find it's fonts.
71
72 7.) The fonts in the SWFs generated by pdf2swf are wrong!
73
74     Try running pdf2swf with the "-v" switch.
75     If you see a line reading "substituting VerySpecialFont -> Times-Roman", then pdf2swf
76     didn't find some fonts, which may be external references in the pdf. 
77     To fix this, copy the fonts into your current directory and pass the "-F ./" (--fontpath ./) 
78     option to pdf2swf. (This doesn't yet work with TTF, only with Type1 Fonts. You can 
79     convert TTF to Type1, however, using ttf2pt1 (http://ttf2pt1.sourceforge.net)).
80     The font files should, in this case, have the filenames VerySpecialFont.afm and
81     VerySpecialFont.pfa (.pfb).
82
83 8.) Can png2swf handle transparency?
84
85     It supports PNG mode 2 transparency (256 color palettes with alpha) since version 0.4.2. 
86     Mode 6 (32 bit RGBA truecolor) is also supported since version 0.4.4.
87
88 9.) How to do Flash MX compression with SWFTools?
89
90     Most tools support the -z flag for outputting compressed SWF.
91     Furthermore you can compress/uncompress SWF files using swfcombine:
92
93         swfcombine -dz file.swf -o file_new.swf
94
95     compresses, while
96
97         swfcombine -d file.swf -o file_new.swf
98
99     decompresses.
100
101 10.) avi2swf converts my avi files upside down!
102
103     Try using the -p (--flip) switch.
104
105 11.) How to extract images/sounds from myfile.swf using swfextract?
106
107     First list all extractable items:
108
109         swfextract myfile.swf
110     
111     The result is something like:
112
113         Objects in file myfile.swf:
114         Shapes: 1, 2, 3
115         MovieClips: 4, 5, 8, 10, 12
116         JPEGs: 69, 116, 447
117         PNGs: 318
118         Sounds: 28, 29, 30
119         Frames: 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10
120
121     Not you can extract a shape using
122
123         swfextract -i 2 myfile.swf -o shape.swf
124
125     a sound using
126         
127         swfextract -s 28 myfile.swf -o sound.wav
128
129     a PNG image file using
130         
131         swfextract -p 318 myfile.swf -o file.png
132
133     etc.
134
135 12.) Is there a mailing list for SWFTools?
136
137     Yes there is. You can subscribe by going to
138     
139     http://mail.nongnu.org/mailman/listinfo/swftools-common
140