Provided by: xscreensaver-data-extra_5.14-1ubuntu1_i386 bug

NAME

       rocks - animation of flying through an asteroid field

SYNOPSIS

       rocks  [-display  host:display.screen] [-foreground color] [-background
       color] [-window]  [-root]  [-mono]  [-ncolors  n]  [-install]  [-visual
       visual]  [-count  integer]  [-delay usecs] [-speed integer] [-norotate]
       [-nomove] [-3d] [-fps]

DESCRIPTION

       The rocks program draws an animation of an asteroid field  moving  past
       the  observer (or vice versa).  Sometimes the observer picks up spin on
       Z axis.

OPTIONS

       rocks accepts the following options:

       -window Draw on a newly-created window.  This is the default.

       -root   Draw on the root window.

       -mono   Make all the rocks the same color.

       -ncolors colors
               How many different colors  to  use.   Default  5.   Colors  are
               chosen randomly.

       -install
               Install a private colormap for the window.

       -visual visual
               Specify  which  visual  to use.  Legal values are the name of a
               visual class, or the id number (decimal or hex) of  a  specific
               visual.

       -count integer
               Maximum number of rocks to draw on the screen at once.  Default
               100.

       -speed integer
               A measure of the speed with which the observer  and  the  rocks
               pass  each  other,  from 1 to 100.  Default 100, meaning ``very
               fast.''  If you're on a slow display connection (the  animation
               looks  jerky)  then  try  making  this  number  smaller, and/or
               decreasing the number of rocks.

       -delay microseconds
               Number of microseconds to delay between  each  frame.   Default
               50000,  meaning about 1/20th second.  Compare and contrast with
               -speed, above.

       -norotate
               Don't rotate the observer; just fly through the  field  on  the
               level.

       -nomove Don't  turn  the  observer; just fly straight ahead through the
               field.

       -3d     Do red/blue 3d separations: if you look at the screen  with  3d
               glasses,  the  rocks will be jumping right out at you.  Oooooh,
               scaaary!

       -fps    Display the current frame rate and CPU load.

ENVIRONMENT

       DISPLAY to get the default host and display number.

       XENVIRONMENT
               to get the name of a resource file that  overrides  the  global
               resources stored in the RESOURCE_MANAGER property.

SEE ALSO

       X(1), xscreensaver(1)

BUGS

       There should be an option to display doppler shift (a gravity rainbow.)

       Speed of rotation should be settable.

       Default speed of rotation should be relative to forward velocity.

COPYRIGHT

       Copyright (C) 1992 by Jamie Zawinski.  Permission to use, copy, modify,
       distribute, and sell  this  software  and  its  documentation  for  any
       purpose  is  hereby  granted  without  fee,  provided  that  the  above
       copyright notice appear in all copies  and  that  both  that  copyright
       notice  and  this permission notice appear in supporting documentation.
       No representations are made about the suitability of this software  for
       any  purpose.   It  is  provided  "as  is"  without  express or implied
       warranty.

AUTHOR

       Based   on   Lisp   Machine   code   copyright   1988    John    Nguyen
       <johnn@hx.lcs.mit.edu>.

       Ported to C and X by Jamie Zawinski <jwz@jwz.org>, 13-aug-92.

       Steering code by Jeremie Petit; 3D code by theiling@coli.uni-sb.de.