Provided by: xscreensaver-data-extra_5.15-2ubuntu1_i386 bug


       rocks - animation of flying through an asteroid field


       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]


       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.


       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 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

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

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

               Don't rotate the observer; just fly through the  field  on  the

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

       -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,

       -fps    Display the current frame rate and CPU load.


       DISPLAY to get the default host and display number.

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


       X(1), xscreensaver(1)


       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  ©  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


       Based   on   Lisp   Machine   code   copyright   1988    John    Nguyen

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

       Steering code by Jeremie Petit; 3D code by