dwww Home | Manual pages | Find package

rocks(6x)                     XScreenSaver manual                    rocks(6x)

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  vis-
       ual]  [-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  cho-
               sen 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 de-
               creasing 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  ©  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.

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.

X Version 11                  5.45 (08-Dec-2020)                     rocks(6x)

Generated by dwww version 1.14 on Fri Jan 24 09:41:21 CET 2025.