From http://www.jwz.org/xscreensaver/xscreensaver-5.30.tar.gz
[xscreensaver] / hacks / fluidballs.man
1 .TH XScreenSaver 1 "" "X Version 11"
2 .SH NAME
3 fluidballs - the physics of bouncing balls.
4 .SH SYNOPSIS
5 .B fluidballs
6 [\-display \fIhost:display.screen\fP]
7 [\-visual \fIvisual\fP]
8 [\-window]
9 [\-root]
10 [\-count \fInumber\fP]
11 [\-size \fInumber\fP]
12 [\-gravity \fInumber\fP]
13 [\-wind \fInumber\fP]
14 [\-elasticity \fInumber\fP]
15 [\-delay \fInumber\fP]
16 [\-nonrandom]
17 [\-no-shake]
18 [\-fps]
19 .SH DESCRIPTION
20 Models the physics of bouncing balls, or of particles in a gas or fluid,
21 depending on the settings. If "Shake Box" is selected, then every now and
22 then, the box will be rotated, changing which direction is down (in order
23 to keep the settled balls in motion.) 
24 .SH OPTIONS
25 .TP 8
26 .B \-visual \fIvisual\fP
27 Specify which visual to use.  Legal values are the name of a visual class,
28 or the id number (decimal or hex) of a specific visual.
29 .TP 8
30 .B \-window
31 Draw on a newly-created window.  This is the default.
32 .TP 8
33 .B \-root
34 Draw on the root window.
35 .TP 8
36 .B \-count \fInumber\fP
37 How many balls to display.  Default: 300.
38 .TP 8
39 .B \-size \fInumber\fP
40 Maximum size of each ball.  Default: 25.
41 .TP 8
42 .B \-gravity \fInumber\fP
43 Coefficient of gravity.  Useful values are < 0.1.  Default: 0.01.
44 .TP 8
45 .B \-wind \fInumber\fP
46 Wind.  Useful values are < 0.1.  Default: 0.00.
47 .TP 8
48 .B \-elasticity \fInumber\fP
49 Coefficient of elasticity.  Useful values are 0.2 to 1.0.  Default: 0.97.
50 Lower numbers make less bouncy balls.
51 .TP 8
52 .B \-delay \fInumber\fP
53 Per-frame delay, in microseconds.  Default: 10000 (0.01 seconds.).
54 .TP 8
55 .B \-nonrandom
56 Make all balls be the same size.
57 .TP 8
58 .B \-no-nonrandom
59 Make the balls be random sizes.  Default.
60 .TP 8
61 .B \-shake | \-no-shake
62 Whether to shake the box if the system seems to have settled down.
63 "Shake" means "change the direction of Down."
64 .TP 8
65 .B \-fps
66 Display the current frame rate and CPU load.
67 .SH ENVIRONMENT
68 .PP
69 .TP 8
70 .B DISPLAY
71 to get the default host and display number.
72 .TP 8
73 .B XENVIRONMENT
74 to get the name of a resource file that overrides the global resources
75 stored in the RESOURCE_MANAGER property.
76 .SH SEE ALSO
77 .BR X (1),
78 .BR xscreensaver (1)
79 .SH COPYRIGHT
80 Copyright \(co 2002 by Peter Birtles and Jamie Zawinski.  Permission to
81 use, copy, modify, distribute, and sell this software and its
82 documentation for any purpose is hereby granted without fee, provided
83 that the above copyright notice appear in all copies and that both that
84 copyright notice and this permission notice appear in supporting
85 documentation.  No representations are made about the suitability of
86 this software for any purpose.  It is provided "as is" without express
87 or implied warranty.
88 .SH AUTHOR
89 Peter Birtles, Jamie Zawinski, and Steven Barker.
90