renamed log() method to remove compiler warning
[swftools.git] / FAQ
diff --git a/FAQ b/FAQ
index e5722b0..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.
 
 6.) How do I compile swftools on Mac OS X?
 
-    First, you need to install all the required libs (jpeg, t1lib, freetype, lame) via Fink.
+    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:
 
-    ( setenv LDFLAGS "-L/sw/lib" ; setenv CPPFLAGS "-I/sw/include -I/sw/include/lame" ; ./configure )
+    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
@@ -79,8 +88,6 @@
     .
     (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.
 
 8.) Where's the source code of the Windows version?
 
     CXX=i386-mingw32msvc-g++ CPP=i386-mingw32msvc-cpp CC=i386-mingw32msvc-gcc \
     ./configure --host=i586-mingw32msvc && make
 
+    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.
     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.
 
 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.
 
 11.) How to do Flash MX compression with SWFTools?
     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
-
-    Not you can extract a shape using
+        [-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
+
+    Now you can extract a shape using
 
        swfextract -i 2 myfile.swf -o shape.swf