renamed log() method to remove compiler warning
[swftools.git] / FAQ
diff --git a/FAQ b/FAQ
index b6c90d4..c735e44 100644 (file)
--- a/FAQ
+++ b/FAQ
@@ -5,26 +5,23 @@
 
 2.) How to compile/link swftools on Unix/Linux/BSD?
 
-    Download swftools-0.x.x.tar.gz and t1lib-1.3.1.tar.gz.
+    Download swftools-0.x.x.tar.gz. Then type, on the
+    command-line:
 
-    gzip -d swftools-0.x.x.tar.gz
-    gzip -d t1lib-1.3.1.tar.gz
-    tar -xf t1lib-1.3.1.tar
-    cd t1lib-1.3.1
-    ./configure
-    make 
-    make install
-    cd ..
-    tar -xf swftools-0.x.x.tar
+    tar -zvxf swftools-0.x.x.tar
     cd swftools-0.x.x
     ./configure
     make 
     make install
 
+    (you will have to be root for the last step)
+
 3.) What libraries do I need to compile swftools on Unix/Linux/BSD?
 
-    You need t1lib and jpeglib to compile pdf2swf.
+    You need t1lib, freetype and jpeglib to compile pdf2swf.
     Links:
+       freetype:
+        http://www.freetype.org
        t1lib: 
         ftp://sunsite.unc.edu/pub/linux/libs/graphics/t1lib-1.3.1.tar.gz
        t1lib (mirrored here): 
 
     LDFLAGS=-lstdc++ ./configure
 
-6.) Is there a pdf2swf for Windows?
+6.) How do I compile swftools on Mac OS X?
+
+    You need to get fink (http://fink.sourceforge.net), and install it.
+    After this, you need to install all the required libs (jpeg, freetype, lame):
+   
+    fink install libjpeg libjpeg-shlibs freetype2 freetype2-shlibs lame lame-shlibs
+
+    Then, you have to inform configure of where they are:
+
+    LDFLAGS="-L/sw/lib" CPPFLAGS="-I/sw/include -I/sw/include/lame" ./configure
+    make
+    sudo make install
+
+    If this doesn't work, especially if you want to use the python library and
+    get weird exceptions, try to remove all versions of jpeglib, freetype and 
+    lame from /usr/lib and /usr/local/lib, and then run configure / make / make install
+    again.
+
+    If you also want to use the python interface, you may have to copy the
+    Imaging headers (Imaging.h, ImPlatform.h, ImConfig.h) to
+      /System/Library/Frameworks/Python.framework/Versions/2.3/include/python2.3/
+    before running configure.
 
-    Windows versions of all SWF utilities (except for avi2swf) are in
-       http://www.quiss.org/swftools/swftools-win32.zip
+7.) Is there a pdf2swf/avi2swf for Windows?
+
+    Windows versions of all SWF utilities are downloadable from
+       http://www.quiss.org/swftools/download.html
     .
-    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.
+    (There's a self-extracting .exe version of all versions since 0.6.1, 
+     and a .zip or .rar archive of the newest development snapshot)
+
+8.) Where's the source code of the Windows version?
+
+    It's the same as the Unix source code. If you want to compile
+    under Windows, it's recommended that you get the CVS version
+    of the sources.
+    You need MingW (http://www.mingw.org) to compile it.
+    When cross-compiling under Linux, e.g. the following generates the Windows .exe files:
+
+    CXX=i386-mingw32msvc-g++ CPP=i386-mingw32msvc-cpp CC=i386-mingw32msvc-gcc \
+    ./configure --host=i586-mingw32msvc && make
 
-7.) The fonts in the SWFs generated by pdf2swf are wrong!
+    For compiling on Windows itself, there's a HOWTO from Daichi Shinozaki:
+    http://lists.gnu.org/archive/html/swftools-common/2005-02/msg00023.html
+
+9.) The fonts in the SWFs generated by pdf2swf are wrong!
 
     Watch the output of pdf2swf closely.
     You should see something like:
     Provided you actually own the font in question (here: Myriad-Roman.ttf), 
     you can copy that fonts into your current directory and pass 
     the "-F ./" (--fontpath ./) option to pdf2swf. 
-    If you use a page in several PDFs, you can also simply copy it
+    If you use a font in several PDFs, you can also simply copy it
     to (on Windows) C:\SWFTools\Fonts\, or (on Unix) /usr/local/share/swftools/fonts 
     to make it work all the time.
 
-8.) Can png2swf handle transparency?
+10.) Can png2swf handle transparency?
 
-    It supports PNG mode 2 transparency (256 color palettes with alpha) since version 0.4.2. 
+    Yes. 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?
+11.) 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.
 
-10.) avi2swf converts my avi files upside down!
+12.) avi2swf converts my avi files upside down!
 
     Try using the -p (--flip) switch.
 
-11.) How to extract images/sounds from myfile.swf using swfextract?
+13.) How to extract images/sounds from myfile.swf using swfextract?
 
     First list all extractable items:
 
     The result is something like:
 
        Objects in file myfile.swf:
-       3 Shapes: ID(s) 1-3
-       5 MovieClips: ID(s) 4, 5, 8, 10, 12
-       3 JPEGs: ID(s) 69, 116, 447
-       1 PNG: ID(s) 318
-       3 Sounds: ID(s) 28-30
-       10 Frames: ID(s) 0-10
+        [-i] 3 Shapes: ID(s) 1-3
+        [-i] 5 MovieClips: ID(s) 4, 5, 8, 10, 12
+        [-j] 3 JPEGs: ID(s) 69, 116, 447
+        [-p] 1 PNG: ID(s) 318
+        [-s] 3 Sounds: ID(s) 28-30
+        [-f] 10 Frames: ID(s) 0-10
 
-    Not you can extract a shape using
+    Now you can extract a shape using
 
        swfextract -i 2 myfile.swf -o shape.swf
 
 
     etc.
 
-12.) Is there a mailing list for SWFTools?
+14.) Is there a mailing list for SWFTools?
 
     Yes there is. You can subscribe by going to
     
     http://mail.nongnu.org/mailman/listinfo/swftools-common
 
+15.) Where can I donate?
+
+    You can donate via PayPal by clicking on the "donate" button
+    on http://www.quiss.org/swftools/index.html
+    .
+    Any financial support for this project is most welcome!
+