renamed log() method to remove compiler warning
[swftools.git] / FAQ
diff --git a/FAQ b/FAQ
index a90a976..c735e44 100644 (file)
--- a/FAQ
+++ b/FAQ
@@ -5,22 +5,17 @@
 
 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, freetype and jpeglib to compile pdf2swf.
 
     LDFLAGS=-lstdc++ ./configure
 
-6.) Is there a pdf2swf/avi2swf 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.
+
+7.) Is there a pdf2swf/avi2swf for Windows?
 
     Windows versions of all SWF utilities are downloadable from
        http://www.quiss.org/swftools/download.html
     .
     (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)
-    Notice: For now, the utilities need to be installed to C:\SWFTOOLS to make pdf2swf work-
-    otherwise it won't be able to find its fonts.
 
-7.) Where's the source code of the Windows version?
+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
     CXX=i386-mingw32msvc-g++ CPP=i386-mingw32msvc-cpp CC=i386-mingw32msvc-gcc \
     ./configure --host=i586-mingw32msvc && make
 
-8.) 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.
 
-9.) 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.
 
-10.) 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.
 
-11.) avi2swf converts my avi files upside down!
+12.) avi2swf converts my avi files upside down!
 
     Try using the -p (--flip) switch.
 
-12.) 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.
 
-13.) 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
 
-14.) Where can I donate?
+15.) Where can I donate?
 
-    I have a PayPal account (http://www.paypal.com). My EMail address is
-    kramm@quiss.org. Any financial support for this project is most welcome!
+    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!