http://packetstormsecurity.org/UNIX/admin/xscreensaver-3.29.tar.gz
[xscreensaver] / driver / XScreenSaver.ad.in
1 !
2 !                              XScreenSaver
3 !
4 !            a screen saver and locker for the X window system
5 !                            by Jamie Zawinski
6 !
7 !                              version 3.29
8 !                              13-Feb-2001
9 !
10 ! See "man xscreensaver" for more info.  The latest version is always
11 ! available at http://www.jwz.org/xscreensaver/
12
13
14 ! These resources, when placed in the system-wide app-defaults directory
15 ! (e.g., /usr/lib/X11/app-defaults/XScreenSaver) will provide the default
16 ! settings for new users.  However, if you have a ".xscreensaver" file in
17 ! your home directory, the settings in that file take precedence.
18
19
20 ! Don't hand this file to "xrdb" -- that isn't how app-defaults files work.
21 ! Though app-defaults files have (mostly) the same syntax as your ~/.Xdefaults
22 ! file, they are used differently, and if you run this file through xrdb,
23 ! you will probably mess things up.
24
25 #error Do not run app-defaults files through xrdb!
26 #error That does not do what you might expect.
27 #error Put this file in /usr/lib/X11/app-defaults/XScreenSaver instead.
28
29 ! /* (xrdb prevention kludge: whole file)
30
31 *timeout:               10
32 *cycle:                 10
33 *lockTimeout:           0
34 *passwdTimeout:         30
35 *nice:                  10
36 *lock:                  False
37 *lockVTs:               True
38 *verbose:               False
39 *timestamp:             False
40 *fade:                  True
41 *unfade:                False
42 *fadeSeconds:           3
43 *fadeTicks:             20
44 *splash:                True
45 *splashDuration:        5
46 *visualID:              default
47
48 *captureStderr:         True
49 *overlayTextForeground: #FFFF00
50 *overlayTextBackground: #000000
51 *overlayStderr:         True
52 *font:                  *-medium-r-*-140-*-m-*
53
54 ! The default is to use these extensions if available (as noted.)
55 *sgiSaverExtension:     True
56 *mitSaverExtension:     False
57 *xidleExtension:        True
58 *procInterrupts:        True
59
60 ! This is what the "Demo" button on the splash screen runs (/bin/sh syntax.)
61 *demoCommand: xscreensaver-demo
62
63 ! This is what the "Prefs" button on the splash screen runs (/bin/sh syntax.)
64 *prefsCommand: xscreensaver-demo -prefs
65
66 ! This is the URL that the "Help" button on the splash screen loads.
67 *helpURL: http://www.jwz.org/xscreensaver/man.html
68
69 ! This is how the "Help" button loads URLs (/bin/sh syntax.)
70 ! The "helpURL" will be substituted for up to two occurrences of "%s".
71 *loadURL: netscape -remote 'openURL(%s)' || netscape '%s'
72
73 ! This is what the "Manual" button in xscreensaver-demo runs (/bin/sh syntax.)
74 *manualCommand: xterm +sb -fg black -bg gray75 -T '%s manual' \
75         -e /bin/sh -c 'man "%s" || read foo'
76 ! Gnome folks might prefer this:
77 !*manualCommand: gnome-help-browser 'man:%s'
78
79
80 ! The format used for printing the date and time in the password dialog box
81 ! (see the strftime(3) manual page for details.)
82 *dateFormat:            %d-%b-%y (%a); %I:%M %p
83 ! To show the time only:
84 ! *dateFormat:          %I:%M %p
85 ! For 24 hour time:
86 ! *dateFormat:          %H:%M
87
88
89 ! Turning on "installColormap" interacts erratically with twm and tvtwm,
90 ! but seems to work fine with mwm and olwm.  Try it and see.  If your
91 ! screen turns some color other than black, the window manager is buggy,
92 ! and you need to set this resource to False (or get a WM that works.)
93 !
94 *installColormap:       True
95
96
97 ! Any program which can draw on the root window will work as a screensaver.
98 ! The following resource enumerates them.
99 !
100 ! Programs are separated by newlines (specified in resource files with \n).
101 ! Lines may be continued with a lone \ at the end of the line.
102 !
103 ! Each line is an `sh' command.
104 !
105 ! If the first (non-blank) character on the line is "-", then that means
106 ! that this command is disabled: it's still in the list, but it won't ever
107 ! be used.  (This is just to make it easy to disable and then re-enable 
108 ! them later.)
109 !
110 ! If the first word on the line is the name of a visual followed by a
111 ! colon, then that visual will be used for the program, if it is available.
112 ! If no such visual is available, then the program will be skipped.  In
113 ! this way, you can specify that you want certain programs to run only
114 ! on color screens, and others only on mono screens, by making use of the
115 ! magic visual names "color" and "mono".  Likewise, if some hacks prefer
116 ! colormaps, but others prefer 24-bit windows, that also can be arranged
117 ! (in this case, by using "PseudoColor:" versus "TrueColor:".)
118 !
119 ! Some of the screenhacks are written using OpenGL.  OpenGL programs are
120 ! a bit different than normal X programs, in that they prefer visuals that
121 ! are *half* as deep as the screen.  You can tell xscreensaver to select a
122 ! good visual for a GL program by using the magic visual name "GL".
123 !
124 ! All programs must be launched in such a way that they draw on the root
125 ! window; they should not be spawned in the background with "&".  If shell
126 ! metacharacters are used, they must be understandable to `sh', not `csh'
127 ! (the $SHELL variable is not consulted, for unfortunate but good reasons.)
128 !
129 ! Be sure to check out Demo Mode: run the `xscreensaver-demo' program to
130 ! edit the current list of programs interactively, try out the various modes,
131 ! and change other parameters.  See the man page for details.
132 !
133 *programs:                                                                    \
134                  "Qix (solid)"  qix -root -solid -delay 0 -segments 100     \n\
135            "Qix (transparent)"  qix -root -count 4 -solid -transparent      \n\
136                 "Qix (linear)"  qix -root -count 5 -solid -transparent        \
137                                   -linear -segments 250 -size 100           \n\
138 - mono:            "Qix (xor)"  qix -root -linear -count 5 -size 200          \
139                                   -spread 30 -segments 75 -solid -xor       \n\
140                                                                               \
141           "Attraction (balls)"  attraction -root -mode balls                \n\
142           "Attraction (lines)"  attraction -root -mode lines -points 3        \
143                                   -segments 200                             \n\
144 -          "Attraction (poly)"  attraction -root -mode polygons             \n\
145         "Attraction (splines)"  attraction -root -mode splines -segments      \
146                                   300                                       \n\
147         "Attraction (orbital)"  attraction -root -mode lines -radius 300      \
148                                   -orbit -vmult 0.5                         \n\
149                                                                               \
150                                 pyro -root                                  \n\
151                                 rocks -root                                 \n\
152                                 helix -root                                 \n\
153                                 pedal -root                                 \n\
154                                 rorschach -root -offset 7                   \n\
155                                 hopalong -root                              \n\
156                                 greynetic -root                             \n\
157                                 imsmap -root                                \n\
158                                 slidescreen -root                           \n\
159                                 decayscreen -root                           \n\
160                                 jigsaw -root                                \n\
161                                 blitspin -root -grab                        \n\
162                                 slip -root                                  \n\
163                                 distort -root                               \n\
164                                 spotlight -root                             \n\
165               "Ripples (oily)"  ripples -root -oily -light 2                \n\
166               "Ripples (stir)"  ripples -root -oily -light 2 -stir          \n\
167            "Ripples (desktop)"  ripples -root -water -light 6               \n\
168                                 hypercube -root                             \n\
169                                 hyperball -root                             \n\
170                                 halo -root                                  \n\
171                                 maze -root                                  \n\
172                                 noseguy -root                               \n\
173                                 flame -root                                 \n\
174                                 lmorph -root                                \n\
175                                 deco -root                                  \n\
176                                 moire -root                                 \n\
177                                 moire2 -root                                \n\
178                                 lightning -root                             \n\
179                                 strange -root                               \n\
180                                 spiral -root                                \n\
181                                 laser -root                                 \n\
182                                 grav -root                                  \n\
183                "Grav (trails)"  grav -root -trail -decay                    \n\
184                                 drift -root                                 \n\
185                                 ifs -root                                   \n\
186                                 julia -root                                 \n\
187                                 penrose -root                               \n\
188                                 sierpinski -root                            \n\
189                                 braid -root                                 \n\
190                                 galaxy -root                                \n\
191                                 bouboule -root                              \n\
192                                 swirl -root                                 \n\
193                                 flag -root                                  \n\
194                                 sphere -root                                \n\
195                                 forest -root                                \n\
196                                 lisa -root                                  \n\
197                                 lissie -root                                \n\
198                                 goop -root -max-velocity 0.5 -elasticity      \
199                                   0.9                                       \n\
200                                 starfish -root                              \n\
201              "Starfish (blob)"  starfish -root -blob                        \n\
202                                 munch -root                                 \n\
203                                 fadeplot -root                              \n\
204                                 coral -root -delay 0                        \n\
205                                 mountain -root                              \n\
206                                 triangle -root -delay 1                     \n\
207                                 worm -root                                  \n\
208                                 rotor -root                                 \n\
209                                 ant -root                                   \n\
210                                 demon -root                                 \n\
211                                 loop -root                                  \n\
212                                 vines -root                                 \n\
213                                 kaleidescope -root                          \n\
214                                 xjack -root                                 \n\
215                                 xlyap -root -randomize                      \n\
216                                 cynosure -root                              \n\
217                                 flow -root                                  \n\
218                                 epicycle -root                              \n\
219                                 interference -root                          \n\
220                                 truchet -root -randomize                    \n\
221                                 bsod -root                                  \n\
222                                 crystal -root                               \n\
223                                 discrete -root                              \n\
224                                 kumppa -root                                \n\
225                                 rd-bomb -root                               \n\
226             "RD-Bomb (mobile)"  rd-bomb -root -speed 1 -size 0.1            \n\
227                                 sonar -root                                 \n\
228                                 t3d -root                                   \n\
229                                 penetrate -root                             \n\
230                                 deluxe -root                                \n\
231                                 compass -root                               \n\
232                                 squiral -root                               \n\
233                                 xflame -root                                \n\
234                                 wander -root                                \n\
235               "Wander (spots)"  wander -root -advance 0 -size 10 -circles     \
236                                   True -length 10000 -reset 100000          \n\
237                                 critical -root                              \n\
238                                 phosphor -root                              \n\
239                                 xmatrix -root                               \n\
240                                 petri -root -size 2 -count 20               \n\
241                      "Petri 2"  petri -root -minlifespeed 0.02                \
242                                   -maxlifespeed 0.03 -minlifespan 1           \
243                                   -maxlifespan 1 -instantdeathchan 0          \
244                                   -minorchan 0 -anychan 0.3                 \n\
245                                 shadebobs -root                             \n\
246                                 ccurve -root                                \n\
247                                 blaster -root                               \n\
248                                 bumps -root                                 \n\
249                                 xteevee -root                               \n\
250                                 xspirograph -root                           \n\
251                                 nerverot -root                              \n\
252 -           "NerveRot (dense)"  nerverot -root -count 1000                  \n\
253 -           "NerveRot (thick)"  nerverot -root -count 100 -line-width 4       \
254                                 -max-nerve-radius 0.8 -nervousness 0.5 -db  \n\
255                                 xrayswarm -root                             \n\
256 -              "Zoom (Fatbits)" zoom -root                                  \n\
257                "Zoom (Lenses)"  zoom -root -lenses                          \n\
258                                 whirlwindwarp -root                         \n\
259   color:                        bubbles -root                               \n\
260   default-n:                    webcollage -root                            \n\
261   default-n:  "WebCollage (whacked)"                                          \
262                                 webcollage -root -filter                      \
263                                   'vidwhacker -stdin -stdout'               \n\
264 - default-n:                    vidwhacker -root                            \n\
265                                                                               \
266 @GL_KLUDGE@ GL:                 gears -root                                 \n\
267 @GL_KLUDGE@ GL: "Gears (planetary)" gears -root -planetary                  \n\
268 @GL_KLUDGE@ GL:                 superquadrics -root                         \n\
269 @GL_KLUDGE@ GL:                 morph3d -root                               \n\
270 @GL_KLUDGE@ GL:                 cage -root                                  \n\
271 @GL_KLUDGE@ GL:                 moebius -root                               \n\
272 @GL_KLUDGE@ GL:                 stairs -root                                \n\
273 @GL_KLUDGE@ GL:                 pipes -root                                 \n\
274 @GL_KLUDGE@ GL:                 sproingies -root                            \n\
275 @GL_KLUDGE@ GL:                 rubik -root                                 \n\
276 @GL_KLUDGE@ GL:                 atlantis -root                              \n\
277 @GL_KLUDGE@ GL:                 lament -root                                \n\
278 @GL_KLUDGE@ GL:                 bubble3d -root                              \n\
279 @GL_KLUDGE@ GL:                 glplanet -root                              \n\
280 @GL_KLUDGE@ GL:                 pulsar -root                                \n\
281 -          GL:     "Pulsar (textures)"                                        \
282                                   pulsar -root -texture -mipmap               \
283                                   -texture_quality -light -fog              \n\
284 @GLE_KLUDGE@GL:                 extrusion -root                             \n\
285 @GL_KLUDGE@ GL:                 sierpinski3d -root                          \n\
286 @GL_KLUDGE@ GL:                 gflux -root                                 \n\
287 @GL_KLUDGE@ GL:                 stonerview -root                            \n\
288 @GL_KLUDGE@ GL:                 starwars -root                              \n\
289 @GL_KLUDGE@ GL:                 gltext -root                                \n\
290                                                                               \
291 -                               xdaliclock -root -builtin3 -cycle           \n\
292 - default-n:                    xearth -nofork -nostars -ncolors 50           \
293                                   -night 3 -wait 0 -timewarp 400.0 -pos       \
294                                   sunrel/38/-30                             \n\
295 -                               ssystem -fullscreen :32                     \n\
296 -                               xmountains -b -M -Z 0 -r 1                  \n\
297 -       "XMountains (top)"      xmountains -b -M -Z 0 -r 1 -m               \n\
298 -                               xaos -root -autopilot -incoloring -1          \
299                                   -nogui -outcoloring -1                    \n\
300 -                               xfishtank -d -s                             \n\
301 -                               xsnow                                       \n\
302 -                               goban -root                                 \n\
303 -                               electricsheep                               \n\
304 -                               cosmos -root                                \n
305
306
307 ! To display a randomized slideshow of images, you can do something like this:
308 !
309 !    default-n:  "Slideshow"    xv -root -rmode 5 -random -viewonly           \
310 !                                 -wloop -wait 30 $HOME/bitmaps/*.jpg       \n\
311 !
312 ! or, if you prefer "xli" to "xv", like this: (but note that xli's "-delay"
313 ! option doesn't work in conjunction with "-onroot", so you need to add a
314 ! line for each image individually... "xv" is better in this respect.)
315 !
316 !    default-n: xli -quiet -onroot -center -border black                      \
317 !                 $HOME/bitmaps/pic1.jpg                                    \n\
318 !    default-n: xli -quiet -onroot -center -border black                      \
319 !                 $HOME/bitmaps/pic2.jpg                                    \n\
320 !    default-n: xli -quiet -onroot -center -border black                      \
321 !                 $HOME/bitmaps/pic3.jpg                                    \n\
322 !
323 ! Note that we've used "default-n" as the visual name, rather than just
324 ! "default": this means "default visual, no install", that is, it's like
325 ! specifying the command-line arguments "-visual default -no-install".
326 ! This is necessary because, when XV or XLI arerunning in "-root" mode, they
327 ! always assume that the default visual and colormap are being used, rather
328 ! than  examining the window it is drawing on to see what visual and colormap
329 ! it has.  If we didn't force the default visual to be used, we would get an
330 ! X error.  If we didn't force the default colormap to be installed, the
331 ! colors would be all wrong.  "default-i" may also be used as a visual name
332 ! (meaning, "-visual default -install") but you probably won't ever need
333 ! to use that.
334 !
335 !
336 ! Some of the GL demos that SGI ships work with XScreenSaver; most don't.
337 ! XScreenSaver includes a program (not built or installed by default)
338 ! called "xscreensaver-sgigl".  To use the SGI demos with XScreenSaver,
339 ! build that program, and use it to launch the SGI demos.  For example,
340 ! on Irix 6.2, you can do this:
341 !
342 !     xscreensaver-sgigl /usr/demos/bin/ep -S
343 !     xscreensaver-sgigl /usr/demos/bin/bongo
344 !
345 ! On Irix 6.3, things have moved, so you need to do it like this:
346 !
347 !     xscreensaver-sgigl /usr/sbin/ep -S
348 !
349 ! (But note that, on non-SGIs, the bundled "stonerview" hack is a decent
350 ! clone of "ep".  Yay!)
351 !
352 ! You can also use the "ant" demo, but first you need to wrap a shell script
353 ! around it that cds to its home directory, so that it can find its files;
354 ! and also pass it the -S argument, to prevent it from forking.  What a mess!
355 ! Basically, the SGI demo writers went out of their way to make my life hell.
356
357
358
359 !=============================================================================
360 !
361 !      You probably don't want to change anything after this point.
362 !
363 !=============================================================================
364
365
366 XScreenSaver.pointerPollTime:           5
367 XScreenSaver.initialDelay:              0
368 XScreenSaver.windowCreationTimeout:     30
369 XScreenSaver.bourneShell:               /bin/sh
370
371
372 ! Resources for the password and splash-screen dialog boxes of
373 ! the "xscreensaver" daemon.
374 !
375 *Dialog.headingFont:            *-times-bold-r-*-*-*-180-*-*-*-iso8859-1
376 *Dialog.bodyFont:               *-helvetica-bold-r-*-*-*-140-*-*-*-iso8859-1
377 *Dialog.labelFont:              *-helvetica-bold-r-*-*-*-140-*-*-*-iso8859-1
378 *Dialog.buttonFont:             *-helvetica-bold-r-*-*-*-140-*-*-*-iso8859-1
379 *Dialog.dateFont:               *-courier-medium-r-*-*-*-80-*-*-*-iso8859-1
380 *Dialog.foreground:             #000000
381 *Dialog.background:             #BFBFBF
382 *Dialog.Button.foreground:      #000000
383 *Dialog.Button.background:      #D0D0D0
384 *Dialog.text.foreground:        #000000
385 *Dialog.text.background:        #FFFFFF
386 *passwd.thermometer.foreground: #FF0000
387 *passwd.thermometer.background: #FFFFFF
388 *Dialog.topShadowColor:         #E7E7E7
389 *Dialog.bottomShadowColor:      #737373
390 *Dialog.logo.width:             210
391 *Dialog.logo.height:            210
392 *Dialog.internalBorderWidth:    30
393 *Dialog.borderWidth:            1
394 *Dialog.shadowThickness:        4
395
396 *passwd.heading.label:          XScreenSaver %s
397 *passwd.body.label:             This display is locked.
398 *passwd.user.label:             User:
399 *passwd.passwd.label:           Password:
400 *passwd.passwdFont:             *-courier-medium-r-*-*-*-140-*-*-*-iso8859-1
401 *passwd.thermometer.width:      8
402
403 *splash.heading.label:          XScreenSaver %s
404 *splash.body.label:             Copyright Â© 1991-2001 by
405 *splash.body2.label:            Jamie Zawinski <jwz@jwz.org>
406 *splash.demo.label:             Demo
407 *splash.prefs.label:            Prefs
408 *splash.help.label:             Help
409
410
411 ! Resources for the Motif dialog boxes of the "xscreensaver-demo" program.
412
413 *fontList:                       *-helvetica-medium-r-*-*-*-120-*-*-*-iso8859-1
414 *demoDialog*label1.fontList:     *-helvetica-medium-r-*-*-*-140-*-*-*-iso8859-1
415 *cmdText.fontList:                 *-courier-medium-r-*-*-*-120-*-*-*-iso8859-1
416 *label0.fontList:                  *-helvetica-bold-r-*-*-*-140-*-*-*-iso8859-1
417 XScreenSaver*doc.fontList:       *-helvetica-medium-r-*-*-*-100-*-*-*-iso8859-1
418 ! above must be fully qualified to get around *sgiMode.
419
420 *foreground:                    #000000
421 *background:                    #C0C0C0
422 *XmTextField.foreground:        #000000
423 *XmTextField.background:        #FFFFFF
424 *list.foreground:               #000000
425 *list.background:               #FFFFFF
426
427 *ApplicationShell.title:        XScreenSaver
428 *warning.title:                 XScreenSaver
429 *warning_popup.title:           XScreenSaver
430 *allowShellResize:              True
431 *autoUnmanage:                  False
432
433 *menubar*file.labelString:      File
434 *menubar*file.mnemonic:         F
435 *file.blank.labelString:        Blank Screen Now
436 *file.blank.mnemonic:           B
437 *file.lock.labelString:         Lock Screen Now
438 *file.lock.mnemonic:            L
439 *file.kill.labelString:         Kill Daemon
440 *file.kill.mnemonic:            K
441 *file.restart.labelString:      Restart Daemon
442 *file.restart.mnemonic:         R
443 *file.exit.labelString:         Exit
444 *file.exit.mnemonic:            E
445
446 *menubar*edit.labelString:      Edit
447 *menubar*edit.mnemonic:         E
448 *edit.cut.labelString:          Cut
449 *edit.cut.mnemonic:             u
450 *edit.copy.labelString:         Copy
451 *edit.copy.mnemonic:            C
452 *edit.paste.labelString:        Paste
453 *edit.paste.mnemonic:           P
454
455 *menubar*help.labelString:      Help
456 *menubar*help.mnemonic:         H
457 *help.about.labelString:        About...
458 *help.about.mnemonic:           A
459 *help.docMenu.labelString:      Documentation...
460 *help.docMenu.mnemonic:         D
461
462 *demoTab.marginWidth:           10
463 *optionsTab.marginWidth:        10
464
465 *XmScrolledWindow.topOffset:    10
466 *XmScrolledWindow.leftOffset:   10
467 *demoTab.topOffset:             4
468 *form1.bottomOffset:            10
469 *form3.leftOffset:              10
470 *form3.rightOffset:             10
471 *frame.topOffset:               10
472 *frame.bottomOffset:            10
473 *enabled.topOffset:             10
474 *visLabel.topOffset:            10
475 *combo.topOffset:               10
476 *form4.bottomOffset:            4
477 *hr.bottomOffset:               4
478 *XmComboBox.marginWidth:        0
479 *XmComboBox.marginHeight:       0
480
481 *demo.marginWidth:              30
482 *demo.marginHeight:             4
483 *man.marginWidth:               10
484 *man.marginHeight:              4
485 *down.leftOffset:               40
486 *down.marginWidth:              4
487 *down.marginHeight:             4
488 *up.marginWidth:                4
489 *up.marginHeight:               4
490 *frame.traversalOn:             False
491
492 *list.automaticSelection:       True
493 *list.visibleItemCount:         20
494 *doc.columns:                   60
495 *combo.columns:                 11
496
497 *demoTab.labelString:           Graphics Demos
498 *optionsTab.labelString:        Screensaver Options
499 *down.labelString:              \\/ 
500 *up.labelString:                /\\ 
501 *frameLabel.labelString:        
502 *cmdLabel.labelString:          Command Line:
503 *cmdLabel.alignment:            ALIGNMENT_BEGINNING
504 *enabled.labelString:           Enabled
505 *visLabel.labelString:          Visual:
506 *visLabel.alignment:            ALIGNMENT_END
507 *visLabel.leftOffset:           20
508 *demo.labelString:              Demo
509 *man.labelString:               Documentation...
510 *done.labelString:              Quit
511
512 *preferencesLabel.labelString:  XScreenSaver Parameters
513
514 *timeoutLabel.labelString:      Saver Timeout
515 *cycleLabel.labelString:        Cycle Timeout
516 *fadeSecondsLabel.labelString:  Fade Duration
517 *fadeTicksLabel.labelString:    Fade Ticks
518 *lockLabel.labelString:         Lock Timeout
519 *passwdLabel.labelString:       Password Timeout
520 *preferencesForm*XmTextField.columns:   8
521
522 *verboseToggle.labelString:     Verbose
523 *cmapToggle.labelString:        Install Colormap
524 *fadeToggle.labelString:        Fade Colormap
525 *unfadeToggle.labelString:      Unfade Colormap
526 *lockToggle.labelString:        Require Password
527
528
529 *OK.marginWidth:                30
530 *OK.marginHeight:               4
531 *OK.leftOffset:                 10
532 *OK.bottomOffset:               10
533 *Cancel.marginWidth:            30
534 *Cancel.marginHeight:           4
535 *Cancel.rightOffset:            10
536 *Cancel.bottomOffset:           10
537
538
539
540
541 !=============================================================================
542 !
543 ! Online documentation for xscreensaver-demo.
544 !
545 !=============================================================================
546
547 ! sanity check -- hands off.
548 *hacks.documentation.isInstalled: True
549
550 *hacks.qix.documentation:                                               \
551 This is the swiss army chainsaw of qix programs.  It bounces a series   \
552 of line segments around the screen, and uses variations on this basic   \
553 motion pattern to produce all sorts of different presentations: line    \
554 segments, filled polygons, overlapping translucent areas...  Written    \
555 by Jamie Zawinski.
556
557 *hacks.attraction.documentation:                                        \
558 Like qix, this uses a simple simple motion model to generate many       \
559 different display modes.  The control points attract each other up to   \
560 a certain distance, and then begin to repel each other.  The            \
561 attraction/repulsion is proportional to the distance between any two    \
562 particles, similar to the strong and weak nuclear forces.               \
563                                                                     \n\n\
564 One of the most interesting ways to watch this hack is simply as        \
565 bouncing balls, because their motions and interactions with each        \
566 other are so odd.  Sometimes two balls will get into a tight orbit      \
567 around each other, to be interrupted later by a third, or by the edge   \
568 of the screen.  It looks quite chaotic.                                 \
569                                                                     \n\n\
570 Written by Jamie Zawinski, based on Lisp code by John Pezaris.
571
572 *hacks.pyro.documentation:                                              \
573 Pyro draws exploding fireworks.  Blah blah blah.  Written by Jamie      \
574 Zawinski.
575
576 *hacks.helix.documentation:                                             \
577 This repeatedly generates spirally string-art-ish patterns.  Written    \
578 by Jamie Zawinski.
579
580 *hacks.pedal.documentation:                                             \
581 This is sort of a combination spirograph/string-art.  It generates a    \
582 large, complex polygon, and lets the X server do the bulk of the work   \
583 by giving it an even/odd winding rule.  Written by Dale Moore, based    \
584 on some ancient PDP-11 code.
585
586 *hacks.rorschach.documentation:                                         \
587 This generates random inkblot patterns.  The algorithm is deceptively   \
588 simple for how well it works; it merely walks a dot around the screen   \
589 randomly, and then reflects the image horizontally, vertically, or      \
590 both.  Any deep-seated neurotic tendencies which this program reveals   \
591 are your own problem.  Written by Jamie Zawinski.
592
593 *hacks.hopalong.documentation:                                          \
594 This draws lacy fractal patterns, based on iteration in the imaginary   \
595 plane, from a 1986 Scientific American article.  Mostly written by      \
596 Patrick Naughton.
597
598 *hacks.greynetic.documentation:                                         \
599 This draws random colored and stippled rectangles.  Written by Jamie    \
600 Zawinski.
601
602 *hacks.imsmap.name: IMSmap
603 *hacks.imsmap.documentation:                                            \
604 This generates random cloud-like patterns.  It looks quite different    \
605 in monochrome and color.  The basic idea is to take four points on      \
606 the edge of the image, and assign each a random ``elevation''.  Then    \
607 find the point between them, and give it a value which is the average   \
608 of the other four, plus some small random offset. Then coloration is    \
609 done based on elevation.                                                \
610                                                                     \n\n\
611 The color selection is done by binding the elevation to either hue,     \
612 saturation, or brightness, and assigning random values to the others.   \
613 The ``brightness'' mode tends to yield cloudlike patterns, and the      \
614 others tend to generate images that look like heat-maps or CAT-scans.   \
615 Written by Juergen Nickelsen and Jamie Zawinski.
616
617 *hacks.slidescreen.name: SlideScreen
618 *hacks.slidescreen.documentation:                                       \
619 This grabs an image of whatever is on your screen, divides it into a    \
620 grid, and then randomly shuffles the squares around as if it was one    \
621 of those annoying ``16-puzzle'' games, where there is a grid of         \
622 squares, one of which is missing.  I hate trying to solve those         \
623 puzzles, but watching one permute itself is more amusing.  Written by   \
624 Jamie Zawinski.
625
626 *hacks.decayscreen.name: DecayScreen
627 *hacks.decayscreen.documentation:                                       \
628 This grabs an image of whatever is on your screen, and makes it melt.   \
629 You've no doubt seen this effect before, but no screensaver would       \
630 really be complete without it.  It works best if there's something      \
631 colorful visible.  Warning, if the effect continues after the screen    \
632 saver is off, seek medical attention.  Written by David Wald and        \
633 Vivek Khera.                                                            \
634                                                                     \n\n\
635 A number of these screenhacks have the ability to take an image of      \
636 your desktop and manipulate it in some way.  On SGI systems, these      \
637 programs are able to (at random) pull their source image from the       \
638 system's video input instead!  This works nicely if you leave some      \
639 some random television station plugged in.
640
641 *hacks.jigsaw.documentation:                                            \
642 This grabs a screen image, carves it up into a jigsaw puzzle,           \
643 shuffles it, and then solves the puzzle.  This works especially well    \
644 when you feed it an external video signal instead of letting it grab    \
645 the screen image (actually, I guess this is generally true...)  When    \
646 it is grabbing a video image, it is sometimes pretty hard to guess      \
647 what the image is going to look like once the puzzle is solved.         \
648 Written by Jamie Zawinski.
649
650 *hacks.blitspin.name: BlitSpin
651 *hacks.blitspin.documentation:                                          \
652 The ``blitspin'' hack repeatedly rotates a bitmap by 90 degrees by      \
653 using logical operations: the bitmap is divided into quadrants, and     \
654 the quadrants are shifted clockwise.  Then the same thing is done       \
655 again with progressively smaller quadrants, except that all             \
656 sub-quadrants of a given size are rotated in parallel.  Written by      \
657 Jamie Zawinski based on some cool SmallTalk code seen in in Byte        \
658 Magazine in 1981.                                                       \
659                                                                     \n\n\
660 As you watch it, the image appears to dissolve into static and then     \
661 reconstitute itself, but rotated. You can provide the image to use,     \
662 as an XBM or XPM file, or tell it to grab a screen image and rotate     \
663 that.
664
665 *hacks.slip.documentation:                                              \
666 This program throws some random bits on the screen, then sucks them     \
667 through a jet engine and spews them out the other side.  To avoid       \
668 turning the image completely to mush, every now and then it will and    \
669 then it interjects some splashes of color into the scene, or go into    \
670 a spin cycle, or stretch the image like taffy, or (this is my           \
671 addition) grab an image of your current desktop to chew on.             \
672 Originally written by Scott Draves; whacked on by Jamie Zawinski.
673
674 *hacks.distort.documentation:                                           \
675 This hack grabs an image of the screen, and then lets a transparent     \
676 lens wander around the screen, magnifying whatever is underneath.       \
677 Written by Jonas Munsin.
678
679 *hacks.spotlight.documentation:                                         \
680 Draws a spotlight scanning across a black screen, illumnating the       \
681 underlying desktop when it passes.  Written by Rick Schultz.
682
683 *hacks.hypercube.documentation:                                         \
684 This displays 2D projections of the sequence of 3D objects which are    \
685 the projections of the 4D analog to the cube: as a square is composed   \
686 of four lines, each touching two others; and a cube is composed of      \
687 six squares, each touching four others; a hypercube is composed of      \
688 eight cubes, each touching six others.  To make it easier to            \
689 visualize the rotation, it uses a different color for the edges of      \
690 each face.  Don't think about it too long, or your brain will melt.     \
691 Written by Joe Keane, Fritz Mueller, and Jamie Zawinski.
692
693 *hacks.hyperball.documentation:                                         \
694 Hyperball is to hypercube as dodecahedron is to cube: this displays     \
695 a 2D projection of the sequence of 3D objects which are the projections \
696 of the 4D analog to the dodecahedron.  Written by Joe Keane.
697
698 *hacks.halo.documentation:                                              \
699 This draws trippy psychedelic circular patterns that hurt to look at.   \
700 It can also animate the control-points, but that takes a lot of CPU     \
701 and bandwidth.  Written by Jamie Zawinski.
702
703 *hacks.maze.documentation:                                              \
704 This is the ancient X maze demo, modified to work with xscreensaver.    \
705 It generates a random maze, then solves it with visual feedback.        \
706 Originally by Jim Randell; modified by a cast of thousands.
707
708 *hacks.noseguy.documentation:                                           \
709 A little man with a big nose wanders around your screen saying          \
710 things.  The things which he says can come from a file, or from an      \
711 external program like `zippy' or `fortune'.  This was extracted from    \
712 `xnlock' by Dan Heller.  Colorized by Jamie Zawinski.
713
714 *hacks.flame.documentation:                                             \
715 Another iterative fractal generator.  Written by Scott Draves.
716
717 *hacks.lmorph.name: LMorph
718 *hacks.lmorph.documentation:                                            \
719 This generates random spline-ish line drawings and morphs between       \
720 them.  Written by Sverre H.  Huseby and Glenn T.  Lines.
721
722 *hacks.deco.documentation:                                              \
723 This one subdivides and colors rectangles randomly.  It looks kind of   \
724 like Brady-Bunch-era rec-room wall paneling.  (Raven says: ``this       \
725 screensaver is ugly enough to peel paint.'')  Written by Jamie          \
726 Zawinski, inspired by Java code by Michael Bayne.
727
728 *hacks.moire.documentation:                                             \
729 This one draws cool circular interference patterns.  Most of the        \
730 circles you see aren't explicitly rendered, but show up as a result     \
731 of interactions between the other pixels that were drawn.  Written by   \
732 Jamie Zawinski, inspired by Java code by Michael Bayne.  As he          \
733 pointed out, the beauty of this one is that the heart of the display    \
734 algorithm can be expressed with just a pair of loops and a handful of   \
735 arithmetic, giving it a high ``display hack metric''.
736
737 *hacks.moire2.documentation:                                            \
738 Another example of the fun you can have with moire                      \
739 interference patterns; this hack generates fields of concentric         \
740 circles or ovals, and combines the planes with various operations.      \
741 The planes are moving independently of one another, causing the         \
742 interference lines to ``spray.''  Written by Jamie Zawinski.
743
744 *hacks.lightning.documentation:                                         \
745 This one draws crackling fractal lightning bolts.  It's simple,         \
746 direct, and to the point.  If only it had sound... Written by Keith     \
747 Romberg.
748
749 *hacks.strange.documentation:                                           \
750 This draws strange attractors: it's a colorful,                         \
751 unpredictably-animating field of dots that swoops and twists around.    \
752 The motion is very nice.  Written by Massimino Pascal.
753
754 *hacks.spiral.documentation:                                            \
755 Moving circular patterns, by Peter Schmitzberger.  Moving circular      \
756 patterns means moire; interference patterns, of course.
757
758 *hacks.laser.documentation:                                             \
759 Moving radiating lines, that look vaguely like scanning laser beams.    \
760 Written by Pascal Pensa.  (Frankie say: relax.)
761
762 *hacks.grav.documentation:                                              \
763 This program draws a simple orbital simulation.  If you turn on         \
764 trails, it looks kind of like a cloud-chamber photograph.  Written      \
765 by Greg Bowering.
766
767 *hacks.drift.documentation:                                             \
768 How could one possibly describe this except as ``drifting recursive     \
769 fractal cosmic flames?''  Another fine hack from the Scott Draves       \
770 collection of fine hacks.
771
772 *hacks.ifs.name: IFS
773 *hacks.ifs.documentation:                                               \
774 This one draws spinning, colliding iterated-function-system images.     \
775 Written by Massimino Pascal.
776
777 *hacks.julia.documentation:                                             \
778 This one draws spinning, animating (are you detecting a pattern here    \
779 yet?)  explorations of the Julia set. You've probably seen static       \
780 images of this fractal form before, but it's a lot of fun to watch in   \
781 motion as well.  One interesting thing is that there is a small         \
782 swinging dot passing in front of the image, which indicates the         \
783 control point from which the rest of the image was generated.           \
784 Written by Sean McCullough.
785
786 *hacks.penrose.documentation:                                           \
787 Draws quasiperiodic tilings; think of the implications on modern        \
788 formica technology.  Written by Timo Korvola.                           \
789                                                                     \n\n\
790 In April 1997, Sir Roger Penrose, a British math professor who has      \
791 worked with Stephen Hawking on such topics as relativity, black         \
792 holes, and whether time has a beginning, filed a                        \
793 copyright-infringement lawsuit against the Kimberly-Clark               \
794 Corporation, which Penrose said copied a pattern he created (a          \
795 pattern demonstrating that ``a nonrepeating pattern could exist in      \
796 nature'') for its Kleenex quilted toilet paper. Penrose said he         \
797 doesn't like litigation but, ``When it comes to the population of       \
798 Great Britain being invited by a multinational to wipe their bottoms    \
799 on what appears to be the work of a Knight of the Realm, then a last    \
800 stand must be taken.''                                                  \
801                                                                     \n\n\
802 As reported by News of the Weird #491, 4-jul-1997.
803
804 *hacks.sierpinski.documentation:                                        \
805 This draws the two-dimensional variant of the recursive Sierpinski      \
806 triangle fractal.  Written by Desmond Daignault.
807
808 *hacks.braid.documentation:                                             \
809 Draws random color-cycling inter-braided concentric circles.  Written   \
810 by John Neil.
811
812 *hacks.galaxy.documentation:                                            \
813 This draws spinning galaxies, which then collide and scatter their      \
814 stars to the, uh, four winds or something.  Originally an Amiga         \
815 program by Uli Siegmund.
816
817 *hacks.bouboule.documentation:                                          \
818 This draws what looks like a spinning, deforming baloon with            \
819 varying-sized spots painted on its invisible surface.  Written by       \
820 Jeremie Petit.
821
822 *hacks.swirl.documentation:                                             \
823 More flowing, swirly patterns. This version is by M.  Dobie and R.      \
824 Taylor, but you might have seen a Mac program similar to this called    \
825 FlowFazer.  There is also a cool Java applet of a similar concept
826
827 *hacks.flag.documentation:                                              \
828 This draws a waving colored flag, that undulates its way around the     \
829 screen.  The trick is the flag can contain arbitrary text and images.   \
830 By default, it displays either the current system name and OS           \
831 type, or a picture of ``Bob,'' but you can replace the text or the      \
832 image with a command-line option.  Written by Charles Vidal and Jamie   \
833 Zawinski.
834
835 *hacks.sphere.documentation:                                            \
836 Another of the classic screenhacks of the distant past, this one        \
837 draws shaded spheres in multiple colors.  This hack traces its          \
838 lineage back to Tom Duff in 1982.
839
840 *hacks.forest.documentation:                                            \
841 This draws fractal trees.  Written by Peter Baumung.  Everybody loves   \
842 fractals, right?
843
844 *hacks.lisa.documentation:                                              \
845 This draws Lisajous loops, by Caleb Cullen.  Remember that device       \
846 they had the Phantom Zone prisoners in during their trial in            \
847 Superman?  I think that was one of these.
848
849 *hacks.lissie.documentation:                                            \
850 Another Lissajous figure.  This one draws the progress of circular      \
851 shapes along a path.  Written by Alexander Jolk.
852
853 *hacks.goop.documentation:                                              \
854 This draws set of animating, transparent, amoeba-like blobs.  The       \
855 blobs change shape as they wander around the screen, and they are       \
856 translucent, so you can see the lower blobs through the higher ones,    \
857 and when one passes over another, their colors merge.  Written by       \
858 Jamie Zawinski.  I got the idea for this from a cool mouse pad I        \
859 have, which achieves the same kind of effect in real life by having     \
860 several layers plastic with colored oil between them.  Written by       \
861 Jamie Zawinski.
862
863 *hacks.starfish.documentation:                                          \
864 This generates a sequence of undulating, throbbing, star-like           \
865 patterns which pulsate, rotate, and turn inside out.  Another display   \
866 mode uses these shapes to lay down a field of colors, which are then    \
867 cycled.  The motion is very organic.  Written by Jamie Zawinski.
868
869 *hacks.munch.documentation:                                           \n\
870         DATAI 2                                                       \n\
871         ADDB 1,2                                                      \n\
872         ROTC 2,-22                                                    \n\
873         XOR 1,2                                                       \n\
874         JRST .-4                                                      \n\
875                                                                       \n\
876 As reported by HAKMEM, in 1962, Jackson Wright wrote the above PDP-1    \
877 code. That code still lives on in this screenhack, some 35 years        \
878 later.  The number of lines of enclosing code has increased             \
879 substantially, however.  This version is by Tim Showalter.
880
881 *hacks.fadeplot.name: FadePlot
882 *hacks.fadeplot.documentation:                                          \
883 Draws what looks like a waving ribbon following a sinusoidal path.      \
884 Written by Bas van Gaalen and Charles Vidal.
885
886 *hacks.coral.documentation:                                             \
887 Simulates coral growth, albeit somewhat slowly.  This image doesn't     \
888 really do it justice.  Written by Frederick Roeber.
889
890 *hacks.mountain.documentation:                                          \
891 Generates random 3d plots that look vaguely mountainous.  Written by    \
892 Pascal Pensa.
893
894 *hacks.triangle.documentation:                                          \
895 Generates random mountain ranges using iterative subdivision of         \
896 triangles.  Written by Tobias Gloth.
897
898 *hacks.worm.documentation:                                              \
899 An ancient xlock hack that draws multicolored worms that crawl around   \
900 the screen.  Written by Brad Taylor, Dave Lemke, Boris Putanec, and     \
901 Henrik Theiling.
902
903 *hacks.rotor.documentation:                                             \
904 Another ancient xlock demo, this one by Tom Lawrence.  It draws a       \
905 line segment moving along a complex spiraling curve.  I tweaked this    \
906 to generate curvier lines, but still frames of it don't look like       \
907 much.
908
909 *hacks.ant.documentation:                                               \
910 A cellular automaton that is really a two-dimensional Turing machine:   \
911 as the heads (``ants'') walk along the screen, they change pixel        \
912 values in their path.  Then, as they pass over changed pixels, their    \
913 behavior is influenced.  Written by David Bagley.
914
915 *hacks.demon.documentation:                                             \
916 A cellular automaton that starts with a random field, and organizes     \
917 it into stripes and spirals.  Written by David Bagley.
918
919 *hacks.loop.documentation:                                              \
920 This one produces loop-shaped colonies that spawn, age, and             \
921 eventually die.  Written by David Bagley.
922
923 *hacks.vines.documentation:                                             \
924 This one generates a continuous sequence of small, curvy geometric      \
925 patterns.  It scatters them around your screen until it fills up,       \
926 then it clears the screen and starts over.  Written by Tracy Camp and   \
927 David Hansen.
928
929 *hacks.kaleidescope.documentation:                                      \
930 Another clone of an ancient meme, consisting largely of frenetic        \
931 rotational motion of colored lines.  This one is by Ron Tapia.  The     \
932 motion is nice, but I think it needs more solids, or perhaps just       \
933 brighter colors.  More variations in the rotational speed might help,   \
934 too.
935
936 *hacks.xjack.documentation:                                             \
937 This program behaves schizophrenically and makes a lot of typos.        \
938 Written by Jamie Zawinski.  If you haven't seen Stanley Kubrick's       \
939 masterpiece, ``The Shining,'' you won't get it.  Those who have         \
940 describe this hack as ``inspired.''
941
942 *hacks.xlyap.documentation:                                             \
943 This generates pretty fractal pictures by doing funky math involving    \
944 the ``Lyapunov exponent.''  It has a cool interactive mode, too.        \
945 Written by Ron Record.
946
947 *hacks.cynosure.documentation:                                          \
948 A hack similar to `greynetic', but less frenetic.  The first            \
949 implementation was by Stephen Linhart; then Ozymandias G. Desiderata    \
950 wrote a Java applet clone.  That clone was discovered by Jamie          \
951 Zawinski, and ported to C for inclusion here.
952
953 *hacks.flow.documentation:                                              \
954 Another series of strange attractors: a flowing series of points,       \
955 making strange rotational shapes.  Written by Jeff Butterworth.
956
957 *hacks.epicycle.documentation:                                          \
958 This program draws the path traced out by a point on the edge of a      \
959 circle.  That circle rotates around a point on the rim of another       \
960 circle, and so on, several times. These were the basis for the          \
961 pre-heliocentric model of planetary motion.  Written by James           \
962 Youngman.
963
964 *hacks.interference.documentation:                                      \
965 Another color-field hack, this one works by computing decaying          \
966 sinusoidal waves, and allowing them to interfere with each other as     \
967 their origins move.  Written by Hannu Mallat.
968
969 *hacks.truchet.documentation:                                           \
970 This draws line- and arc-based Truchet patterns that tile the screen.   \
971 Written by Adrian Likins.
972
973 *hacks.bsod.name: BSOD
974 *hacks.bsod.documentation:                                              \
975 BSOD stands for ``Blue Screen of Death.''  The finest in personal       \
976 computer emulation, this hack simulates popular screen savers from a    \
977 number of less robust operating systems.  Written by Jamie Zawinski.
978
979 *hacks.crystal.documentation:                                           \
980 Moving polygons, similar to a kaleidescope (more like a kaleidescope    \
981 than the hack called `kaleid,' actually.) This one by Jouk Jansen.
982
983 *hacks.discrete.documentation:                                          \
984 More ``discrete map'' systems, including new variants of Hopalong and   \
985 Julia, and a few others.  Written by Tim Auckland.
986
987 *hacks.kumppa.documentation:                                            \
988 Spiraling, spinning, and very, very fast splashes of color rush         \
989 toward the screen.  Written by Teemu Suutari.
990
991 *hacks.rd-bomb.name: RD-Bomb
992 *hacks.rd-bomb.documentation:                                           \
993 Another variation of the `Bomb' program by Scott Draves.  This draws    \
994 a grid of growing square-like shapes that, once they overtake each      \
995 other, react in unpredictable ways.  ``RD'' stands for                  \
996 reaction-diffusion.
997
998 *hacks.sonar.documentation:                                             \
999 This program draws a simulation of a sonar screen.  Written by          \
1000 default, it displays a random assortment of ``bogies'' on the screen,   \
1001 but if compiled properly, it can ping (pun intended) your local         \
1002 network, and actually plot the proximity of the other hosts on your     \
1003 network to you.  It would be easy to make it monitor other sources of   \
1004 data, too.  (Processes?  Active network connections?  CPU usage per     \
1005 user?)  Written by Stephen Martin.
1006
1007 *hacks.t3d.name: T3D
1008 *hacks.t3d.documentation:                                               \
1009 This draws a working analog clock composed of floating, throbbing       \
1010 bubbles.  Written by Bernd Paysan.
1011
1012 *hacks.penetrate.documentation:                                         \
1013 This hack simulates the classic arcade game Missile Command.  Written   \
1014 by Adam Miller.
1015
1016 *hacks.deluxe.documentation:                                            \
1017 This draws a pulsing sequence of stars, circles, and lines.  It would   \
1018 look better if it was faster, but as far as I can tell, there is no     \
1019 way to make this be both: fast, and flicker-free.  Yet another reason   \
1020 X sucks.  Written by Jamie Zawinski.
1021
1022 *hacks.compass.documentation:                                           \
1023 This draws a compass, with all elements spinning about randomly, for    \
1024 that ``lost and nauseous'' feeling. Written by Jamie Zawinski.
1025
1026 *hacks.squiral.documentation:                                           \
1027 Draws a set of interacting, square-spiral-producing automata.  The      \
1028 spirals grow outward until they hit something, then they go around      \
1029 it.  Written by Jeff Epler.
1030
1031 *hacks.xflame.documentation:                                            \
1032 Draws a simulation of pulsing fire.  It can also take an arbitrary      \
1033 image and set it on fire too.  Written by Carsten Haitzler, hacked on   \
1034 by many others.
1035
1036 *hacks.wander.documentation:                                            \
1037 Draws a colorful random-walk, in various forms.  Written by Rick        \
1038 Campbell.
1039
1040 *hacks.critical.documentation:                                          \
1041 Draws a system of self-organizing lines.  It starts out as random       \
1042 squiggles, but after a few iterations, order begins to appear.          \
1043 Written by Martin Pool.
1044
1045 *hacks.phosphor.documentation:                                          \
1046 Draws a simulation of an old terminal, with large pixels and            \
1047 long-sustain phosphor. It can run any program as a source of the text   \
1048 it displays.  Written by Jamie Zawinski.
1049
1050 *hacks.xmatrix.documentation:                                           \
1051 A rendition of the text scrolls seen in the movie ``The Matrix.''       \
1052 Written by Jamie Zawinski.
1053
1054 *hacks.petri.documentation:                                             \
1055 This simulates colonies of mold growing in a petri dish.  Growing       \
1056 colored circles overlap and leave spiral interference in their wake.    \
1057 Written by Dan Bornstein.
1058
1059 *hacks.shadebobs.name: ShadeBobs
1060 *hacks.shadebobs.documentation:                                         \
1061 This draws smoothly-shaded oscilating oval patterns, that look          \
1062 something like vapor trails or neon tubes.  Written by Shane Smit.
1063
1064 *hacks.ccurve.name: C Curve
1065 *hacks.ccurve.documentation:                                            \
1066 Generates self-similar linear fractals, including the classic ``C       \
1067 Curve.''  Written by Rick Campbell.
1068
1069 *hacks.blaster.documentation:                                           \
1070 Draws a simulation of flying space-combat robots (cleverly disguised    \
1071 as colored circles) doing battle in front of a moving star field.       \
1072 Written by Jonathan Lin.
1073
1074 *hacks.bumps.documentation:                                             \
1075 A bit like `Spotlight', except that instead of merely exposing part     \
1076 of your desktop, it creates a bump map from it.  Basically, it          \
1077 3D-izes a roaming section of your desktop, based on color intensity.    \
1078 Written by Shane Smit.
1079
1080 *hacks.xteevee.name: XTeeVee
1081 *hacks.xteevee.documentation:                                           \
1082 XTeeVee simulates various television problems, including static,        \
1083 loss of vertical hold, and a test pattern.  By Greg Knauss.
1084
1085 *hacks.xspirograph.name: XSpiroGraph
1086 *hacks.xspirograph.documentation:                                       \
1087 Simulates that pen-in-nested-plastic-gears toy from your childhood.     \
1088 By Rohit Singh.
1089
1090 *hacks.nerverot.name: NerveRot
1091 *hacks.nerverot.documentation:                                          \
1092 Draws different shapes composed of nervously vibrating squiggles,       \
1093 as if seen through a camera operated by a monkey on crack.              \
1094 By Dan Bornstein.
1095
1096 *hacks.webcollage.name: WebCollage
1097 *hacks.webcollage.documentation:                                        \
1098 This program makes collages out of random images pulled off of the      \
1099 World Wide Web.  It finds these images by doing random web searches,    \
1100 and then extracting images from the returned pages.  It can also be     \
1101 set up to filter the images through the `VidWhacker' program, above,    \
1102 which looks really great.                                               \
1103                                                                     \n\n\
1104 (Note that most of the images it finds are text, and not pictures.      \
1105 This is because most of the web is pictures of text.  Which is pretty   \
1106 sad.)  Written by Jamie Zawinski.
1107
1108 *hacks.vidwhacker.name: VidWhacker
1109 *hacks.vidwhacker.documentation:                                        \
1110 This is actually just a shell script that grabs a frame of video from   \
1111 the system's video input, and then uses some PBM filters (chosen at     \
1112 random) to manipulate and recombine the video frame in various ways     \
1113 (edge detection, subtracting the image from a rotated version of        \
1114 itself, etc.)  Then it displays that image for a few seconds, and       \
1115 does it again.  This works really well if you just feed broadcast       \
1116 television into it.                                                     \
1117                                                                     \n\n\
1118 Currently, the three lines of the script that actually grab the         \
1119 source picture are SGI specific, but it should be trivial to adapt it   \
1120 to work on other systems that can grab video (please send me the        \
1121 changes if you do this...)
1122
1123 *hacks.rocks.documentation:                                             \
1124 This draws an animation of flight through an asteroid field, with       \
1125 changes in rotation and direction.  It can also display 3D              \
1126 separations for red/blue glasses!  Mostly written by Jamie Zawinski.
1127
1128 *hacks.bubbles.documentation:                                           \
1129 This simulates the kind of bubble formation that happens when water     \
1130 boils:small bubbles appear, and as they get closer to each other,       \
1131 they combine to form larger bubbles, which eventually pop.  Written     \
1132 by James Macnicol.
1133
1134 *hacks.gears.documentation:                                             \
1135 This draws sets of turning, interlocking gears, rotating in three       \
1136 dimensions.  Another GL hack, by Danny Sung, Brian Paul, Ed Mackey,     \
1137 and Jamie Zawinski.
1138
1139 *hacks.superquadrics.documentation:                                     \
1140 Ed Mackey reports that he wrote the first version of this program in    \
1141 BASIC on a Commodore 64 in 1987, as a 320x200 black and white           \
1142 wireframe.  Now it is GL and has specular reflections.
1143
1144 *hacks.morph3d.name: Morph3D
1145 *hacks.morph3d.documentation:                                           \
1146 Another 3d shape-changing GL hack, by Marcelo Vianna.  It has the       \
1147 same shiny-plastic feel as Superquadrics, as many computer-generated    \
1148 objects do...
1149
1150 *hacks.cage.documentation:                                              \
1151 This draws Escher's ``Impossible Cage,'' a 3d analog of a moebius       \
1152 strip, and rotates it in three dimensions.  Written by Marcelo          \
1153 Vianna.
1154
1155 *hacks.moebius.documentation:                                           \
1156 Another M.  C.  Escher hack by Marcelo Vianna, this one draws           \
1157 ``Moebius Strip II,'' a GL image of ants walking along the surface of   \
1158 a moebius strip.
1159
1160 *hacks.stairs.documentation:                                            \
1161 by Marcelo Vianna's third Escher GL hack, this one draws an             \
1162 ``infinite'' staircase.
1163
1164 *hacks.pipes.documentation:                                             \
1165 If you've ever been in the same room with a Windows NT machine,         \
1166 you've probably seen this GL hack.  This version is by Marcelo          \
1167 Vianna.
1168
1169 *hacks.sproingies.documentation:                                        \
1170 Q-Bert meets Marble Madness!  Written by Ed Mackey.
1171
1172 *hacks.rubik.documentation:                                             \
1173 Draws a Rubik's Cube that rotates in three dimensions and repeatedly    \
1174 shuffles and solves itself.  Another fine GL hack by Marcelo Vianna.
1175
1176 *hacks.atlantis.documentation:                                          \
1177 This is xfishtank writ large: a GL animation of a number of sharks,     \
1178 dolphins, and whales.  The swimming motions are great. Originally       \
1179 written by Mark Kilgard.
1180
1181 *hacks.lament.documentation:                                            \
1182 Animates a simulation of Lemarchand's Box, repeatedly solving itself.   \
1183 Requires OpenGL, and a machine with fast hardware support for texture   \
1184 maps.  Warning: occasionally opens doors.  Written by Jamie Zawinski.
1185
1186 *hacks.bubble3d.name: Bubble3D
1187 *hacks.bubble3d.documentation:                                          \
1188 Draws a stream of rising, undulating 3D bubbles, rising toward the      \
1189 top of the screen, with nice specular reflections. Written by Richard   \
1190 Jones.
1191
1192 *hacks.glplanet.name: GLPlanet
1193 *hacks.glplanet.documentation:                                          \
1194 Draws a planet bouncing around in space.  Written by David Konerding.   \
1195 The built-in image is a map of the earth (extracted from `xearth'),     \
1196 but you can wrap any texture around the sphere, e.g., the planetary     \
1197 textures that come with `ssystem'.
1198
1199 *hacks.pulsar.documentation:                                            \
1200 Draws some intersecting planes, making use of alpha blending, fog,      \
1201 textures, and mipmaps, plus a ``frames per second'' meter so that you   \
1202 can tell how fast your graphics card is...  Requires OpenGL.  Written   \
1203 by David Konerding.
1204
1205 *hacks.extrusion.documentation:                                         \
1206 Draws various rotating extruded shapes that twist around, lengthen,     \
1207 and turn inside out.  Created by David Konerding from the samples       \
1208 that come with the GL Extrusion library by Linas Vepstas.
1209
1210 *hacks.sierpinski3d.name: Sierpinski3D
1211 *hacks.sierpinski3d.documentation:                                      \
1212 This draws the three-dimensional variant of the recursive Sierpinski    \
1213 triangle fractal, using GL.  Written by Tim Robinson and Jamie Zawinski.
1214
1215 *hacks.ripples.documentation:                                           \
1216 This draws rippling interference patterns like splashing water.         \
1217 With the -water option, it manipulates your desktop image to look       \
1218 like something is dripping into it.  Written by Tom Hammersley.
1219
1220 *hacks.gflux.name: GFlux
1221 *hacks.gflux.documentation:                                             \
1222 Draws a rippling waves on a rotating wireframe grid, using GL.          \
1223 Written by Josiah Pease.
1224
1225 *hacks.xrayswarm.name: XRaySwarm
1226 *hacks.xrayswarm.documentation:                                         \
1227 Draws a few swarms of critters flying around the screen, with nicely    \
1228 faded color trails behind them.  Written by Chris Leger.
1229
1230 *hacks.zoom.documentation:                                              \
1231 Zooms in on a part of the screen and then moves around.  With the       \
1232 -lenses option the result is like looking through many overlapping      \
1233 lenses rather than just a simple zoom.  Written by James Macnicol.
1234
1235 *hacks.whirlwindwarp.name: WhirlwindWarp
1236 *hacks.whirlwindwarp.documentation:                                  \
1237 Floating stars are acted upon by a mixture of simple 2D              \
1238 forcefields.  The strength of each forcefield changes                \
1239 continuously, and it is also switched on and off at random.          \
1240 By Paul 'Joey' Clark.
1241
1242 *hacks.stonerview.name: StonerView
1243 *hacks.stonerview.documentation:                                     \
1244 Chains of colorful squares dance around each other in complex spiral \
1245 patterns.  Written by Andrew Plotkin, based on SGI's `electropaint'  \
1246 screensaver.
1247
1248 *hacks.starwars.name: StarWars
1249 *hacks.starwars.documentation:                                       \
1250 Draws a stream of text slowly scrolling into the distance at an      \
1251 angle, over a star field, like at the beginning of the movie of the  \
1252 same name.  Written by Jamie Zawinski and Claudio Matauoka.
1253
1254 *hacks.gltext.name: GLText
1255 *hacks.gltext.documentation:                                         \
1256 Displays a few lines of text spinning around in a solid 3D font.     \
1257 Written by Jamie Zawinski.
1258
1259
1260 !=============================================================================
1261 !
1262 ! Documentation for some programs that are not bundled with XScreenSaver
1263 !
1264 !=============================================================================
1265
1266 *hacks.xdaliclock.name: XDaliClock
1267 *hacks.xdaliclock.documentation:                                        \
1268 XDaliClock draws a large digital clock, the numbers of which change by  \
1269 ``melting'' into their new shapes.  Written by Jamie Zawinski.  This    \
1270 is not included with the XScreenSaver package, but if you don't have    \
1271 it already, you can find it at <http://www.jwz.org/xdaliclock/>.
1272
1273 *hacks.xearth.documentation:                                            \
1274 XEarth draws an image of the Earth, as seen from your favorite vantage  \
1275 point in space, correctly shaded for the current position of the Sun.   \
1276 Written by Kirk Johnson.  This is not included with the XScreenSaver    \
1277 package, but if you don't have it already, you can find it at           \
1278 <http://www.cs.colorado.edu/~tuna/xearth/>.
1279
1280 *hacks.ssystem.name: SSystem
1281 *hacks.ssystem.documentation:                                           \
1282 SSystem is a GL Solar System simulator.  It simulates flybys of Sun,    \
1283 the nine planets and a few major satellites, with four camera modes.    \
1284 Written by Raul Alonso.  This is not included with the XScreenSaver     \
1285 package, but if you don't have it already, you can find it at           \
1286 <http://www1.las.es/~amil/ssystem/>.
1287
1288 *hacks.xmountains.documentation:                                        \
1289 XMountains generates realistic-looking fractal terrains of snow-capped  \
1290 mountains near water, with either a top view or a side view.            \
1291 Written by Stephen Booth.  This is not included with the XScreenSaver   \
1292 package, but if you don't have it already, you can find it at           \
1293 <http://www.epcc.ed.ac.uk/~spb/xmountains/>.                            \
1294                                                                     \n\n\
1295 Be sure to compile it with -DVROOT or it won't work right when launched \
1296 by the xscreensaver daemon.
1297
1298 *hacks.xaos.name: XaoS
1299 *hacks.xaos.documentation:                                              \
1300 XaoS generates fast fly-through animations of the Mandelbrot and other  \
1301 fractal sets.  Written by Thomas Marsh and Jan Hubicka.    This is not  \
1302 included with the XScreenSaver package, but if you don't have it        \
1303 already, you can find it at <http://limax.paru.cas.cz/~hubicka/XaoS/>.
1304
1305 *hacks.xfishtank.name: XFishTank
1306 *hacks.xfishtank.documentation:                                         \
1307 Fish!  This is not included with the XScreenSaver package, but if you   \
1308 don't have it already, you can find it at                               \
1309 <http://metalab.unc.edu/pub/Linux/X11/demos/>.
1310
1311 *hacks.xsnow.documentation:                                             \
1312 Draws falling snow and the occasional tiny Santa.  By Rick Jansen.      \
1313 You can find it at <http://www.euronet.nl/~rja/Xsnow/>.
1314
1315 *hacks.goban.documentation:                                             \
1316 Replays historical games of go (aka wei-chi and baduk) on the screen.   \
1317 By Scott Draves.  You can find it at <http://www.draves.org/goban/>.
1318
1319 *hacks.electricsheep.name: ElectricSheep
1320 *hacks.electricsheep.documentation:                                     \
1321 ElectricSheep is an xscreensaver module that displays mpeg video of     \
1322 an animated fractal flame.  In the background, it contributes render    \
1323 cycles to the next animation.  Periodically it uploades completed       \
1324 frames to the server, where they are compressed for distribution to     \
1325 all clients.                                                            \
1326                                                                     \n\n\
1327 This program is recommended only if you have a high bandwidth           \
1328 connection to the Internet.                                             \
1329                                                                     \n\n\
1330 By Scott Draves.  You can find it at <http://www.electricsheep.org/>.   \
1331 See that web site for configuration information.
1332
1333 *hacks.cosmos.documentation:                                            \
1334 Draws fireworks and zooming, fading flares.  By Tom Campbell.           \
1335 You can find it at <http://www.mindspring.com/~campbell/cosmos/>.
1336
1337 ! (xrdb prevention kludge: whole file) */