Provided by: xscreensaver-data-extra_5.08-0ubuntu3_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  cho-
                sen 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 (C) 1992 by Jamie Zawinski.  Permission to use, copy, modify,
        distribute,  and  sell this software and its documentation for any pur-
        pose 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  repre-
        sentations are made about the suitability of this software for any pur-
        pose.  It is provided "as is" without express or implied warranty.


        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