git.hungrycats.org Git - xscreensaver/blob - 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 | \-no-fps
  66 Whether to show a frames-per-second display at the bottom of the screen.
  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