Provided by: xfireworks_1.3-8_i386 bug

NAME

       XFireworks - Fireworks in the root window on X.

SYNOPSIS

       xfireworks [ options ]

DESCRIPTION

       XFireworks makes fireworks in the root window on X.
       This  is  imitation  of  Japanese  "Hanabi Taikai".  It is very popular
       event in Japanese summer and  performed  on  some  rivers.   Sumidagawa
       River's  Hanabi  Taikai  is  very popular.  The author has seen Arakawa
       River's Hanabi Taikai every year.

OPTIONS

       -h, -help

               Output help messages.

       -display [displayname]

               The name of the X server to use.

       -bg, -background, -background-color [color name]

               Background color of the root window.

       -f, -file [filename]

               The name of the file to configure fireworks.  Default configure
               file is ./xfireworks.conf

       -wait [wait time]

               Wait time for micro seconds.

       -fine [number]

               Steps  of moving pieces of fireworks for percent. Default value
               is 100.
               If this value is small, xfireworks runs quickly and speedy.

       -gradation [number]

               Color gradation. Default value is 16.
               If color gradation is a little, colors are shared, memory of  X
               server  and  xfireworks  are  saved,  and  xfireworks starts up
               quickly.

       -direct-draw

               XFireworks  draw  fireworks  in  the  root   window   directly.
               (Default)

       -no-direct-draw

               XFireworks  draw  fireworks in a pixmap and copy it to the root
               window  as  a  background  pixmap.   If  xfireworks  don't  run
               properly  or you want to run XFireworks as a background pixmap,
               try this option.

       -probability, -probability-magnification [number]

               Magnification  of  probability  of  performing  fireworks   for
               percent.  Default value is 100.
               If this value is small, fireworks is very silent.
               If this value is large, fireworks is very loud.

       -size, -size-magnification [number]

               Magnification  of  size of pieces for percent. Default value is
               100.

       -air, -air-magnification [number]

               Magnification of air resistance for percent. Default  value  is
               100.

       -gravity, -gravity-magnification [number]

               Magnification of gravity for percent. Default value is 100.

       -transmission, -transmission-magnification [number]

               Magnification  of  velocity  transmission  for percent. Default
               value is 100.

       -after-image, -after-image-magnification [number]

               Magnification of after images length for percent. Default value
               is 100.
               If this value is large, length of after images is very long.

       -color-length, -color-length-magnification [number]

               Magnification of color change length for percent. Default value
               is 100.

       -next-power, -next-power-magnification [number]

               Magnification of pieces explosion power  for  percent.  Default
               value is 100.

       -next-number, -next-number-magnification [number]

               Magnification  of  the  number  of  pieces for percent. Default
               value is 100.
               If this value is small, fireworks is very silent.
               If this value is large, fireworks is very loud.

EXAMPLES

       If your machine is very slow, try
       > xfireworks -fine 75 -after-image 75

       If your machine has less colors, try
       > xfireworks -gradation 5
       XFireworks use 5x5x5=125 colors.

       If you have very high spec machine, try
       > xfireworks -fine 200 -after-image 150 -gradation 64 -wait 10000

       If you like simple fireworks (it's Japanese "Wabi Sabi"), try
       > xfireworks -probability 50

       If you like loud fireworks, try
       > xfireworks -probability 500 -after-image 200 -next-number 120

       If xfireworks don't run properly, try
       > xfireworks -direct-draw
       or
       > xfireworks -no-direct-draw

SEE ALSO

       X(1)

FILES

       ./xfireworks.conf, /usr/lib/games/xfireworks/xfireworks.conf

       The default file to configure XFireworks.

       XFireworks search the configuration file in  the  current  directry  at
       first.      If     not     exist,     second,     XFireworks     search
       "<XRoot>/lib/X11/XFireworks".  If not exist, XFireworks use the default
       data in itself at last.

       You can get the newest xfireworks.conf from the web page of XFireworks.
       The newest xfireworks.conf has more kinds  of  fireworks  and  is  more
       beautiful.

Q AND A

       Q.
       All of fireworks are white.

       A.
       Your  machine  have less colors. Use -gradation option and decrease the
       number of colors to use.

       Q.
       If I use gmc (GNOME file manager), xfireworks runs very slow.

       A.
       Try -no-direct-draw option.

       Q.
       I want to put fireworks on the root window  as  a  background  picture.
       But, if I stop xfireworks with Ctrl-C, the root window is cleaned.

       A.
       Try  -no-direct-draw option. If you run xfireworks with -no-direct-draw
       option,  xfireworks  don't  clean  the  root  window  when   you   stop
       xfireworks.

       Q.
       If  I use xfireworks with -fine 500 -after-image 500 options, movements
       of fireworks are not smoothly.

       A.
       Try -no-direct-draw option. If you run xfireworks with  -no-direct-draw
       option,  xfireworks  draw fireworks on a pixmap and copy it to the root
       window, and movements of fireworks are smoothly.

       Q.
       I want to see more beautiful fireworks!

       A.
       Access  the   XFireworks's   web   page   and   download   the   newest
       xfireworks.conf.

       Q.
       I want to make my original fireworks!

       A.
       Edit xfireworks.conf. If you make more beautiful fireworks, please send
       it to the author.

AUTHOR

       Programed by SAKAI Hiroaki.
       E-Mail: sakai@seki.ee.kagu.sut.ac.jp, hsakai@pfu.co.jp
       Web site:
       http://www.seki.ee.kagu.sut.ac.jp/~sakai/myfreesoft/index.html
       Mirror site:
       http://hp.vector.co.jp/authors/VA014157/myfreesoft/index.html
       http://www.people.or.jp/~hsakai/myfreesoft/index.html
       If you want the newest xfireworks.conf, access these web pages.

SPECIAL THANKS

       Hashimoto Jun for many advices and test on Linux.
       Simosako Akira for test on Linux and many informations.
       Koga Kazuhiro for test on Linux.
       Umehara Taro for test on FreeBSD.
       Morimi Asuka for many advices.

COPYRIGHT

       XFireworks Copyright (c) 2000 SAKAI Hiroaki.
       All Rights Reserved.

       This program is free software; you can redistribute it and/or modify it
       under  the  terms of the GNU General Public License as published by the
       Free Software Foundation; either version 2, or  (at  your  option)  any
       later version.