renamed log() method to remove compiler warning
[swftools.git] / FAQ
diff --git a/FAQ b/FAQ
index 7df0eb6..c735e44 100644 (file)
--- a/FAQ
+++ b/FAQ
     SWFTools is free of charge, and is released under the GPL
     (http://www.gnu.org/licenses/gpl.html).
 
-2.) How to compile/link swftools?
+2.) How to compile/link swftools on Unix/Linux/BSD?
 
-    Download swftools-0.4.2.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.4.2.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.4.2.tar
-    cd swftools-0.4.2
+    tar -zvxf swftools-0.x.x.tar
+    cd swftools-0.x.x
     ./configure
     make 
     make install
 
-3.) Is there a pdf2swf for Windows?
+    (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.
+    Links:
+       freetype:
+        http://www.freetype.org
+       t1lib: 
+        ftp://sunsite.unc.edu/pub/linux/libs/graphics/t1lib-1.3.1.tar.gz
+       t1lib (mirrored here): 
+        http://www.quiss.org/swftools/t1lib-1.3.1.tar.gz
+       jpeglib: 
+        http://www.ijg.org/files/jpegsrc.v6b.tar.gz
+
+    Furthermore, if you want to compile avi2swf, you need the avifile library:
+        http://avifile.sourceforge.net
+    .
+
+4.) when compiling the sourcecode version, configure doesn't find my jpeglib / my t1lib!
+
+    In case some of your libraries/include files are installed in /usr/local,
+    try the following:
+
+    rm -f config.cache
+    LDFLAGS="-L/usr/local/lib" CPPFLAGS="-I/usr/local/include" ./configure
+
+    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
 
-    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.
+6.) How do I compile swftools on Mac OS X?
 
-4.) Is there *going to* be a pdf2swf for Windows?
+    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
 
-    Probably. As soon as we find the time to look into the Cygwin compile issues.
+    Then, you have to inform configure of where they are:
 
-5.) The fonts in the SWFs generated by pdf2swf are wrong!
+    LDFLAGS="-L/sw/lib" CPPFLAGS="-I/sw/include -I/sw/include/lame" ./configure
+    make
+    sudo make install
 
-    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).
+    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.
 
-6.) Can png2swf handle transparency?
+    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.
 
-    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.
+7.) Is there a pdf2swf/avi2swf for Windows?
 
-7.) How to get Flash MX compression with SWFTools?
+    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)
+
+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
+
+    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:
+
+      WARNING Font Myriad-Roman could not be loaded.
+      WARNING Try putting a TTF version of that font (named "Myriad-Roman.ttf") into /swftools/fonts
+
+    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 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?
+
+    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?
 
     Most tools support the -z flag for outputting compressed SWF.
     Furthermore you can compress/uncompress SWF files using swfcombine:
 
     decompresses.
 
-8.) avi2swf converts my avi files upside down!
+12.) avi2swf converts my avi files upside down!
 
     Try using the -p (--flip) switch.
 
-9.) 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:
-       Shapes: 1, 2, 3
-       MovieClips: 4, 5, 8, 10, 12
-       JPEGs: 69, 116, 447
-       PNGs: 318
-       Sounds: 28, 29, 30
-       Frames: 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 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.
 
-10.) 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?
 
-    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 .
+    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!