1rocks(6x)                     XScreenSaver manual                    rocks(6x)
2
3
4

NAME

6       rocks - animation of flying through an asteroid field
7

SYNOPSIS

9       rocks  [--display  host:display.screen]  [--foreground  color] [--back‐
10       ground color] [--window] [--root] [--window-id number][--mono] [--ncol‐
11       ors  n] [--install] [--visual visual] [--count integer] [--delay usecs]
12       [--speed integer] [--norotate] [--nomove] [-3d] [--fps]
13

DESCRIPTION

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

OPTIONS

20       rocks accepts the following options:
21
22       --window
23               Draw on a newly-created window.  This is the default.
24
25       --root  Draw on the root window.
26
27       --window-id number
28               Draw on the specified window.
29
30       --mono  Make all the rocks the same color.
31
32       --ncolors colors
33               How many different colors to use.  Default 5.  Colors are  cho‐
34               sen randomly.
35
36       --install
37               Install a private colormap for the window.
38
39       --visual visual
40               Specify  which  visual  to use.  Legal values are the name of a
41               visual class, or the id number (decimal or hex) of  a  specific
42               visual.
43
44       --count integer
45               Maximum number of rocks to draw on the screen at once.  Default
46               100.
47
48       --speed integer
49               A measure of the speed with which the observer  and  the  rocks
50               pass  each  other,  from 1 to 100.  Default 100, meaning ``very
51               fast.''  If you're on a slow display connection (the  animation
52               looks  jerky)  then  try making this number smaller, and/or de‐
53               creasing the number of rocks.
54
55       --delay microseconds
56               Number of microseconds to delay between  each  frame.   Default
57               50000,  meaning about 1/20th second.  Compare and contrast with
58               --speed, above.
59
60       --norotate
61               Don't rotate the observer; just fly through the  field  on  the
62               level.
63
64       --nomove
65               Don't  turn  the  observer; just fly straight ahead through the
66               field.
67
68       -3d     Do red/blue 3d separations: if you look at the screen  with  3d
69               glasses,  the  rocks will be jumping right out at you.  Oooooh,
70               scaaary!
71
72       --fps   Display the current frame rate and CPU load.
73

ENVIRONMENT

75       DISPLAY to get the default host and display number.
76
77       XENVIRONMENT
78               to get the name of a resource file that  overrides  the  global
79               resources stored in the RESOURCE_MANAGER property.
80
81       XSCREENSAVER_WINDOW
82               The window ID to use with --root.
83

SEE ALSO

85       X(1), xscreensaver(1)
86

BUGS

88       There should be an option to display doppler shift (a gravity rainbow.)
89
90       Speed of rotation should be settable.
91
92       Default speed of rotation should be relative to forward velocity.
93
95       Copyright  ©  1992 by Jamie Zawinski.  Permission to use, copy, modify,
96       distribute, and sell this software and its documentation for  any  pur‐
97       pose  is  hereby granted without fee, provided that the above copyright
98       notice appear in all copies and that both  that  copyright  notice  and
99       this  permission  notice appear in supporting documentation.  No repre‐
100       sentations are made about the suitability of this software for any pur‐
101       pose.  It is provided "as is" without express or implied warranty.
102

AUTHOR

104       Based    on    Lisp   Machine   code   copyright   1988   John   Nguyen
105       <johnn@hx.lcs.mit.edu>.
106
107       Ported to C and X by Jamie Zawinski <jwz@jwz.org>, 13-aug-92.
108
109       Steering code by Jeremie Petit; 3D code by theiling@coli.uni-sb.de.
110
111
112
113X Version 11               6.08-1.fc39 (17-Oct-2023)                 rocks(6x)
Impressum