| 1 | .TH XScreenSaver 1 "13-aug-92" "X Version 11" |
|---|
| 2 | .SH NAME |
|---|
| 3 | rocks - animation of flying through an asteroid field |
|---|
| 4 | .SH SYNOPSIS |
|---|
| 5 | .B rocks |
|---|
| 6 | [\-display \fIhost:display.screen\fP] [\-foreground \fIcolor\fP] [\-background \fIcolor\fP] [\-window] [\-root] [\-mono] [\-ncolors \fIn\fP] [\-install] [\-visual \fIvisual\fP] [\-count \fIinteger\fP] [\-delay \fIusecs\fP] [\-speed \fIinteger\fP] [\-norotate] [\-nomove] [\-3d] |
|---|
| 7 | .SH DESCRIPTION |
|---|
| 8 | The \fIrocks\fP program draws an animation of an asteroid field moving past |
|---|
| 9 | the observer (or vice versa). Sometimes the observer picks up spin on Z axis. |
|---|
| 10 | .SH OPTIONS |
|---|
| 11 | .I rocks |
|---|
| 12 | accepts the following options: |
|---|
| 13 | .TP 8 |
|---|
| 14 | .B \-window |
|---|
| 15 | Draw on a newly-created window. This is the default. |
|---|
| 16 | .TP 8 |
|---|
| 17 | .B \-root |
|---|
| 18 | Draw on the root window. |
|---|
| 19 | .TP 8 |
|---|
| 20 | .B \-mono |
|---|
| 21 | Make all the rocks the same color. |
|---|
| 22 | .TP 8 |
|---|
| 23 | .B \-ncolors colors |
|---|
| 24 | How many different colors to use. Default 5. Colors are chosen randomly. |
|---|
| 25 | .TP 8 |
|---|
| 26 | .B \-install |
|---|
| 27 | Install a private colormap for the window. |
|---|
| 28 | .TP 8 |
|---|
| 29 | .B \-visual \fIvisual\fP |
|---|
| 30 | Specify which visual to use. Legal values are the name of a visual class, |
|---|
| 31 | or the id number (decimal or hex) of a specific visual. |
|---|
| 32 | .TP 8 |
|---|
| 33 | .B \-count \fIinteger\fP |
|---|
| 34 | Maximum number of rocks to draw on the screen at once. Default 100. |
|---|
| 35 | .TP 8 |
|---|
| 36 | .B \-speed \fIinteger\fP |
|---|
| 37 | A measure of the speed with which the observer and the rocks pass each other, |
|---|
| 38 | from 1 to 100. Default 100, meaning ``very fast.'' If you're on a slow |
|---|
| 39 | display connection (the animation looks jerky) then try making this number |
|---|
| 40 | smaller, and/or decreasing the number of rocks. |
|---|
| 41 | .TP 8 |
|---|
| 42 | .B \-delay \fImicroseconds\fP |
|---|
| 43 | Number of microseconds to delay between each frame. Default 50000, meaning |
|---|
| 44 | about 1/20th second. Compare and contrast with \fI\-speed\fP, above. |
|---|
| 45 | .TP 8 |
|---|
| 46 | .B \-norotate |
|---|
| 47 | Don't rotate the observer; just fly through the field on the level. |
|---|
| 48 | .TP 8 |
|---|
| 49 | .B \-nomove |
|---|
| 50 | Don't turn the observer; just fly straight ahead through the field. |
|---|
| 51 | .TP 8 |
|---|
| 52 | .B \-3d |
|---|
| 53 | Do red/blue 3d separations: if you look at the screen with 3d glasses, |
|---|
| 54 | the rocks will be \fIjumping\fP right \fIout\fP at you. Oooooh, scaaary! |
|---|
| 55 | .SH ENVIRONMENT |
|---|
| 56 | .PP |
|---|
| 57 | .TP 8 |
|---|
| 58 | .B DISPLAY |
|---|
| 59 | to get the default host and display number. |
|---|
| 60 | .TP 8 |
|---|
| 61 | .B XENVIRONMENT |
|---|
| 62 | to get the name of a resource file that overrides the global resources |
|---|
| 63 | stored in the RESOURCE_MANAGER property. |
|---|
| 64 | .SH SEE ALSO |
|---|
| 65 | .BR X (1), |
|---|
| 66 | .BR xscreensaver (1) |
|---|
| 67 | .SH BUGS |
|---|
| 68 | There should be an option to display doppler shift (a gravity rainbow.) |
|---|
| 69 | |
|---|
| 70 | Speed of rotation should be settable. |
|---|
| 71 | |
|---|
| 72 | Default speed of rotation should be relative to forward velocity. |
|---|
| 73 | .SH COPYRIGHT |
|---|
| 74 | Copyright \(co 1992 by Jamie Zawinski. Permission to use, copy, modify, |
|---|
| 75 | distribute, and sell this software and its documentation for any purpose is |
|---|
| 76 | hereby granted without fee, provided that the above copyright notice appear |
|---|
| 77 | in all copies and that both that copyright notice and this permission notice |
|---|
| 78 | appear in supporting documentation. No representations are made about the |
|---|
| 79 | suitability of this software for any purpose. It is provided "as is" without |
|---|
| 80 | express or implied warranty. |
|---|
| 81 | .SH AUTHOR |
|---|
| 82 | Based on Lisp Machine code copyright 1988 John Nguyen <johnn@hx.lcs.mit.edu>. |
|---|
| 83 | |
|---|
| 84 | Ported to C and X by Jamie Zawinski <jwz@jwz.org>, 13-aug-92. |
|---|
| 85 | |
|---|
| 86 | Steering code by Jeremie Petit; 3D code by theiling@coli.uni-sb.de. |
|---|
