minor bugfixes and speed improvements in polygon intersector
[swftools.git] / FAQ
diff --git a/FAQ b/FAQ
index 8014c17..eda6f5b 100644 (file)
--- a/FAQ
+++ b/FAQ
@@ -1,9 +1,15 @@
-1.) What's the cost of swftools?
+1.) What's the price of swftools?
 
-    SWFTools is free of charge, and is released under the GPL
-    (http://www.gnu.org/licenses/gpl.html).
+    SWFTools is free of charge (donations are welcome, though), and is 
+    released under the GPL (http://www.gnu.org/licenses/gpl.html).
 
-2.) How to compile/link swftools on Unix/Linux/BSD?
+2.) Where can I donate?
+
+    You can donate via PayPal by clicking on the "donate" button
+    on http://www.swftools.org/donate.html
+    .
+
+3.) How to compile/link swftools on Unix/Linux/BSD?
 
     Download swftools-0.x.x.tar.gz. Then type, on the
     command-line:
 
     (you will have to be root for the last step)
 
-3.) What libraries do I need to compile swftools on Unix/Linux/BSD?
+4.) What libraries do I need to compile swftools on Unix/Linux/BSD?
 
-    You need t1lib, freetype and jpeglib to compile pdf2swf.
+    You need 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!
+5.) when compiling the sourcecode version, configure doesn't find my jpeglib!
 
     In case some of your libraries/include files are installed in /usr/local,
     try the following:
@@ -56,7 +54,7 @@
     If it still doesn't work, try removing the file "config.cache"
     before running configure again.
 
-5.) There are problems during compilation:
+6.) There are problems during compilation:
     Error messages complain about "undefined reference to `operator new(unsigned)'"
     as well as "undefined reference to `__gxx_personality_v0'".
 
@@ -64,7 +62,7 @@
 
     LDFLAGS=-lstdc++ ./configure
 
-6.) How do I compile swftools on Mac OS X?
+7.) 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):
@@ -87,7 +85,7 @@
       /System/Library/Frameworks/Python.framework/Versions/2.3/include/python2.3/
     before running configure.
 
-7.) Is there a pdf2swf/avi2swf for Windows?
+8.) Is there a pdf2swf/avi2swf for Windows?
 
     Windows versions of all SWF utilities are downloadable from
        http://www.quiss.org/swftools/download.html
@@ -95,7 +93,7 @@
     (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?
+9.) 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
     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!
+10.) The fonts in the SWFs generated by pdf2swf are wrong!
 
     Watch the output of pdf2swf closely.
     You should see something like:
     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?
+11.) 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?
+12.) 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.
 
-12.) avi2swf converts my avi files upside down!
+13.) avi2swf converts my avi files upside down!
 
     Try using the -p (--flip) switch.
 
-13.) How to extract images/sounds from myfile.swf using swfextract?
+14.) How to extract images/sounds from myfile.swf using swfextract?
 
     First list all extractable items:
 
 
     etc.
 
-14.) Is there a mailing list for SWFTools?
+15.) 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?
+16.) Why didn't Matthias answer my swftools-related mail?
 
-    You can donate via PayPal by clicking on the "donate" button
-    on http://www.swftools.org/donate.html
-    .
-    Any financial support for this project is most welcome!
+    Currently, Matthias is getting much more mails than he can answer. It's frustrating,
+    but it's true.
+    He tries his best to at least *read* all mails he receives. 
+    If you need an answer to something, it's usually more effective to post it on the
+    mailing list, though, as there are a lot of friendly users around there which may 
+    have the one or other helpful tip concerning your problem.
+
+16.) When will feature/bugfix/enhancement XY be implemented?
+
+    Setting deadlines in a non-commercial, spare-time project like swftools tools is hard,
+    and keeping them is even harder, if not impossible. 
+
+    Therefore, do not ask about deadlines, and you won't get fuzzy, or even wrong, answers.
+
+17.) How to compile avi2swf?
+
+    avi2swf isn't part of the swftools distribution anymore. If you want to convert avi files
+    to swf, please use either mencoder or ffmpeg:
+
+    mencoder file.avi -lavfopts i_certify_that_my_video_stream_does_not_use_b_frames \
+                      -ffourcc FLV1 -oac mp3lame -of lavf -ovc lavc \
+                      -lavcopts vcodec=flv:acodec=mp3:vbitrate=500:abitrate=56 -srate 22050  \
+                      -o file.swf
+
+    or
+
+    ffmpeg -i video.mpg -b <bitrate> -s <X>y<Y> -pass 1 -passlogfile log_file video.flv
+    ffmpeg -i video.mpg -b <bitrate> -s <X>y<Y> -pass 2 -passlogfile log_file video.flv
+    flvtool2 -UP video.flv
+
+18.) How can I create transparent SWFs from PDFs?
+
+    Run pdf2swf as usual, and then, on the resulting file, execute:
+
+        swfextract -i 3- file.swf -o file.swf
+
+19.) How can I convert SWF frames to bitmap?
 
+    There's a "swfrender" utility in the CVS, which isn't finished yet,
+    and will only work for *very* simple SWF files. (No Actionscript, no
+    gradient fills, no morph shapes, no blending modes, no filters, etc.)
+    Probably other Flash Open-Source projects (like Gnash) have some
+    more sophisticated utilities for this. (One user reported that
+    swfdec (http://swfdec.freedesktop.org/wiki/) and pyswfdec 
+    (http://www.gnome.org/~gianmt) work good)
+    If you find other tools that work, I'd like to know about it. 
+    Please mail me at kramm@quiss.org.