Brought up to date
[swftools.git] / FAQ
diff --git a/FAQ b/FAQ
index 53c1cbd..434c465 100644 (file)
--- a/FAQ
+++ b/FAQ
     make 
     make install
 
-3.) Is there a pdf2swf for Windows?
+3.) What libraries do I need to compile swftools?
 
-    No. pdf2swf only runs on Unix platforms, like Linux, *BSD, MacOS X, etc.
-    There have been some reports on more or less successfully compling pdf2swf on Win32 using
-    Cygwin (http://sources.redhat.com/cygwin), however, there's no working version
-    yet.
-    If you want to use pdf2swf, find a Unix machine.
+    You need t1lib and jpeglib to compile pdf2swf.
+    Links:
+       t1lib: 
+        ftp://sunsite.unc.edu/pub/linux/libs/graphics/t1lib-1.3.1.tar.gz
+       t1lib (mirrored here): 
+        http://www.quiss.org/swftools/t1llib-1.3.1.tar.gz
+       jpeglib: 
+        http://www.ijg.org/files/jpegsrc.v6b.tar.gz
 
-4.) Is there *going to* be a pdf2swf for Windows?
+    Furthermore, if you want to compile avi2swf, you need the avifile library:
+        http://avifile.sourceforge.net
+    .
 
-    Probably. As soon as we find the time to look into the Cygwin compile issues.
+4.) configure doesn't find my jpeglib / my t1lib!
 
-5.) Can png2swf handle transparency?
+    In case some of your libraries/include files are installed in /usr/local,
+    try the following:
 
-    It supports PNG mode 2 transparency (alpha palettes) since version 0.4.2. 
-    Mode 6 (32 bit RGBA truecolor) is also supported since version 0.4.3, however
-    it seems most Flash players don't handle the alpha channel in the resulting 
-    32 bit images correctly.
+    rm -f config.cache
+    LDFLAGS="-L/usr/local/lib" CPPFLAGS="-I/usr/local/include" ./configure
 
-6.) How to get Flash MX compression with SWFTools?
+    Furthermore, a new installation of jpeglib (the following assumes it's in
+    /usr/local/lib) often requires doing a
+
+    ranlib /usr/local/lib/libjpeg.a
+    ldconfig /usr/local/lib
+
+    If it still doesn't work, try removing the file "config.cache"
+    before running configure again.
+
+5.) There are problems during compilation:
+    Error messages complain about "undefined reference to `operator new(unsigned)'"
+    as well as "undefined reference to `__gxx_personality_v0'".
+
+    Try running configure as
+
+    LDFLAGS=-lstdc++ ./configure
+
+6.) Is there a pdf2swf for Windows?
+
+    Windows versions of all SWF utilities (except for avi2swf) are in
+       http://www.quiss.org/swftools/swftools-win32.zip
+    .
+    Notice: You need to unzip the Archive to C:\SWFTOOLS to make pdf2swf work-
+    otherwise it won't be able to find it's fonts.
+
+7.) The fonts in the SWFs generated by pdf2swf are wrong!
+
+    Try running pdf2swf with the "-v" switch.
+    If you see a line reading "substituting VerySpecialFont -> Times-Roman", then pdf2swf
+    didn't find some fonts, which may be external references in the pdf. 
+    To fix this, copy the fonts into your current directory and pass the "-F ./" (--fontpath ./) 
+    option to pdf2swf. (This doesn't yet work with TTF, only with Type1 Fonts. You can 
+    convert TTF to Type1, however, using ttf2pt1 (http://ttf2pt1.sourceforge.net)).
+    The font files should, in this case, have the filenames VerySpecialFont.afm and
+    VerySpecialFont.pfa (.pfb).
+
+8.) Can png2swf handle transparency?
+
+    It supports PNG mode 2 transparency (256 color palettes with alpha) since version 0.4.2. 
+    Mode 6 (32 bit RGBA truecolor) is also supported since version 0.4.4.
+
+9.) How to do Flash MX compression with SWFTools?
 
     Most tools support the -z flag for outputting compressed SWF.
     Furthermore you can compress/uncompress SWF files using swfcombine:
 
     decompresses.
 
-7.) avi2swf converts my avi files upside down!
+10.) avi2swf converts my avi files upside down!
 
     Try using the -p (--flip) switch.
 
-8.) How to extract images/sounds from myfile.swf using swfextract?
+11.) How to extract images/sounds from myfile.swf using swfextract?
 
     First list all extractable items:
 
 
     etc.
 
-9.) Is there a mailing list for SWFTools?
+12.) Is there a mailing list for SWFTools?
 
-    There used to be, however it was shut down due to lack of traffic. The archive
-    is available as raw INBOX file on http://www.quiss.org/swftools/list.tar.gz.
+    Yes there is. You can subscribe by going to
+    
+    http://mail.nongnu.org/mailman/listinfo/swftools-common