Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
XFIREWORKS(1)		    General Commands Manual		 XFIREWORKS(1)

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. (De-
	       fault)

       -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 prop-
	       erly or you want	to run XFireworks as a background pixmap,  try
	       this option.

       -probability, -probability-magnification	[number]

	       Magnification  of  probability of performing fireworks for per-
	       cent.  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, <XRoot>/lib/X11/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/XFire-
       works".	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	xfire-
       works.

       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	xfire-
       works.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.

X Version 11			   Release 6			 XFIREWORKS(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=xfireworks&sektion=1&manpath=FreeBSD+Ports+15.0>

home | help