From: Zygo Blaxell Date: Fri, 27 Feb 2009 21:43:46 +0000 (-0500) Subject: ftp://ftp.sunet.se/pub/vendor/sco/skunkware/osr5/x11/savers/xscreensaver/xscreensaver... X-Git-Url: http://git.hungrycats.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=3d56d5d02d64c01dca5e0d755aa63e1e06f0a1cd;p=xscreensaver ftp://ftp.sunet.se/pub/vendor/sco/skunkware/osr5/x11/savers/xscreensaver/xscreensaver-3.15-dist.tar.gz -rw-r--r-- 1 zblaxell zblaxell 2851086 Feb 27 16:43 xscreensaver-3.15-dist.tar.gz 9154ee3f0f70ba8e83ef29c136c07f453d505574 xscreensaver-3.15-dist.tar.gz --- 3d56d5d02d64c01dca5e0d755aa63e1e06f0a1cd diff --git a/lib/X11/app-defaults/XScreenSaver b/lib/X11/app-defaults/XScreenSaver new file mode 100644 index 00000000..976ef172 --- /dev/null +++ b/lib/X11/app-defaults/XScreenSaver @@ -0,0 +1,520 @@ +! +! XScreenSaver +! +! a screen saver and locker for the X window system +! by Jamie Zawinski +! +! version 3.15 +! 20-Jun-99 +! +! See "man xscreensaver" for more info. The latest version is always +! available at http://www.jwz.org/xscreensaver/ + + +! These resources, when placed in the system-wide app-defaults directory +! (e.g., /usr/lib/X11/app-defaults/XScreenSaver) will provide the default +! settings for new users. However, if you have a ".xscreensaver" file in +! your home directory, the settings in that file take precedence. + + +*timeout: 10 +*cycle: 10 +*lockTimeout: 0 +*passwdTimeout: 30 +*nice: 10 +*lock: True +*lockVTs: True +*verbose: False +*timestamp: False +*fade: True +*unfade: False +*fadeSeconds: 3 +*fadeTicks: 20 +*splash: True +*splashDuration: 5 +*visualID: default + +*captureStderr: True +*overlayTextForeground: #FFFF00 +*overlayTextBackground: #000000 +*overlayStderr: True +*font: *-medium-r-*-140-*-m-* + +! The default is to use these extensions if available (as noted.) +*sgiSaverExtension: True +*mitSaverExtension: False +*xidleExtension: True +*procInterrupts: True + +! This is what the "Demo" button on the splash screen runs (/bin/sh syntax.) +*demoCommand: xscreensaver-demo + +! This is what the "Prefs" button on the splash screen runs (/bin/sh syntax.) +*prefsCommand: xscreensaver-demo -prefs + +! This is the URL that the "Help" button on the splash screen loads. +*helpURL: http://www.jwz.org/xscreensaver/man.html + +! This is how the "Help" button loads URLs (/bin/sh syntax.) +! The "helpURL" will be substituted for up to two occurrences of "%s". +*loadURL: netscape -remote 'openURL(%s)' || netscape '%s' + + +! Turning on "installColormap" interacts erratically with twm and tvtwm, +! but seems to work fine with mwm and olwm. Try it and see. If your +! screen turns some color other than black, the window manager is buggy, +! and you need to set this resource to False (or get a WM that works.) +! +*installColormap: True + + +! Any program which can draw on the root window will work as a screensaver. +! The following resource enumerates them. +! +! Programs are separated by newlines (specified in resource files with \n). +! Lines may be continued with a lone \ at the end of the line. +! +! Each line is an `sh' command. +! +! If the first (non-blank) character on the line is "-", then that means +! that this command is disabled: it's still in the list, but it won't ever +! be used. (This is just to make it easy to disable and then re-enable +! them later.) +! +! If the first word on the line is the name of a visual followed by a +! colon, then that visual will be used for the program, if it is available. +! If no such visual is available, then the program will be skipped. In +! this way, you can specify that you want certain programs to run only +! on color screens, and others only on mono screens, by making use of the +! magic visual names "color" and "mono". Likewise, if some hacks prefer +! colormaps, but others prefer 24-bit windows, that also can be arranged +! (in this case, by using "PseudoColor:" versus "TrueColor:".) +! +! Some of the screenhacks are written using OpenGL. OpenGL programs are +! a bit different than normal X programs, in that they prefer visuals that +! are *half* as deep as the screen. You can tell xscreensaver to select a +! good visual for a GL program by using the magic visual name "GL". +! +! All programs must be launched in such a way that they draw on the root +! window; they should not be spawned in the background with "&". If shell +! metacharacters are used, they must be understandable to `sh', not `csh' +! (the $SHELL variable is not consulted, for unfortunate but good reasons.) +! +! Be sure to check out Demo Mode: run the `xscreensaver-demo' program to +! edit the current list of programs interactively, try out the various modes, +! and change other parameters. See the man page for details. +! +*programs: qix -root -solid -delay 0 -segments 100 \n\ + qix -root -count 4 -solid -transparent \n\ + qix -root -count 5 -solid -transparent -linear \ + -segments 250 -size 100 \n\ + attraction -root -mode balls \n\ + attraction -root -mode lines -points 3 -segments 200 \n\ + attraction -root -mode splines -segments 300 \n\ + attraction -root -mode lines -radius 300 \ + -orbit -vmult 0.5 \n\ + pyro -root \n\ + helix -root \n\ + pedal -root \n\ + rorschach -root -offset 7 \n\ + hopalong -root \n\ + greynetic -root \n\ + xroger -root \n\ + imsmap -root \n\ + slidescreen -root \n\ + decayscreen -root \n\ + jigsaw -root \n\ + blitspin -root -grab \n\ + slip -root \n\ + distort -root \n\ + spotlight -root \n\ + hypercube -root \n\ + halo -root \n\ + maze -root \n\ + noseguy -root \n\ + flame -root \n\ + lmorph -root \n\ + deco -root \n\ + moire -root \n\ + moire2 -root \n\ + lightning -root \n\ + strange -root \n\ + spiral -root \n\ + laser -root \n\ + grav -root \n\ + grav -root -trail -decay \n\ + drift -root \n\ + ifs -root \n\ + xjulia -root \n\ + penrose -root \n\ + sierpinski -root \n\ + braid -root \n\ + galaxy -root \n\ + bouboule -root \n\ + swirl -root \n\ + flag -root \n\ + sphere -root \n\ + forest -root \n\ + lisa -root \n\ + lissie -root \n\ + goop -root \n\ + starfish -root \n\ + starfish -root -blob \n\ + munch -root \n\ + fadeplot -root \n\ + xcoral -root \n\ + mountain -root \n\ + triangle -root \n\ + worm -root \n\ + rotor -root \n\ + ant -root \n\ + demon -root \n\ + loop -root \n\ + vines -root \n\ + kaleidescope -root \n\ + xjack -root \n\ + - xlyap -root -randomize \n\ + cynosure -root \n\ + flow -root \n\ + epicycle -root \n\ + interference -root \n\ + truchet -root -randomize \n\ + bsod -root \n\ + crystal -root \n\ + discrete -root \n\ + kumppa -root \n\ + rd-bomb -root \n\ + rd-bomb -root -speed 1 -size 0.1 \n\ + sonar -root \n\ + t3d -root \n\ + penetrate -root \n\ + deluxe -root \n\ + compass -root \n\ + squiral -root \n\ + xflame -root \n\ + wander -root \n\ + wander -root -advance 0 -size 10 -circles True \ + -length 10000 -reset 100000 \n\ + critical -root \n\ + phosphor -root \n\ + xmatrix -root \n\ + petri -root -size 1 -count 20 \n\ + petri -root -minlifespeed 0.02 -maxlifespeed 0.03 \ + -minlifespan 1 -maxlifespan 1 -instantdeathchan 0 \ + -minorchan 0 -anychan 0.3 \n\ + shadebobs -root \n\ + default-n: webcollage -root \n\ + - default-n webcollage -root -filter 'vidwhacker -stdin -stdout' \n\ + - default-n vidwhacker -root \n\ + \ + mono: rocks -root \n\ + color: rocks -root -fg darksalmon \n\ + \ + mono: qix -root -linear -count 5 -size 200 -spread 30 \ + -segments 75 -solid -xor \n\ + \ + color: attraction -root -mode polygons \n\ + color: attraction -root -mode filled-splines -segments 0 \n\ + color: attraction -root -glow -points 10 \n\ + color: bubbles -root \n\ + \ + GL: gears -root \n\ + GL: superquadrics -root \n\ + GL: morph3d -root \n\ + GL: cage -root \n\ + GL: moebius -root \n\ + GL: stairs -root \n\ + GL: pipes -root \n\ + GL: sproingies -root \n\ + GL: rubik -root \n\ + GL: atlantis -root \n\ + GL: lament -root \n\ + GL: bubble3d -root \n\ + GL: glplanet -root \n\ + GL: pulsar -root \n\ + - GL: pulsar -root -texture -mipmap -texture_quality \ + -light -fog \n + + +! Some other programs that you might want to track down (these work as +! XScreenSaver helpers, but are not distributed with it): +! +! xdaliclock -root -builtin2 \n\ +! xswarm -r 2>&- \n\ +! xwave -root \n\ +! xbouncebits ... \n\ +! ico -r -faces -sleep 1 -obj ico \n\ +! xsplinefun \n\ +! xmountains -b -M \n\ +! color: xfishtank -c black -d -r 2 \n\ +! +! xtacy is ok, but it only works on the default visual. We can satisfy +! that constraint like so: +! +! default: xtacy -root -delay 100 -funky -number 3 \n\ +! default: xtacy -root -delay 100 -gravity \n\ +! default: xtacy -root -delay 100 -mixer \n\ +! default: xtacy -root -delay 100 -taffy -pal 4 \n\ +! +! To display a randomized slideshow of images, you can do something like this: +! +! default-n: xv -root -rmode 5 -random -viewonly -wloop \ +! -wait 30 $HOME/bitmaps/*.jpg \n\ +! +! Note that we've used "default-n" as the visual name, rather than just +! "default": this means "default visual, no install", that is, it's like +! specifying the command-line arguments "-visual default -no-install". +! This is necessary because, when XV is running in "-root" mode, it always +! assumes that the default visual and colormap are being used, rather than +! examining the window it is drawing on to see what visual and colormap it +! has. If we didn't force the default visual to be used, xv would get an +! X error. If we didn't force the default colormap to be installed, the +! colors would be all wrong. "default-i" may also be used as a visual name +! (meaning, "-visual default -install") but you probably won't ever need +! to use that. +! +! XEarth is nice, too: +! +! default-n: xearth -nostars -wait 0 -timewarp 400 -pos sunrel/38/-30 +! +! +! Some of the GL demos that SGI ships work with XScreenSaver; most don't. +! XScreenSaver includes a program (not built or installed by default) +! called "xscreensaver-sgigl". To use the SGI demos with XScreenSaver, +! build that program, and use it to launch the SGI demos. For example, +! on Irix 6.2, you can do this: +! +! xscreensaver-sgigl /usr/demos/bin/ep -S +! xscreensaver-sgigl /usr/demos/bin/bongo +! +! On Irix 6.3, things have moved, so you need to do it like this: +! +! xscreensaver-sgigl /usr/sbin/ep -S +! +! You can also use the "ant" demo, but first you need to wrap a shell script +! around it that cds to its home directory, so that it can find its files; +! and also pass it the -S argument, to prevent it from forking. +! +! +! Also, since these actually end up mapping their own windows instead of +! drawing on the XScreenSaver-provided root, when they are being run from +! demo-mode, you can't pop up the demo-mode dialog just by clicking the +! mouse: you must first type ESC to make the SGI programs exit. This sucks. +! Things should work properly when they are being run by xscreensaver in +! non-demo-mode, however. +! +! Basically, the SGI demo writers went out of their way to make my life hell. + + + +!============================================================================= +! +! You probably don't want to change anything after this point. +! +!============================================================================= + + +XScreenSaver.pointerPollTime: 5 +XScreenSaver.initialDelay: 0 +XScreenSaver.windowCreationTimeout: 30 +XScreenSaver.bourneShell: /bin/sh + + +! Resources for the password and splash-screen dialog boxes of +! the "xscreensaver" daemon. +! +*Dialog.headingFont: *-times-bold-r-*-*-*-180-*-*-*-iso8859-1 +*Dialog.bodyFont: *-helvetica-bold-r-*-*-*-140-*-*-*-iso8859-1 +*Dialog.labelFont: *-helvetica-bold-r-*-*-*-140-*-*-*-iso8859-1 +*Dialog.buttonFont: *-helvetica-bold-r-*-*-*-140-*-*-*-iso8859-1 +*Dialog.foreground: #000000 +*Dialog.background: #BFBFBF +*Dialog.Button.foreground: #000000 +*Dialog.Button.background: #D0D0D0 +*Dialog.text.foreground: #000000 +*Dialog.text.background: #FFFFFF +*Dialog.logo.foreground: #FF0000 +*Dialog.logo.background: #FFFFFF +*Dialog.topShadowColor: #E7E7E7 +*Dialog.bottomShadowColor: #737373 +*Dialog.logo.width: 200 +*Dialog.logo.height: 200 +*Dialog.internalBorderWidth: 30 +*Dialog.borderWidth: 1 +*Dialog.shadowThickness: 4 + +*passwd.heading.label: XScreenSaver %s +*passwd.body.label: This display is locked. +*passwd.user.label: User: +*passwd.passwd.label: Password: +*passwd.passwdFont: *-courier-medium-r-*-*-*-140-*-*-*-iso8859-1 +*passwd.thermometer.width: 8 + +*splash.heading.label: XScreenSaver %s +*splash.body.label: Copyright © 1991-1999 by +*splash.body2.label: Jamie Zawinski +*splash.demo.label: Demo +*splash.prefs.label: Prefs +*splash.help.label: Help + + +! Resources for the Motif dialog boxes of the "xscreensaver-demo" program. +! +*fontList: *-helvetica-medium-r-*-*-*-120-*-*-*-iso8859-1 +*demoDialog*label1.fontList: *-helvetica-medium-r-*-*-*-140-*-*-*-iso8859-1 +*XmTextField.fontList: *-courier-medium-r-*-*-*-120-*-*-*-iso8859-1 +*label0.fontList: *-helvetica-bold-r-*-*-*-140-*-*-*-iso8859-1 +XScreenSaver*XmList.fontList: *-courier-medium-r-*-*-*-120-*-*-*-iso8859-1 +! Need to fully-qualify the preceeding in the case of of *sgiMode. + +*XmDialogShell*foreground: #000000 +*XmDialogShell*background: #E5E5E5 +*XmDialogShell*XmTextField.foreground: #000000 +*XmDialogShell*XmTextField.background: #FFFFFF +*XmDialogShell*demoList.foreground: #000000 +*XmDialogShell*demoList.background: #FFFFFF + +*XmDialogShell.title: XScreenSaver +*versionWarning_popup.title: XScreenSaver Warning +*demoForm_popup.title: XScreenSaver Demo +*preferencesForm_popup.title: XScreenSaver Preferences +*allowShellResize: True +*autoUnmanage: False + +! This doesn't work. Motif ignores it if there is a scroll-list! +*demoDialog.maxWidth: 600 + +*label1.labelString: XScreenSaver %s +*label1.label: XScreenSaver %s +*label2.labelString: Copyright © 1991-1999 by Jamie Zawinski +*label2.label: Copyright © 1991-1999 by Jamie Zawinski +*demoList.visibleItemCount: 10 +*demoList.automaticSelection: True +*next.labelString: Run Next +*prev.labelString: Run Previous +*edit.labelString: Preferences +*restart.labelString: Reinitialize +*done.labelString: Quit + +*preferencesLabel.labelString: XScreenSaver Parameters + +*timeoutLabel.labelString: Saver Timeout +*cycleLabel.labelString: Cycle Timeout +*fadeSecondsLabel.labelString: Fade Duration +*fadeTicksLabel.labelString: Fade Ticks +*lockLabel.labelString: Lock Timeout +*passwdLabel.labelString: Password Timeout +*preferencesForm*XmTextField.columns: 8 + +*verboseToggle.labelString: Verbose +*cmapToggle.labelString: Install Colormap +*fadeToggle.labelString: Fade Colormap +*unfadeToggle.labelString: Unfade Colormap +*lockToggle.labelString: Require Password +*preferencesDone.labelString: OK +*preferencesCancel.labelString: Cancel + + +! Disable Motif drag-and-drop in dialog boxes. This is kind of pathetic, but +! in some older versions of Motif, most any attempt to drag cause immediate +! flaming death from above. This *should* rip the legs off that bug. +! (But sadly, Lesstif 0.86 and earlier ignore these resources *and* have +! buggy drag-and-drop.) +! +XScreenSaver*dragInitiatorProtocolStyle: DRAG_NONE +XScreenSaver*dragReceiverProtocolStyle: DRAG_NONE + + + +! Resources for the Athena dialog boxes of the "xscreensaver-demo" program. +! +*demo_dialog.title: XScreenSaver Demo +*preferences_dialog.title: XScreenSaver Preferences +*warning_dialog.title: XScreenSaver Warning + +! For some reason, it doesn't size correctly by itself. +*demo_dialog.geometry: =640x400 + +*demo_dialog*font: *-helvetica-bold-r-*-*-*-120-*-*-*-iso8859-1 +*preferences_dialog*font: *-helvetica-bold-r-*-*-*-120-*-*-*-iso8859-1 +*demo_dialog*label1.font: *-helvetica-bold-r-*-*-*-140-*-*-*-iso8859-1 +*preferences_dialog*label1.font:*-helvetica-bold-r-*-*-*-140-*-*-*-iso8859-1 +XScreenSaver*warning_dialog*label0.font: \ + *-helvetica-bold-r-*-*-*-140-*-*-*-iso8859-1 +XScreenSaver*warning_dialog*Label.font: \ + *-helvetica-bold-r-*-*-*-120-*-*-*-iso8859-1 +XScreenSaver*warning_dialog*Command.font: \ + *-helvetica-bold-r-*-*-*-140-*-*-*-iso8859-1 +XScreenSaver.demo_dialog*List.font: \ + *-courier-medium-r-*-*-*-120-*-*-*-iso8859-1 +XScreenSaver.demo_dialog*Text*font: \ + *-courier-medium-r-*-*-*-120-*-*-*-iso8859-1 + +XScreenSaver.demo_dialog*foreground: #000000 +XScreenSaver.demo_dialog*background: #E5E5E5 +XScreenSaver.demo_dialog*List.background: #FFFFFF +XScreenSaver.demo_dialog*Scrollbar.background: #D9D9D9 +XScreenSaver.demo_dialog*Command.background: #D9D9D9 +XScreenSaver.demo_dialog*Text*background: #FFFFFF + +XScreenSaver.preferences_dialog*foreground: #000000 +XScreenSaver.preferences_dialog*background: #E5E5E5 +XScreenSaver.preferences_dialog*Command.background: #D9D9D9 +XScreenSaver.preferences_dialog*Toggle.background: #D9D9D9 +XScreenSaver.preferences_dialog*Text*background: #FFFFFF + +XScreenSaver.warning_dialog*foreground: #000000 +XScreenSaver.warning_dialog*background: #E5E5E5 +XScreenSaver.warning_dialog*Command.background: #D9D9D9 + +*preferences_dialog*Dialog.value.translations: #override\n\ + Return: beginning-of-line()\n + +*demo_dialog*viewport.height: 200 +*Form.borderWidth: 0 +*Box.borderWidth: 0 +*Label.borderWidth: 0 +*preferences_dialog*Dialog.borderWidth: 0 + +*demo_dialog*run.label: Run +*demo_dialog*next.label: Run Next +*demo_dialog*prev.label: Run Previous +*demo_dialog*edit.label: Preferences +*demo_dialog*restart.label: Reinitialize +*demo_dialog*done.label: Quit +XScreenSaver.demo_dialog*Command.internalWidth: 10 +XScreenSaver.demo_dialog*Command.internalHeight: 4 + +*preferences_dialog*timeout.label: Saver Timeout: +*preferences_dialog*cycle.label: Cycle Timeout: +*preferences_dialog*fade.label: Fade Duration: +*preferences_dialog*ticks.label: Fade Ticks: +*preferences_dialog*lockTime.label: Lock Timeout: +*preferences_dialog*passwdTime.label: Password Timeout: +XScreenSaver.preferences_dialog*Command.internalWidth: 10 +XScreenSaver.preferences_dialog*Command.internalHeight: 4 + +*preferences_dialog*label1.label: XScreenSaver Parameters +*preferences_dialog*buttonbox.verbose.label: Verbose +*preferences_dialog*buttonbox.cmap.label: Install Colormap +*preferences_dialog*buttonbox.fade.label: Fade Colormap +*preferences_dialog*buttonbox.unfade.label: Unfade Colormap +*preferences_dialog*buttonbox.lock.label: Require Password +*preferences_dialog*done.label: Ok +*preferences_dialog*cancel.label: Cancel + +*warning_dialog*ok.label: Ok + +*warning_dialog*horizDistance: 30 +*warning_dialog*vertDistance: 0 + +*warning_dialog*Label.internalWidth: 1 +*warning_dialog*Label.internalHeight: 0 + +*warning_dialog*label0.horizDistance: 80 +*warning_dialog*label0.vertDistance: 20 + +*warning_dialog*Command.horizDistance: 160 +*warning_dialog*Command.vertDistance: 20 +*warning_dialog*Command.internalWidth: 20 +*warning_dialog*Command.internalHeight: 5 diff --git a/local/bin/ant b/local/bin/ant new file mode 100755 index 00000000..1b9c7930 Binary files /dev/null and b/local/bin/ant differ diff --git a/local/bin/atlantis b/local/bin/atlantis new file mode 100755 index 00000000..7e3d1e18 Binary files /dev/null and b/local/bin/atlantis differ diff --git a/local/bin/attraction b/local/bin/attraction new file mode 100755 index 00000000..e9afa4a0 Binary files /dev/null and b/local/bin/attraction differ diff --git a/local/bin/blitspin b/local/bin/blitspin new file mode 100755 index 00000000..3ce49f99 Binary files /dev/null and b/local/bin/blitspin differ diff --git a/local/bin/bouboule b/local/bin/bouboule new file mode 100755 index 00000000..2b485c32 Binary files /dev/null and b/local/bin/bouboule differ diff --git a/local/bin/braid b/local/bin/braid new file mode 100755 index 00000000..7ac67af1 Binary files /dev/null and b/local/bin/braid differ diff --git a/local/bin/bsod b/local/bin/bsod new file mode 100755 index 00000000..8d16c35f Binary files /dev/null and b/local/bin/bsod differ diff --git a/local/bin/bubble3d b/local/bin/bubble3d new file mode 100755 index 00000000..a586ef59 Binary files /dev/null and b/local/bin/bubble3d differ diff --git a/local/bin/bubbles b/local/bin/bubbles new file mode 100755 index 00000000..d1abe79c Binary files /dev/null and b/local/bin/bubbles differ diff --git a/local/bin/cage b/local/bin/cage new file mode 100755 index 00000000..ae5e8610 Binary files /dev/null and b/local/bin/cage differ diff --git a/local/bin/compass b/local/bin/compass new file mode 100755 index 00000000..252e5556 Binary files /dev/null and b/local/bin/compass differ diff --git a/local/bin/critical b/local/bin/critical new file mode 100755 index 00000000..0f85c43d Binary files /dev/null and b/local/bin/critical differ diff --git a/local/bin/crystal b/local/bin/crystal new file mode 100755 index 00000000..fa08fb0e Binary files /dev/null and b/local/bin/crystal differ diff --git a/local/bin/cynosure b/local/bin/cynosure new file mode 100755 index 00000000..4d8821f5 Binary files /dev/null and b/local/bin/cynosure differ diff --git a/local/bin/decayscreen b/local/bin/decayscreen new file mode 100755 index 00000000..9f559353 Binary files /dev/null and b/local/bin/decayscreen differ diff --git a/local/bin/deco b/local/bin/deco new file mode 100755 index 00000000..87df7135 Binary files /dev/null and b/local/bin/deco differ diff --git a/local/bin/deluxe b/local/bin/deluxe new file mode 100755 index 00000000..1eb57608 Binary files /dev/null and b/local/bin/deluxe differ diff --git a/local/bin/demon b/local/bin/demon new file mode 100755 index 00000000..5daf5712 Binary files /dev/null and b/local/bin/demon differ diff --git a/local/bin/discrete b/local/bin/discrete new file mode 100755 index 00000000..4a849a10 Binary files /dev/null and b/local/bin/discrete differ diff --git a/local/bin/distort b/local/bin/distort new file mode 100755 index 00000000..1fe3ad91 Binary files /dev/null and b/local/bin/distort differ diff --git a/local/bin/drift b/local/bin/drift new file mode 100755 index 00000000..5ca8dd19 Binary files /dev/null and b/local/bin/drift differ diff --git a/local/bin/epicycle b/local/bin/epicycle new file mode 100755 index 00000000..a48fce99 Binary files /dev/null and b/local/bin/epicycle differ diff --git a/local/bin/fadeplot b/local/bin/fadeplot new file mode 100755 index 00000000..54206f33 Binary files /dev/null and b/local/bin/fadeplot differ diff --git a/local/bin/flag b/local/bin/flag new file mode 100755 index 00000000..fa1aae2a Binary files /dev/null and b/local/bin/flag differ diff --git a/local/bin/flame b/local/bin/flame new file mode 100755 index 00000000..41cf34d4 Binary files /dev/null and b/local/bin/flame differ diff --git a/local/bin/flow b/local/bin/flow new file mode 100755 index 00000000..5c982faf Binary files /dev/null and b/local/bin/flow differ diff --git a/local/bin/forest b/local/bin/forest new file mode 100755 index 00000000..91f2c64d Binary files /dev/null and b/local/bin/forest differ diff --git a/local/bin/galaxy b/local/bin/galaxy new file mode 100755 index 00000000..38e8df92 Binary files /dev/null and b/local/bin/galaxy differ diff --git a/local/bin/gears b/local/bin/gears new file mode 100755 index 00000000..4e66d1dc Binary files /dev/null and b/local/bin/gears differ diff --git a/local/bin/glplanet b/local/bin/glplanet new file mode 100755 index 00000000..e5805168 Binary files /dev/null and b/local/bin/glplanet differ diff --git a/local/bin/goop b/local/bin/goop new file mode 100755 index 00000000..9911f6d3 Binary files /dev/null and b/local/bin/goop differ diff --git a/local/bin/grav b/local/bin/grav new file mode 100755 index 00000000..39b35a8d Binary files /dev/null and b/local/bin/grav differ diff --git a/local/bin/greynetic b/local/bin/greynetic new file mode 100755 index 00000000..b28b6e40 Binary files /dev/null and b/local/bin/greynetic differ diff --git a/local/bin/halo b/local/bin/halo new file mode 100755 index 00000000..999096f9 Binary files /dev/null and b/local/bin/halo differ diff --git a/local/bin/helix b/local/bin/helix new file mode 100755 index 00000000..2a7288d8 Binary files /dev/null and b/local/bin/helix differ diff --git a/local/bin/hopalong b/local/bin/hopalong new file mode 100755 index 00000000..13497e06 Binary files /dev/null and b/local/bin/hopalong differ diff --git a/local/bin/hypercube b/local/bin/hypercube new file mode 100755 index 00000000..f4e57528 Binary files /dev/null and b/local/bin/hypercube differ diff --git a/local/bin/ifs b/local/bin/ifs new file mode 100755 index 00000000..4e5f4f3f Binary files /dev/null and b/local/bin/ifs differ diff --git a/local/bin/imsmap b/local/bin/imsmap new file mode 100755 index 00000000..0ea3f754 Binary files /dev/null and b/local/bin/imsmap differ diff --git a/local/bin/interference b/local/bin/interference new file mode 100755 index 00000000..19b5271f Binary files /dev/null and b/local/bin/interference differ diff --git a/local/bin/jigsaw b/local/bin/jigsaw new file mode 100755 index 00000000..8b987cba Binary files /dev/null and b/local/bin/jigsaw differ diff --git a/local/bin/kaleidescope b/local/bin/kaleidescope new file mode 100755 index 00000000..b7c21c84 Binary files /dev/null and b/local/bin/kaleidescope differ diff --git a/local/bin/kumppa b/local/bin/kumppa new file mode 100755 index 00000000..6ab5b448 Binary files /dev/null and b/local/bin/kumppa differ diff --git a/local/bin/lament b/local/bin/lament new file mode 100755 index 00000000..e19b5790 Binary files /dev/null and b/local/bin/lament differ diff --git a/local/bin/laser b/local/bin/laser new file mode 100755 index 00000000..3278df60 Binary files /dev/null and b/local/bin/laser differ diff --git a/local/bin/lightning b/local/bin/lightning new file mode 100755 index 00000000..106798bd Binary files /dev/null and b/local/bin/lightning differ diff --git a/local/bin/lisa b/local/bin/lisa new file mode 100755 index 00000000..a2b03dfa Binary files /dev/null and b/local/bin/lisa differ diff --git a/local/bin/lissie b/local/bin/lissie new file mode 100755 index 00000000..f355e0e5 Binary files /dev/null and b/local/bin/lissie differ diff --git a/local/bin/lmorph b/local/bin/lmorph new file mode 100755 index 00000000..110b5b91 Binary files /dev/null and b/local/bin/lmorph differ diff --git a/local/bin/loop b/local/bin/loop new file mode 100755 index 00000000..7c8f098f Binary files /dev/null and b/local/bin/loop differ diff --git a/local/bin/maze b/local/bin/maze new file mode 100755 index 00000000..698fd5d9 Binary files /dev/null and b/local/bin/maze differ diff --git a/local/bin/moebius b/local/bin/moebius new file mode 100755 index 00000000..8c623178 Binary files /dev/null and b/local/bin/moebius differ diff --git a/local/bin/moire b/local/bin/moire new file mode 100755 index 00000000..2f151bad Binary files /dev/null and b/local/bin/moire differ diff --git a/local/bin/moire2 b/local/bin/moire2 new file mode 100755 index 00000000..c53bc027 Binary files /dev/null and b/local/bin/moire2 differ diff --git a/local/bin/morph3d b/local/bin/morph3d new file mode 100755 index 00000000..5efefaf1 Binary files /dev/null and b/local/bin/morph3d differ diff --git a/local/bin/mountain b/local/bin/mountain new file mode 100755 index 00000000..aaa7e458 Binary files /dev/null and b/local/bin/mountain differ diff --git a/local/bin/munch b/local/bin/munch new file mode 100755 index 00000000..33a30d5d Binary files /dev/null and b/local/bin/munch differ diff --git a/local/bin/noseguy b/local/bin/noseguy new file mode 100755 index 00000000..a5338f30 Binary files /dev/null and b/local/bin/noseguy differ diff --git a/local/bin/pedal b/local/bin/pedal new file mode 100755 index 00000000..d15b204a Binary files /dev/null and b/local/bin/pedal differ diff --git a/local/bin/penetrate b/local/bin/penetrate new file mode 100755 index 00000000..9ebca812 Binary files /dev/null and b/local/bin/penetrate differ diff --git a/local/bin/penrose b/local/bin/penrose new file mode 100755 index 00000000..3711512b Binary files /dev/null and b/local/bin/penrose differ diff --git a/local/bin/petri b/local/bin/petri new file mode 100755 index 00000000..74ceb514 Binary files /dev/null and b/local/bin/petri differ diff --git a/local/bin/phosphor b/local/bin/phosphor new file mode 100755 index 00000000..644b13ae Binary files /dev/null and b/local/bin/phosphor differ diff --git a/local/bin/pipes b/local/bin/pipes new file mode 100755 index 00000000..38848789 Binary files /dev/null and b/local/bin/pipes differ diff --git a/local/bin/pulsar b/local/bin/pulsar new file mode 100755 index 00000000..96df10ec Binary files /dev/null and b/local/bin/pulsar differ diff --git a/local/bin/pyro b/local/bin/pyro new file mode 100755 index 00000000..20ae7690 Binary files /dev/null and b/local/bin/pyro differ diff --git a/local/bin/qix b/local/bin/qix new file mode 100755 index 00000000..e98aca96 Binary files /dev/null and b/local/bin/qix differ diff --git a/local/bin/rd-bomb b/local/bin/rd-bomb new file mode 100755 index 00000000..c914b1ed Binary files /dev/null and b/local/bin/rd-bomb differ diff --git a/local/bin/rocks b/local/bin/rocks new file mode 100755 index 00000000..5bb57cd8 Binary files /dev/null and b/local/bin/rocks differ diff --git a/local/bin/rorschach b/local/bin/rorschach new file mode 100755 index 00000000..cca92fd2 Binary files /dev/null and b/local/bin/rorschach differ diff --git a/local/bin/rotor b/local/bin/rotor new file mode 100755 index 00000000..3ef607b8 Binary files /dev/null and b/local/bin/rotor differ diff --git a/local/bin/rubik b/local/bin/rubik new file mode 100755 index 00000000..f0b13ec8 Binary files /dev/null and b/local/bin/rubik differ diff --git a/local/bin/shadebobs b/local/bin/shadebobs new file mode 100755 index 00000000..f841eca5 Binary files /dev/null and b/local/bin/shadebobs differ diff --git a/local/bin/sierpinski b/local/bin/sierpinski new file mode 100755 index 00000000..95810e76 Binary files /dev/null and b/local/bin/sierpinski differ diff --git a/local/bin/slidescreen b/local/bin/slidescreen new file mode 100755 index 00000000..6709b6a4 Binary files /dev/null and b/local/bin/slidescreen differ diff --git a/local/bin/slip b/local/bin/slip new file mode 100755 index 00000000..b1dd5dce Binary files /dev/null and b/local/bin/slip differ diff --git a/local/bin/sonar b/local/bin/sonar new file mode 100755 index 00000000..78c55d7e Binary files /dev/null and b/local/bin/sonar differ diff --git a/local/bin/sphere b/local/bin/sphere new file mode 100755 index 00000000..4f8ee1a5 Binary files /dev/null and b/local/bin/sphere differ diff --git a/local/bin/spiral b/local/bin/spiral new file mode 100755 index 00000000..99306109 Binary files /dev/null and b/local/bin/spiral differ diff --git a/local/bin/spotlight b/local/bin/spotlight new file mode 100755 index 00000000..fe1f7a84 Binary files /dev/null and b/local/bin/spotlight differ diff --git a/local/bin/sproingies b/local/bin/sproingies new file mode 100755 index 00000000..fefbd578 Binary files /dev/null and b/local/bin/sproingies differ diff --git a/local/bin/squiral b/local/bin/squiral new file mode 100755 index 00000000..5d2929c2 Binary files /dev/null and b/local/bin/squiral differ diff --git a/local/bin/stairs b/local/bin/stairs new file mode 100755 index 00000000..a61c3039 Binary files /dev/null and b/local/bin/stairs differ diff --git a/local/bin/starfish b/local/bin/starfish new file mode 100755 index 00000000..0ebbb393 Binary files /dev/null and b/local/bin/starfish differ diff --git a/local/bin/strange b/local/bin/strange new file mode 100755 index 00000000..881abb12 Binary files /dev/null and b/local/bin/strange differ diff --git a/local/bin/superquadrics b/local/bin/superquadrics new file mode 100755 index 00000000..4abd3d53 Binary files /dev/null and b/local/bin/superquadrics differ diff --git a/local/bin/swirl b/local/bin/swirl new file mode 100755 index 00000000..a7a901cd Binary files /dev/null and b/local/bin/swirl differ diff --git a/local/bin/t3d b/local/bin/t3d new file mode 100755 index 00000000..201a584d Binary files /dev/null and b/local/bin/t3d differ diff --git a/local/bin/triangle b/local/bin/triangle new file mode 100755 index 00000000..c57364d2 Binary files /dev/null and b/local/bin/triangle differ diff --git a/local/bin/truchet b/local/bin/truchet new file mode 100755 index 00000000..a2ee81ab Binary files /dev/null and b/local/bin/truchet differ diff --git a/local/bin/vidwhacker b/local/bin/vidwhacker new file mode 100755 index 00000000..b35af3a1 --- /dev/null +++ b/local/bin/vidwhacker @@ -0,0 +1,401 @@ +#!/bin/sh +# +# vidwhacker, for xscreensaver. Copyright (c) 1998, 1999 Jamie Zawinski. +# +# Permission to use, copy, modify, distribute, and sell this software and its +# documentation for any purpose 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 representations are made about the suitability of this +# software for any purpose. It is provided "as is" without express or +# implied warranty. +# +# +# This script grabs a frame of video, then uses various pbm filters to +# munge the image in random nefarious ways, then uses xv to put it on +# the root window. This works out really nicely if you just feed some +# random TV station into it... +# +# The video grabbing part is SGI-specific -- if you want to use this on +# another system, add a new clause to the grab() procedure. + + +# Process command-line args... + +onroot=false +verbose=false +delay=3 +use_stdin=false +use_stdout=false + +pid="" +tmp=${TMPDIR:-/tmp}/vidwhacker.$$ +tmp_rgb=$tmp-00000.rgb +tmp_ppm0=$tmp-0.ppm +tmp_ppm1=$tmp-1.ppm +tmp_ppm2=$tmp-2.ppm +tmp_ppm3=$tmp-3.ppm +tmp_ppm4=$tmp-4.ppm +tmp_ppmS=$tmp-S.ppm + + +getargs() { + + while [ $# != 0 ]; do + case "$1" in + -display | -disp | -dis | -dpy | -d ) + shift + DISPLAY="$1" + export DISPLAY + ;; + -root ) + onroot=true + ;; + -window ) + onroot=false + ;; + -verbose ) + verbose=true + ;; + -stdin ) + use_stdin=true + ;; + -stdout ) + use_stdout=true + ;; + -delay) + shift + delay="$1" + ;; + * ) + echo "VidWhacker, Copyright (c) 1999 Jamie Zawinski " >&2 + echo " http://www.jwz.org/xscreensaver/" >&2 + echo "" >&2 + echo "usage: $0 [-display dpy] [-verbose] [-root | -window]" >&2 + echo " [-stdin] [-stdout] [-delay secs]" >&2 + exit 1 + ;; + esac + shift + done + + xvargs="-quick24" + + if [ "$onroot" = true ]; then + xvargs="$xvargs -root -rmode 5 -noresetroot -rfg black -rbg black -viewonly" + else + xvargs="$xvargs -geom +0+0" + fi + + + screen_width='' + if [ "$use_stdout" = false ]; then + screen_width=`xdpyinfo 2>/dev/null | + sed -n 's/.* dimensions: *\([0-9]*\).*/\1/p'` + if [ "$screen_width" = "" ]; then + screen_width=800 + fi + fi +} + + +clean() { + rm -f $tmp_rgb $tmp_ppm1 $tmp_ppm2 $tmp_ppm3 $tmp_ppm4 +} + +clean2() { + clean + rm -f $tmp_ppm0 $tmp_ppmS +} + + +# Grab a frame of video. leaves it in $tmp_ppm1. +# +grab() { + uname=`uname` + if [ $uname = IRIX ]; then + # + # SGI's "vidtomem" returns an SGI RGB image of the default video input, + # and has stupid non-overridable ouput-file-naming conventions. So, let + # it write its file; and then convert it to a pgm. + # + + vidtomem -f $tmp + sgitopnm $tmp_rgb > $tmp_ppm1 + + # Cut off the close-captioning blips in the NTSC overscan region. YMMV. + # | pnmcut 12 7 695 477 + + elif [ $uname = Linux ]; then + + # Marcus Herbert says the following works with his Connectix Qcam. + # Don't have qcam? Well, do something else then... and send me a patch. + + qcam > $tmp_ppm1 + + # Friedrich Delgado Friedrichs says the following works with a + # Brooktree 848 or 878 tuner card: + # + # bttvgrab -Q -d q -l 1 -F /dev/null -o gif -f ${tmp}.gif -N PAL + # giftopnm ${tmp}.gif > $tmp_ppm1 + # rm ${tmp}.gif + # + # He notes that you might need to run a TV application (e.g., xawtv) + # before the first time you run vidwhacker in order to initialize the + # tuner card and kernel modules. + + + else + echo "$0: don't know how to grab video on this OS." >&2 + clean2 + exit 1 + fi +} + + +# Use perl to pick a random foreground/background color in pbm's syntax. +# +randcolor() { + perl -e 'srand; + printf("#%02x%02x%02x-#%02x%02x%02x", + int(rand()*60), + int(rand()*60), + int(rand()*60), + 120+int(rand()*135), + 120+int(rand()*135), + 120+int(rand()*135))' +} + +# Frobnicate the image in some random way. +# +frob() { + + w_h=`head -2 $tmp_ppm1 | tail -1` + width=`echo $w_h | awk '{print $1}'` + height=`echo $w_h | awk '{print $2}'` + + N=`perl -e 'srand; print int(rand() * 17)'` + + if [ "$verbose" = true ]; then + echo "mode $N..." >&2 + fi + + if [ $N = 0 ]; then + ppmtopgm $tmp_ppm1 | pgmedge | pgmtoppm `randcolor` | ppmnorm + + elif [ $N = 1 ]; then + ppmtopgm $tmp_ppm1 | + pgmenhance | + pgmtoppm `randcolor` + + elif [ $N = 2 ]; then + ppmtopgm $tmp_ppm1 | pgmoil | pgmtoppm `randcolor` + + elif [ $N = 3 ]; then + ppmrelief $tmp_ppm1 | ppmtopgm | pgmedge | ppmrelief | ppmtopgm | + pgmedge | pnminvert | pgmtoppm `randcolor` + + elif [ $N = 4 ]; then + ppmspread 71 $tmp_ppm1 > $tmp_ppm2 + pnmarith -add $tmp_ppm1 $tmp_ppm2 + + elif [ $N = 5 ]; then + pnmflip -lr $tmp_ppm1 > $tmp_ppm2 + pnmarith -multiply $tmp_ppm1 $tmp_ppm2 > $tmp_ppm3 + pnmflip -tb $tmp_ppm3 | ppmnorm > $tmp_ppm2 + pnmarith -multiply $tmp_ppm1 $tmp_ppm2 + + elif [ $N = 6 ]; then + N2=`perl -e 'srand; print int(rand() * 3)'` + if [ $N2 = 0 ]; then + pnmflip -lr $tmp_ppm1 > $tmp_ppm2 + elif [ $N2 = 1 ]; then + pnmflip -tb $tmp_ppm1 > $tmp_ppm2 + else + pnmflip -lr $tmp_ppm1 > $tmp_ppm2 + pnmflip -tb $tmp_ppm2 > $tmp_ppm3 + cp $tmp_ppm3 $tmp_ppm2 + fi + + pnmarith -difference $tmp_ppm1 $tmp_ppm2 + + elif [ $N = 7 ]; then + + for i in 1 2 3 ; do + ppmtopgm $tmp_ppm1 | pgmedge > $tmp_ppm2 + pnmarith -difference $tmp_ppm1 $tmp_ppm2 > $tmp_ppm3 + cp $tmp_ppm3 $tmp_ppm1 + done + ppmnorm < $tmp_ppm1 + + elif [ $N = 8 ]; then + pnmflip -lr $tmp_ppm1 > $tmp_ppm2 + pnmarith -multiply $tmp_ppm1 $tmp_ppm2 | ppmrelief | ppmnorm | pnminvert + + elif [ $N = 9 ]; then + pnmflip -lr $tmp_ppm1 > $tmp_ppm2 + pnmarith -subtract $tmp_ppm1 $tmp_ppm2 | ppmrelief | ppmtopgm | pgmedge + + elif [ $N = 10 ]; then + ppmtopgm $tmp_ppm1 | pgmbentley | pgmtoppm `randcolor` + + elif [ $N = 11 ]; then + pgmcrater -number 20000 -height $height -width $width | pgmtoppm `randcolor` > $tmp_ppm2 + pnmarith -difference $tmp_ppm1 $tmp_ppm2 > $tmp_ppm3 + pnmflip -tb $tmp_ppm3 | ppmnorm > $tmp_ppm2 + pnmarith -multiply $tmp_ppm1 $tmp_ppm2 + + elif [ $N = 12 ]; then + ppmshift 30 $tmp_ppm1 | ppmtopgm | pgmoil | pgmedge | pgmtoppm `randcolor` > $tmp_ppm2 + pnmarith -difference $tmp_ppm1 $tmp_ppm2 + + elif [ $N = 13 ]; then + ppmpat -madras $width $height | pnmdepth 255 > $tmp_ppm2 + pnmarith -difference $tmp_ppm1 $tmp_ppm2 + + elif [ $N = 14 ]; then + ppmpat -tartan $width $height | pnmdepth 255 > $tmp_ppm2 + pnmarith -difference $tmp_ppm1 $tmp_ppm2 + + elif [ $N = 15 ]; then + ppmpat -camo $width $height | pnmdepth 255 | ppmshift 50 > $tmp_ppm2 + pnmarith -multiply $tmp_ppm1 $tmp_ppm2 + + elif [ $N = 16 ]; then + pgmnoise $width $height | pgmedge | pgmtoppm `randcolor` > $tmp_ppm2 + pnmarith -difference $tmp_ppm1 $tmp_ppm2 | pnmdepth 255 | pnmsmooth + + else cat $tmp_ppm1 + fi +} + + +# Grab a frame and frob it. leave it in $tmp_ppm3. +# +whack() { + clean + + while [ ! -f $tmp_ppm1 ]; do + if [ "$use_stdin" != true ]; then + grab + else + cp $tmp_ppmS $tmp_ppm0 + cp $tmp_ppm0 $tmp_ppm1 + fi + done + + rm -f $tmp_rgb + + if [ "$screen_width" != "" ]; then + frob | pnmscale -width $screen_width > $tmp_ppm3 + else + frob > $tmp_ppm3 + fi + + rm -f $tmp_ppm1 $tmp_ppm2 +} + + +# Kill off the xv subprocess, if it's running +# +kill_pid() { + if [ "$pid" != "" ]; then + + if [ "$verbose" = true ]; then + echo "killing pid $pid..." >&2 + fi + + # need to do this to avoid "6898 Terminated" messages! + # apparently one can't redirect the output of the builtin `kill' command. +# ( sh -c "kill $pid" ) >/dev/null 2>/dev/null /dev/null 2>&1 + + pid="" + fi +} + +# called when this process is signalled (for cleanup) +# +my_trap() { + if [ "$verbose" = true ]; then + echo "trapped signal!" >&2 + fi + kill_pid + clean2 + exit 1 +} + +main() { + + getargs $@ + + trap my_trap 1 2 3 6 9 13 15 + + if [ "$use_stdin" = true ]; then + cat > $tmp_ppmS + fi + + while true; do + + # Loop grabbing and frobbing images. + # + # If we're running on the root, run xv in the foreground (with -exit) + # and then wait. + # + # If we're running in a window, spawn xv in the background; then when + # it's time to put up the new image, kill off the currently-running xv. + + if [ "$verbose" = true ]; then + whack + else + whack >/dev/null 2>&1 + fi + + kill_pid + + if [ ! -s $tmp_ppm3 ]; then + echo "$0: no image grabbed" >&2 + + elif [ "$use_stdout" = true ]; then + + cat $tmp_ppm3 + clean2 + exit 0 + + else + + pnmtosgi < $tmp_ppm3 > $tmp_ppm2 + rm -f $tmp_ppm3 + + if [ -s $tmp_ppm2 ]; then + if [ "$verbose" = true ]; then + echo "launching xv $xvargs $tmp_ppm2" >&2 + ls -lF $tmp_ppm2 + fi + + mv $tmp_ppm2 $tmp_ppm0 + xv $xvargs $tmp_ppm0 & + +# this doesn't work -- leaves xv processes around, instead of stray xset +# data. Sigh. +# +# # cat the file so that we can nuke it without racing against xv. +# cat $tmp_ppm2 | xv $xvargs - & + + pid=$! + fi + fi + + clean + sleep $delay + + done + exit 1 +} + +main $@ + +# to find stray xv data: +# xwininfo -root -children|grep 'xv image comments' | awk '{print "xkill -id ", $1}' diff --git a/local/bin/vines b/local/bin/vines new file mode 100755 index 00000000..78159ed5 Binary files /dev/null and b/local/bin/vines differ diff --git a/local/bin/wander b/local/bin/wander new file mode 100755 index 00000000..52fe3a38 Binary files /dev/null and b/local/bin/wander differ diff --git a/local/bin/webcollage b/local/bin/webcollage new file mode 100755 index 00000000..a218de16 --- /dev/null +++ b/local/bin/webcollage @@ -0,0 +1,788 @@ +#!/usr/local/bin/perl5 -w +# +# webcollage, for xscreensaver, Copyright (c) 1999 Jamie Zawinski +# +# Permission to use, copy, modify, distribute, and sell this software and its +# documentation for any purpose 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 representations are made about the suitability of this +# software for any purpose. It is provided "as is" without express or +# implied warranty. +# +# +# This program decorate the screen with random images from the web. + + +use Socket; + +my $progname = "$0"; +my $version = "1.0"; + +$progname =~ s@^.*/([^/]+)$@$1@; + +my $random_redirector = "http://random.yahoo.com/bin/ryl"; +my $image_randomizer_a = "http://image.altavista.com/"; +my $image_randomizer = $image_randomizer_a . "cgi-bin/avncgi" . + "?do=3&verb=no&oshape=n&oorder=" . + "&ophoto=1&oart=1&ocolor=1&obw=1" . + "&stype=simage&oprem=0&query="; + +my $http_timeout = 30; +my $ppm_to_root_window_cmd = "xv -root -rmode 5 -viewonly" . + " +noresetroot %%PPM%% -quit"; +my $filter_cmd = undef; +my $post_filter_cmd = undef; +my $background = undef; +my $no_output_p = 0; +my $delay = 0; + +my $wordlist = "/usr/dict/words"; + +if (!-r $wordlist) { + $wordlist = "/usr/share/lib/dict/words"; # irix +} + + +my $min_width = 50; +my $min_height = 50; + +my $DEBUG = 0; + + +# returns three values: the HTTP response line; the document headers; +# and the document body. +# +sub get_document_1 { + my ( $url ) = @_; + + if ( $DEBUG > 2 ) { + print STDERR "get_document_1 $url\n"; + } + + my($dummy, $dummy, $serverstring, $path) = split(/\//, $url, 4); + my($them,$port) = split(/:/, $serverstring); + $port = 80 unless $port; + my $size=""; + + my ($remote, $iaddr, $paddr, $proto, $line); + $remote = $them; + if ($port =~ /\D/) { $port = getservbyname($port, 'tcp') } + return unless $port; + $iaddr = inet_aton($remote) || return; + $paddr = sockaddr_in($port, $iaddr); + + @_ = + eval { + local $SIG{ALRM} = sub { + if ($DEBUG > 0) { + print STDERR "timed out for $url\n"; + } + die "alarm\n" }; + alarm $http_timeout; + + $proto = getprotobyname('tcp'); + socket(S, PF_INET, SOCK_STREAM, $proto) || return; + connect(S, $paddr) || return; + + select(S); $| = 1; select(STDOUT); + + print S ("GET /$path HTTP/1.0\n" . + "Host: $them\n" . + "User-Agent: $progname/$version\n" . + "\n"); + + my $http = ; + + my $head = ""; + my $body = ""; + while () { + $head .= $_; + last if m@^[\r\n]@; + } + while () { + $body .= $_; + } + + close S; + + return ( $http, $head, $body ); + }; + die if ($@ && $@ ne "alarm\n"); # propagate errors + if ($@) { + # timed out + return undef; + } else { + # didn't + alarm 0; + return @_; + } +} + + +# returns two values: the document headers; and the document body. +# if the given URL did a redirect, returns the redirected-to document. +# +sub get_document { + my ( $url ) = @_; + + do { + my ( $http, $head, $body ) = get_document_1 $url; + + return undef if ( ! $body ); + + if ( $http =~ m@HTTP/[0-9.]+ 30[23]@ ) { + $_ = $head; + my ( $location ) = m@^location:[ \t]*(.*)$@im; + if ( $location ) { + + if ( $DEBUG > 2 ) { + print STDERR "redirect from $url to $location\n"; + } + $url = $location; + } else { + return ( $url, $body ); + } + + } elsif ( $http =~ m@HTTP/[0-9.]+ [4-9][0-9][0-9]@ ) { + # http errors -- return nothing. + return undef; + + } else { + + return ( $url, $body ); + } + + } while (1); +} + + +# given a URL and the body text at that URL, selects and returns a random +# image from it. returns undef if no suitable images found. +# +sub pick_image_from_body { + my ( $base, $body ) = @_; + + $_ = $base; + + # if there's at least one slash after the host, take off the last + # pathname component + if ( m@^http://[^/]+/@io ) { + ( $base = $base ) =~ s@[^/]+$@@go; + } + + # if there are no slashes after the host at all, put one on the end. + if ( m@^http://[^/]+$@io ) { + $base .= "/"; + } + + if ( $DEBUG > 2 ) { + print STDERR "base is $base\n"; + } + + + $_ = $body; + + # strip out newlines, compress whitespace + s/[\r\n\t ]+/ /go; + + # nuke comments + s///go; + + my @urls; + my %unique_urls; + + foreach (split(/ *\"]/io ) { + + my $was_inline = ( "$1" eq "a" || "$1" eq "A" ); + my $link = $3; + my ( $width ) = m/width ?= ?([0-9]+)/oi; + my ( $height ) = m/height ?= ?([0-9]+)/oi; + $_ = $link; + + if ( m@^/@o ) { + my $site; + ( $site = $base ) =~ s@^(http://[^/]*).*@$1@gio; + $_ = "$site$link"; + } elsif ( ! m/:/ ) { + $_ = "$base$link"; + s@/\./@/@; + while (s@/\.\./@/@g) { + } + } + + # skip non-http + if ( ! m@^http://@io ) { + next; + } + + # skip non-image + if ( ! m@[.](gif|jpg|jpeg|pjpg|pjpeg)@io ) { + next; + } + + # skip GIF! +# if ( m@[.](gif)@io ) { +## if ( $DEBUG > 2 ) { print "skip GIF $_\n"; } +# next; +# } + + # skip really short or really narrow images + if ( $width && $width < $min_width) { + if ( $DEBUG > 2 ) { + print STDERR "skip narrow image $_ ($width x $height)\n"; + } + next; + } + + if ( $height && $height < $min_height) { + if ( $DEBUG > 2 ) { + print STDERR "skip short image $_ ($width x $height)\n"; + } + next; + } + + my $url = $_; + + if ( $unique_urls{$url} ) { + if ( $DEBUG > 2 ) { print STDERR "skip duplicate image $_\n"; } + next; + } + + if ( $DEBUG > 2 ) { + print STDERR "got $url" . + ($width && $height ? " (${width}x${height})" : "") . + ($was_inline ? " (inline)" : "") . "\n"; + } + + $urls[++$#urls] = $url; + $unique_urls{$url}++; + + # pointers to images are preferable to inlined images + if ( ! $was_inline ) { + $urls[++$#urls] = $url; + } + } + } + + if ( $#urls == 0 ) { + if ( $DEBUG > 2 ) { + print STDERR "no images on $base\n"; + } + return undef; + } + + return undef if ( $#urls < 1 ); + + # pick a random element of the table + my $i = ((rand() * 99999) % $#urls); + + # if the page has several images on it, prefer the later ones most of + # the time. + my $fudge = 4; + if ($#urls > ($fudge * 2) && $i <= $fudge && ((rand() < 0.9))) { + if ( $DEBUG > 2 ) { + print STDERR "skipping first $fudge of $#urls images.\n"; + } + $i += ($fudge - $i); + } + + my $url = $urls[$i]; + + if ( $DEBUG > 2 ) { + print STDERR "picked $url\n"; + } + + return $url; +} + + +# Using the URL-randomizer, picks a random image on a random page, and +# returns two URLs: the page containing the image, and the image. +# Returns undef if nothing found this time. +# +sub pick_from_url_randomizer { + + if ( $DEBUG > 2 ) { + print STDERR "\n\npicking from $random_redirector...\n\n"; + } + + my ( $base, $body ) = get_document $random_redirector; + + return if (!$base || !$body); + my $img = pick_image_from_body ($base, $body); + + if ($img) { + return ($base, $img); + } else { + return undef; + } +} + + +sub random_word { + + my $word = 0; + if (open (IN, "<$wordlist")) { + my $size = (stat(IN))[7]; + my $pos = rand $size; + if (seek (IN, $pos, 0)) { + $word = ; # toss partial line + $word = ; # keep next line + } + close (IN); + } + + return 0 if (!$word); + + $word =~ s/^[ \t\n\r]+//; + $word =~ s/[ \t\n\r]+$//; + $word =~ s/ly$//; + $word =~ s/ies$/y/; + $word =~ s/ally$/al/; + + return $word; +} + + + +# Using the image-randomizer, picks a random image on a random page, and +# returns two URLs: the page containing the image, and the image. +# Returns undef if nothing found this time. +# +sub pick_from_image_randomizer { + + my $words = random_word; + $words .= "%20" . random_word; + $words .= "%20" . random_word; + + my $search_url = $image_randomizer . $words; + + if ( $DEBUG > 2 ) { + print STDERR "\n\npicking from $search_url\n"; + } + + my ( $base, $body ) = get_document $search_url; + + return if (! $body); + + + my @subpages; + my $skipped = 0; + + $_ = $body; + s/(]+)> 2 ) { + print STDERR "skipping corbis URL: $_\n"; + } + next; + } elsif ( $DEBUG > 2 ) { + print STDERR "sub-page: $1\n"; + } + + $subpages[++$#subpages] = $u; + } + } + + if ( $#subpages <= 0 ) { + if (!$skipped) { + print STDERR "Found nothing on $base\n"; + } + return undef; + } + + # pick a random element of the table + my $i = ((rand() * 99999) % $#subpages); + my $subpage = $subpages[$i]; + + if ( $DEBUG > 2 ) { + print STDERR "picked page $subpage\n"; + } + + + + my ( $base2, $body2 ) = get_document $subpage; + + return undef if (!$base2 || !body2); + + my $img = pick_image_from_body ($base2, $body2); + + if ($img) { + return ($base2, $img); + } else { + return undef; + } +} + + +# Picks a random image on a random page, and returns two URLs: +# the page containing the image, and the image. +# Returns undef if nothing found this time. +# Uses the url-randomizer 1 time in 5, else the image randomizer. +# +sub pick_image { + if (int(rand 5) == 0) { + return pick_from_url_randomizer; + } else { + return pick_from_image_randomizer; + } +} + + +# returns the full path of the named program, or undef. +# +sub which { + my ($prog) = @_; + foreach (split (/:/, $ENV{PATH})) { + if (-x "$_/$prog") { + return $prog; + } + } + return undef; +} + + + +################################# +# +# running as a CGI +# +################################# + + +sub do_html_output { + + $| = 1; + + if ( $progname =~ m/nph-/o ) { + print "HTTP/1.0 200 OK\n"; + print "Content-type: text/html\n"; + print "\n"; + } + + print "random images\n"; + print "\n"; + print "

random images

\n"; + print "

\n"; + print "These images have been selected randomly from the web,\n"; + print "by using both \n"; + print "$random_redirector and \n"; + print "$image_randomizer_a as a source of URLs from which\n"; + print "images are extracted.\n"; + print "

\n"; + print "Note: if you leave this running\n"; + print "long enough, your browser will undoubtedly run out of memory\n"; + print "and crash...\n"; + print "


\n"; + + do { + my ($base, $img) = pick_image; + if ($img) { + if ($DEBUG > 0) { + print STDERR "$img\n"; + } + print ""; + print "\n"; + } + + sleep $delay; + + } while (1); +} + + +################################# +# +# running as an xscreensaver mode +# +################################# + + +my $image = ($ENV{TMPDIR} ? $ENV{TMPDIR} : "/tmp") . "/webcollage." . $$; +my $tmp = $image . "-1"; +my $tmp2 = $image . "-2"; +my $tmp3 = $image . "-3"; + +sub x_cleanup { + if ($DEBUG > 0) { print STDERR "caught signal\n"; } + unlink $image, $tmp, $tmp2, $tmp3; + exit 1; +} + +my $screen_width = undef; +my $screen_height = undef; + +sub do_x_output { + + my $win_cmd = $ppm_to_root_window_cmd; + $win_cmd =~ s/^([^ \t\r\n]+).*$/$1/; + + # make sure the various programs we execute exist, right up front. + foreach ("ppmmake", "giftopnm", "djpeg", "pnmpaste", $win_cmd) { + which ($_) || die "$progname: $_ not found on \$PATH.\n"; + } + + $SIG{HUP} = \&x_cleanup; + $SIG{INT} = \&x_cleanup; + $SIG{QUIT} = \&x_cleanup; + $SIG{ABRT} = \&x_cleanup; + $SIG{KILL} = \&x_cleanup; + $SIG{TERM} = \&x_cleanup; + + # Need this so that if giftopnm dies, we don't die. + $SIG{PIPE} = 'IGNORE'; + + if (!$screen_width || !$screen_height) { + $_ = `xdpyinfo`; + ($screen_width, $screen_height) = m/dimensions: *([0-9]+)x([0-9]+) /; + } + + my $bgcolor = "#000000"; + my $bgimage = undef; + + if ($background) { + if ($background =~ m/^\#[0-9a-f]+$/i) { + $bgcolor = $background; + } elsif (-r $background) { + $bgimage = $background; + + } elsif (! $background =~ m@^[-a-z0-9 ]+$@i) { + print STDERR "not a color or readable file: $background\n"; + exit 1; + } else { + # default to assuming it's a color + $bgcolor = $background; + } + } + + # Create the sold-colored base image. + # + $_ = "ppmmake '$bgcolor' $screen_width $screen_height"; + if ($DEBUG > 1) { + print STDERR "creating base image: $_\n"; + } + system "$_ > $image"; + + # Paste the default background image in the middle of it. + # + if ($bgimage) { + my ($iw, $ih); + if (open(IMG, "<$bgimage")) { + $_ = ; + $_ = ; + ($iw, $ih) = m/^([0-9]+) ([0-9]+)$/; + close (IMG); + } + my $x = int (($screen_width - $iw) / 2); + my $y = int (($screen_height - $ih) / 2); + if ($DEBUG > 1) { + print STDERR "pasting $bgimage into base image at $x, $y\n"; + } + system "pnmpaste $bgimage $x $y $image > $tmp2 && mv $tmp2 $image"; + } + + + do { + my ($base, $img) = pick_image; + + my ($headers, $body); + if ($img) { + ($headers, $body) = get_document ($img); + } + + if ($body) { + + if ($DEBUG > 0) { + print STDERR "got $img (" . length($body) . ")\n"; + } + + my $cmd; + if ($img =~ m/\.gif/i) { + $cmd = "giftopnm"; + } else { + $cmd = "djpeg"; + } + + if ($DEBUG == 0) { + $cmd .= " 2>/dev/null"; + } + + if (open(PIPE, "| $cmd > $tmp")) { + print PIPE $body; + close PIPE; + + if ($DEBUG > 1) { + print STDERR "created $tmp ($cmd)\n"; + } + } + + if (-s $tmp) { + + if ($filter_cmd) { + if ($DEBUG > 1) { + print STDERR "running $filter_cmd\n"; + } + system "($filter_cmd) < $tmp > $tmp3 && mv $tmp3 $tmp"; + } + + my ($iw, $ih); + if (open(IMG, "<$tmp")) { + $_ = ; + $_ = ; + ($iw, $ih) = m/^([0-9]+) ([0-9]+)$/; + close (IMG); + } + + if ($iw && $ih) { + + if ($DEBUG > 1) { + print STDERR "image size is $iw x $ih\n"; + } + + if ($iw > $screen_width || $ih > $screen_height) { + while ($iw > $screen_width || + $ih > $screen_height) { + $iw = int($iw / 2); + $ih = int($ih / 2); + } + if ($DEBUG > 1) { + print STDERR "scaling to $iw x $ih\n"; + } + system "pnmscale -xysize $iw $ih $tmp > $tmp2" . + " 2>/dev/null && mv $tmp2 $tmp"; + } + + my $x = int (rand() * ($screen_width - $iw)); + my $y = int (rand() * ($screen_height - $ih)); + + if ($DEBUG > 1) { + print STDERR "pasting at $x, $y in $image\n"; + } + + system "pnmpaste $tmp $x $y $image > $tmp2 " . + "&& mv $tmp2 $image"; + + + my $target = $image; + if ($post_filter_cmd) { + if ($DEBUG > 1) { + print STDERR "running $post_filter_cmd\n"; + } + system "($post_filter_cmd) < $image > $tmp3"; + $target = $tmp3; + } + + if (!$no_output_p) { + + my $tsize = (stat($target))[7]; + if ($tsize > 200) { + $_ = $ppm_to_root_window_cmd; + s/%%PPM%%/$target/; + + if ($DEBUG > 1) { + print STDERR "running $_\n"; + } + system $_; + + } elsif ($DEBUG > 1) { + print STDERR "$target size is $tsize\n"; + } + } + } + } + unlink $tmp, $tmp2, $tmp3; + } + + sleep $delay; + + } while (1); +} + + +################################# +# +# decide how to run +# +################################# + +sub main { + srand(time ^ $$); + + my $usage ="WebCollage, Copyright (c) 1999" . + " Jamie Zawinski \n" . + " http://www.jwz.org/xscreensaver/\n"; + + if ( $progname =~ m/\.cgi$/i ) { + $#ARGV == -1 || die "$usage\nusage: $progname (no arguments)\n"; + do_html_output; + + } else { + my $root_p = 0; + + while ($_ = $ARGV[0]) { + shift @ARGV; + if ($_ eq "-display" || + $_ eq "-displ" || + $_ eq "-disp" || + $_ eq "-dis" || + $_ eq "-dpy" || + $_ eq "-d") { + $ENV{DISPLAY} = shift @ARGV; + } elsif ($_ eq "-root") { + $root_p = 1; + } elsif ($_ eq "-no-output") { + $no_output_p = 1; + } elsif ($_ eq "-verbose") { + $DEBUG++; + } elsif (m/^-v+$/) { + $DEBUG += length($_)-1; + } elsif ($_ eq "-delay") { + $delay = shift @ARGV; + } elsif ($_ eq "-timeout") { + $http_timeout = shift @ARGV; + } elsif ($_ eq "-filter") { + $filter_cmd = shift @ARGV; + } elsif ($_ eq "-filter2") { + $post_filter_cmd = shift @ARGV; + } elsif ($_ eq "-background" || $_ eq "-bg") { + $background = shift @ARGV; + } elsif ($_ eq "-size") { + $_ = shift @ARGV; + if (m@^([0-9]+)x([0-9]+)$@) { + $screen_width = $1; + $screen_height = $2; + } else { + die "$progname: argument to \"-size\" must be" . + " of the form \"640x400\"\n"; + } + } else { + die "$usage\nusage: $progname [-root]" . + " [-display dpy] [-root] [-verbose] [-timeout secs]\n" . + "\t\t [-delay secs] [-filter cmd] [-filter2 cmd]\n"; + } + } + if (!$root_p && !$no_output_p) { + die "$progname: the -root argument is manditory (for now.)\n"; + } + + if (!$no_output_p && !$ENV{DISPLAY}) { + die "$progname: \$DISPLAY is not set.\n"; + } + + do_x_output; + } +} + +main; +exit 0; diff --git a/local/bin/worm b/local/bin/worm new file mode 100755 index 00000000..c438bab3 Binary files /dev/null and b/local/bin/worm differ diff --git a/local/bin/xcoral b/local/bin/xcoral new file mode 100755 index 00000000..fc62e523 Binary files /dev/null and b/local/bin/xcoral differ diff --git a/local/bin/xflame b/local/bin/xflame new file mode 100755 index 00000000..4b952551 Binary files /dev/null and b/local/bin/xflame differ diff --git a/local/bin/xjack b/local/bin/xjack new file mode 100755 index 00000000..91f79ee1 Binary files /dev/null and b/local/bin/xjack differ diff --git a/local/bin/xjulia b/local/bin/xjulia new file mode 100755 index 00000000..4dcfc00b Binary files /dev/null and b/local/bin/xjulia differ diff --git a/local/bin/xlyap b/local/bin/xlyap new file mode 100755 index 00000000..82b994e8 Binary files /dev/null and b/local/bin/xlyap differ diff --git a/local/bin/xmatrix b/local/bin/xmatrix new file mode 100755 index 00000000..50603dfb Binary files /dev/null and b/local/bin/xmatrix differ diff --git a/local/bin/xroger b/local/bin/xroger new file mode 100755 index 00000000..30a52caa Binary files /dev/null and b/local/bin/xroger differ diff --git a/local/bin/xscreensaver b/local/bin/xscreensaver new file mode 100755 index 00000000..2ce5a473 Binary files /dev/null and b/local/bin/xscreensaver differ diff --git a/local/bin/xscreensaver-command b/local/bin/xscreensaver-command new file mode 100755 index 00000000..0f3bad63 Binary files /dev/null and b/local/bin/xscreensaver-command differ diff --git a/local/bin/xscreensaver-demo b/local/bin/xscreensaver-demo new file mode 100755 index 00000000..b6c50f7e Binary files /dev/null and b/local/bin/xscreensaver-demo differ diff --git a/local/man/cat.1/attraction.1 b/local/man/cat.1/attraction.1 new file mode 100644 index 00000000..629557b5 --- /dev/null +++ b/local/man/cat.1/attraction.1 @@ -0,0 +1,264 @@ + + + +XScreenSaver(1) XScreenSaver(1) + + +NNAAMMEE + attraction - interactions of opposing forces + +SSYYNNOOPPSSIISS + aattttrraaccttiioonn [-display _h_o_s_t_:_d_i_s_p_l_a_y_._s_c_r_e_e_n] [-foreground + _c_o_l_o_r] [-background _c_o_l_o_r] [-window] [-root] [-mono] + [-install] [-visual _v_i_s_u_a_l] [-points _i_n_t] [-threshold _i_n_t] + [-mode balls | lines | polygons | splines | filled-splines + | tails ] [-size _i_n_t] [-segments _i_n_t] [-delay _u_s_e_c_s] + [-color-shift _i_n_t] [-radius _i_n_t] [-vx _i_n_t] [-vy _i_n_t] + [-glow] [-noglow] [-orbit] [-viscosity _f_l_o_a_t] [-mouse] + [-no-mouse] [-mouse-size] + +DDEESSCCRRIIPPTTIIOONN + The _a_t_t_r_a_c_t_i_o_n program has several visually different + modes of operation, all of which are based on the interac- + tions of a set of control points which attract each other + up to a certain distance, and then begin to repel each + other. The attraction/repulsion is proportional to the + distance between any two particles. + +OOPPTTIIOONNSS + _a_t_t_r_a_c_t_i_o_n accepts the following options: + + --wwiinnddooww Draw on a newly-created window. This is the + default. + + --rroooott Draw on the root window. + + --mmoonnoo If on a color display, pretend we're on a + monochrome display. + + --iinnssttaallll + Install a private colormap for the window. + + --vviissuuaall _v_i_s_u_a_l + 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. + + --ppooiinnttss iinntteeggeerr + How many control points should be used, or 0 to + select the number randomly. Default 0. Between 3 + and 15 works best. + + --tthhrreesshhoolldd iinntteeggeerr + The distance (in pixels) from each particle at + which the attractive force becomes repulsive. + Default 100. + + --mmooddee bbaallllss || lliinneess || ppoollyyggoonnss || ttaaiillss || sspplliinneess || ffiilllleedd-- + sspplliinneess + In _b_a_l_l_s mode (the default) the control points are + drawn as filled circles. The larger the circle, + + + +X Version 11 14-Jun-97 1 + + + + + +XScreenSaver(1) XScreenSaver(1) + + + the more massive the particle. + + In _l_i_n_e_s mode, the control points are connected by + straight lines; the effect is something like _q_i_x. + + In _p_o_l_y_g_o_n_s mode, the control points are connected + by straight lines, and filled in. This is most + interesting in color. + + In _s_p_l_i_n_e_s mode, a closed spline is interpolated + from the control points. + + In _f_i_l_l_e_d_-_s_p_l_i_n_e_s mode, the splines are filled in + instead of being outlines. This is most interest- + ing in color. + + In _t_a_i_l_s mode, the path which each particle fol- + lows is indicated by a worm-like trail, whose + length is controlled by the _s_e_g_m_e_n_t_s parameter. + + --ssiizzee iinntteeggeerr + The size of the balls in pixels, or 0, meaning to + select the sizes randomly (the default.) If this + is specified, then all balls will be the same + size. This option has an effect in all modes, + since the ``size'' of the balls controls their + mass. + + --sseeggmmeennttss iinntteeggeerr + If in _l_i_n_e_s or _p_o_l_y_g_o_n_s mode, how many sets of + line segments or polygons should be drawn. Default + 100. This has no effect in _b_a_l_l_s mode. If _s_e_g_- + _m_e_n_t_s is 0, then no segments will ever be erased + (this is only useful in color.) + + --ddeellaayy mmiiccrroosseeccoonnddss + How much of a delay should be introduced between + steps of the animation. Default 10000, or about + 0.01 seconds. + + --ccoolloorr--sshhiifftt iinntt + If on a color display, the color of the line seg- + ments or polygons will cycle through the color + map. This specifies how many lines will be drawn + before a new color is chosen. (When a small num- + ber of colors are available, increasing this value + will yield smoother transitions.) Default 3. + This has no effect in _b_a_l_l_s mode. + + --rraaddiiuuss The size in pixels of the circle on which the + points are initially positioned. The default is + slightly smaller than the size of the window. + + --ggllooww This is consulted only in _b_a_l_l_s mode. If this is + + + +X Version 11 14-Jun-97 2 + + + + + +XScreenSaver(1) XScreenSaver(1) + + + specified, then the saturation of the colors of + the points will vary according to their current + acceleration. This has the effect that the balls + flare brighter when they are reacting to each + other most strongly. + + In _g_l_o_w mode, all of the balls will be drawn the + same (random) color, modulo the saturation shifts. + In non-glow mode, the balls will each be drawn in + a random color that doesn't change. + + --nnooggllooww Don't do ``glowing.'' This is the default. + + --vvxx ppiixxeellss + + --vvyy ppiixxeellss + Initial velocity of the balls. This has no effect + in --oorrbbiitt mode. + + --oorrbbiitt Make the initial force on each ball be tangential + to the circle on which they are initially placed, + with the right velocity to hold them in orbit + about each other. After a while, roundoff errors + will cause the orbit to decay. + + --vvmmuulltt ffllooaatt + In orbit mode, the initial velocity of the balls + is multiplied by this; a number less than 1 will + make the balls pull closer together, and a larger + number will make them move apart. The default is + 0.9, meaning a slight inward pull. + + --vviissccoossiittyy ffllooaatt + This sets the viscosity of the hypothetical fluid + through which the control points move; the default + is 1, meaning no resistance. Values higher than 1 + aren't interesting; lower values cause less + motion. + + One interesting thing to try is + + attraction -viscosity 0.8 -points 75 \ + -mouse -geometry =500x500 + + Give it a few seconds to settle down into a stable + clump, and then move the mouse through it to make + "waves". + + --mmoouussee This will cause the mouse to be considered a con- + trol point; it will not be drawn, but it will + influence the other points, so you can wave the + mouse and influence the images being created. + + + + + +X Version 11 14-Jun-97 3 + + + + + +XScreenSaver(1) XScreenSaver(1) + + + --nnoo--mmoouussee + Turns off --mmoouussee. + + --mmoouussee--ssiizzee iinntteeggeerr + In --mmoouussee mode, this sets the mass of the mouse + (analagously to the --ssiizzee parameter.) + +EENNVVIIRROONNMMEENNTT + DDIISSPPLLAAYY to get the default host and display number. + + XXEENNVVIIRROONNMMEENNTT + to get the name of a resource file that overrides + the global resources stored in the RESOURCE_MAN- + AGER property. + +SSEEEE AALLSSOO + XX(1), xxssccrreeeennssaavveerr(1) + +CCOOPPYYRRIIGGHHTT + Copyright (C) 1992, 1993, 1997 by Jamie Zawinski. Permis- + sion to use, copy, modify, distribute, and sell this soft- + ware and its documentation for any purpose 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 representations are made about the + suitability of this software for any purpose. It is pro- + vided "as is" without express or implied warranty. + +AAUUTTHHOORR + Jamie Zawinski , 13-aug-92. + + Viscosity and mouse support by Philip Edward Cutone, III. + + + + + + + + + + + + + + + + + + + + + + + + +X Version 11 14-Jun-97 4 + + diff --git a/local/man/cat.1/blitspin.1 b/local/man/cat.1/blitspin.1 new file mode 100644 index 00000000..a87f7718 --- /dev/null +++ b/local/man/cat.1/blitspin.1 @@ -0,0 +1,198 @@ + + + +XScreenSaver(1) XScreenSaver(1) + + +NNAAMMEE + blitspin - rotate a bitmap in an interesting way + +SSYYNNOOPPSSIISS + bblliittssppiinn [-display _h_o_s_t_:_d_i_s_p_l_a_y_._s_c_r_e_e_n] [-foreground + _c_o_l_o_r] [-background _c_o_l_o_r] [-window] [-root] [-mono] + [-install] [-visual _v_i_s_u_a_l] [-bitmap _f_i_l_e_n_a_m_e] [-delay + _u_s_e_c_s] [-delay2 _u_s_e_c_s] + +DDEESSCCRRIIPPTTIIOONN + The _b_l_i_t_s_p_i_n program repeatedly rotates a bitmap by 90 + degrees by using logical operations: the bitmap is divided + into quadrants, and the quadrants are shifted clockwise. + Then the same thing is done again with progressively + smaller quadrants, except that all sub-quadrants of a + given size are rotated in parallel. So this takes + OO((1166**lloogg22((NN)))) blits of size NxN, with the limitation that + the image must be square, and the size must be a power of + 2. + +OOPPTTIIOONNSS + _b_l_i_t_s_p_i_n accepts the following options: + + --wwiinnddooww Draw on a newly-created window. This is the + default. + + --rroooott Draw on the root window. + + --mmoonnoo If on a color display, pretend we're on a + monochrome display. + + --iinnssttaallll + Install a private colormap for the window. + + --vviissuuaall _v_i_s_u_a_l + 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. + + --bbiittmmaapp _f_i_l_e_n_a_m_e + The file name of a bitmap to rotate. It need not + be square: it will be padded with the background + color. If unspecified or the string _(_d_e_f_a_u_l_t_), a + builtin bitmap is used. + + If support for the _X_P_M library was enabled at com- + pile-time, the specified file may be in _X_P_M format + as well as _X_B_M, and thus may be a color image. + + The **bbiittmmaappFFiilleePPaatthh resource will be searched if + the bitmap name is not a fully-qualified pathname. + + --ggrraabb--ssccrreeeenn + If this option is specified, then the image which + + + +X Version 11 24-Nov-97 1 + + + + + +XScreenSaver(1) XScreenSaver(1) + + + is spun will be grabbed from the portion of the + screen underlying the blitspin window. (Or, it + may come from an external video source: see + below.) + + + --ddeellaayy _m_i_c_r_o_s_e_c_o_n_d_s + How long to delay between steps of the rotation + process, in microseconds. Default is 500000, one- + half second. + + + --ddeellaayy22 _m_i_c_r_o_s_e_c_o_n_d_s + How long to delay between each 90-degree rotation, + in microseconds. Default is 500000, one-half sec- + ond. DDIISSPPLLAAYY to get the default host and display + number. + +RREESSOOUURRCCEESS + On some systems (currently, only SGIs), this program can, + instead of grabbing a desktop image, grab a frame of video + from an external camera and manipulate that instead. The + following resources control that. + + + ggrraabbVViiddeeooPPrroobbaabbiilliittyy (Float) + What portion of the time to grab video rather than + a screen image, between 0.0 and 1.0. Defaults to + 0.5, or half the time. + + vviiddeeooDDeevviiccee (Integer) + The number of the default video input device to + check first. If unspecified, the default camera + (from videopanel(1)) will be checked first. After + that, all other available video input devices will + be checked in order. + + The first one which produces a non-black image + will be used. If all images are black, the others + will be re-checked a few times before giving up + and falling back to simply grabbing a desktop + image (but note that this takes a few seconds, so + if you don't actually have any video sources + hooked up, you should consider turning off video + grabbing by setting ggrraabbVViiddeeooPPrroobbaabbiilliittyy to 0.0.) + + vviiddeeooGGaaiinn (Float) + The amount by which to brighten the grabbed image. + This defaults to 2.2. + +EENNVVIIRROONNMMEENNTT + XXEENNVVIIRROONNMMEENNTT to get the name of a resource file that over- + rides the global resources stored in the RESOURCE_MANAGER + property. + + + +X Version 11 24-Nov-97 2 + + + + + +XScreenSaver(1) XScreenSaver(1) + + +SSEEEE AALLSSOO + XX(1), xxssccrreeeennssaavveerr(1) + +CCOOPPYYRRIIGGHHTT + Copyright (C) 1992, 1993, 1997 by Jamie Zawinski. Permis- + sion to use, copy, modify, distribute, and sell this soft- + ware and its documentation for any purpose 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 representations are made about the + suitability of this software for any purpose. It is pro- + vided "as is" without express or implied warranty. + +AAUUTTHHOORR + Jamie Zawinski , 17-aug-92. + + Based on SmallTalk code which appeared in the August 1981 + issue of Byte magazine. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +X Version 11 24-Nov-97 3 + + diff --git a/local/man/cat.1/bouboule.1 b/local/man/cat.1/bouboule.1 new file mode 100644 index 00000000..852fcc70 --- /dev/null +++ b/local/man/cat.1/bouboule.1 @@ -0,0 +1,132 @@ + + + +XScreenSaver(1) XScreenSaver(1) + + +NNAAMMEE + bouboule - draws spinning 3D blobs + +SSYYNNOOPPSSIISS + bboouubboouullee [-display _h_o_s_t_:_d_i_s_p_l_a_y_._s_c_r_e_e_n] [-foreground + _c_o_l_o_r] [-background _c_o_l_o_r] [-window] [-root] [-mono] + [-install] [-visual _v_i_s_u_a_l] [-ncolors _i_n_t_e_g_e_r] [-delay + _m_i_c_r_o_s_e_c_o_n_d_s] [-cycles _i_n_t_e_g_e_r] [-count _i_n_t_e_g_e_r] [-3d] + + +DDEESSCCRRIIPPTTIIOONN + The _b_o_u_b_o_u_l_e program draws spinning 3D blobs. + +OOPPTTIIOONNSS + _b_o_u_b_o_u_l_e accepts the following options: + + --wwiinnddooww Draw on a newly-created window. This is the + default. + + --rroooott Draw on the root window. + + --mmoonnoo If on a color display, pretend we're on a + monochrome display. + + --iinnssttaallll + Install a private colormap for the window. + + --vviissuuaall _v_i_s_u_a_l + 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. + + --nnccoolloorrss _i_n_t_e_g_e_r + How many colors should be used (if possible). + Default 64. The colors used cycle through the + hue, making N stops around the color wheel. + + --ccyycclleess _i_n_t_e_g_e_r + + + --ccoouunntt _i_n_t_e_g_e_r + + + --33dd Do red/blue 3d separations (for 3d glasses.) + + +EENNVVIIRROONNMMEENNTT + DDIISSPPLLAAYY to get the default host and display number. + + XXEENNVVIIRROONNMMEENNTT + to get the name of a resource file that overrides + the global resources stored in the RESOURCE_MAN- + AGER property. + + + + +X Version 11 15-May-97 1 + + + + + +XScreenSaver(1) XScreenSaver(1) + + +SSEEEE AALLSSOO + XX(1), xxssccrreeeennssaavveerr(1), xxlloocckk(1) + +CCOOPPYYRRIIGGHHTT + Copyright (C) 1996 by Jeremie Petit. + + Permission to use, copy, modify, and distribute this soft- + ware and its documentation for any purpose and without fee + is hereby granted, provided that the above copyright + notice appear in all copies and that both that copyright + notice and this permission notice appear in supporting + documentation. + + +AAUUTTHHOORR + Jeremie Petit , 1996. + + 3D support by Henrik Theiling , + 04-Sep-96. + + VMS support by Jouk Jansen , + 01-Feb-96. + + TrueColor support by David Bagley , + 01-Feb-96. + + Ability to run standalone or with _x_s_c_r_e_e_n_s_a_v_e_r added by + Jamie Zawinski , 15-May-97. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +X Version 11 15-May-97 2 + + diff --git a/local/man/cat.1/braid.1 b/local/man/cat.1/braid.1 new file mode 100644 index 00000000..06d8d11d --- /dev/null +++ b/local/man/cat.1/braid.1 @@ -0,0 +1,132 @@ + + + +XScreenSaver(1) XScreenSaver(1) + + +NNAAMMEE + braid - draws random color-cycling braids around a circle + +SSYYNNOOPPSSIISS + bbrraaiidd [-display _h_o_s_t_:_d_i_s_p_l_a_y_._s_c_r_e_e_n] [-foreground _c_o_l_o_r] + [-background _c_o_l_o_r] [-window] [-root] [-mono] [-install] + [-visual _v_i_s_u_a_l] [-ncolors _i_n_t_e_g_e_r] [-delay _m_i_c_r_o_s_e_c_o_n_d_s] + [-cycles _i_n_t_e_g_e_r] [-count _i_n_t_e_g_e_r] + + +DDEESSCCRRIIPPTTIIOONN + The _b_r_a_i_d program draws random color-cycling braids around + a circle. + +OOPPTTIIOONNSS + _b_r_a_i_d accepts the following options: + + --wwiinnddooww Draw on a newly-created window. This is the + default. + + --rroooott Draw on the root window. + + --mmoonnoo If on a color display, pretend we're on a + monochrome display. + + --iinnssttaallll + Install a private colormap for the window. + + --vviissuuaall _v_i_s_u_a_l + 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. + + --nnccoolloorrss _i_n_t_e_g_e_r + How many colors should be used (if possible). + Default 64. The colors used cycle through the + hue, making N stops around the color wheel. + + --ccyycclleess _i_n_t_e_g_e_r + + + --ccoouunntt _i_n_t_e_g_e_r + + +EENNVVIIRROONNMMEENNTT + DDIISSPPLLAAYY to get the default host and display number. + + XXEENNVVIIRROONNMMEENNTT + to get the name of a resource file that overrides + the global resources stored in the RESOURCE_MAN- + AGER property. + +SSEEEE AALLSSOO + XX(1), xxssccrreeeennssaavveerr(1), xxlloocckk(1) + + + +X Version 11 10-May-97 1 + + + + + +XScreenSaver(1) XScreenSaver(1) + + +CCOOPPYYRRIIGGHHTT + Copyright (C) 1995 by John Neil. + + Permission to use, copy, modify, and distribute this soft- + ware and its documentation for any purpose and without fee + is hereby granted, provided that the above copyright + notice appear in all copies and that both that copyright + notice and this permission notice appear in supporting + documentation. + +AAUUTTHHOORR + John Neil , 29-Aug-95. + + Ability to run standalone or with _x_s_c_r_e_e_n_s_a_v_e_r added by + Jamie Zawinski , 10-May-97. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +X Version 11 10-May-97 2 + + diff --git a/local/man/cat.1/bsod.1 b/local/man/cat.1/bsod.1 new file mode 100644 index 00000000..52d9d203 --- /dev/null +++ b/local/man/cat.1/bsod.1 @@ -0,0 +1,198 @@ + + + +XScreenSaver(1) XScreenSaver(1) + + +NNAAMMEE + bsod - Blue Screen of Death emulator + +SSYYNNOOPPSSIISS + bbssoodd [-display _h_o_s_t_:_d_i_s_p_l_a_y_._s_c_r_e_e_n] [-foreground _c_o_l_o_r] + [-background _c_o_l_o_r] [-window] [-root] [-mono] [-install] + [-visual _v_i_s_u_a_l] [-delay _s_e_c_o_n_d_s] + +DDEESSCCRRIIPPTTIIOONN + The _b_s_o_d program is the finest in personal computer emula- + tion. + + _b_s_o_d steps through a set of screens, each one a recreation + of a different failure mode of an operating system. Sys- + tems depicted include Microsoft's Windows 95 and Windows + NT, Commodore-Amiga's AmigaDOS 1.3, SPARC Linux, SCO UNIX, + the Apple Macintosh (both the MacsBug debugger and the + rarer "Sad Mac"), and the Atari ST. + + +OOPPTTIIOONNSS + _b_s_o_d accepts the following options: + + --wwiinnddooww Draw on a newly-created window. This is the + default. + + --rroooott Draw on the root window. + + --mmoonnoo If on a color display, pretend we're on a + monochrome display. + + --iinnssttaallll + Install a private colormap for the window. + + --vviissuuaall _v_i_s_u_a_l + 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. + + --ddeellaayy _d_e_l_a_y + The delay between displaying one crash and + another. + +EENNVVIIRROONNMMEENNTT + DDIISSPPLLAAYY to get the default host and display number. + + XXEENNVVIIRROONNMMEENNTT + to get the name of a resource file that overrides + the global resources stored in the RESOURCE_MAN- + AGER property. + +XX RREESSOOUURRCCEESS + Notable X resources supported include the following, which + control which hacks are displayed and which aren't. + + + +X Version 11 28-Oct-98 1 + + + + + +XScreenSaver(1) XScreenSaver(1) + + + ddooWWiinnddoowwss, ddooNNTT, ddooAAmmiiggaa, ddooMMaacc, ddooMMaaccssBBuugg, ddooSSCCOO, + ddooAAttaarrii, and ddooSSppaarrccLLiinnuuxx. Each of these is a Boolean + resource, they all default to true, except for doSpar- + cLinux and doAtari, which are turned off by default, + because they're really not all that interesting looking + unless you're a fan of those systems. There aren't com- + mand-line options for these, so to change them, you'll + need to add entries to your .Xdefaults file, or use the + -xrm option. For example, to tell bsod not to show the NT + crash: + + bsod -xrm '*doNT: false' + + +BBUUGGSS + Unlike the systems that the images are borrowed from, _b_s_o_d + does not require a reboot after running. + + _b_s_o_d should also emulate more systems, but systems with + interesting crash graphics are not as common as one might + hope. + + One I'd really like to see is a Unix system getting a ker- + nel panic, rebooting, and running ffsscckk(8). + +SSEEEE AALLSSOO + XX(1), xxssccrreeeennssaavveerr(1), hhttttpp::////wwwwww..mmiiccrroossoofftt..ccoomm//, + hhttttpp::////wwwwww..aappppllee..ccoomm//, and hhttttpp::////wwwwww..ssccoo..ccoomm//, + hhttttpp::////wwwwww..kkeerrnneell..oorrgg//, and hhttttpp::////wwwwww..aammiiggaa..ddee//. + +TTRRAADDEEMMAARRKKSS + Microsoft Windows, Microsoft Windows 95, and Microsoft + Windows NT are all registered trademarks of Microsoft Cor- + poration. Apple Macintosh is a registered trademark of + Apple Computer. Amiga is a registered trademark of Amiga + International, Inc. Atari ST is probably a trademark, + too, but it's hard to tell who owns it. Linux is a regis- + tered trademark of Linus Torvalds, but it isn't his fault. + +CCOOPPYYRRIIGGHHTT + Copyright (C) 1998 by Jamie Zawinski. Permission to use, + copy, modify, distribute, and sell this software and its + documentation for any purpose 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 + representations are made about the suitability of this + software for any purpose. It is provided "as is" without + express or implied warranty. No animals were harmed dur- + ing the testing of these simulations. Always mount a + scratch monkey. + +AAUUTTHHOORR + Concept cribbed from Stephen Martin . + + + +X Version 11 28-Oct-98 2 + + + + + +XScreenSaver(1) XScreenSaver(1) + + + This version is by Jamie Zawinski . + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +X Version 11 28-Oct-98 3 + + diff --git a/local/man/cat.1/bubbles.1 b/local/man/cat.1/bubbles.1 new file mode 100644 index 00000000..27e7ed82 --- /dev/null +++ b/local/man/cat.1/bubbles.1 @@ -0,0 +1,198 @@ + + + +XScreenSaver(1) XScreenSaver(1) + + +NNAAMMEE + bubbles - frying pan / soft drink simulation + +SSYYNNOOPPSSIISS + bbuubbbblleess [-display _h_o_s_t_:_d_i_s_p_l_a_y_._s_c_r_e_e_n] [-foreground _c_o_l_o_r] + [-background _c_o_l_o_r] [-window] [-root] [-mono] [-install] + [-visual _v_i_s_u_a_l] [-simple] [-broken] [-3D] [-file file- + name] [-directory directoryname] + +DDEESSCCRRIIPPTTIIOONN + _B_u_b_b_l_e_s sprays lots of little random bubbles all over the + window which then grow until they reach their maximum size + and go pop. The inspiration for this was watching little + globules of oil on the bottom of a frying pan and it also + looks a little like bubbles in fizzy soft drink. The + default mode uses fancy ray-traced bubbles but there is + also a mode which just draws circles in case the default + mode is too taxing on your hardware. + +OOPPTTIIOONNSS + Depending on how your _b_u_b_b_l_e_s was compiled, it accepts the + following options: + + --ffoorreeggrroouunndd + Colour of circles if _-_s_i_m_p_l_e mode is selected. + + --bbaacckkggrroouunndd + Colour of window background. + + --wwiinnddooww Draw on a newly-created window. This is the + default. + + --rroooott Draw on the root window. + + --mmoonnoo If on a color display, pretend we're on a + monochrome display. + + --iinnssttaallll + Install a private colormap for the window. + + --vviissuuaall _v_i_s_u_a_l + 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. + + --ddeellaayy mmiiccrroosseeccoonnddss + How much of a delay should be introduced between + steps of the animation. Default 1, or about 1 + microsecond. Actually, this is the delay between + each group of 15 new bubbles since such a delay + between each step results in a very slow animation + rate. + + + + + +X Version 11 14-Dec-95 1 + + + + + +XScreenSaver(1) XScreenSaver(1) + + + --nnooddeellaayy + Same as _-_d_e_l_a_y _0. + + --ssiimmppllee Don't use the default fancy pixmap bubbles. Just + draw circles instead. This may give more bearable + performance if your hardware wasn't made for this + sort of thing. + + --bbrrookkeenn Don't hide bubbles when they pop. This was a bug + during development but the results were actually + quite attractive. (This option is only available + if you have the XPM library available and the + imake generated Makefile has defined HAVE_XPM). + + --33DD Normally, the simulation is done completely in two + dimensions. When a bubble swallows up another + bubble, the areas of each are added to get the + area of the resulting bubble. This option changes + the algorithm to instead add volume (imagining + each to be a sphere in 3D space). The whole thing + looks more realistic but I find it attracts atten- + tion to the flickering of each bubble as they are + move and are redrawn. Your mileage may vary. + + --ffiillee ffiilleennaammee + Use the pixmap definitions in the given file, + instead of the default (if one is compiled in). + This is ignored if _-_s_i_m_p_l_e is specified. If the + file is compressed (either with compress or gzip), + it is decompressed before use. (This option only + works if you have XPM compiled into your binary + and you have compiled with BUBBLES_IO set in bub- + bles.h. This is nnoott the default). + + --ddiirreeccttoorryy ddiirreeccttoorryynnaammee + Similar to _-_f_i_l_e except the file is taken randomly + from the contents of the specified directory. + (Again, this option is only available if you have + XPM and BUBBLES_IO was set when compiling. See + above). + + --qquuiieett Don't print messages explaining why one or several + command line options were ignored. This is dis- + abled by default. + +NNOOTTEESS + If you find the pace of things too slow, remember that + there is a delay even though you specify no _-_d_e_l_a_y option. + Try using _-_n_o_d_e_l_a_y although beware of the effects of irri- + tation of other users if you're on a shared system as you + bleed their CPU time away. + + Some tools to assist in creation of new bubbles are + included in the source distribution. These can either be + + + +X Version 11 14-Dec-95 2 + + + + + +XScreenSaver(1) XScreenSaver(1) + + + loaded with the _-_f_i_l_e or _-_d_i_r_e_c_t_o_r_y options (if available) + or they can be used in place of the distributed default + bubble (bubble_default.c). You might like to copy these + scripts to a permanent location and use them. Read bub- + bles.README. + + Rendered bubbles are not supported on monochrome displays. + I'm not convinced that small bubbles, even dithered prop- + erly are going to look like anything more than a jumble of + random dots. + +BBUUGGSS + There is a delay before something appears on the screen + when using rendered bubbles. The XPM library seems to + take a lloonngg time to make pixmaps out of raw data. This + can be irritating on slower systems. + + The movement of the bubbles looks jerky if an incomplete + set of bubbles is used. + + The hide/display algorithm could do with some work to + avoid flickering when _-_n_o_d_e_l_a_y is set. + +EENNVVIIRROONNMMEENNTT + DDIISSPPLLAAYY to get the default host and display number. + + XXEENNVVIIRROONNMMEENNTT + to get the name of a resource file that overrides + the global resources stored in the RESOURCE_MAN- + AGER property. + +SSEEEE AALLSSOO + XX(1), xxssccrreeeennssaavveerr(1) + +DDIISSTTRRIIBBUUTTIIOONN PPOOLLIICCYY + This work is Copyright (C) 1995, 1996 by James Macnicol. + Distribution is allowed under the terms of the GNU General + Public License. Look at the sources for the legalese. + +AAUUTTHHOORR + James Macnicol . + + + + + + + + + + + + + + + + +X Version 11 14-Dec-95 3 + + diff --git a/local/man/cat.1/critical.1 b/local/man/cat.1/critical.1 new file mode 100644 index 00000000..a28582d6 --- /dev/null +++ b/local/man/cat.1/critical.1 @@ -0,0 +1,132 @@ + + + +XScreenSaver(1) XScreenSaver(1) + + +NNAAMMEE + critical - Draw a system showing self-organizing critical- + ity + +SSYYNNOOPPSSIISS + ccrriittiiccaall [-display _h_o_s_t_:_d_i_s_p_l_a_y_._s_c_r_e_e_n] [-foreground + _c_o_l_o_r] [-background _c_o_l_o_r] [-window] [-root] [-mono] + [-install] [-visual _v_i_s_u_a_l] [-delay _s_e_c_o_n_d_s] [-random + _b_o_o_l_e_a_n] [-ncolors _i_n_t] [-offset _i_n_t] + +DDEESSCCRRIIPPTTIIOONN + The _c_r_i_t_i_c_a_l program displays a self-organizing critical + system that gradually emerges from chaos. + + _c_r_i_t_i_c_a_l performs a simulation on a two-dimensional array + of integers. The array is initialized to random values. + On each iteration, it draws a line to the array position + with the greatest value. It then replaces that location + and the eight neighboring locations with randomly-selected + values. + + The lines are initially random, but over time a chaotic + self-organizing system evolves: areas of the screen which + happen to have lower values are less likely to be updated + to new values, and so the line tends to avoid those areas. + Eventually, the histogram of changes approaches the power- + law curve typical of such systems. + + The simplest documented self-organizing system is the one- + dimensional equivalent of _c_r_i_t_i_c_a_l. + + I heard about this algorithm second-hand: apparently there + was an article in _S_c_i_e_n_t_i_f_i_c _A_m_e_r_i_c_a_n describing it some- + time in 1997. + +OOPPTTIIOONNSS + _c_r_i_t_i_c_a_l accepts the following options: + + --wwiinnddooww Draw on a newly-created window. This is the + default. + + --rroooott Draw on the root window. + + --mmoonnoo If on a color display, pretend we're on a + monochrome display. + + --iinnssttaallll + Install a private colormap for the window. + + --vviissuuaall _v_i_s_u_a_l + 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. + + + + +X Version 11 13-Nov-98 1 + + + + + +XScreenSaver(1) XScreenSaver(1) + + + --ddeellaayy _u_s_e_c_s + Number of microseconds to wait after drawing each + line. + + --rraannddoomm _b_o_o_l_e_a_n + Whether to use randomly selected colours rather + than a cycle around the colour wheel. + + --ooffffsseett _i_n_t_e_g_e_r + The maximum random radius increment to use. + + --nnccoolloorrss _i_n_t_e_g_e_r + How many colors should be allocated in the color + ramp (note that this value interacts with _o_f_f_s_e_t.) + +EENNVVIIRROONNMMEENNTT + DDIISSPPLLAAYY to get the default host and display number. + + XXEENNVVIIRROONNMMEENNTT + to get the name of a resource file that overrides + the global resources stored in the RESOURCE_MAN- + AGER property. + +SSEEEE AALLSSOO + XX(1), xxssccrreeeennssaavveerr(1) xxssccrreeeennssaavveerr--ccoommmmaanndd(1) xxssccrreeeenn-- + ssaavveerr--ddeemmoo(1) + +CCOOPPYYRRIIGGHHTT + Copyright (C) 1998 by Martin Pool. + + Permission to use, copy, modify, distribute, and sell this + software and its documentation for any purpose 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 representations are made about the + suitability of this software for any purpose. It is pro- + vided "as is" without express or implied warranty. + +AAUUTTHHOORR + Martin Pool , 13-Nov-1998. Based in + part on the XScreenSaver code by Jamie Zawinski + . + + + + + + + + + + + + + + +X Version 11 13-Nov-98 2 + + diff --git a/local/man/cat.1/decayscreen.1 b/local/man/cat.1/decayscreen.1 new file mode 100644 index 00000000..8c3b79ca --- /dev/null +++ b/local/man/cat.1/decayscreen.1 @@ -0,0 +1,132 @@ + + + +XScreenSaver(1) XScreenSaver(1) + + +NNAAMMEE + decayscreen - make a screen meltdown. + +SSYYNNOOPPSSIISS + ddeeccaayyssccrreeeenn [-display _h_o_s_t_:_d_i_s_p_l_a_y_._s_c_r_e_e_n] [-window] + [-root] [-mono] [-install] [-visual _v_i_s_u_a_l] [-delay _u_s_e_c_s] + [-mode _m_o_d_e] + +DDEESSCCRRIIPPTTIIOONN + The _d_e_c_a_y_s_c_r_e_e_n program creates a melting effect by ran- + domly shifting rectangles around the screen. + +OOPPTTIIOONNSS + _d_e_c_a_y_s_c_r_e_e_n accepts the following options: + + --wwiinnddooww Draw on a newly-created window. This is the + default. + + --rroooott Draw on the root window. + + --mmoonnoo If on a color display, pretend we're on a + monochrome display. + + --iinnssttaallll + Install a private colormap for the window. + + --vviissuuaall _v_i_s_u_a_l + 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. + + --ddeellaayy _m_i_c_r_o_s_e_c_o_n_d_s + Slow it down. + + --mmooddee _m_o_d_e + The direction in which the image should tend to + slide. Legal values are _r_a_n_d_o_m (meaning pick + one), _u_p, _l_e_f_t, _r_i_g_h_t, _d_o_w_n, _u_p_l_e_f_t, _d_o_w_n_l_e_f_t, + _u_p_r_i_g_h_t, _d_o_w_n_r_i_g_h_t, _s_h_u_f_f_l_e (meaning perfer no + particular direction), _i_n (meaning move things + toward the center), _o_u_t (meaning move things away + from the center), _m_e_l_t (meaning melt straight + downward), and _s_t_r_e_t_c_h (meaning stretch the screen + downward). + +RREESSOOUURRCCEESS + On some systems (currently, only SGIs), this program can, + instead of grabbing a desktop image, grab a frame of video + from an external camera and manipulate that instead. The + following resources control that. + + + ggrraabbVViiddeeooPPrroobbaabbiilliittyy (Float) + What portion of the time to grab video rather than + + + +X Version 11 05-Apr-1999 1 + + + + + +XScreenSaver(1) XScreenSaver(1) + + + a screen image, between 0.0 and 1.0. Defaults to + 0.5, or half the time. + + vviiddeeooDDeevviiccee (Integer) + The number of the default video input device to + check first. If unspecified, the default camera + (from videopanel(1)) will be checked first. After + that, all other available video input devices will + be checked in order. + + The first one which produces a non-black image + will be used. If all images are black, the others + will be re-checked a few times before giving up + and falling back to simply grabbing a desktop + image (but note that this takes a few seconds, so + if you don't actually have any video sources + hooked up, you should consider turning off video + grabbing by setting ggrraabbVViiddeeooPPrroobbaabbiilliittyy to 0.0.) + + vviiddeeooGGaaiinn (Float) + The amount by which to brighten the grabbed image. + This defaults to 2.2. + +EENNVVIIRROONNMMEENNTT + DDIISSPPLLAAYY to get the default host and display number. + + XXEENNVVIIRROONNMMEENNTT + to get the name of a resource file that overrides + the global resources stored in the RESOURCE_MAN- + AGER property. + +SSEEEE AALLSSOO + X(1), xscreensaver(1) + +CCOOPPYYRRIIGGHHTT + Copyright 1992 by Vivek Khera. Permission to use, copy, + modify, distribute, and sell this software and its docu- + mentation for any purpose is hereby granted without fee, + provided that the above copyright notice appear in all + copies and that both that copyright notice and this per- + mission notice appear in supporting documentation. No + representations are made about the suitability of this + software for any purpose. It is provided "as is" without + express or implied warranty. + +AAUUTTHHOORR + Vivek Khera , 05-Aug-93; based on code + by David Wald, 1988. Modified by jwz, 28-Nov-97. Modi- + fied by Rick Schultz 05-Apr-1999. + + + + + + + + +X Version 11 05-Apr-1999 2 + + diff --git a/local/man/cat.1/deco.1 b/local/man/cat.1/deco.1 new file mode 100644 index 00000000..19a479d7 --- /dev/null +++ b/local/man/cat.1/deco.1 @@ -0,0 +1,132 @@ + + + +XScreenSaver(1) XScreenSaver(1) + + +NNAAMMEE + deco - draw tacky 70s basement wall panelling + +SSYYNNOOPPSSIISS + ddeeccoo [-display _h_o_s_t_:_d_i_s_p_l_a_y_._s_c_r_e_e_n] [-foreground _c_o_l_o_r] + [-background _c_o_l_o_r] [-window] [-root] [-mono] [-install] + [-visual _v_i_s_u_a_l] [-delay _s_e_c_o_n_d_s] [-max-depth _i_n_t] + [-min-width _i_n_t] [-min-height _i_n_t] [-cycle] [-no-cycle] + [-cycle-delay] + +DDEESSCCRRIIPPTTIIOONN + The _d_e_c_o program subdivides and colors rectangles ran- + domly. It looks kind of like Brady-Bunch-era rec-room + wall paneling. (Raven says: "this screensaver is ugly + enough to peel paint.") + +OOPPTTIIOONNSS + _d_e_c_o accepts the following options: + + --wwiinnddooww Draw on a newly-created window. This is the + default. + + --rroooott Draw on the root window. + + --mmoonnoo If on a color display, pretend we're on a + monochrome display. + + --iinnssttaallll + Install a private colormap for the window. + + --vviissuuaall _v_i_s_u_a_l + 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. + + --ddeellaayy _s_e_c_o_n_d_s + How long to wait before starting over. Default 5 + seconds. + + --mmaaxx--ddeepptthh _i_n_t_e_g_e_r + How deep to subdivide. Default 12. Default 8. + + --mmiinn--wwiiddtthh _i_n_t_e_g_e_r + --mmiinn--hheeiigghhtt _i_n_t_e_g_e_r The size of the smallest rect- + angle to draw. Default 20x20. + + --ccyyccllee + + --nnoo--ccyyccllee + Whether to do color cycling. Default False. + + --ccyyccllee--ddeellaayy _u_s_e_c_s + If color cycling, how often to change the colors. + Default 1000000, or 1 second. + + + +X Version 11 27-Apr-97 1 + + + + + +XScreenSaver(1) XScreenSaver(1) + + +EENNVVIIRROONNMMEENNTT + DDIISSPPLLAAYY to get the default host and display number. + + XXEENNVVIIRROONNMMEENNTT + to get the name of a resource file that overrides + the global resources stored in the RESOURCE_MAN- + AGER property. + +SSEEEE AALLSSOO + XX(1), xxssccrreeeennssaavveerr(1) + +CCOOPPYYRRIIGGHHTT + Copyright (C) 1997 by Jamie Zawinski. Permission to use, + copy, modify, distribute, and sell this software and its + documentation for any purpose 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 + representations are made about the suitability of this + software for any purpose. It is provided "as is" without + express or implied warranty. + +AAUUTTHHOORR + Jamie Zawinski , 26-Apr-97, based on code by + Michael D. Bayne . + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +X Version 11 27-Apr-97 2 + + diff --git a/local/man/cat.1/drift.1 b/local/man/cat.1/drift.1 new file mode 100644 index 00000000..75f982b3 --- /dev/null +++ b/local/man/cat.1/drift.1 @@ -0,0 +1,132 @@ + + + +XScreenSaver(1) XScreenSaver(1) + + +NNAAMMEE + drift - draws drifting recursive fractal cosmic flames + +SSYYNNOOPPSSIISS + ddrriifftt [-display _h_o_s_t_:_d_i_s_p_l_a_y_._s_c_r_e_e_n] [-foreground _c_o_l_o_r] + [-background _c_o_l_o_r] [-window] [-root] [-mono] [-install] + [-visual _v_i_s_u_a_l] [-ncolors _i_n_t_e_g_e_r] [-delay _m_i_c_r_o_s_e_c_o_n_d_s] + [-count _i_n_t_e_g_e_r] [-grow] [-no-grow] [-liss] [-no-liss] + + +DDEESSCCRRIIPPTTIIOONN + The _d_r_i_f_t program draws drifting recursive fractal cosmic + flames + +OOPPTTIIOONNSS + _d_r_i_f_t accepts the following options: + + --wwiinnddooww Draw on a newly-created window. This is the + default. + + --rroooott Draw on the root window. + + --mmoonnoo If on a color display, pretend we're on a + monochrome display. + + --iinnssttaallll + Install a private colormap for the window. + + --vviissuuaall _v_i_s_u_a_l + 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. + + --nnccoolloorrss _i_n_t_e_g_e_r + How many colors should be used (if possible). + Default 200. The colors used cycle through the + hue, making N stops around the color wheel. + + --ccoouunntt _i_n_t_e_g_e_r + + + --ggrrooww + + --nnoo--ggrrooww + Whether fractals should grow; otherwise, they are + animated. + + + --lliissss + + --nnoo--lliissss + Whether we should use lissojous figures to get + points. + + + + +X Version 11 10-May-97 1 + + + + + +XScreenSaver(1) XScreenSaver(1) + + +EENNVVIIRROONNMMEENNTT + DDIISSPPLLAAYY to get the default host and display number. + + XXEENNVVIIRROONNMMEENNTT + to get the name of a resource file that overrides + the global resources stored in the RESOURCE_MAN- + AGER property. + +SSEEEE AALLSSOO + ffllaammee(1), XX(1), xxssccrreeeennssaavveerr(1), xxlloocckk(1) + +CCOOPPYYRRIIGGHHTT + Copyright (C) 1991, 1995 by Scott Draves. + + Permission to use, copy, modify, and distribute this soft- + ware and its documentation for any purpose and without fee + is hereby granted, provided that the above copyright + notice appear in all copies and that both that copyright + notice and this permission notice appear in supporting + documentation. + +AAUUTTHHOORR + Scott Draves , 06-Jun-91, 01-Jun-95. + + Ability to run standalone or with _x_s_c_r_e_e_n_s_a_v_e_r added by + Jamie Zawinski , 10-May-97. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +X Version 11 10-May-97 2 + + diff --git a/local/man/cat.1/epicycle.1 b/local/man/cat.1/epicycle.1 new file mode 100644 index 00000000..a263b9a3 --- /dev/null +++ b/local/man/cat.1/epicycle.1 @@ -0,0 +1,264 @@ + + + +XScreenSaver(1) XScreenSaver(1) + + +NNAAMMEE + epicycle - draws a point moving around a circle which + moves around a cicle which... + +SSYYNNOOPPSSIISS + eeppiiccyyccllee [-display _h_o_s_t_:_d_i_s_p_l_a_y_._s_c_r_e_e_n] [-root] [-window] + [-mono] [-install] [-noinstall] [-visual _v_i_z] [-colors _N] + [-foreground _n_a_m_e] [-color-shift _N] [-delay _m_i_c_r_o_s_e_c_o_n_d_s] + [-holdtime _s_e_c_o_n_d_s] [-linewidth _N] [-min_circles _N] + [-max_circles _N] [-min_speed _n_u_m_b_e_r] [-max_speed _n_u_m_b_e_r] + [-harmonics _N] [-timestep _n_u_m_b_e_r] [-divisor_poisson _p_r_o_b_a_- + _b_i_l_i_t_y] [-size_factor_min _n_u_m_b_e_r] [-size_factor_max _n_u_m_- + _b_e_r] + +DDEESSCCRRIIPPTTIIOONN + The epicycle program draws the path traced out by a point + on the edge of a circle. That circle rotates around a + point on the rim of another circle, and so on, several + times. The random curves produced can be simple or com- + plex, convex or concave, but they are always closed curves + (they never go in indefinitely). + + You can configure both the way the curves are drawn and + the way in which the random sequence of circles is gener- + ated, either with command-line options or X resources. + +OOPPTTIIOONNSS + --ddiissppllaayy _h_o_s_t_:_d_i_s_p_l_a_y_._s_c_r_e_e_n + Specifies which X display we should use (see the + section DISPLAY NAMES in XX(1) for more information + about this option). + + --rroooott Draw on the root window. + + --wwiinnddooww Draw on a newly-created window. This is the + default. + + --mmoonnoo If on a color display, pretend we're on a + monochrome display. If we're on a mono display, + we have no choice. + + --iinnssttaallll + Install a private colormap for the window. + + --nnooiinnssttaallll + Don't install a private colormap for the window. + + --vviissuuaall _v_i_z + 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. Possible choices + include + + default, best, mono, monochrome, gray, grey, + + + +X Version 11 27-Apr-97 1 + + + + + +XScreenSaver(1) XScreenSaver(1) + + + color, staticgray, staticcolor, truecolor, + grayscale, greyscale, pseudocolor, directcolor, + _n_u_m_b_e_r + + If a decimal or hexadecimal number is used, + XXGGeettVViissuuaallIInnffoo(3X) is consulted to obtain the + required visual. + + --ccoolloorrss _N + How many colors should be used (if possible). The + colors are chosen randomly. + + --ffoorreeggrroouunndd _n_a_m_e + With --mmoonnoo, this option selects the foreground + colour. + + --ddeellaayy _m_i_c_r_o_s_e_c_o_n_d_s + Specifies the delay between drawing successive + line segments of the path. If you do not specify + --ssyynncc, some X servers may batch up several drawing + operations together, producing a less smooth + effect. This is more likely to happen in + monochrome mode (on monochrome servers or when + --mmoonnoo is specified). + + --hhoollddttiimmee _s_e_c_o_n_d_s + When the figure is complete, _e_p_i_c_y_c_l_e pauses this + number of seconds. + + --lliinneewwiiddtthh _N + Width in pixels of the body's track. Specifying + values greater than one may cause slower drawing. + The fastest value is usually zero, meaning one + pixel. + + --mmiinn__cciirrcclleess _N + Smallest number of epicycles in the figure. + + --mmaaxx__cciirrcclleess _N + Largest number of epicycles in the figure. + + --mmiinn__ssppeeeedd _n_u_m_b_e_r + Smallest possible value for the base speed of rev- + olution of the epicycles. The actual speeds of + the epicycles vary from this down to _m_i_n___s_p_e_e_d _/ + _h_a_r_m_o_n_i_c_s.. + + --mmaaxx__ssppeeeedd _n_u_m_b_e_r + Smallest possible value for the base speed of rev- + olution of the epicycles. + + --hhaarrmmoonniiccss _N + Number of possible harmonics; the larger this + value is, the greater the possible variety of + + + +X Version 11 27-Apr-97 2 + + + + + +XScreenSaver(1) XScreenSaver(1) + + + possible speeds of epicycle. + + --ttiimmeesstteepp _n_u_m_b_e_r + Decreasing this value will reduce the distance the + body moves for each line segment, possibly produc- + ing a smoother figure. Increasing it may produce + faster results. + + --ddiivviissoorr__ppooiissssoonn _p_r_o_b_a_b_i_l_i_t_y + Each epicycle rotates at a rate which is a factor + of the base speed. The speed of each epicycle is + the base speed divided by some integer between 1 + and the value of the --hhaarrmmoonniiccss option. This + integer is decided by starting at 1 and tossing a + biased coin. For each consecutive head, the value + is incremented by one. The integer will not be + incremented above the value of the --hhaarrmmoonniiccss + option. The argument of this option decides the + bias of the coin; it is the probability that that + coin will produce a head at any given toss. + + --ssiizzee__ffaaccttoorr__mmiinn _n_u_m_b_e_r + Epicycles are always at least this factor smaller + than their parents. + + --ssiizzee__ffaaccttoorr__mmaaxx _n_u_m_b_e_r + Epicycles are never more than this factor smaller + than their parents. + +RREESSOOUURRCCEESS + Option Resource Default Value + ------ -------- ------------- + -colors .colors 100 + -delay .delay 1000 + -holdtime .holdtime 2 + -linewidth .lineWidth 4 + -min_circles .minCircles 2 + -max_circles .maxCircles 10 + -min_speed .minSpeed 0.003 + -max_speed .maxSpeed 0.005 + -harmonics .harmonics 8 + -timestep .timestep 1.0 + -divisor_poisson .divisorPoisson 0.4 + -size_factor_min .sizeFactorMin 1.05 + -size_factor_max .sizeFactorMax 2.05 + .timestepCoarseFactor 1.0 + + Before the drawing of the figure is begun, a preliminary + calculation of the path is done in order to scale the + radii of the epicycles so as to fit the figure on the + screen or window. For the sake of speed, This calculation + is done with a larger timestep than the actual drawing. + The time-step used is the value of the --ttiimmeesstteepp option + multiplied by the timestepCoarseFactor resource. The + + + +X Version 11 27-Apr-97 3 + + + + + +XScreenSaver(1) XScreenSaver(1) + + + default value of 1 will almost always work fast enough and + so this resource is not available as a command-line + option. + +UUSSEERR IINNTTEERRFFAACCEE + The program runs mostly without user interaction. When + running on the root window, no input is accepted. When + running in its own window, the program will exit if mouse + button 3 is pressed. If any other mouse button is + pressed, the current figure will be abandoned and another + will be started. + +HHIISSTTOORRYY + The geometry of epicycles was perfected by Hipparchus of + Rhodes at some time around 125 B.C., 185 years after the + birth of Aristarchus of Samos, the inventor of the helio- + centric universe model. Hipparchus applied epicycles to + the Sun and the Moon. Ptolemy of Alexandria went on to + apply them to what was then the known universe, at around + 150 A.D. Copernicus went on to apply them to the helio- + centric model at the beginning of the sixteenth century. + Johannes Kepler discovered that the planets actually move + in elliptical orbits in about 1602. The inverse-square + law of gravity was suggested by Boulliau in 1645. Isaac + Newton's _P_r_i_n_c_i_p_i_a _M_a_t_h_e_m_a_t_i_c_a was published in 1687, and + proved that Kepler's laws derived from Newtonian gravita- + tion. + +BBUUGGSS + The colour selection is re-done for every figure. This + may generate too much network traffic for this program to + work well over slow or long links. + +CCOOPPYYRRIIGGHHTT + Copyright (C) 1998, James Youngman. Permission to use, + copy, modify, distribute, and sell this software and its + documentation for any purpose 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 + representations are made about the suitability of this + software for any purpose. It is provided "as is" without + express or implied warranty. + +AAUUTTHHOORR + James Youngman , April 1998. + + + + + + + + + + + +X Version 11 27-Apr-97 4 + + diff --git a/local/man/cat.1/flag.1 b/local/man/cat.1/flag.1 new file mode 100644 index 00000000..1420eb1d --- /dev/null +++ b/local/man/cat.1/flag.1 @@ -0,0 +1,132 @@ + + + +XScreenSaver(1) XScreenSaver(1) + + +NNAAMMEE + flag - draws a waving flag, containing text or an image + +SSYYNNOOPPSSIISS + ffllaagg [-display _h_o_s_t_:_d_i_s_p_l_a_y_._s_c_r_e_e_n] [-foreground _c_o_l_o_r] + [-background _c_o_l_o_r] [-window] [-root] [-mono] [-install] + [-visual _v_i_s_u_a_l] [-ncolors _i_n_t_e_g_e_r] [-delay _m_i_c_r_o_s_e_c_o_n_d_s] + [-cycles _i_n_t_e_g_e_r] [-size _i_n_t_e_g_e_r] [-text _s_t_r_i_n_g] [-font + _f_o_n_t] [-bitmap _x_b_m_-_f_i_l_e] + + +DDEESSCCRRIIPPTTIIOONN + The _f_l_a_g program draws a waving flag that contains text or + a bitmap. + +OOPPTTIIOONNSS + _f_l_a_g accepts the following options: + + --wwiinnddooww Draw on a newly-created window. This is the + default. + + --rroooott Draw on the root window. + + --mmoonnoo If on a color display, pretend we're on a + monochrome display. + + --iinnssttaallll + Install a private colormap for the window. + + --vviissuuaall _v_i_s_u_a_l + 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. + + --nnccoolloorrss _i_n_t_e_g_e_r + How many colors should be used (if possible). + Default 200. + + --ccyycclleess _i_n_t_e_g_e_r + + + --ccoouunntt _i_n_t_e_g_e_r + + + --ssiizzee _i_n_t_e_g_e_r + How large the pixels in the flag should be, from 1 + to 8. If this is a negative number, the pixel + size is chosen randomly from the range 1 to -size. + Default -7. + + --tteexxtt _t_e_x_t + The text to display in the flag. Multiple lines + of text are allowed; the lines will be displayed + centered atop one another. Default: none. If the + + + +X Version 11 24-May-97 1 + + + + + +XScreenSaver(1) XScreenSaver(1) + + + text is the magic string _"_(_d_e_f_a_u_l_t_)_", then the + text used will be the local machine name; a new- + line; and the local OS version. + + --bbiittmmaapp _x_b_m_-_f_i_l_e + The bitmap to display in the flag; this must be an + XBM file (color XPMs are not allowed.) Default: + none. If the bitmap is the magic string + _"_(_d_e_f_a_u_l_t_)_", then the bitmap used will be a charm- + ing little picture of J. R. "Bob" Dobbs. + + If neither _-_t_e_x_t nor _-_b_i_t_m_a_p are specified, then + either the builtin text or the builtin bitmap will + be chosen randomly. + + --ffoonntt _f_o_n_t + The font in which to draw the text; the default is + "-*-helvetica-bold-r-*-240-*". + +EENNVVIIRROONNMMEENNTT + DDIISSPPLLAAYY to get the default host and display number. + + XXEENNVVIIRROONNMMEENNTT + to get the name of a resource file that overrides + the global resources stored in the RESOURCE_MAN- + AGER property. + +SSEEEE AALLSSOO + XX(1), xxssccrreeeennssaavveerr(1), xxlloocckk(1) + +CCOOPPYYRRIIGGHHTT + Copyright (C) 1996 Charles Vidal. + + Permission to use, copy, modify, and distribute this soft- + ware and its documentation for any purpose and without fee + is hereby granted, provided that the above copyright + notice appear in all copies and that both that copyright + notice and this permission notice appear in supporting + documentation. + + +AAUUTTHHOORR + Charles Vidal , 1996. + + Ability to run standalone or with _x_s_c_r_e_e_n_s_a_v_e_r, and the + -text and -bitmap options, added by Jamie Zawinski + , 24-May-97. + + + + + + + + + + +X Version 11 24-May-97 2 + + diff --git a/local/man/cat.1/flame.1 b/local/man/cat.1/flame.1 new file mode 100644 index 00000000..e5c4ebac --- /dev/null +++ b/local/man/cat.1/flame.1 @@ -0,0 +1,132 @@ + + + +XScreenSaver(1) XScreenSaver(1) + + +NNAAMMEE + flame - draw weird cosmic fractals + +SSYYNNOOPPSSIISS + ffllaammee [-display _h_o_s_t_:_d_i_s_p_l_a_y_._s_c_r_e_e_n] [-foreground _c_o_l_o_r] + [-background _c_o_l_o_r] [-window] [-root] [-mono] [-install] + [-visual _v_i_s_u_a_l] [-colors _i_n_t_e_g_e_r] [-iterations _i_n_t_e_g_e_r] + [-points _i_n_t_e_g_e_r] [-delay _m_i_c_r_o_s_e_c_o_n_d_s] [-delay2 _m_i_c_r_o_s_e_c_- + _o_n_d_s] + +DDEESSCCRRIIPPTTIIOONN + The _f_l_a_m_e program generates colorful fractal displays. + +OOPPTTIIOONNSS + _f_l_a_m_e accepts the following options: + + --wwiinnddooww Draw on a newly-created window. This is the + default. + + --rroooott Draw on the root window. + + --mmoonnoo If on a color display, pretend we're on a + monochrome display. + + --iinnssttaallll + Install a private colormap for the window. + + --vviissuuaall _v_i_s_u_a_l + 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. + + --ccoolloorrss _i_n_t_e_g_e_r + How many colors should be used (if possible). + Default 64. + + --iitteerraattiioonnss _i_n_t_e_g_e_r + How many fractals to generate. Default 25. + + --ppooiinnttss _i_n_t_e_g_e_r + How many pixels to draw for each fractal. Default + 10000. + + --ddeellaayy _m_i_c_r_o_s_e_c_o_n_d_s + How long we should wait between drawing each frac- + tal. Default 50000, or about 1/20th second. + + --ddeellaayy22 _m_i_c_r_o_s_e_c_o_n_d_s + How long we should wait before clearing the screen + when each run ends. Default 2000000, or two sec- + onds. + +EENNVVIIRROONNMMEENNTT + DDIISSPPLLAAYY to get the default host and display number. + + + +X Version 11 13-aug-92 1 + + + + + +XScreenSaver(1) XScreenSaver(1) + + + XXEENNVVIIRROONNMMEENNTT + to get the name of a resource file that overrides + the global resources stored in the RESOURCE_MAN- + AGER property. + +SSEEEE AALLSSOO + XX(1), xxssccrreeeennssaavveerr(1), xxlloocckk(1) + +CCOOPPYYRRIIGGHHTT + Copyright (C) 1991 by Patrick J. Naughton + + Permission to use, copy, modify, and distribute this soft- + ware and its documentation for any purpose and without fee + is hereby granted, provided that the above copyright + notice appear in all copies and that both that copyright + notice and this permission notice appear in supporting + documentation. + +AAUUTTHHOORR + Scott Graves , 06-Jun-91.n + + Ability to run standalone or with _x_s_c_r_e_e_n_s_a_v_e_r added by + Jamie Zawinski , 18-Oct-93. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +X Version 11 13-aug-92 2 + + diff --git a/local/man/cat.1/forest.1 b/local/man/cat.1/forest.1 new file mode 100644 index 00000000..4f5d39ab --- /dev/null +++ b/local/man/cat.1/forest.1 @@ -0,0 +1,132 @@ + + + +XScreenSaver(1) XScreenSaver(1) + + +NNAAMMEE + forest - draws a fractal forest + +SSYYNNOOPPSSIISS + ffoorreesstt [-display _h_o_s_t_:_d_i_s_p_l_a_y_._s_c_r_e_e_n] [-foreground _c_o_l_o_r] + [-background _c_o_l_o_r] [-window] [-root] [-mono] [-install] + [-visual _v_i_s_u_a_l] [-ncolors _i_n_t_e_g_e_r] [-delay _m_i_c_r_o_s_e_c_o_n_d_s] + [-cycles _i_n_t_e_g_e_r] [-count _i_n_t_e_g_e_r] + + +DDEESSCCRRIIPPTTIIOONN + The _f_o_r_e_s_t program draws a fractal forest. + +OOPPTTIIOONNSS + _f_o_r_e_s_t accepts the following options: + + --wwiinnddooww Draw on a newly-created window. This is the + default. + + --rroooott Draw on the root window. + + --mmoonnoo If on a color display, pretend we're on a + monochrome display. + + --iinnssttaallll + Install a private colormap for the window. + + --vviissuuaall _v_i_s_u_a_l + 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. + + --nnccoolloorrss _i_n_t_e_g_e_r + How many colors should be used (if possible). + Default 100. + + --ccyycclleess _i_n_t_e_g_e_r + + + --ccoouunntt _i_n_t_e_g_e_r + + +EENNVVIIRROONNMMEENNTT + DDIISSPPLLAAYY to get the default host and display number. + + XXEENNVVIIRROONNMMEENNTT + to get the name of a resource file that overrides + the global resources stored in the RESOURCE_MAN- + AGER property. + +SSEEEE AALLSSOO + XX(1), xxssccrreeeennssaavveerr(1), xxlloocckk(1) + + + + + +X Version 11 27-May-97 1 + + + + + +XScreenSaver(1) XScreenSaver(1) + + +CCOOPPYYRRIIGGHHTT + Copyright (C) 1995 by Pascal Pensa. + + Permission to use, copy, modify, and distribute this soft- + ware and its documentation for any purpose and without fee + is hereby granted, provided that the above copyright + notice appear in all copies and that both that copyright + notice and this permission notice appear in supporting + documentation. + +AAUUTTHHOORR + Pascal Pensa , 1995. + + Ability to run standalone or with _x_s_c_r_e_e_n_s_a_v_e_r added by + Jamie Zawinski , 27-May-97. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +X Version 11 27-May-97 2 + + diff --git a/local/man/cat.1/galaxy.1 b/local/man/cat.1/galaxy.1 new file mode 100644 index 00000000..59f93008 --- /dev/null +++ b/local/man/cat.1/galaxy.1 @@ -0,0 +1,132 @@ + + + +XScreenSaver(1) XScreenSaver(1) + + +NNAAMMEE + galaxy - draws spinning galaxies + +SSYYNNOOPPSSIISS + ggaallaaxxyy [-display _h_o_s_t_:_d_i_s_p_l_a_y_._s_c_r_e_e_n] [-foreground _c_o_l_o_r] + [-background _c_o_l_o_r] [-window] [-root] [-mono] [-install] + [-visual _v_i_s_u_a_l] [-ncolors _i_n_t_e_g_e_r] [-delay _m_i_c_r_o_s_e_c_o_n_d_s] + [-cycles _i_n_t_e_g_e_r] [-count _i_n_t_e_g_e_r] [-size _i_n_t_e_g_e_r] + [-trail] [-no-trail] + + +DDEESSCCRRIIPPTTIIOONN + The _g_a_l_a_x_y program draws spinning galaxies. + +OOPPTTIIOONNSS + _g_a_l_a_x_y accepts the following options: + + --wwiinnddooww Draw on a newly-created window. This is the + default. + + --rroooott Draw on the root window. + + --mmoonnoo If on a color display, pretend we're on a + monochrome display. + + --iinnssttaallll + Install a private colormap for the window. + + --vviissuuaall _v_i_s_u_a_l + 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. + + --nnccoolloorrss _i_n_t_e_g_e_r + How many colors should be used (if possible). + Default 64. The colors used cycle through the + hue, making N stops around the color wheel. + + --ccyycclleess _i_n_t_e_g_e_r + + + --ccoouunntt _i_n_t_e_g_e_r + + + --ssiizzee _i_n_t_e_g_e_r + + + --ttrraaiill + + --nnoo--ttrraaiill + + +EENNVVIIRROONNMMEENNTT + DDIISSPPLLAAYY to get the default host and display number. + + + +X Version 11 10-May-97 1 + + + + + +XScreenSaver(1) XScreenSaver(1) + + + XXEENNVVIIRROONNMMEENNTT + to get the name of a resource file that overrides + the global resources stored in the RESOURCE_MAN- + AGER property. + +SSEEEE AALLSSOO + XX(1), xxssccrreeeennssaavveerr(1), xxlloocckk(1) + +CCOOPPYYRRIIGGHHTT + Copyright (C) 1994 by Hubert Feyrer. + + Permission to use, copy, modify, and distribute this soft- + ware and its documentation for any purpose and without fee + is hereby granted, provided that the above copyright + notice appear in all copies and that both that copyright + notice and this permission notice appear in supporting + documentation. + +AAUUTTHHOORR + Original Amiga version by Uli Siegmund + for EGS in Cluster. + + Ported from Cluster/EGS to C/Intuition by Harald Backert. + + Ported to X11 and xlockmore by Hubert Feyrer + , 30-Sep-94. + + Modified by David Bagley , 23-Oct-94. + + Modified by Dave Mitchell , 7-Apr-97. + + Ability to run standalone or with _x_s_c_r_e_e_n_s_a_v_e_r added by + Jamie Zawinski , 10-May-97. + + + + + + + + + + + + + + + + + + + + + + + +X Version 11 10-May-97 2 + + diff --git a/local/man/cat.1/goop.1 b/local/man/cat.1/goop.1 new file mode 100644 index 00000000..ad05f484 --- /dev/null +++ b/local/man/cat.1/goop.1 @@ -0,0 +1,132 @@ + + + +XScreenSaver(1) XScreenSaver(1) + + +NNAAMMEE + goop - squishy transparent oil and bubble screenhack + +SSYYNNOOPPSSIISS + ggoooopp [-display _h_o_s_t_:_d_i_s_p_l_a_y_._s_c_r_e_e_n] [-foreground _c_o_l_o_r] + [-background _c_o_l_o_r] [-window] [-root] [-mono] [-install] + [-visual _v_i_s_u_a_l] [-transparent] [-non-transparent] [-addi- + tive] [-subtractive] [-xor] [-no-xor] + +DDEESSCCRRIIPPTTIIOONN + The _g_o_o_p program draws a simulation of bubbles in layers + of overlapping multicolored translucent fluid. + +OOPPTTIIOONNSS + _g_o_o_p accepts the following options: + + --wwiinnddooww Draw on a newly-created window. This is the + default. + + --rroooott Draw on the root window. + + --mmoonnoo If on a color display, pretend we're on a + monochrome display. + + --iinnssttaallll + Install a private colormap for the window. + + --vviissuuaall _v_i_s_u_a_l + 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. + + --ccoouunntt _i_n_t_e_g_e_r + How many bubbles to draw per layer. Default: ran- + dom. + + --llaayyeerrss _i_n_t_e_g_e_r + How many layers to draw. Default: random, based + on screen depth. + + --ddeellaayy _m_i_c_r_o_s_e_c_o_n_d_s + How much of a delay should be introduced between + steps of the animation. Default 100000, or about + 1/10th second. + + --ttrraannssppaarreenntt + If _-_l_a_y_e_r_s is greater than 1, then each layer will + be drawn in one color, and when they overlap, the + colors will be mixed. This is the default. + + --nnoonn--ttrraannssppaarreenntt + Turns off _-_t_r_a_n_s_p_a_r_e_n_t. + + + + + +X Version 11 11-Jun-97 1 + + + + + +XScreenSaver(1) XScreenSaver(1) + + + --aaddddiittiivvee + If _-_t_r_a_n_s_p_a_r_e_n_t is specified, then this option + means that the colors will be mixed using an addi- + tive color model, as if the blobs were projected + light. This is the default. + + --ssuubbttrraaccttiivvee + If _-_t_r_a_n_s_p_a_r_e_n_t is specified, then this option + means that the colors will be mixed using a sub- + tractive color model, as if the blobs were + translucent filters. + + --xxoorr Draw with xor instead of the other color tricks. + +EENNVVIIRROONNMMEENNTT + DDIISSPPLLAAYY to get the default host and display number. + + XXEENNVVIIRROONNMMEENNTT + to get the name of a resource file that overrides + the global resources stored in the RESOURCE_MAN- + AGER property. + +SSEEEE AALLSSOO + XX(1), xxssccrreeeennssaavveerr(1) + +CCOOPPYYRRIIGGHHTT + Copyright (C) 1997 by Jamie Zawinski. Permission to use, + copy, modify, distribute, and sell this software and its + documentation for any purpose 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 + representations are made about the suitability of this + software for any purpose. It is provided "as is" without + express or implied warranty. + +AAUUTTHHOORR + Jamie Zawinski , 11-Jun-97. + + + + + + + + + + + + + + + + + + + +X Version 11 11-Jun-97 2 + + diff --git a/local/man/cat.1/grav.1 b/local/man/cat.1/grav.1 new file mode 100644 index 00000000..1a9edb4d --- /dev/null +++ b/local/man/cat.1/grav.1 @@ -0,0 +1,132 @@ + + + +XScreenSaver(1) XScreenSaver(1) + + +NNAAMMEE + grav - draws a simple orbital simulation + +SSYYNNOOPPSSIISS + ggrraavv [-display _h_o_s_t_:_d_i_s_p_l_a_y_._s_c_r_e_e_n] [-foreground _c_o_l_o_r] + [-background _c_o_l_o_r] [-window] [-root] [-mono] [-install] + [-visual _v_i_s_u_a_l] [-ncolors _i_n_t_e_g_e_r] [-delay _m_i_c_r_o_s_e_c_o_n_d_s] + [-count _i_n_t_e_g_e_r] [-decay] [-no-decay] [-trail] [-no-trail] + + +DDEESSCCRRIIPPTTIIOONN + The _g_r_a_v program draws a simple orbital simulation + +OOPPTTIIOONNSS + _g_r_a_v accepts the following options: + + --wwiinnddooww Draw on a newly-created window. This is the + default. + + --rroooott Draw on the root window. + + --mmoonnoo If on a color display, pretend we're on a + monochrome display. + + --iinnssttaallll + Install a private colormap for the window. + + --vviissuuaall _v_i_s_u_a_l + 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. + + --nnccoolloorrss _i_n_t_e_g_e_r + How many colors should be used (if possible). + Default 200. The colors are chosen randomly. + + --ccoouunntt _i_n_t_e_g_e_r + Default 12. + + --ddeeccaayy + + --nnoo--eeccaayy + Whether orbits should decay. + + + --ttrraaiill + + --nnoo--ttrraaiill + Whether the objects should leave trails behind + them (makes it look vaguely like a cloud-chamber. + + +EENNVVIIRROONNMMEENNTT + DDIISSPPLLAAYY to get the default host and display number. + + + +X Version 11 10-May-97 1 + + + + + +XScreenSaver(1) XScreenSaver(1) + + + XXEENNVVIIRROONNMMEENNTT + to get the name of a resource file that overrides + the global resources stored in the RESOURCE_MAN- + AGER property. + +SSEEEE AALLSSOO + XX(1), xxssccrreeeennssaavveerr(1), xxlloocckk(1) + +CCOOPPYYRRIIGGHHTT + Copyright (C) 1993 by Greg Bowering. + + Permission to use, copy, modify, and distribute this soft- + ware and its documentation for any purpose and without fee + is hereby granted, provided that the above copyright + notice appear in all copies and that both that copyright + notice and this permission notice appear in supporting + documentation. + +AAUUTTHHOORR + Greg Bowering , 1993. + + Ability to run standalone or with _x_s_c_r_e_e_n_s_a_v_e_r added by + Jamie Zawinski , 10-May-97. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +X Version 11 10-May-97 2 + + diff --git a/local/man/cat.1/greynetic.1 b/local/man/cat.1/greynetic.1 new file mode 100644 index 00000000..7280236b --- /dev/null +++ b/local/man/cat.1/greynetic.1 @@ -0,0 +1,132 @@ + + + +XScreenSaver(1) XScreenSaver(1) + + +NNAAMMEE + greynetic - draw random stippled/color rectangles + +SSYYNNOOPPSSIISS + ggrreeyynneettiicc [-display _h_o_s_t_:_d_i_s_p_l_a_y_._s_c_r_e_e_n] [-foreground + _c_o_l_o_r] [-background _c_o_l_o_r] [-window] [-root] [-mono] + [-install] [-visual _v_i_s_u_a_l] [-delay _u_s_e_c_s] + +DDEESSCCRRIIPPTTIIOONN + The _g_r_e_y_n_e_t_i_c program draws random rectangles. + +OOPPTTIIOONNSS + _g_r_e_y_n_e_t_i_c accepts the following options: + + --wwiinnddooww Draw on a newly-created window. This is the + default. + + --rroooott Draw on the root window. + + --mmoonnoo If on a color display, pretend we're on a + monochrome display. + + --iinnssttaallll + Install a private colormap for the window. + + --vviissuuaall _v_i_s_u_a_l + 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. + + --ddeellaayy _m_i_c_r_o_s_e_c_o_n_d_s + Slow it down. + +EENNVVIIRROONNMMEENNTT + DDIISSPPLLAAYY to get the default host and display number. + + XXEENNVVIIRROONNMMEENNTT + to get the name of a resource file that overrides + the global resources stored in the RESOURCE_MAN- + AGER property. + +SSEEEE AALLSSOO + XX(1), xxssccrreeeennssaavveerr(1) + +CCOOPPYYRRIIGGHHTT + Copyright (C) 1992 by Jamie Zawinski. Permission to use, + copy, modify, distribute, and sell this software and its + documentation for any purpose 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 + representations are made about the suitability of this + software for any purpose. It is provided "as is" without + express or implied warranty. + + + +X Version 11 13-aug-92 1 + + + + + +XScreenSaver(1) XScreenSaver(1) + + +AAUUTTHHOORR + Jamie Zawinski , 13-aug-92. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +X Version 11 13-aug-92 2 + + diff --git a/local/man/cat.1/halo.1 b/local/man/cat.1/halo.1 new file mode 100644 index 00000000..e5668e20 --- /dev/null +++ b/local/man/cat.1/halo.1 @@ -0,0 +1,132 @@ + + + +XScreenSaver(1) XScreenSaver(1) + + +NNAAMMEE + halo - draw circular patterns + +SSYYNNOOPPSSIISS + hhaalloo [-display _h_o_s_t_:_d_i_s_p_l_a_y_._s_c_r_e_e_n] [-foreground _c_o_l_o_r] + [-background _c_o_l_o_r] [-window] [-root] [-mono] [-install] + [-visual _v_i_s_u_a_l] [-count _i_n_t] [-delay _u_s_e_c_s] [-mode seuss + | ramp | random ] [-animate] [-colors _i_n_t_e_g_e_r] [-cycle] + [-no-cycle] [-cycle-delay _u_s_e_c_s] + +DDEESSCCRRIIPPTTIIOONN + The _h_a_l_o program draws cool patterns based on circles. + +OOPPTTIIOONNSS + _h_a_l_o accepts the following options: + + --wwiinnddooww Draw on a newly-created window. This is the + default. + + --rroooott Draw on the root window. + + --mmoonnoo If on a color display, pretend we're on a + monochrome display. + + --iinnssttaallll + Install a private colormap for the window. + + --vviissuuaall _v_i_s_u_a_l + 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. + + --ccoouunntt _i_n_t_e_g_e_r + How many circles to draw. Default 0, meaning ran- + dom. + + --mmooddee sseeuussss || rraammpp || rraannddoomm + In _s_e_u_s_s mode, alternating striped curves will be + drawn. + + In _r_a_m_p mode, a color ramp will be drawn. + + _r_a_n_d_o_m means pick the mode randomly. + + --ddeellaayy _m_i_c_r_o_s_e_c_o_n_d_s + How much of a delay should be introduced between + steps of the animation. Default 100000, or about + 0.1 second. + + --ccoolloorrss _i_n_t_e_g_e_r + How many colors to use. Default 100. + + --aanniimmaattee + If specified, then the centerpoints of the circles + + + +X Version 11 12-Jun-97 1 + + + + + +XScreenSaver(1) XScreenSaver(1) + + + will bounce around. Otherwise, the circles will + be drawn once, erased, and a new set of circles + will be drawn. + + --ccyyccllee + + --nnoo--ccyyccllee + Whether to do colormap cycling. Default is to + cycle. + + --ccyyccllee--ddeellaayy + Number of microseconds between shifts of the col- + ormap; default 100000, or 1/10th second. + +EENNVVIIRROONNMMEENNTT + DDIISSPPLLAAYY to get the default host and display number. + + XXEENNVVIIRROONNMMEENNTT + to get the name of a resource file that overrides + the global resources stored in the RESOURCE_MAN- + AGER property. + +SSEEEE AALLSSOO + XX(1), xxssccrreeeennssaavveerr(1) + +CCOOPPYYRRIIGGHHTT + Copyright (C) 1993 by Jamie Zawinski. Permission to use, + copy, modify, distribute, and sell this software and its + documentation for any purpose 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 + representations are made about the suitability of this + software for any purpose. It is provided "as is" without + express or implied warranty. + +AAUUTTHHOORR + Jamie Zawinski , 6-jul-93. + + + + + + + + + + + + + + + + + + + +X Version 11 12-Jun-97 2 + + diff --git a/local/man/cat.1/helix.1 b/local/man/cat.1/helix.1 new file mode 100644 index 00000000..2b74553c --- /dev/null +++ b/local/man/cat.1/helix.1 @@ -0,0 +1,132 @@ + + + +XScreenSaver(1) XScreenSaver(1) + + +NNAAMMEE + helix - draw helical string-art patterns + +SSYYNNOOPPSSIISS + hheelliixx [-display _h_o_s_t_:_d_i_s_p_l_a_y_._s_c_r_e_e_n] [-foreground _c_o_l_o_r] + [-background _c_o_l_o_r] [-window] [-root] [-mono] + [-erase-speed _u_s_e_c_s] [-erase-mode _i_n_t_e_g_e_r] [-delay _s_e_c_- + _o_n_d_s] [-install] [-visual _v_i_s_u_a_l] + +DDEESSCCRRIIPPTTIIOONN + The _h_e_l_i_x program draws interesting patterns composed of + line segments in random colors. + +OOPPTTIIOONNSS + _h_e_l_i_x accepts the following options: + + --wwiinnddooww Draw on a newly-created window. This is the + default. + + --rroooott Draw on the root window. + + --mmoonnoo If on a color display, pretend we're on a + monochrome display. + + --eerraassee--ssppeeeedd _u_s_e_c_s + This controls the speed at which the screen will + be erased. Lower numbers erase faster. + + --eerraassee--mmooddee _i_n_t_e_g_e_r + This sets the erase mode. Mode -1 chooses a random + mode each time. There are currently 6 modes + defined (0-5). + + --ddeellaayy _s_e_c_o_n_d_s + This sets the number of seconds that the helix + will be on the screen. + + --iinnssttaallll + Install a private colormap for the window. + + --vviissuuaall _v_i_s_u_a_l + 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. + +EENNVVIIRROONNMMEENNTT + DDIISSPPLLAAYY to get the default host and display number. + + XXEENNVVIIRROONNMMEENNTT + to get the name of a resource file that overrides + the global resources stored in the RESOURCE_MAN- + AGER property. + + + + + +X Version 11 18-sep-97 1 + + + + + +XScreenSaver(1) XScreenSaver(1) + + +SSEEEE AALLSSOO + XX(1), xxssccrreeeennssaavveerr(1) + +CCOOPPYYRRIIGGHHTT + Copyright (C) 1992 by Jamie Zawinski. Permission to use, + copy, modify, distribute, and sell this software and its + documentation for any purpose 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 + representations are made about the suitability of this + software for any purpose. It is provided "as is" without + express or implied warranty. + +AAUUTTHHOORR + Jamie Zawinski , 13-aug-92. Screen eraser + improved by Johannes Keukelaar , + 18-sep-97. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +X Version 11 18-sep-97 2 + + diff --git a/local/man/cat.1/hopalong.1 b/local/man/cat.1/hopalong.1 new file mode 100644 index 00000000..fe9dafb9 --- /dev/null +++ b/local/man/cat.1/hopalong.1 @@ -0,0 +1,132 @@ + + + +XScreenSaver(1) XScreenSaver(1) + + +NNAAMMEE + hopalong - draw real plane fractals + +SSYYNNOOPPSSIISS + hhooppaalloonngg [-display _h_o_s_t_:_d_i_s_p_l_a_y_._s_c_r_e_e_n] [-foreground + _c_o_l_o_r] [-background _c_o_l_o_r] [-window] [-root] [-mono] + [-install] [-visual _v_i_s_u_a_l] [-ncolors _i_n_t_e_g_e_r] [-delay + _m_i_c_r_o_s_e_c_o_n_d_s] [-cycles _i_n_t_e_g_e_r] [-count _i_n_t_e_g_e_r] [-jong] + [-no-jong] [-jong] [-no-sine] + + +DDEESSCCRRIIPPTTIIOONN + The _h_o_p_a_l_o_n_g program generates real plane fractals as + described in the September 1986 issue of Scientific Ameri- + can. + +OOPPTTIIOONNSS + _h_o_p_a_l_o_n_g accepts the following options: + + --wwiinnddooww Draw on a newly-created window. This is the + default. + + --rroooott Draw on the root window. + + --mmoonnoo If on a color display, pretend we're on a + monochrome display. + + --iinnssttaallll + Install a private colormap for the window. + + --vviissuuaall _v_i_s_u_a_l + 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. + + --nnccoolloorrss _i_n_t_e_g_e_r + How many colors should be used (if possible). + Default 200. The colors used cycle through the + hue, making N stops around the color wheel. + + --ccyycclleess _i_n_t_e_g_e_r + How long to run each batch. Default 2500 pixels. + + --ccoouunntt _i_n_t_e_g_e_r + How many pixels should be drawn before a color + change. Default 1000. + + --jjoonngg _i_n_t_e_g_e_r + + --nnoo--jjoonngg _i_n_t_e_g_e_r + Whether to use the Jong format (default is to + choose randomly.) + + + + + +X Version 11 10-May-97 1 + + + + + +XScreenSaver(1) XScreenSaver(1) + + + --ssiinnee _i_n_t_e_g_e_r + + --nnoo--ssiinnee _i_n_t_e_g_e_r + Whether to use the Sine format (default is to + choose randomly.) + + +EENNVVIIRROONNMMEENNTT + DDIISSPPLLAAYY to get the default host and display number. + + XXEENNVVIIRROONNMMEENNTT + to get the name of a resource file that overrides + the global resources stored in the RESOURCE_MAN- + AGER property. + +SSEEEE AALLSSOO + XX(1), xxssccrreeeennssaavveerr(1), xxlloocckk(1) + +CCOOPPYYRRIIGGHHTT + Copyright (C) 1988-91 by Patrick J. Naughton. + + Permission to use, copy, modify, and distribute this soft- + ware and its documentation for any purpose and without fee + is hereby granted, provided that the above copyright + notice appear in all copies and that both that copyright + notice and this permission notice appear in supporting + documentation. + +AAUUTTHHOORR + Patrick J. Naughton , 23-mar-88. + + Ability to run standalone or with _x_s_c_r_e_e_n_s_a_v_e_r added by + Jamie Zawinski , 13-aug-92, and again on + 10-May-97. + + + + + + + + + + + + + + + + + + + + + + + +X Version 11 10-May-97 2 + + diff --git a/local/man/cat.1/hypercube.1 b/local/man/cat.1/hypercube.1 new file mode 100644 index 00000000..78f9a231 --- /dev/null +++ b/local/man/cat.1/hypercube.1 @@ -0,0 +1,132 @@ + + + +XScreenSaver(1) XScreenSaver(1) + + +NNAAMMEE + hypercube - 2d projection of a 4d object + +SSYYNNOOPPSSIISS + hhyyppeerrccuubbee [-display _h_o_s_t_:_d_i_s_p_l_a_y_._s_c_r_e_e_n] [-foreground + _c_o_l_o_r] [-background _c_o_l_o_r] [-color[0-7] _c_o_l_o_r] [-xy _f_l_o_a_t] + [-xz _f_l_o_a_t] [-yz _f_l_o_a_t] [-xw _f_l_o_a_t] [-yw _f_l_o_a_t] [-zw + _f_l_o_a_t] [-observer-z _i_n_t] [-delay _u_s_e_c_s] [-window] [-root] + [-mono] [-install] [-visual _v_i_s_u_a_l] + +DDEESSCCRRIIPPTTIIOONN + The _h_y_p_e_r_c_u_b_e program displays a wireframe projection of a + hypercube which is rotating at user-specified rates around + any or all of its four axes. + +OOPPTTIIOONNSS + _h_y_p_e_r_c_u_b_e accepts the following options: + + --wwiinnddooww Draw on a newly-created window. This is the + default. + + --rroooott Draw on the root window. + + --mmoonnoo If on a color display, pretend we're on a + monochrome display. + + --iinnssttaallll + Install a private colormap for the window. + + --vviissuuaall _v_i_s_u_a_l + 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. + + --ddeellaayy _m_i_c_r_o_s_e_c_o_n_d_s + How much of a delay should be introduced between + steps of the animation. Default 100000, or about + 1/10th second. + + --oobbsseerrvveerr--zz _i_n_t + How far away the observer is from the center of + the cube (the cube is one unit per side.) Default + 5. + + --ccoolloorr00 _c_o_l_o_r + + --ccoolloorr11 _c_o_l_o_r + + --ccoolloorr22 _c_o_l_o_r + + --ccoolloorr33 _c_o_l_o_r + + --ccoolloorr44 _c_o_l_o_r + + + + +X Version 11 6-dec-92 1 + + + + + +XScreenSaver(1) XScreenSaver(1) + + + --ccoolloorr55 _c_o_l_o_r + + --ccoolloorr66 _c_o_l_o_r + + --ccoolloorr77 _c_o_l_o_r + The colors used to draw the line segments border- + ing the eight faces of the cube. Some of the + faces have only two of their border-lines drawn in + the specified color, and some have all four. + + --xxww _f_l_o_a_t + + --xxyy _f_l_o_a_t + + --xxzz _f_l_o_a_t + + --yyww _f_l_o_a_t + + --yyzz _f_l_o_a_t + + --zzww _f_l_o_a_t + The amount that the cube should be rotated around + the specified axis at each frame of the animation, + expressed in radians. These should be small + floating-point values (less than 0.05 works best.) + Default: xy=0.01, xz=0.005, yw=0.01. + +EENNVVIIRROONNMMEENNTT + DDIISSPPLLAAYY to get the default host and display number. + + XXEENNVVIIRROONNMMEENNTT + to get the name of a resource file that overrides + the global resources stored in the RESOURCE_MAN- + AGER property. + +SSEEEE AALLSSOO + XX(1), xxssccrreeeennssaavveerr(1) + +CCOOPPYYRRIIGGHHTT + Copyright (C) 1992 by Jamie Zawinski. Permission to use, + copy, modify, distribute, and sell this software and its + documentation for any purpose 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 + representations are made about the suitability of this + software for any purpose. It is provided "as is" without + express or implied warranty. + +AAUUTTHHOORR + Jamie Zawinski , 6-dec-92. + + + + + + +X Version 11 6-dec-92 2 + + diff --git a/local/man/cat.1/ifs.1 b/local/man/cat.1/ifs.1 new file mode 100644 index 00000000..b3a4a82b --- /dev/null +++ b/local/man/cat.1/ifs.1 @@ -0,0 +1,132 @@ + + + +XScreenSaver(1) XScreenSaver(1) + + +NNAAMMEE + ifs - draws spinning, colliding iterated-function-system + images + +SSYYNNOOPPSSIISS + iiffss [-display _h_o_s_t_:_d_i_s_p_l_a_y_._s_c_r_e_e_n] [-foreground _c_o_l_o_r] + [-background _c_o_l_o_r] [-window] [-root] [-mono] [-install] + [-visual _v_i_s_u_a_l] [-ncolors _i_n_t_e_g_e_r] [-delay _m_i_c_r_o_s_e_c_o_n_d_s] + + +DDEESSCCRRIIPPTTIIOONN + The _i_f_s program draws spinning, colliding iterated-func- + tion-system images. + +OOPPTTIIOONNSS + _i_f_s accepts the following options: + + --wwiinnddooww Draw on a newly-created window. This is the + default. + + --rroooott Draw on the root window. + + --mmoonnoo If on a color display, pretend we're on a + monochrome display. + + --iinnssttaallll + Install a private colormap for the window. + + --vviissuuaall _v_i_s_u_a_l + 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. + + --nnccoolloorrss _i_n_t_e_g_e_r + How many colors should be used (if possible). + Default 200. The colors used cycle through the + hue, making N stops around the color wheel. + +EENNVVIIRROONNMMEENNTT + DDIISSPPLLAAYY to get the default host and display number. + + XXEENNVVIIRROONNMMEENNTT + to get the name of a resource file that overrides + the global resources stored in the RESOURCE_MAN- + AGER property. + +SSEEEE AALLSSOO + XX(1), xxssccrreeeennssaavveerr(1), xxlloocckk(1) + +CCOOPPYYRRIIGGHHTT + Copyright (C) 1997 by Massimino Pascal. + + Permission to use, copy, modify, and distribute this soft- + ware and its documentation for any purpose and without fee + + + +X Version 11 10-May-97 1 + + + + + +XScreenSaver(1) XScreenSaver(1) + + + is hereby granted, provided that the above copyright + notice appear in all copies and that both that copyright + notice and this permission notice appear in supporting + documentation. + +AAUUTTHHOORR + Massimino Pascal , 1997. + + Ability to run standalone or with _x_s_c_r_e_e_n_s_a_v_e_r added by + Jamie Zawinski , 10-May-97. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +X Version 11 10-May-97 2 + + diff --git a/local/man/cat.1/imsmap.1 b/local/man/cat.1/imsmap.1 new file mode 100644 index 00000000..4ec433c4 --- /dev/null +++ b/local/man/cat.1/imsmap.1 @@ -0,0 +1,132 @@ + + + +XScreenSaver(1) XScreenSaver(1) + + +NNAAMMEE + imsmap - generate fractal maps + +SSYYNNOOPPSSIISS + iimmssmmaapp [-display _h_o_s_t_:_d_i_s_p_l_a_y_._s_c_r_e_e_n] [-foreground _c_o_l_o_r] + [-background _c_o_l_o_r] [-window] [-root] [-mono] [-install] + [-visual _v_i_s_u_a_l] [-ncolors _i_n_t] [-delay _s_e_c_o_n_d_s] [-itera- + tions _i_n_t] [-mode h|s|v|random] [-cycle] [-no-cycle] + +DDEESSCCRRIIPPTTIIOONN + The _i_m_s_m_a_p program generates map or cloud-like patterns. + It looks quite different in monochrome and color. + +OOPPTTIIOONNSS + _i_m_s_m_a_p accepts the following options: + + --wwiinnddooww Draw on a newly-created window. This is the + default. + + --rroooott Draw on the root window. + + --mmoonnoo If on a color display, pretend we're on a + monochrome display. + + --iinnssttaallll + Install a private colormap for the window. + + --vviissuuaall _v_i_s_u_a_l + 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. + + --nnccoolloorrss _i_n_t_e_g_e_r + How many colors to use. Default 50. + + --ddeellaayy _i_n_t_e_g_e_r + How long to delay between images. Default 10 sec- + onds. + + --iitteerraattiioonnss _i_n_t_e_g_e_r + A measure of the resolution of the resultant + image, from 0 to 7. Default 7. + + --mmooddee [[ hhuuee || ssaattuurraattiioonn || vvaalluuee || rraannddoomm ]] + The axis upon which colors should be interpolated + between the foreground and background color. + Default random. + + --ccyyccllee + + --nnoo--ccyyccllee + Whether to do colormap cycling. Default is to + cycle. + + + + +X Version 11 17-May-97 1 + + + + + +XScreenSaver(1) XScreenSaver(1) + + + --ccyyccllee--ddeellaayy + Number of microseconds between shifts of the col- + ormap; default 100000, or 1/10th second. + +EENNVVIIRROONNMMEENNTT + DDIISSPPLLAAYY to get the default host and display number. + + XXEENNVVIIRROONNMMEENNTT + to get the name of a resource file that overrides + the global resources stored in the RESOURCE_MAN- + AGER property. + +SSEEEE AALLSSOO + XX(1), xxssccrreeeennssaavveerr(1) + +AAUUTTHHOORR + Juergen Nickelsen , 23-aug-92. + + Hacked on by Jamie Zawinski , 24-aug-92, + 17-May-97. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +X Version 11 17-May-97 2 + + diff --git a/local/man/cat.1/jigsaw.1 b/local/man/cat.1/jigsaw.1 new file mode 100644 index 00000000..21893bb2 --- /dev/null +++ b/local/man/cat.1/jigsaw.1 @@ -0,0 +1,132 @@ + + + +XScreenSaver(1) XScreenSaver(1) + + +NNAAMMEE + jigsaw - permute the screen image like a jigsaw puzzle + +SSYYNNOOPPSSIISS + jjiiggssaaww [-display _h_o_s_t_:_d_i_s_p_l_a_y_._s_c_r_e_e_n] [-background _c_o_l_o_r] + [-delay _u_s_e_c_s] [-window] [-root] [-install] [-visual + _v_i_s_u_a_l] + +DDEESSCCRRIIPPTTIIOONN + The _j_i_g_s_a_w program takes an image of the screen, carves it + up into a jigsaw puzzle, shuffles it, and then solves it. + +OOPPTTIIOONNSS + _j_i_g_s_a_w accepts the following options: + + --wwiinnddooww Draw on a newly-created window. This is the + default. + + --rroooott Draw on the root window. + + --iinnssttaallll + Install a private colormap for the window. + + --vviissuuaall _v_i_s_u_a_l + 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. + + --ddeellaayy _m_i_c_r_o_s_e_c_o_n_d_s + How long to wait between shuffling pieces; default + 700000, or 0.7 seconds. + +RREESSOOUURRCCEESS + On some systems (currently, only SGIs), this program can, + instead of grabbing a desktop image, grab a frame of video + from an external camera and manipulate that instead. The + following resources control that. + + + ggrraabbVViiddeeooPPrroobbaabbiilliittyy (Float) + What portion of the time to grab video rather than + a screen image, between 0.0 and 1.0. Defaults to + 0.5, or half the time. + + vviiddeeooDDeevviiccee (Integer) + The number of the default video input device to + check first. If unspecified, the default camera + (from videopanel(1)) will be checked first. After + that, all other available video input devices will + be checked in order. + + The first one which produces a non-black image + will be used. If all images are black, the others + will be re-checked a few times before giving up + + + +X Version 11 25-Nov-97 1 + + + + + +XScreenSaver(1) XScreenSaver(1) + + + and falling back to simply grabbing a desktop + image (but note that this takes a few seconds, so + if you don't actually have any video sources + hooked up, you should consider turning off video + grabbing by setting ggrraabbVViiddeeooPPrroobbaabbiilliittyy to 0.0.) + + vviiddeeooGGaaiinn (Float) + The amount by which to brighten the grabbed image. + This defaults to 2.2. + +EENNVVIIRROONNMMEENNTT + DDIISSPPLLAAYY to get the default host and display number. + + XXEENNVVIIRROONNMMEENNTT + to get the name of a resource file that overrides + the global resources stored in the RESOURCE_MAN- + AGER property. + +SSEEEE AALLSSOO + XX(1), xxssccrreeeennssaavveerr(1) + +CCOOPPYYRRIIGGHHTT + Copyright (C) 1997 by Jamie Zawinski. Permission to use, + copy, modify, distribute, and sell this software and its + documentation for any purpose 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 + representations are made about the suitability of this + software for any purpose. It is provided "as is" without + express or implied warranty. + +AAUUTTHHOORR + Jamie Zawinski , 25-Nov-97. + + + + + + + + + + + + + + + + + + + + + + + +X Version 11 25-Nov-97 2 + + diff --git a/local/man/cat.1/kaleidescope.1 b/local/man/cat.1/kaleidescope.1 new file mode 100644 index 00000000..8aa46522 --- /dev/null +++ b/local/man/cat.1/kaleidescope.1 @@ -0,0 +1,132 @@ + + + +Kaleidescpe(1) Kaleidescpe(1) + + +NNAAMMEE + Kaleidescope - rotating line segments + +SSYYNNOOPPSSIISS + kkaalleeiiddeessccooppee [-display _h_o_s_t_:_d_i_s_p_l_a_y_._s_c_r_e_e_n] [-foreground + _c_o_l_o_r] [-background _c_o_l_o_r] [-window] [-root] [-install] + [-visual _v_i_s_u_a_l] [-color_mode _m_o_n_o _| _n_i_c_e _| _g_r_e_e_d_y] + [-nsegments _i_n_t] [-ntrails _i_n_t] [-local_rotation _i_n_t] + [-global_rotation _i_n_t] [-delay _u_s_e_c_s] [-redmin _i_n_t] + [-greenmin _i_n_t] [-bluemin _i_n_t] [-redrange _i_n_t] [-green- + range _i_n_t] [-bluerange _i_n_t] + +DDEESSCCRRIIPPTTIIOONN + The _k_a_l_e_i_d_e_s_c_o_p_e program draws line segments in a symmet- + ric pattern that evolves over time. + +OOPPTTIIOONNSS + _k_a_l_e_i_d_e_s_c_o_p_e accepts the following options: + + --rroooott Draw on the root window. + + --ccoolloorr__mmooddee mmoonnoo || nniiccee || ggrreeeeddyy + Specify how kaleidescope uses colors. Mono uses + just the default foreground and background colors. + Nice uses one color for each segment (specified by + nsegments). Greedy uses (ntrails * nsegments) + 1 + colors. + + --iinnssttaallll + Install a private colormap for the window. + + --vviissuuaall _v_i_s_u_a_l + 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. + + --nnsseeggmmeennttss iinntteeggeerr + The number of segments to draw. Default is 7. + + --nnttrraaiillss iinntteeggeerr + The number of trails to draw. Default is 100. + + --llooccaall__rroottaattiioonn iinntteeggeerr + The rate at which segments rotate around their + center. Default is -59. + + --gglloobbaall__rroottaattiioonn iinntteeggeerr + The rate at which segments rotate around the cen- + ter of the window. Default is 1. + + --rreeddmmiinn,, --ggrreeeennmmiinn,, --bblluueemmiinn,, --rreeddrraannggee,, --ggrreeeennrraannggee,, + --bblluueerraannggee + All take an integer argument. When colors are ran- + domly chosen, they are chosen from the interval + + + +X Version 11 14-Dec-95 1 + + + + + +Kaleidescpe(1) Kaleidescpe(1) + + + min to min plus range. The minimums default to + 30000. The ranges default to 20000. + + --ddeellaayy mmiiccrroosseeccoonnddss + How much of a delay should be introduced between + steps of the animation. Default is 20000, or + about 5 frames a second. + +EENNVVIIRROONNMMEENNTT + DDIISSPPLLAAYY to get the default host and display number. + + XXEENNVVIIRROONNMMEENNTT + to get the name of a resource file that overrides + the global resources stored in the RESOURCE_MAN- + AGER property. + +SSEEEE AALLSSOO + XX(1), kkaalleeiiddeessccooppee(1) + +CCOOPPYYRRIIGGHHTT + Copyright (C) 1997 by Ron Tapia. Permission to use, copy, + modify, distribute, and sell this software and its docu- + mentation for any purpose is hereby granted without fee, + provided that the above copyright notice appear in all + copies and that both that copyright notice and this per- + mission notice appear in supporting documentation. No + representations are made about the suitability of this + software for any purpose. It is provided "as is" without + express or implied warranty. + +AAUUTTHHOORR + Ron Tapia , 20-Mar-97. + + + + + + + + + + + + + + + + + + + + + + + + + +X Version 11 14-Dec-95 2 + + diff --git a/local/man/cat.1/lament.1 b/local/man/cat.1/lament.1 new file mode 100644 index 00000000..a441a9b0 --- /dev/null +++ b/local/man/cat.1/lament.1 @@ -0,0 +1,132 @@ + + + +XScreenSaver(1) XScreenSaver(1) + + +NNAAMMEE + lament - animates the Lament Configuration + +SSYYNNOOPPSSIISS + llaammeenntt [-display _h_o_s_t_:_d_i_s_p_l_a_y_._s_c_r_e_e_n] [-window] [-root] + [-install] [-visual _v_i_s_u_a_l] [-texture] [-no-texture] + [-wireframe] + +DDEESSCCRRIIPPTTIIOONN + The _l_a_m_e_n_t program draws an animation of a particular puz- + zle box repeatedly solving itself. + +OOPPTTIIOONNSS + _l_a_m_e_n_t accepts the following options: + + --wwiinnddooww Draw on a newly-created window. This is the + default. + + --rroooott Draw on the root window. + + --iinnssttaallll + Install a private colormap for the window. + + --vviissuuaall _v_i_s_u_a_l + 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. + + --tteexxttuurree + Use texture maps. This is the default. + + --nnoo--tteexxttuurree + Do not use texture maps. This is boring and + wrong. + + --wwiirreeffrraammee + Only draw outlines. + +EENNVVIIRROONNMMEENNTT + DDIISSPPLLAAYY to get the default host and display number. + + XXEENNVVIIRROONNMMEENNTT + to get the name of a resource file that overrides + the global resources stored in the RESOURCE_MAN- + AGER property. + +BBUUGGSS + This hack is glacially slow on machines lacking hardware + texture support. + + Occasionally opens doors, admitting theologians of the + Order of the Gash. + + + + + +X Version 11 25-Jul-98 1 + + + + + +XScreenSaver(1) XScreenSaver(1) + + +SSEEEE AALLSSOO + XX(1), xxssccrreeeennssaavveerr(1) + +CCOOPPYYRRIIGGHHTT + Copyright (C) 1998 by Jamie Zawinski. Permission to use, + copy, modify, distribute, and sell this software and its + documentation for any purpose 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 + representations are made about the suitability of this + software for any purpose. It is provided "as is" without + express or implied warranty. + +AAUUTTHHOORR + Jamie Zawinski , 25-Jul-98. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +X Version 11 25-Jul-98 2 + + diff --git a/local/man/cat.1/laser.1 b/local/man/cat.1/laser.1 new file mode 100644 index 00000000..f97588a4 --- /dev/null +++ b/local/man/cat.1/laser.1 @@ -0,0 +1,132 @@ + + + +XScreenSaver(1) XScreenSaver(1) + + +NNAAMMEE + laser - draws vaguely laser-like moving lines + +SSYYNNOOPPSSIISS + llaasseerr [-display _h_o_s_t_:_d_i_s_p_l_a_y_._s_c_r_e_e_n] [-foreground _c_o_l_o_r] + [-background _c_o_l_o_r] [-window] [-root] [-mono] [-install] + [-visual _v_i_s_u_a_l] [-ncolors _i_n_t_e_g_e_r] [-delay _m_i_c_r_o_s_e_c_o_n_d_s] + [-cycles _i_n_t_e_g_e_r] [-count _i_n_t_e_g_e_r] + + +DDEESSCCRRIIPPTTIIOONN + The _l_a_s_e_r program draws vaguely laser-like moving lines + +OOPPTTIIOONNSS + _l_a_s_e_r accepts the following options: + + --wwiinnddooww Draw on a newly-created window. This is the + default. + + --rroooott Draw on the root window. + + --mmoonnoo If on a color display, pretend we're on a + monochrome display. + + --iinnssttaallll + Install a private colormap for the window. + + --vviissuuaall _v_i_s_u_a_l + 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. + + --nnccoolloorrss _i_n_t_e_g_e_r + How many colors should be used (if possible). + Default 64. The colors used cycle through the + hue, making N stops around the color wheel. + + --ccyycclleess _i_n_t_e_g_e_r + Default 200. + + --ccoouunntt _i_n_t_e_g_e_r + Default 10. + +EENNVVIIRROONNMMEENNTT + DDIISSPPLLAAYY to get the default host and display number. + + XXEENNVVIIRROONNMMEENNTT + to get the name of a resource file that overrides + the global resources stored in the RESOURCE_MAN- + AGER property. + +SSEEEE AALLSSOO + XX(1), xxssccrreeeennssaavveerr(1), xxlloocckk(1) + + + + +X Version 11 10-May-97 1 + + + + + +XScreenSaver(1) XScreenSaver(1) + + +CCOOPPYYRRIIGGHHTT + Copyright (C) 1995 by Pascal Pensa. + + Permission to use, copy, modify, and distribute this soft- + ware and its documentation for any purpose and without fee + is hereby granted, provided that the above copyright + notice appear in all copies and that both that copyright + notice and this permission notice appear in supporting + documentation. + +AAUUTTHHOORR + Pascal Pensa , 1995. + + Ability to run standalone or with _x_s_c_r_e_e_n_s_a_v_e_r added by + Jamie Zawinski , 10-May-97. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +X Version 11 10-May-97 2 + + diff --git a/local/man/cat.1/lightning.1 b/local/man/cat.1/lightning.1 new file mode 100644 index 00000000..e30ef019 --- /dev/null +++ b/local/man/cat.1/lightning.1 @@ -0,0 +1,132 @@ + + + +XScreenSaver(1) XScreenSaver(1) + + +NNAAMMEE + lightning - draws fractal lightning bolts + +SSYYNNOOPPSSIISS + lliigghhttnniinngg [-display _h_o_s_t_:_d_i_s_p_l_a_y_._s_c_r_e_e_n] [-foreground + _c_o_l_o_r] [-background _c_o_l_o_r] [-window] [-root] [-mono] + [-install] [-visual _v_i_s_u_a_l] [-ncolors _i_n_t_e_g_e_r] [-delay + _m_i_c_r_o_s_e_c_o_n_d_s] + + +DDEESSCCRRIIPPTTIIOONN + The _l_i_g_h_t_n_i_n_g program draws fractal lightning bolts + +OOPPTTIIOONNSS + _l_i_g_h_t_n_i_n_g accepts the following options: + + --wwiinnddooww Draw on a newly-created window. This is the + default. + + --rroooott Draw on the root window. + + --mmoonnoo If on a color display, pretend we're on a + monochrome display. + + --iinnssttaallll + Install a private colormap for the window. + + --vviissuuaall _v_i_s_u_a_l + 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. + + --nnccoolloorrss _i_n_t_e_g_e_r + How many colors should be used (if possible). + Default 64. The colors are chosen randomly. + +EENNVVIIRROONNMMEENNTT + DDIISSPPLLAAYY to get the default host and display number. + + XXEENNVVIIRROONNMMEENNTT + to get the name of a resource file that overrides + the global resources stored in the RESOURCE_MAN- + AGER property. + +SSEEEE AALLSSOO + XX(1), xxssccrreeeennssaavveerr(1), xxlloocckk(1) + +CCOOPPYYRRIIGGHHTT + Copyright (C) 1996 by Keith Romberg. + + Permission to use, copy, modify, and distribute this soft- + ware and its documentation for any purpose and without fee + is hereby granted, provided that the above copyright + notice appear in all copies and that both that copyright + + + +X Version 11 10-May-97 1 + + + + + +XScreenSaver(1) XScreenSaver(1) + + + notice and this permission notice appear in supporting + documentation. + +AAUUTTHHOORR + Keith Romberg , 27-Jun-96. + + Ability to run standalone or with _x_s_c_r_e_e_n_s_a_v_e_r added by + Jamie Zawinski , 10-May-97. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +X Version 11 10-May-97 2 + + diff --git a/local/man/cat.1/lisa.1 b/local/man/cat.1/lisa.1 new file mode 100644 index 00000000..ab6ba005 --- /dev/null +++ b/local/man/cat.1/lisa.1 @@ -0,0 +1,132 @@ + + + +XScreenSaver(1) XScreenSaver(1) + + +NNAAMMEE + lisa - draws animated full-loop lisajous figures + +SSYYNNOOPPSSIISS + lliissaa [-display _h_o_s_t_:_d_i_s_p_l_a_y_._s_c_r_e_e_n] [-foreground _c_o_l_o_r] + [-background _c_o_l_o_r] [-window] [-root] [-mono] [-install] + [-visual _v_i_s_u_a_l] [-ncolors _i_n_t_e_g_e_r] [-delay _m_i_c_r_o_s_e_c_o_n_d_s] + [-cycles _i_n_t_e_g_e_r] [-count _i_n_t_e_g_e_r] [-size _i_n_t_e_g_e_r] + + +DDEESSCCRRIIPPTTIIOONN + The _l_i_s_a program draws animated full-loop lisajous fig- + ures. + +OOPPTTIIOONNSS + _l_i_s_a accepts the following options: + + --wwiinnddooww Draw on a newly-created window. This is the + default. + + --rroooott Draw on the root window. + + --mmoonnoo If on a color display, pretend we're on a + monochrome display. + + --iinnssttaallll + Install a private colormap for the window. + + --vviissuuaall _v_i_s_u_a_l + 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. + + --nnccoolloorrss _i_n_t_e_g_e_r + How many colors should be used (if possible). + Default 200. The colors are chosen randomly. + + --ccyycclleess _i_n_t_e_g_e_r + + + --ccoouunntt _i_n_t_e_g_e_r + + + --ssiizzee _i_n_t_e_g_e_r + + +EENNVVIIRROONNMMEENNTT + DDIISSPPLLAAYY to get the default host and display number. + + XXEENNVVIIRROONNMMEENNTT + to get the name of a resource file that overrides + the global resources stored in the RESOURCE_MAN- + AGER property. + + + + +X Version 11 27-May-97 1 + + + + + +XScreenSaver(1) XScreenSaver(1) + + +SSEEEE AALLSSOO + XX(1), xxssccrreeeennssaavveerr(1), xxlloocckk(1) + +CCOOPPYYRRIIGGHHTT + Copyright (C) 1997 by Caleb Cullen. + + Permission to use, copy, modify, and distribute this soft- + ware and its documentation for any purpose and without fee + is hereby granted, provided that the above copyright + notice appear in all copies and that both that copyright + notice and this permission notice appear in supporting + documentation. + +AAUUTTHHOORR + Caleb Cullen, 1997. + + Ability to run standalone or with _x_s_c_r_e_e_n_s_a_v_e_r added by + Jamie Zawinski , 27-May-97. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +X Version 11 27-May-97 2 + + diff --git a/local/man/cat.1/lmorph.1 b/local/man/cat.1/lmorph.1 new file mode 100644 index 00000000..80566143 --- /dev/null +++ b/local/man/cat.1/lmorph.1 @@ -0,0 +1,132 @@ + + + +LMORPH(1) LMORPH(1) + + +NNAAMMEE + lmorph - morphing lines + +SSYYNNOOPPSSIISS + llmmoorrpphh [-display _h_o_s_t_:_d_i_s_p_l_a_y_._s_c_r_e_e_n] [-foreground _c_o_l_o_r] + [-background _c_o_l_o_r] [-window] [-root] [-mono] [-install] + [-visual _v_i_s_u_a_l] [-points _i_n_t] [-steps _i_n_t] [-delay _u_s_e_c_s] + [-figtype _t_y_p_e] + +DDEESSCCRRIIPPTTIIOONN + The _l_m_o_r_p_h program morphs between simple linedrawings + using bilinear interpolation. + +OOPPTTIIOONNSS + _l_m_o_r_p_h accepts the following options: + + --wwiinnddooww Draw on a newly-created window. This is the + default. + + --rroooott Draw on the root window. + + --mmoonnoo If on a color display, pretend we're on a + monochrome display. + + --iinnssttaallll + Install a private colormap for the window. + + --vviissuuaall _v_i_s_u_a_l + 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. + + --ppooiinnttss _i_n_t_e_g_e_r + Number of points in each line drawing. Default is + 150 points. + + --sstteeppss _i_n_t_e_g_e_r + Interpolation steps from one drawing to the next. + Default is 0, which means a random number between + 100 and 500. + + --ddeellaayy _m_i_c_r_o_s_e_c_o_n_d_s + How much of a delay should be introduced between + steps of the animation. Default 50000. + + --ffiiggttyyppee _t_y_p_e + Limit the figures to only open or closed figures. + Possible types are "all" (default), "open" and + "closed". + +EENNVVIIRROONNMMEENNTT + DDIISSPPLLAAYY to get the default host and display number. + + + + + + xscreensaver hack 1 + + + + + +LMORPH(1) LMORPH(1) + + + XXEENNVVIIRROONNMMEENNTT + to get the name of a resource file that overrides + the global resources stored in the RESOURCE_MAN- + AGER property. + +SSEEEE AALLSSOO + XX(1), xxssccrreeeennssaavveerr(1) + +AAUUTTHHOORR + Sverre H. Huseby and Glenn T. Lines + , built on top of the screen saver rou- + tines by Jamie Zawinski . + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + xscreensaver hack 2 + + diff --git a/local/man/cat.1/maze.1 b/local/man/cat.1/maze.1 new file mode 100644 index 00000000..8c460d2e --- /dev/null +++ b/local/man/cat.1/maze.1 @@ -0,0 +1,264 @@ + + + +XScreenSaver(1) XScreenSaver(1) + + +NNAAMMEE + maze - an automated X11 demo repeatedly creating and solv- + ing a random maze + +SSYYNNOOPPSSIISS + mmaazzee [-display _h_o_s_t_:_d_i_s_p_l_a_y_._s_c_r_e_e_n] [-foreground _c_o_l_o_r] + [-background _c_o_l_o_r] [-window] [-root] [-install] [-visual + _v_i_s_u_a_l] [-grid-size _p_i_x_e_l_s] [-live-color _c_o_l_o_r] + [-dead-color _c_o_l_o_r] [-solve-delay _u_s_e_c_s] [-pre-delay + _u_s_e_c_s] [-post-delay _u_s_e_c_s] [-generator _i_n_t_e_g_e_r] + [-max-length _i_n_t_e_g_e_r] [-bridge] [-no-bridge] + +DDEESSCCRRIIPPTTIIOONN + The _m_a_z_e program creates a "random" maze and then solves + it with graphical feedback. + +OOPPTTIIOONNSS + _m_a_z_e accepts the following options: + + --wwiinnddooww Draw on a newly-created window. This is the + default. + + --rroooott Draw on the root window. + + --iinnssttaallll + Install a private colormap for the window. + + --vviissuuaall _v_i_s_u_a_l + 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. + + --ggrriidd--ssiizzee _p_i_x_e_l_s + The size of each block of the maze, in pixels; + default is 0, meaning pick a random grid size. + + --lliivvee--ccoolloorr _c_o_l_o_r + The color of the path. + + --ddeeaadd--ccoolloorr _c_o_l_o_r + The color of the failed path (it is also stippled + with a 50% pattern.) + + --sskkiipp--ccoolloorr _c_o_l_o_r + The maze solver will choose to not go down a path + if it can "see" (in a straight line) that it is a + dead end. This is the color to use for paths that + are skipped for this reason. + + --ssuurrrroouunndd--ccoolloorr _c_o_l_o_r + If the maze solver ever completely encloses an + area within the maze, then it knows that the exit + is not in there (and in fact the interior of that + area might not even be reachable.) It will mark + + + +X Version 11 7-mar-93 1 + + + + + +XScreenSaver(1) XScreenSaver(1) + + + out those cells using this color. + + --ssoollvvee--ddeellaayy _i_n_t_e_g_e_r + Delay (in microseconds) between each step of the + solution path. Default 5000, or about 1/200th + second. + + --pprree--ddeellaayy _i_n_t_e_g_e_r + Delay (in microseconds) between generating a maze + and starting to solve it. Default 2000000 (2 sec- + onds.) + + --ppoosstt--ddeellaayy _i_n_t_e_g_e_r + Delay (in microseconds) after solving a maze and + before generating a new one. Default 4000000 (4 + seconds.) + + --ggeenneerraattoorr _n_u_m + Sets the algorithm that will be used to generate + the mazes. The default is -1, which randomly + selects an algorithm for each maze that is gener- + ated. Generator 0 is the original one, and works + by walking around randomly until we hit a place + we've been before, then backtracking and trying a + new direction somewhere. Generator 1 picks a ran- + dom spot in the maze, then draws a straight wall + from that spot in a random direction until it hits + another wall (and continues until the maze is com- + plete). Generator 2 is based on sets. Initially + all cells are in different sets. Then two neigh- + boring cells are chosen and if they are in differ- + ent sets, their sets are joined. If they were in + the same set, a wall is built between them. This + continues until the maze is complete. + + All generators generate mazes with a certain + 'characteristic'. See if you can spot them! + + --mmaaxx--lleennggtthh _n_u_m + Controls the maximum length of walls drawn in one + go by generator 1. + + --bbrriiddggee + + --nnoo--bbrriiddggee + Controls whether or not a 'bridge' will appear + over the logo. + + Clicking the mouse in the maze window controls it. + + LLeeffttBBuuttttoonn Clears the window and restarts maze. + + MMiiddddlleeBBuuttttoonn Pause or unpause the program. + + + + +X Version 11 7-mar-93 2 + + + + + +XScreenSaver(1) XScreenSaver(1) + + + RRiigghhttBBuuttttoonn Exit. + +BBUUGGSS + Expose events force a restart of maze. + + Mouse actions are based on "raw" values (Button1, Button2 + and Button3) instead of using the pointer map. + +EENNVVIIRROONNMMEENNTT + DDIISSPPLLAAYY to get the default host and display number. + + XXEENNVVIIRROONNMMEENNTT + to get the name of a resource file that overrides + the global resources stored in the RESOURCE_MAN- + AGER property. + +SSEEEE AALLSSOO + XX(1), xxssccrreeeennssaavveerr(1) + +CCOOPPYYRRIIGGHHTT + Copyright (C) 1988 by Sun Microsystems, Inc. Mountain + View, CA. + + All Rights Reserved + + Permission to use, copy, modify, and distribute this soft- + ware and its documentation for any purpose and without fee + is hereby granted, provided that the above copyright + notice appear in all copies and that both that copyright + notice and this permission notice appear in supporting + documentation, and that the names of Sun or MIT not be + used in advertising or publicity pertaining to distribu- + tion of the software without specific prior written per- + mission. Sun and M.I.T. make no representations about the + suitability of this software for any purpose. It is pro- + vided "as is" without any express or implied warranty. + + SUN DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, + INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND + FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL SUN BE + LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES + OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA + OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE + OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION + WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. + +AAUUTTHHOORR((ss)) + Zack Weinberg [ Smarter maze-solver ] zack@rabi.phys.columbia.edu + Johannes Keukelaar [ Generators 1 and 2 ] johannes@nada.kth.se + Royal Institute of Technology, Stockholm, Sweden + Jim Randell [ XScreenSaver version ] jmr@mddjmr.fc.hp.com + HPLabs, Bristol + Richard Hess [ X11 extensions ] {...}!uunet!cimshop!rhess + Consilium, Mountain View, CA + + + +X Version 11 7-mar-93 3 + + + + + +XScreenSaver(1) XScreenSaver(1) + + + Dave Lemke [ X11 version ] lemke@sun.COM + Sun MicroSystems, Mountain View, CA + Martin Weiss [ SunView version ] + Sun MicroSystems, Mountain View, CA + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +X Version 11 7-mar-93 4 + + diff --git a/local/man/cat.1/moire.1 b/local/man/cat.1/moire.1 new file mode 100644 index 00000000..4361a3c3 --- /dev/null +++ b/local/man/cat.1/moire.1 @@ -0,0 +1,132 @@ + + + +XScreenSaver(1) XScreenSaver(1) + + +NNAAMMEE + halo - draw circular interference patterns + +SSYYNNOOPPSSIISS + hhaalloo [-display _h_o_s_t_:_d_i_s_p_l_a_y_._s_c_r_e_e_n] [-foreground _c_o_l_o_r] + [-background _c_o_l_o_r] [-window] [-root] [-mono] [-install] + [-visual _v_i_s_u_a_l] [-delay _s_e_c_o_n_d_s] [-random _b_o_o_l_e_a_n] + [-ncolors _i_n_t] [-offset _i_n_t] + +DDEESSCCRRIIPPTTIIOONN + The _m_o_i_r_e program draws cool circular interference pat- + terns. + +OOPPTTIIOONNSS + _m_o_i_r_e accepts the following options: + + --wwiinnddooww Draw on a newly-created window. This is the + default. + + --rroooott Draw on the root window. + + --mmoonnoo If on a color display, pretend we're on a + monochrome display. + + --iinnssttaallll + Install a private colormap for the window. + + --vviissuuaall _v_i_s_u_a_l + 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. + + --ddeellaayy _s_e_c_o_n_d_s + How long to wait before starting over. Default 5 + seconds. + + --rraannddoomm _b_o_o_l_e_a_n + Whether to ignore the foreground/background col- + ors, and pick them randomly instead. + + --ooffffsseett _i_n_t_e_g_e_r + The maximum random radius increment to use. + + --nnccoolloorrss _i_n_t_e_g_e_r + How many colors should be allocated in the color + ramp (note that this value interacts with _o_f_f_s_e_t.) + +EENNVVIIRROONNMMEENNTT + DDIISSPPLLAAYY to get the default host and display number. + + XXEENNVVIIRROONNMMEENNTT + to get the name of a resource file that overrides + the global resources stored in the RESOURCE_MAN- + AGER property. + + + +X Version 11 27-Apr-97 1 + + + + + +XScreenSaver(1) XScreenSaver(1) + + +SSEEEE AALLSSOO + XX(1), xxssccrreeeennssaavveerr(1) + +CCOOPPYYRRIIGGHHTT + Copyright (C) 1997 by Jamie Zawinski. Permission to use, + copy, modify, distribute, and sell this software and its + documentation for any purpose 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 + representations are made about the suitability of this + software for any purpose. It is provided "as is" without + express or implied warranty. + +AAUUTTHHOORR + Jamie Zawinski , 27-Apr-97, based on code by + Michael D. Bayne . + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +X Version 11 27-Apr-97 2 + + diff --git a/local/man/cat.1/munch.1 b/local/man/cat.1/munch.1 new file mode 100644 index 00000000..35203b02 --- /dev/null +++ b/local/man/cat.1/munch.1 @@ -0,0 +1,198 @@ + + + +XScreenSaver(1) XScreenSaver(1) + + +NNAAMMEE + munch - munching squares screen hack + +SSYYNNOOPPSSIISS + mmuunncchh [-display _h_o_s_t_:_d_i_s_p_l_a_y_._s_c_r_e_e_n] [-foreground _c_o_l_o_r] + [-background _c_o_l_o_r] [-window] [-root] [-mono] [-install] + [-visual _v_i_s_u_a_l] [-delay _s_e_c_o_n_d_s] [-xor] [-noxor] [-shift] + [-noshift] [-logminwidth _m_i_n_i_m_u_m _w_i_d_t_h] + +DDEESSCCRRIIPPTTIIOONN + The _m_u_n_c_h program preforms the munching squares hack until + killed. It picks square size, position, and gravity ran- + domly; configurable options are listed below. + + The munching squares hack cosists of drawing Y = X XOR T + for a range of X and T over and over until all the possi- + ble combinations of X and T have come up. It was report- + edly discovered by Jackson Wright in 1962 and took 5 + instructions of PDP-6 code. + +OOPPTTIIOONNSS + _m_u_n_c_h accepts the following options: + + --wwiinnddooww Draw on a newly-created window. This is the + default. + + --rroooott Draw on the root window. + + --mmoonnoo If on a color display, pretend we're on a + monochrome display. + + --iinnssttaallll + Install a private colormap for the window. + + --vviissuuaall _v_i_s_u_a_l + 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. + + --ddeellaayy _s_e_c_o_n_d_s + How long to wait before starting over. Default 5 + seconds. + + --xxoorr Use the XOR drawing function. (Default.) + + --nnoo--xxoorr Don't use the XOR drawing function. + + --sshhiifftt Start drawing the square at weird starting points. + (Default.) + + --nnoo--sshhiifftt + Don't shift and start drawing the square at weird + starting points. + + + + +X Version 11 17-Jun-97 1 + + + + + +XScreenSaver(1) XScreenSaver(1) + + + --llooggmmiinnwwiiddtthh _m_i_n_i_m_u_m_-_w_i_d_t_h + The logarithm (base 2) of the minimum with of a + square (must be a power of 2, or some parts of the + square aren't.) + +EENNVVIIRROONNMMEENNTT + DDIISSPPLLAAYY to get the default host and display number. + + XXEENNVVIIRROONNMMEENNTT + to get the name of a resource file that overrides + the global resources stored in the RESOURCE_MAN- + AGER property. + +SSEEEE AALLSSOO + XX(1), xxssccrreeeennssaavveerr(1), + hhttttpp::////wwwwww..iinnwwaapp..ccoomm//ppddpp1100//hhbbaakkeerr//hhaakkmmeemm//hhaakkmmeemm..hhttmmll,, + hhttttpp::////wwwwww..ccoommeeddiiaa..ccoomm//HHoott//jjaarrggoonn__33..00//JJAARRGGOONN__MM//MMUUNNCCHH-- + SSQQRR..HHTTMMLL + +HHIISSTTOORRYY + Quoted from HAKMEM, for historical interest. As that doc- + ument says, "Unless otherwise stated, all computer pro- + grams are in PDP-6/10 assembly language." + + ITEM 146: MUNCHING SQUARES + Another simple display program. It is thought that + this was discovered by Jackson Wright on the RLE + PDP-1 circa 1962. + + + DATAI 2 + ADDB 1,2 + ROTC 2,-22 + XOR 1,2 + JRST .-4 + + 2=X, 3=Y. Try things like 1001002 in data + switches. This also does interesting things with + operations other than XOR, and rotations other + than -22. (Try IOR; AND; TSC; FADR; FDV(!); ROT + -14, -9, -20, ...) + + ITEM 147 (Schroeppel): + Munching squares is just views of the graph Y = X + XOR T for consecutive values of T = time. + + ITEM 148 (Cohen, Beeler): + A modification to munching squares which reveals + them in frozen states through opening and closing + curtains: insert FADR 2,1 before the XOR. Try data + switches = + + + + + + +X Version 11 17-Jun-97 2 + + + + + +XScreenSaver(1) XScreenSaver(1) + + + 4000,,4 1000,,2002 2000,,4 0,,1002 + + (Notation: ,,) + + Also try the FADR after the XOR, switches = + 1001,,1. + +CCOOPPYYRRIIGGHHTT + Copyright (C) 1997 by Tim Showalter. Permission to use, + copy, modify, distribute, and sell this software and its + documentation for any purpose 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 + representations are made about the suitability of this + software for any purpose. It is provided "as is" without + express or implied warranty. + +AAUUTTHHOORR + Tim Showalter , 17-Jun-97, based on + what's in the Jargon File and stealing stuff from existing + xscreensaver modules. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +X Version 11 17-Jun-97 3 + + diff --git a/local/man/cat.1/noseguy.1 b/local/man/cat.1/noseguy.1 new file mode 100644 index 00000000..bf536098 --- /dev/null +++ b/local/man/cat.1/noseguy.1 @@ -0,0 +1,132 @@ + + + +XScreenSaver(1) XScreenSaver(1) + + +NNAAMMEE + noseguy - a little guy with a big nose wanders around + being witty + +SSYYNNOOPPSSIISS + nnoosseegguuyy [-display _h_o_s_t_:_d_i_s_p_l_a_y_._s_c_r_e_e_n] [-foreground _c_o_l_o_r] + [-background _c_o_l_o_r] [-text-foreground _c_o_l_o_r] [-text-back- + ground _c_o_l_o_r] [-font _f_o_n_t] [-window] [-root] [-install] + [-visual _v_i_s_u_a_l] [-mode _m_o_d_e] [-program _p_r_o_g_r_a_m] [-file- + name le_] _[_-_t_e_x_t _t_e_x_t_] + +DDEESSCCRRIIPPTTIIOONN + A little man with a big nose and a hat runs around spewing + out messages to the screen. This code (and its bitmaps) + were extracted from the _x_n_l_o_c_k program. + +OOPPTTIIOONNSS + _n_o_s_e_g_u_y accepts the following options: + + --wwiinnddooww Draw on a newly-created window. This is the + default. + + --rroooott Draw on the root window. + + --iinnssttaallll + Install a private colormap for the window. + + --vviissuuaall _v_i_s_u_a_l + 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. + + --ffoonntt _f_o_n_t + The font used for the messages. + + --mmooddee [[ pprrooggrraamm || ffiillee || ssttrriinngg ]] + In _p_r_o_g_r_a_m mode, the messages are gotten by run- + ning a program. The program used is controlled by + the _-_p_r_o_g_r_a_m option, and the _._p_r_o_g_r_a_m resource. + + In _f_i_l_e_n_a_m_e mode, the message used is the contents + of a file. The file used is controlled by the + _-_f_i_l_e option, and the _._f_i_l_e_n_a_m_e resource. + + In _s_t_r_i_n_g mode, the message is whatever was speci- + fied on the command line as the _-_t_e_x_t option, or + in the resource database as the _._t_e_x_t resource. + + --pprrooggrraamm _p_r_o_g_r_a_m + If _m_o_d_e is _p_r_o_g_r_a_m (the default), then this pro- + gram will be run periodically, and its output will + be the text of the messages. The default program + is _"_f_o_r_t_u_n_e _-_s_", but _y_o_w is also a good choice. + + + + +X Version 11 13-aug-92 1 + + + + + +XScreenSaver(1) XScreenSaver(1) + + + --ffiilleennaammee _f_i_l_e + If _m_o_d_e is _f_i_l_e, then the contents of this file + will be used for all messages. + + --tteexxtt _s_t_r_i_n_g + If _m_o_d_e is _s_t_r_i_n_g, then this text will be used for + all messages. + +EENNVVIIRROONNMMEENNTT + DDIISSPPLLAAYY to get the default host and display number. + + XXEENNVVIIRROONNMMEENNTT + to get the name of a resource file that overrides + the global resources stored in the RESOURCE_MAN- + AGER property. + +SSEEEE AALLSSOO + XX(1), xxssccrreeeennssaavveerr(1), xxnnlloocckk(1) + +CCOOPPYYRRIIGGHHTT + Copyright 1985, 1990 by Dan Heller . + +AAUUTTHHOORR + Dan Heller , 1985. + + Ability to run standalone or with _x_s_c_r_e_e_n_s_a_v_e_r added by + Jamie Zawinski , 13-aug-92. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +X Version 11 13-aug-92 2 + + diff --git a/local/man/cat.1/pedal.1 b/local/man/cat.1/pedal.1 new file mode 100644 index 00000000..b31f6b80 --- /dev/null +++ b/local/man/cat.1/pedal.1 @@ -0,0 +1,132 @@ + + + +XScreenSaver(1) XScreenSaver(1) + + +NNAAMMEE + pedal - pretty geometric picture program + +SSYYNNOOPPSSIISS + ppeeddaall [-display _h_o_s_t_:_d_i_s_p_l_a_y_._s_c_r_e_e_n] [-foreground _c_o_l_o_r] + [-background _c_o_l_o_r] [-window] [-root] [-delay _s_e_c_o_n_d_s] + [-maxlines _n_u_m_b_e_r] [-fadedelay _u_s_e_c_o_n_d_s] [-mono] + [-install] [-visual _v_i_s_u_a_l] + +DDEESSCCRRIIPPTTIIOONN + The _p_e_d_a_l program displays pretty geometric pictures. + +OOPPTTIIOONNSS + _p_e_d_a_l accepts the following options: + + --wwiinnddooww Draw on a newly-created window. This is the + default. + + --rroooott Draw on the root window. + + --ffoorreeggrroouunndd _c_o_l_o_r + The color for the foreground. Default is white. + + --bbaacckkggrroouunndd _c_o_l_o_r + The color for the background. Default is black. + + --ddeellaayy _s_e_c_o_n_d_s + The number of seconds to pause between each pic- + ture. + + --mmaaxxlliinneess _n_u_m_b_e_r + The maximum number of lines in the drawing. Good + values are between 20 and 2000. Maximum value is + 16K. + + --ffaaddeeddeellaayy _m_i_c_r_o_s_e_c_o_n_d_s + The number of micro seconds to take when fading in + and out. + + --mmoonnoo Don't do fading. Pretend we're on a monochrome + display. + + To make your X server grunt under load, and to impress + your friends, try _p_e_d_a_l _-_m_o_n_o _-_d_e_l_a_y _0 _-_m_a_x_l_i_n_e_s _1_0_0_. + +EENNVVIIRROONNMMEENNTT + DDIISSPPLLAAYY to get the default host and display number. + + XXEENNVVIIRROONNMMEENNTT + to get the name of a resource file that overrides + the global resources stored in the RESOURCE_MAN- + AGER property. + + + + + +X Version 11 24-Jun-94 1 + + + + + +XScreenSaver(1) XScreenSaver(1) + + +SSEEEE AALLSSOO + XX(1), xxssccrreeeennssaavveerr(1) + +CCOOPPYYRRIIGGHHTT + Copyright (C) 1994, by Carnegie Mellon University. Per- + mission to use, copy, modify, distribute, and sell this + software and its documentation for any purpose is hereby + granted without fee, provided fnord that the above copy- + right notice appear in all copies and that both that copy- + right notice and this permission notice appear in support- + ing documentation. No representations are made about the + suitability of fnord this software for any purpose. It is + provided "as is" without express or implied warranty. + +AAUUTTHHOORR + Dale Moore , 24-Jun-1994. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +X Version 11 24-Jun-94 2 + + diff --git a/local/man/cat.1/penrose.1 b/local/man/cat.1/penrose.1 new file mode 100644 index 00000000..8bdb131e --- /dev/null +++ b/local/man/cat.1/penrose.1 @@ -0,0 +1,198 @@ + + + +XScreenSaver(1) XScreenSaver(1) + + +NNAAMMEE + penrose - draws quasiperiodic tilings + +SSYYNNOOPPSSIISS + ppeennrroossee [-display _h_o_s_t_:_d_i_s_p_l_a_y_._s_c_r_e_e_n] [-foreground _c_o_l_o_r] + [-background _c_o_l_o_r] [-window] [-root] [-mono] [-install] + [-visual _v_i_s_u_a_l] [-ncolors _i_n_t_e_g_e_r] [-delay _m_i_c_r_o_s_e_c_o_n_d_s] + [-redoDelay _s_e_c_o_n_d_s] [-size _i_n_t_e_g_e_r] [-ammann] + [-no-ammann] + + +DDEESSCCRRIIPPTTIIOONN + The _p_e_n_r_o_s_e program draws quasiperiodic tilings. + + See Onoda, Steinhardt, DiVincenzo and Socolar in Phys. + Rev. Lett. 60, #25, 1988 or Strandburg in Computers in + Physics, Sep/Oct 1991. + + This implementation uses the simpler version of the growth + algorithm, i.e., if there are no forced vertices, a ran- + domly chosen tile is added to a randomly chosen vertex (no + preference for those 108 degree angles). + + There are two essential differences to the algorithm pre- + sented in the literature: First, we do not allow the + tiling to enclose an untiled area. Whenever this is in + danger of happening, we just do not add the tile, hoping + for a better random choice the next time. Second, when + choosing a vertex randomly, we will take one that lies + withing the viewport if available. If this seems to cause + enclosures in the forced rule case, we will allow invisi- + ble vertices to be chosen. + + Tiling is restarted whenever one of the following happens: + there are no incomplete vertices within the viewport or + the tiling has extended a window's length beyond the edge + of the window horizontally or vertically or forced rule + choice has failed 100 times due to areas about to become + enclosed. + + Although quasiperiodic tilings are produced, the tiles + themselves are not penrose tiles (darts and kites). In + contrast to penrose tiles, these tiles can be arranged to + form a periodic tiling. + + +OOPPTTIIOONNSS + _p_e_n_r_o_s_e accepts the following options: + + --wwiinnddooww Draw on a newly-created window. This is the + default. + + --rroooott Draw on the root window. + + + + +X Version 11 10-May-97 1 + + + + + +XScreenSaver(1) XScreenSaver(1) + + + --mmoonnoo If on a color display, pretend we're on a + monochrome display. + + --iinnssttaallll + Install a private colormap for the window. + + --vviissuuaall _v_i_s_u_a_l + 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. + + --nnccoolloorrss _i_n_t_e_g_e_r + How many colors should be used (if possible). + Default 64. The colors are chosen randomly. + + --ssiizzee _i_n_t_e_g_e_r + How big the tiles should be. Default 40 pixels. + + + --ddeellaayy _m_i_l_l_i_s_e_c_o_n_d_s + How long (in 1/1,000,000'ths of a second) to wait + between drawing each tile. Default 10,000 or .01 + seconds. + + + --rreeddooDDeellaayy _s_e_c_o_n_d_s + How long to wait between starting a completely new + tiling. Default 3 seconds. + + + --aammmmaannnn _i_n_t_e_g_e_r + + --nnoo--aammmmaannnn _i_n_t_e_g_e_r + Whether Ammann lines should be added. + + +EENNVVIIRROONNMMEENNTT + DDIISSPPLLAAYY to get the default host and display number. + + XXEENNVVIIRROONNMMEENNTT + to get the name of a resource file that overrides + the global resources stored in the RESOURCE_MAN- + AGER property. + +SSEEEE AALLSSOO + XX(1), xxssccrreeeennssaavveerr(1), xxlloocckk(1) + +CCOOPPYYRRIIGGHHTT + Copyright (C) 1996 by Timo Korvola. + + Permission to use, copy, modify, and distribute this soft- + ware and its documentation for any purpose and without fee + is hereby granted, provided that the above copyright + notice appear in all copies and that both that copyright + + + +X Version 11 10-May-97 2 + + + + + +XScreenSaver(1) XScreenSaver(1) + + + notice and this permission notice appear in supporting + documentation. + +AAUUTTHHOORR + Timo Korvola , 1996. + + Ability to run standalone or with _x_s_c_r_e_e_n_s_a_v_e_r added by + Jamie Zawinski , 10-May-97. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +X Version 11 10-May-97 3 + + diff --git a/local/man/cat.1/pyro.1 b/local/man/cat.1/pyro.1 new file mode 100644 index 00000000..d45279c2 --- /dev/null +++ b/local/man/cat.1/pyro.1 @@ -0,0 +1,132 @@ + + + +XScreenSaver(1) XScreenSaver(1) + + +NNAAMMEE + pyro - simulate fireworks + +SSYYNNOOPPSSIISS + ppyyrroo [-display _h_o_s_t_:_d_i_s_p_l_a_y_._s_c_r_e_e_n] [-foreground _c_o_l_o_r] + [-background _c_o_l_o_r] [-window] [-root] [-mono] [-install] + [-visual _v_i_s_u_a_l] [-count _i_n_t_e_g_e_r] [-frequency _i_n_t_e_g_e_r] + [-scatter _i_n_t_e_g_e_r] + +DDEESSCCRRIIPPTTIIOONN + The _p_y_r_o program simulates fireworks, in a way similar to + a Macintosh program of the same name. + +OOPPTTIIOONNSS + _p_y_r_o accepts the following options: + + --wwiinnddooww Draw on a newly-created window. This is the + default. + + --rroooott Draw on the root window. + + --mmoonnoo If on a color display, pretend we're on a + monochrome display. + + --iinnssttaallll + Install a private colormap for the window. + + --vviissuuaall _v_i_s_u_a_l + 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. + + --ccoouunntt _i_n_t_e_g_e_r + How many particles should be allowed on the screen + at once. Default 100. + + --ffrreeqquueennccyy _i_n_t_e_g_e_r + How often new missiles should launch. Default 30. + + --ssccaatttteerr _i_n_t_e_g_e_r + How many particles should appear when a missile + explodes. Default 20. The actual number used is + between _N and _N_+_(_N_/_2_). + +EENNVVIIRROONNMMEENNTT + DDIISSPPLLAAYY to get the default host and display number. + + XXEENNVVIIRROONNMMEENNTT + to get the name of a resource file that overrides + the global resources stored in the RESOURCE_MAN- + AGER property. + +SSEEEE AALLSSOO + XX(1), xxssccrreeeennssaavveerr(1) + + + +X Version 11 13-aug-92 1 + + + + + +XScreenSaver(1) XScreenSaver(1) + + +CCOOPPYYRRIIGGHHTT + Copyright (C) 1992 by Jamie Zawinski. Permission to use, + copy, modify, distribute, and sell this software and its + documentation for any purpose 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 + representations are made about the suitability of this + software for any purpose. It is provided "as is" without + express or implied warranty. + +AAUUTTHHOORR + Jamie Zawinski , 13-aug-92. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +X Version 11 13-aug-92 2 + + diff --git a/local/man/cat.1/qix.1 b/local/man/cat.1/qix.1 new file mode 100644 index 00000000..d99d5d89 --- /dev/null +++ b/local/man/cat.1/qix.1 @@ -0,0 +1,198 @@ + + + +XScreenSaver(1) XScreenSaver(1) + + +NNAAMMEE + qix - bounce colored lines around a window + +SSYYNNOOPPSSIISS + qqiixx [-display _h_o_s_t_:_d_i_s_p_l_a_y_._s_c_r_e_e_n] [-foreground _c_o_l_o_r] + [-background _c_o_l_o_r] [-window] [-root] [-mono] [-install] + [-visual _v_i_s_u_a_l] [-segments _i_n_t] [-spread _p_i_x_e_l_s] [-size + _p_i_x_e_l_s] [-count _i_n_t] [-color-shift _d_e_g_r_e_e_s] [-delay _u_s_e_c_s] + [-random] [-linear] [-solid] [-hollow] [-xor] [-no-xor] + [-transparent] [-non-transparent] [-additive] [-subtrac- + tive] [-poly _i_n_t] [-gravity] [-no-gravity] + +DDEESSCCRRIIPPTTIIOONN + The _q_i_x program bounces a series of line segments around + its window. This is truly the swiss army chainsaw of qix + programs. If you know of one with more display modes, I + want to know about it. + +OOPPTTIIOONNSS + _q_i_x accepts the following options: + + --wwiinnddooww Draw on a newly-created window. This is the + default. + + --rroooott Draw on the root window. + + --mmoonnoo If on a color display, pretend we're on a + monochrome display. + + --iinnssttaallll + Install a private colormap for the window. + + --vviissuuaall _v_i_s_u_a_l + 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. + + --sseeggmmeennttss _i_n_t_e_g_e_r + How many line segments should be drawn. Default + 50. + + --sspprreeaadd _i_n_t_e_g_e_r + How far apart the endpoints of one segment should + be from the next. Default 8. + + --ssiizzee _i_n_t_e_g_e_r + The maximum distance one endpoint of a segment is + allowed to be from the opposite end of that seg- + ment. Default 0, meaning unlimited. + + --ccoouunntt _i_n_t_e_g_e_r + How many qixes to draw. Default 1. + + + + + +X Version 11 27-Apr-97 1 + + + + + +XScreenSaver(1) XScreenSaver(1) + + + --ccoolloorr--sshhiifftt _d_e_g_r_e_e_s + If on a color display, the color of the line seg- + ments will cycle through the spectrum. This spec- + ifies how far the hue of each segment should be + from the next, in degrees on the HSV wheel. + Default 3. + + --ddeellaayy _m_i_c_r_o_s_e_c_o_n_d_s + How much of a delay should be introduced between + steps of the animation. Default 25000, or about + 0.025 seconds. + + --rraannddoomm The _q_i_x will wander around the screen semi-ran- + domly. This is the default. + + --lliinneeaarr The opposite of _-_r_a_n_d_o_m: the _q_i_x will travel in + straight lines until it reaches a wall, and then + it will bounce. + + --ssoolliidd If this is specified, then the area between the + line segments will be filled in with the appropri- + ate color, instead of the _q_i_x simply being com- + posed of one-pixel-wide line segments. This + option looks really good in color. + + --hhoollllooww The opposite of _-_s_o_l_i_d; this is the default. + + --xxoorr If this is specified, then qix segments will be + drawn and erased with xor, instead of being drawn + in some color and erased in the background color. + This implies _-_m_o_n_o, in that only two colors can be + used. + + --ttrraannssppaarreenntt + If this is specified, and _-_c_o_u_n_t is greater than + 1, then each qix will be drawn in one color, and + when they overlap, the colors will be mixed. This + looks best in conjuction with _-_s_o_l_i_d. + + --nnoonn--ttrraannssppaarreenntt + Turns off _-_t_r_a_n_s_p_a_r_e_n_t. + + --aaddddiittiivvee + If _-_t_r_a_n_s_p_a_r_e_n_t is specified, then this option + means that the colors will be mixed using an addi- + tive color model, as if the qixes were projected + light. This is the default. + + --ssuubbttrraaccttiivvee + If _-_t_r_a_n_s_p_a_r_e_n_t is specified, then this option + means that the colors will be mixed using a sub- + tractive color model, as if the qixes were + translucent filters. + + + + +X Version 11 27-Apr-97 2 + + + + + +XScreenSaver(1) XScreenSaver(1) + + + --ppoollyy _i_n_t + How many vertices each qix-line should have: the + default is 2, meaning the traditional qix line + shape. Three will yield triangles, and so on. + + --ggrraavviittyy + + --nnoo--ggrraavviittyy + Whether there should be downward attraction. For + example, the options --ggrraavviittyy --lliinneeaarr will make + everything move in nice smooth parabolas. Gravity + is off by default. + +EENNVVIIRROONNMMEENNTT + DDIISSPPLLAAYY to get the default host and display number. + + XXEENNVVIIRROONNMMEENNTT + to get the name of a resource file that overrides + the global resources stored in the RESOURCE_MAN- + AGER property. + +SSEEEE AALLSSOO + XX(1), xxssccrreeeennssaavveerr(1) + +CCOOPPYYRRIIGGHHTT + Copyright (C) 1992 by Jamie Zawinski. Permission to use, + copy, modify, distribute, and sell this software and its + documentation for any purpose 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 + representations are made about the suitability of this + software for any purpose. It is provided "as is" without + express or implied warranty. + +AAUUTTHHOORR + Jamie Zawinski , 13-aug-92. + + Thanks to Ariel Scolnicov for the -poly and -gravity + options. + + + + + + + + + + + + + + + + + +X Version 11 27-Apr-97 3 + + diff --git a/local/man/cat.1/rd-bomb.1 b/local/man/cat.1/rd-bomb.1 new file mode 100644 index 00000000..cd9240f6 --- /dev/null +++ b/local/man/cat.1/rd-bomb.1 @@ -0,0 +1,132 @@ + + + +XScreenSaver(1) XScreenSaver(1) + + +NNAAMMEE + rd-bomb - reaction/diffusion textures + +SSYYNNOOPPSSIISS + rrdd--bboommbb [-display _h_o_s_t_:_d_i_s_p_l_a_y_._s_c_r_e_e_n] [-foreground _c_o_l_o_r] + [-background _c_o_l_o_r] [-window] [-root] [-install] [-visual + _v_i_s_u_a_l] [-width _n] [-height _n] [-reaction _n] [-diffusion + _n] [-size _f] [-speed _f] [-delay _u_s_e_c_s] + +DDEESSCCRRIIPPTTIIOONN + The _r_d_-_b_o_m_b program draws reaction/diffusion textures. + The code is derived from the 'd' mode of the "bomb" visual + musical instrument (see + http://www.cs.cmu.edu/~spot/bomb.html). I got the equa- + tions from xmorphia (http://www.ccsf.cal- + tech.edu/ismap/image.html), which is based on a version of + the Gray-Scott model taken from: + John E. Pearson "Complex Patterns in a Simple System" + Science, 261,189, 9 July 1993. + + If the frame-rate is too low, consider decreasing the + width and height of the tile, or decreasing the size of + the active part of the screen. + + +OOPPTTIIOONNSS + If one of the reaction, diffusion, radius, and palette + options is set to a negative value, then that option will + be set to a random appropriate value. + + Be sure to try "-speed 1 -size 0.1 -epoch 3000". + + _r_d_-_b_o_m_b accepts the following options: + + --wwiinnddooww Draw on a newly-created window. This is the + default. + + --rroooott Draw on the root window. + + --iinnssttaallll + Install a private colormap for the window. + + --vviissuuaall _v_i_s_u_a_l + 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. + + --wwiiddtthh _n + + --hheeiigghhtt _n + Specify the size of the tile, in pixels. + + --rreeaaccttiioonn _n + + + + +X Version 11 10-May-97 1 + + + + + +XScreenSaver(1) XScreenSaver(1) + + + --ddiiffffuussiioonn _n + These are constants in the equations that effect + its visual nature. Each may be one of 0, 1, or 2. + + --rraaddiiuuss _n + Size of the seed. + + --ppaalleettttee _n + Selects a palette. Must be between 0 and 80, + inclusive. + + --ssiizzee _f What fraction of the window is actively drawn, a + floating point number between 0 (exclusive) and 1 + (inclusive). Default is 0.66. + + --ssppeeeedd _f + When a fraction of the screen is active, the + active area moves at this rate (a floating point + number). Default is zero. Suggested value: 1.0. + + --ddeellaayy _u_s_e_c_s + How many microseconds to delay between frames; + default 1000, or about 1/1000th of a second. + +EENNVVIIRROONNMMEENNTT + DDIISSPPLLAAYY to get the default host and display number. + + XXEENNVVIIRROONNMMEENNTT + to get the name of a resource file that overrides + the global resources stored in the RESOURCE_MAN- + AGER property. + +SSEEEE AALLSSOO + XX(1), xxssccrreeeennssaavveerr(1), xxlloocckk(1) + +CCOOPPYYRRIIGGHHTT + Copyright (C) 1997 by Scott Draves. + + Permission to use, copy, modify, and distribute this soft- + ware and its documentation for any purpose and without fee + is hereby granted, provided that the above copyright + notice appear in all copies and that both that copyright + notice and this permission notice appear in supporting + documentation. + +AAUUTTHHOORR + Scott Draves , 9/97 + + + + + + + + + + +X Version 11 10-May-97 2 + + diff --git a/local/man/cat.1/rocks.1 b/local/man/cat.1/rocks.1 new file mode 100644 index 00000000..cc811b4e --- /dev/null +++ b/local/man/cat.1/rocks.1 @@ -0,0 +1,132 @@ + + + +XScreenSaver(1) XScreenSaver(1) + + +NNAAMMEE + rocks - animation of flying through an asteroid field + +SSYYNNOOPPSSIISS + rroocckkss [-display _h_o_s_t_:_d_i_s_p_l_a_y_._s_c_r_e_e_n] [-foreground _c_o_l_o_r] + [-background _c_o_l_o_r] [-window] [-root] [-mono] [-ncolors _n] + [-install] [-visual _v_i_s_u_a_l] [-count _i_n_t_e_g_e_r] [-delay + _u_s_e_c_s] [-speed _i_n_t_e_g_e_r] [-norotate] [-nomove] [-3d] + +DDEESSCCRRIIPPTTIIOONN + The _r_o_c_k_s program draws an animation of an asteroid field + moving past the observer (or vice versa). Sometimes the + observer picks up spin on Z axis. + +OOPPTTIIOONNSS + _r_o_c_k_s accepts the following options: + + --wwiinnddooww Draw on a newly-created window. This is the + default. + + --rroooott Draw on the root window. + + --mmoonnoo Make all the rocks the same color. + + --nnccoolloorrss ccoolloorrss + How many different colors to use. Default 5. + Colors are chosen randomly. + + --iinnssttaallll + Install a private colormap for the window. + + --vviissuuaall _v_i_s_u_a_l + 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. + + --ccoouunntt _i_n_t_e_g_e_r + Maximum number of rocks to draw on the screen at + once. Default 100. + + --ssppeeeedd _i_n_t_e_g_e_r + 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. + + --ddeellaayy _m_i_c_r_o_s_e_c_o_n_d_s + Number of microseconds to delay between each + frame. Default 50000, meaning about 1/20th sec- + ond. Compare and contrast with _-_s_p_e_e_d, above. + + + + + +X Version 11 13-aug-92 1 + + + + + +XScreenSaver(1) XScreenSaver(1) + + + --nnoorroottaattee + Don't rotate the observer; just fly through the + field on the level. + + --nnoommoovvee Don't turn the observer; just fly straight ahead + through the field. + + --33dd Do red/blue 3d separations: if you look at the + screen with 3d glasses, the rocks will be _j_u_m_p_i_n_g + right _o_u_t at you. Oooooh, scaaary! + +EENNVVIIRROONNMMEENNTT + DDIISSPPLLAAYY to get the default host and display number. + + XXEENNVVIIRROONNMMEENNTT + to get the name of a resource file that overrides + the global resources stored in the RESOURCE_MAN- + AGER property. + +SSEEEE AALLSSOO + XX(1), xxssccrreeeennssaavveerr(1) + +BBUUGGSS + 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. + +CCOOPPYYRRIIGGHHTT + Copyright (C) 1992 by Jamie Zawinski. Permission to use, + copy, modify, distribute, and sell this software and its + documentation for any purpose 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 + representations are made about the suitability of this + software for any purpose. It is provided "as is" without + express or implied warranty. + +AAUUTTHHOORR + 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 theil- + ing@coli.uni-sb.de. + + + + + + +X Version 11 13-aug-92 2 + + diff --git a/local/man/cat.1/rorschach.1 b/local/man/cat.1/rorschach.1 new file mode 100644 index 00000000..4592596d --- /dev/null +++ b/local/man/cat.1/rorschach.1 @@ -0,0 +1,132 @@ + + + +XScreenSaver(1) XScreenSaver(1) + + +NNAAMMEE + rorschach - simulate ink-blot patterns + +SSYYNNOOPPSSIISS + rroorrsscchhaacchh [-display _h_o_s_t_:_d_i_s_p_l_a_y_._s_c_r_e_e_n] [-foreground + _c_o_l_o_r] [-background _c_o_l_o_r] [-window] [-root] [-mono] + [-install] [-visual _v_i_s_u_a_l] [-iterations _i_n_t_e_g_e_r] [-offset + _i_n_t_e_g_e_r] [-xsymmetry] [-ysymmetry] [-erase-mode _i_n_t_e_g_e_r] + [-erase-speed _u_s_e_c_s] [-delay _s_e_c_s] + +DDEESSCCRRIIPPTTIIOONN + The _r_o_r_s_c_h_a_c_h program draws random patterns reminiscent of + the psychological test of same name. + +OOPPTTIIOONNSS + _r_o_r_s_c_h_a_c_h accepts the following options: + + --wwiinnddooww Draw on a newly-created window. This is the + default. + + --rroooott Draw on the root window. + + --mmoonnoo If on a color display, pretend we're on a + monochrome display. + + --iinnssttaallll + Install a private colormap for the window. + + --vviissuuaall _v_i_s_u_a_l + 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. + + --iitteerraattiioonnss _i_n_t_e_g_e_r + How many dots should be drawn each time. Default + 4000. + + --ooffffsseett _i_n_t_e_g_e_r + How far apart the dots should be. Default 4 pix- + els. + + --xxssyymmmmeettrryy + Whether the images should be horizontally symmet- + rical. Default true. + + --yyssyymmmmeettrryy + Whether the images should be vertically symmetri- + cal. Default false. + + --eerraassee--mmooddee _i_n_t_e_g_e_r + This sets the erase mode. Mode -1 chooses a random + mode each time. There are currently 6 modes + defined (0-5). + + + + +X Version 11 13-aug-92 1 + + + + + +XScreenSaver(1) XScreenSaver(1) + + + --eerraassee--ssppeeeedd _u_s_e_c_s + This controls the speed at which the screen will + be erased. (Delay between erasing of individual + lines.) + + --ddeellaayy _s_e_c_o_n_d_s + This sets the number of seconds that the figure + will be on the screen. + +EENNVVIIRROONNMMEENNTT + DDIISSPPLLAAYY to get the default host and display number. + + XXEENNVVIIRROONNMMEENNTT + to get the name of a resource file that overrides + the global resources stored in the RESOURCE_MAN- + AGER property. + +BBUUGGSS + May call your sanity into question. + +SSEEEE AALLSSOO + XX(1), xxssccrreeeennssaavveerr(1) + +CCOOPPYYRRIIGGHHTT + Copyright (C) 1992 by Jamie Zawinski. Permission to use, + copy, modify, distribute, and sell this software and its + documentation for any purpose 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 + representations are made about the suitability of this + software for any purpose. It is provided "as is" without + express or implied warranty. + +AAUUTTHHOORR + Jamie Zawinski , 13-aug-92. + + + + + + + + + + + + + + + + + + + + + +X Version 11 13-aug-92 2 + + diff --git a/local/man/cat.1/sierpinski.1 b/local/man/cat.1/sierpinski.1 new file mode 100644 index 00000000..b09527fd --- /dev/null +++ b/local/man/cat.1/sierpinski.1 @@ -0,0 +1,132 @@ + + + +XScreenSaver(1) XScreenSaver(1) + + +NNAAMMEE + sierpinski - draws Sierpinski triangle fractals + +SSYYNNOOPPSSIISS + ssiieerrppiinnsskkii [-display _h_o_s_t_:_d_i_s_p_l_a_y_._s_c_r_e_e_n] [-foreground + _c_o_l_o_r] [-background _c_o_l_o_r] [-window] [-root] [-mono] + [-install] [-visual _v_i_s_u_a_l] [-ncolors _i_n_t_e_g_e_r] [-delay + _m_i_c_r_o_s_e_c_o_n_d_s] [-cycles _i_n_t_e_g_e_r] [-count _i_n_t_e_g_e_r] + + +DDEESSCCRRIIPPTTIIOONN + The _s_i_e_r_p_i_n_s_k_i program draws Sierpinski triangle fractals. + +OOPPTTIIOONNSS + _s_i_e_r_p_i_n_s_k_i accepts the following options: + + --wwiinnddooww Draw on a newly-created window. This is the + default. + + --rroooott Draw on the root window. + + --mmoonnoo If on a color display, pretend we're on a + monochrome display. + + --iinnssttaallll + Install a private colormap for the window. + + --vviissuuaall _v_i_s_u_a_l + 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. + + --nnccoolloorrss _i_n_t_e_g_e_r + How many colors should be used (if possible). + Default 64. The colors are chosen randomly. + + --ccyycclleess _i_n_t_e_g_e_r + + + --ccoouunntt _i_n_t_e_g_e_r + + +EENNVVIIRROONNMMEENNTT + DDIISSPPLLAAYY to get the default host and display number. + + XXEENNVVIIRROONNMMEENNTT + to get the name of a resource file that overrides + the global resources stored in the RESOURCE_MAN- + AGER property. + +SSEEEE AALLSSOO + XX(1), xxssccrreeeennssaavveerr(1), xxlloocckk(1) + + + + + +X Version 11 10-May-97 1 + + + + + +XScreenSaver(1) XScreenSaver(1) + + +CCOOPPYYRRIIGGHHTT + Copyright (C) 1996 by Desmond Daignault. + + Permission to use, copy, modify, and distribute this soft- + ware and its documentation for any purpose and without fee + is hereby granted, provided that the above copyright + notice appear in all copies and that both that copyright + notice and this permission notice appear in supporting + documentation. + +AAUUTTHHOORR + Desmond Daignault , 05-Sep-96. + (Original xlock version was called tri.c.) + + Ability to run standalone or with _x_s_c_r_e_e_n_s_a_v_e_r added by + Jamie Zawinski , 10-May-97. (Renamed to + sierpinski.) + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +X Version 11 10-May-97 2 + + diff --git a/local/man/cat.1/slidescreen.1 b/local/man/cat.1/slidescreen.1 new file mode 100644 index 00000000..695d71df --- /dev/null +++ b/local/man/cat.1/slidescreen.1 @@ -0,0 +1,198 @@ + + + +XScreenSaver(1) XScreenSaver(1) + + +NNAAMMEE + slidescreen - permute the screen image like an 8-puzzle + +SSYYNNOOPPSSIISS + sslliiddeessccrreeeenn [-display _h_o_s_t_:_d_i_s_p_l_a_y_._s_c_r_e_e_n] [-background + _c_o_l_o_r] [-grid-size _p_i_x_e_l_s] [-ibw _p_i_x_e_l_s] [-increment _p_i_x_- + _e_l_s] [-delay _u_s_e_c_s] [-delay2 _u_s_e_c_s] [-window] [-root] + [-install] [-visual _v_i_s_u_a_l] + +DDEESSCCRRIIPPTTIIOONN + The _s_l_i_d_e_s_c_r_e_e_n program takes an image of the screen, + divides it into a grid, deletes a random square of that + grid, and then randomly slides one of the neighbors of + this "hole" into the hole (and repeat.) + +OOPPTTIIOONNSS + _s_l_i_d_e_s_c_r_e_e_n accepts the following options: + + --wwiinnddooww Draw on a newly-created window. This is the + default. + + --rroooott Draw on the root window. + + --iinnssttaallll + Install a private colormap for the window. + + --vviissuuaall _v_i_s_u_a_l + 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. + + --ggrriidd--ssiizzee _p_i_x_e_l_s + The size of the grid cells. Default 70 pixels. + + --iibbww _p_i_x_e_l_s + The size of the "gutter" between grid cells. + Default 1 pixel. + + --iinnccrreemmeenntt _p_i_x_e_l_s + How many pixels by which a piece should be moved + when sliding to a new location. Default 10 pix- + els. + + --ddeellaayy _m_i_c_r_o_s_e_c_o_n_d_s + How much of a delay should be introduced between + steps of the animation of the motion of each seg- + ment. Default 50000, which is 0.05 seconds. This + is closely related to the _-_i_n_c_r_e_m_e_n_t parameter. + + --ddeellaayy _m_i_c_r_o_s_e_c_o_n_d_s + How much of a delay should be introduced between + the end of the motion of one segment and the + beginning of the motion of another. Default + 1000000, which is one second. + + + +X Version 11 24-Nov-97 1 + + + + + +XScreenSaver(1) XScreenSaver(1) + + +RREESSOOUURRCCEESS + On some systems (currently, only SGIs), this program can, + instead of grabbing a desktop image, grab a frame of video + from an external camera and manipulate that instead. The + following resources control that. + + + ggrraabbVViiddeeooPPrroobbaabbiilliittyy (Float) + What portion of the time to grab video rather than + a screen image, between 0.0 and 1.0. Defaults to + 0.5, or half the time. + + vviiddeeooDDeevviiccee (Integer) + The number of the default video input device to + check first. If unspecified, the default camera + (from videopanel(1)) will be checked first. After + that, all other available video input devices will + be checked in order. + + The first one which produces a non-black image + will be used. If all images are black, the others + will be re-checked a few times before giving up + and falling back to simply grabbing a desktop + image (but note that this takes a few seconds, so + if you don't actually have any video sources + hooked up, you should consider turning off video + grabbing by setting ggrraabbVViiddeeooPPrroobbaabbiilliittyy to 0.0.) + + vviiddeeooGGaaiinn (Float) + The amount by which to brighten the grabbed image. + This defaults to 2.2. + +EENNVVIIRROONNMMEENNTT + DDIISSPPLLAAYY to get the default host and display number. + + XXEENNVVIIRROONNMMEENNTT + to get the name of a resource file that overrides + the global resources stored in the RESOURCE_MAN- + AGER property. + +SSEEEE AALLSSOO + XX(1), xxssccrreeeennssaavveerr(1) + +CCOOPPYYRRIIGGHHTT + Copyright (C) 1992 by Jamie Zawinski. Permission to use, + copy, modify, distribute, and sell this software and its + documentation for any purpose 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 + representations are made about the suitability of this + software for any purpose. It is provided "as is" without + express or implied warranty. + + + + +X Version 11 24-Nov-97 2 + + + + + +XScreenSaver(1) XScreenSaver(1) + + +AAUUTTHHOORR + Jamie Zawinski , 3-dec-92. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +X Version 11 24-Nov-97 3 + + diff --git a/local/man/cat.1/slip.1 b/local/man/cat.1/slip.1 new file mode 100644 index 00000000..46c8df7c --- /dev/null +++ b/local/man/cat.1/slip.1 @@ -0,0 +1,132 @@ + + + +XScreenSaver(1) XScreenSaver(1) + + +NNAAMMEE + slip - sucks your screen into a jet engine + +SSYYNNOOPPSSIISS + sslliipp [-display _h_o_s_t_:_d_i_s_p_l_a_y_._s_c_r_e_e_n] [-foreground _c_o_l_o_r] + [-background _c_o_l_o_r] [-window] [-root] [-mono] [-install] + [-visual _v_i_s_u_a_l] [-ncolors _i_n_t_e_g_e_r] [-iterations _i_n_t_e_g_e_r] + [-points _i_n_t_e_g_e_r] [-delay _m_i_c_r_o_s_e_c_o_n_d_s] [-delay2 _m_i_c_r_o_s_e_c_- + _o_n_d_s] + +DDEESSCCRRIIPPTTIIOONN + The _s_l_i_p program does lots of blits and chews up your + screen image. + +OOPPTTIIOONNSS + _s_l_i_p accepts the following options: + + --wwiinnddooww Draw on a newly-created window. This is the + default. + + --rroooott Draw on the root window. + + --mmoonnoo If on a color display, pretend we're on a + monochrome display. + + --iinnssttaallll + Install a private colormap for the window. + + --vviissuuaall _v_i_s_u_a_l + 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. + + --nnccoolloorrss _i_n_t_e_g_e_r + How many colors should be used (if possible). + Default 128. The colors used cycle through the + hue, making N stops around the color wheel. + + --ccoouunntt _i_n_t_e_g_e_r + How many whooziwhatsis to generate. Default 35. + + --ccyycclleess _i_n_t_e_g_e_r + How long to frobnicate. Default 50. + + --ddeellaayy _m_i_c_r_o_s_e_c_o_n_d_s + How long we should wait between drawing each step. + Default 50000, or about 1/20th second. + + +RREESSOOUURRCCEESS + On some systems (currently, only SGIs), this program can, + instead of grabbing a desktop image, grab a frame of video + from an external camera and manipulate that instead. The + following resources control that. + + + +X Version 11 24-Nov-97 1 + + + + + +XScreenSaver(1) XScreenSaver(1) + + + ggrraabbVViiddeeooPPrroobbaabbiilliittyy (Float) + What portion of the time to grab video rather than + a screen image, between 0.0 and 1.0. Defaults to + 0.5, or half the time. + + vviiddeeooDDeevviiccee (Integer) + The number of the default video input device to + check first. If unspecified, the default camera + (from videopanel(1)) will be checked first. After + that, all other available video input devices will + be checked in order. + + The first one which produces a non-black image + will be used. If all images are black, the others + will be re-checked a few times before giving up + and falling back to simply grabbing a desktop + image (but note that this takes a few seconds, so + if you don't actually have any video sources + hooked up, you should consider turning off video + grabbing by setting ggrraabbVViiddeeooPPrroobbaabbiilliittyy to 0.0.) + + vviiddeeooGGaaiinn (Float) + The amount by which to brighten the grabbed image. + This defaults to 2.2. + +EENNVVIIRROONNMMEENNTT + DDIISSPPLLAAYY to get the default host and display number. + + XXEENNVVIIRROONNMMEENNTT + to get the name of a resource file that overrides + the global resources stored in the RESOURCE_MAN- + AGER property. + +SSEEEE AALLSSOO + XX(1), xxssccrreeeennssaavveerr(1), xxlloocckk(1) + +CCOOPPYYRRIIGGHHTT + Copyright (C) 1992 by Scott Draves. + + Permission to use, copy, modify, and distribute this soft- + ware and its documentation for any purpose and without fee + is hereby granted, provided that the above copyright + notice appear in all copies and that both that copyright + notice and this permission notice appear in supporting + documentation. + +AAUUTTHHOORR + Scott Graves . + + Ability to run standalone or with _x_s_c_r_e_e_n_s_a_v_e_r added by + Jamie Zawinski , 18-Oct-93. + + + + + + +X Version 11 24-Nov-97 2 + + diff --git a/local/man/cat.1/sonar.1 b/local/man/cat.1/sonar.1 new file mode 100644 index 00000000..494dbc0e --- /dev/null +++ b/local/man/cat.1/sonar.1 @@ -0,0 +1,264 @@ + + + +Sonar(1) Sonar(1) + + +NNAAMMEE + sonar - display a sonar scope + +SSYYNNOOPPSSIISS + ssoonnaarr [-background _c_o_l_o_r] [-sweep-color _c_o_l_o_r] [-low-color + _c_o_l_o_r] [-scope-color _c_o_l_o_r] [-grid-color _c_o_l_o_r] + [-text-color _c_o_l_o_r] [-ttl _i_n_t_e_g_e_r] [-mode ping] [-font + _f_o_n_t] [-ping-timeout _i_n_t] [-ping-source list | file | sub- + net ] [-ping-file _h_o_s_t_s_-_f_i_l_e] [-ping-list _h_o_s_t_-_n_a_m_e_-_l_i_s_t] + [-team-a-name _s_t_r_i_n_g] [-team-b-name _s_t_r_i_n_g] [-team-a-count + _i_n_t] [-team-b-count _i_n_t] + +DDEESSCCRRIIPPTTIIOONN + The _s_o_n_a_r program displays a sonar scope on the computer's + screen. This scope polls a sensor as the sweep goes + around the scope and displays what it finds as bogies on + the screen. The program is designed to support different + modes representing different types of sensors. Currently + the only implemented sensors are a simulator, and a net- + work ping function that pings hosts and plots the results + on the scope. + +OOPPTTIIOONNSS + _s_o_n_a_r understands the following options: + + --bbaacckkggrroouunndd _C_o_l_o_r + The background Color of the screen not covered by + the scope. + + --sswweeeepp--ccoolloorr _C_o_l_o_r + The color of the brightest part of the sweep. + + --ssccooppee--ccoolloorr _C_o_l_o_r + The color of the circular part of the scope. + + --ggrriidd--ccoolloorr _C_o_l_o_r + The color to the grid lines overlaying the scope. + + --tteexxtt--ccoolloorr _C_o_l_o_r + The color of the text identifying bogies on the + scope. + + --ttttll _i_n_t_e_g_e_r + "Time to live": visible time of a Bogie. Try val- + ues between 10 (very short) and 100. + + --mmooddee _s_i_m_u_l_a_t_i_o_n _| _p_i_n_g + The sensor mode to use, the currently supported + modes _s_i_m_u_l_a_t_e (the default) and _p_i_n_g. + + --ffoonntt _f_o_n_t + The font used to display text on the scope. + Default "fixed". + + + + +X Version 11 3-Nov-98 1 + + + + + +Sonar(1) Sonar(1) + + + --ppiinngg--ttiimmeeoouutt _i_n_t + The amount of time in milliseconds the program + will wait for an answer to a ping. + + --ppiinngg--ssoouurrccee lliisstt || ffiillee || ssuubbnneett + Th source of the list of hosts to ping. Valid val- + ues are: _l_i_s_t, _f_i_l_e, _s_u_b_n_e_t. The first two values + are described below; and _s_u_b_n_e_t indicates that the + sonar should ping all hosts in the same subnet as + the current machine. (All addresses are treated + as class C nets, therefore this will at most ping + 254 hosts.) + + --ppiinngg--ffiillee _f_i_l_e_n_a_m_e + The path to a file listing the hosts to ping. + This file can be in the format used by _/_e_t_c_/_h_o_s_t_s, + or it can be any file that has host names as the + first element on each line. If you use ssh, try + this: + + sonar -mode ping -ping-file $HOME/.ssh/known_hosts + + This is used only used when _p_i_n_g_S_o_u_r_c_e is set to + ffiillee. + + --ppiinngg--lliisstt _l_i_s_t + A comma separated list of hostnames, eg + _"_p_i_n_k_y_,_b_r_a_i_n_,_d_o_t_". Only used when _p_i_n_g_S_o_u_r_c_e is + set to lliisstt. + + --tteeaamm--aa--nnaammee _s_t_r_i_n_g + The name of team A, in simulation-mode. + + --tteeaamm--bb--nnaammee _s_t_r_i_n_g + The name of team B, in simulation-mode. + + --tteeaamm--aa--ccoouunntt _i_n_t + The number of bogies on team A, in simulation- + mode. + + --tteeaamm--bb--ccoouunntt _i_n_t + The number of bogies on team B, in simulation- + mode. + +RREESSOOUURRCCEESS + Configuration of the targets to ping is best done by set- + ting X Resources. + + + bbaacckkggrroouunndd _(_C_o_l_o_r_) + See option -background, above; default value is + _b_l_a_c_k. + + + + + +X Version 11 3-Nov-98 2 + + + + + +Sonar(1) Sonar(1) + + + sswweeeeppCCoolloorr _(_C_o_l_o_r_) + See option -sweep-color, above; default value is + _#_0_0_f_f_0_0. + + ssccooppeeCCoolloorr _(_C_o_l_o_r_) + See option -scope-color, above; default value is + _#_0_0_3_3_0_0. + + ggrriiddCCoolloorr _(_C_o_l_o_r_) + See option -grid-color, above; default value is + _#_0_0_a_a_0_0. + + tteexxttCCoolloorr _(_C_o_l_o_r_) + See option -text-color, above; default value is + _#_f_f_f_f_0_0. + + ttttll _(_i_n_t_e_g_e_r_) + See option -ttl, above; default value is _9_0 or one + sweep. + + mmooddee _(_p_i_n_g_) + See option -mode, above. If set to ddeeffaauulltt, it + will ping hosts if possible, otherwise, will run + in simulation-mode. + + ffoonntt _(_f_o_n_t_) + See option -font, above; default value is _f_i_x_e_d. + + ppiinnggTTiimmeeoouutt _(_I_n_t_e_g_e_r_) + See option -pingtimeout, above; default value is + 3000. + + ppiinnggSSoouurrccee _l_i_s_t _| _f_i_l_e _| _s_u_b_n_e_t + See option -ping-source, above. Default value is + _f_i_l_e. + + ppiinnggFFiillee _p_a_t_h_n_a_m_e + See option -ping-file, above. Default value is + _/_e_t_c_/_h_o_s_t_s. + + ppiinnggLLiisstt _h_o_s_t_,_h_o_s_t_,_h_o_s_t_._._. + See option -ping-list, above; default value is + llooccaallhhoosstt. + + tteeaammAANNaammee _s_t_r_i_n_g + See option -team-a-name, above. Default value is + FF1188. + + tteeaammBBNNaammee _s_t_r_i_n_g + See option -teamBName, above. Default value is + MMIIGG. + + tteeaammAACCoouunntt _i_n_t + See option -teamACount, above. Default value is + + + +X Version 11 3-Nov-98 3 + + + + + +Sonar(1) Sonar(1) + + + 4. + + tteeaammBBCCoouunntt _i_n_t + See option -teamBCount, above. Default value is + 4. + +NNOOTTEESS + In order to use the ping sensor, this program must be + installed as setuid root, so that it can create an ICMP + socket. + +SSEEEE AALLSSOO + XX(1), xxssccrreeeennssaavveerr(1), ppiinngg(8) + +CCOOPPYYRRIIGGHHTT + Copyright (C) 1998 by Stephen Martin. (smartin@canada.com) + + Permission to use, copy, modify, distribute, and sell this + software and its documentation for any purpose 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 representations are made about the + suitability of this software for any purpose. It is pro- + vided "as is" without express or implied warranty. + + +AAUUTTHHOORRSS + Stephen Martin , 3-nov-98. + + Thanks to Tom Kelly for suggesting a modular approach to + the sensor amoung other things. + + Thomas Bahls hacked the "ttl" + option, 12-jul-98. + + + + + + + + + + + + + + + + + + + + + + +X Version 11 3-Nov-98 4 + + diff --git a/local/man/cat.1/sphere.1 b/local/man/cat.1/sphere.1 new file mode 100644 index 00000000..82d47922 --- /dev/null +++ b/local/man/cat.1/sphere.1 @@ -0,0 +1,132 @@ + + + +XScreenSaver(1) XScreenSaver(1) + + +NNAAMMEE + sphere - draws shaded spheres + +SSYYNNOOPPSSIISS + sspphheerree [-display _h_o_s_t_:_d_i_s_p_l_a_y_._s_c_r_e_e_n] [-foreground _c_o_l_o_r] + [-background _c_o_l_o_r] [-window] [-root] [-mono] [-install] + [-visual _v_i_s_u_a_l] [-ncolors _i_n_t_e_g_e_r] [-delay _m_i_c_r_o_s_e_c_o_n_d_s] + + +DDEESSCCRRIIPPTTIIOONN + The _s_p_h_e_r_e program draws shaded spheres. + +OOPPTTIIOONNSS + _s_p_h_e_r_e accepts the following options: + + --wwiinnddooww Draw on a newly-created window. This is the + default. + + --rroooott Draw on the root window. + + --mmoonnoo If on a color display, pretend we're on a + monochrome display. + + --iinnssttaallll + Install a private colormap for the window. + + --vviissuuaall _v_i_s_u_a_l + 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. + + --nnccoolloorrss _i_n_t_e_g_e_r + How many colors should be used (if possible). + Default 64. The colors are chosen randomly. + +EENNVVIIRROONNMMEENNTT + DDIISSPPLLAAYY to get the default host and display number. + + XXEENNVVIIRROONNMMEENNTT + to get the name of a resource file that overrides + the global resources stored in the RESOURCE_MAN- + AGER property. + +SSEEEE AALLSSOO + XX(1), xxssccrreeeennssaavveerr(1), xxlloocckk(1) + +CCOOPPYYRRIIGGHHTT + Copyright (C) 1988 by Sun Microsystems, Inc. + + Permission to use, copy, modify, and distribute this soft- + ware and its documentation for any purpose and without fee + is hereby granted, provided that the above copyright + notice appear in all copies and that both that copyright + notice and this permission notice appear in supporting + + + +X Version 11 27-May-97 1 + + + + + +XScreenSaver(1) XScreenSaver(1) + + + documentation. + +AAUUTTHHOORR + Sun Microsystems, Inc, 1988. + + Ability to run standalone or with _x_s_c_r_e_e_n_s_a_v_e_r added by + Jamie Zawinski , 27-May-97. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +X Version 11 27-May-97 2 + + diff --git a/local/man/cat.1/spiral.1 b/local/man/cat.1/spiral.1 new file mode 100644 index 00000000..e817143c --- /dev/null +++ b/local/man/cat.1/spiral.1 @@ -0,0 +1,132 @@ + + + +XScreenSaver(1) XScreenSaver(1) + + +NNAAMMEE + spiral - draws moving circular spiral patterns + +SSYYNNOOPPSSIISS + ssppiirraall [-display _h_o_s_t_:_d_i_s_p_l_a_y_._s_c_r_e_e_n] [-foreground _c_o_l_o_r] + [-background _c_o_l_o_r] [-window] [-root] [-mono] [-install] + [-visual _v_i_s_u_a_l] [-ncolors _i_n_t_e_g_e_r] [-delay _m_i_c_r_o_s_e_c_o_n_d_s] + [-count _i_n_t_e_g_e_r] + + +DDEESSCCRRIIPPTTIIOONN + The _s_p_i_r_a_l program draws moving circular spiral patterns + +OOPPTTIIOONNSS + _s_p_i_r_a_l accepts the following options: + + --wwiinnddooww Draw on a newly-created window. This is the + default. + + --rroooott Draw on the root window. + + --mmoonnoo If on a color display, pretend we're on a + monochrome display. + + --iinnssttaallll + Install a private colormap for the window. + + --vviissuuaall _v_i_s_u_a_l + 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. + + --nnccoolloorrss _i_n_t_e_g_e_r + How many colors should be used (if possible). + Default 64. The colors are chosen randomly. + + --ccoouunntt _i_n_t_e_g_e_r + Default 40. + + --ccyycclleess _i_n_t_e_g_e_r + Default 350. + + +EENNVVIIRROONNMMEENNTT + DDIISSPPLLAAYY to get the default host and display number. + + XXEENNVVIIRROONNMMEENNTT + to get the name of a resource file that overrides + the global resources stored in the RESOURCE_MAN- + AGER property. + +SSEEEE AALLSSOO + XX(1), xxssccrreeeennssaavveerr(1), xxlloocckk(1) + + + + +X Version 11 10-May-97 1 + + + + + +XScreenSaver(1) XScreenSaver(1) + + +CCOOPPYYRRIIGGHHTT + Copyright (C) 1994 by Darrick Brown. + + Permission to use, copy, modify, and distribute this soft- + ware and its documentation for any purpose and without fee + is hereby granted, provided that the above copyright + notice appear in all copies and that both that copyright + notice and this permission notice appear in supporting + documentation. + +AAUUTTHHOORR + Darrick Brown, 1994. + + Improved by Peter Schmitzberger , + 24-Jul-95. + + Ability to run standalone or with _x_s_c_r_e_e_n_s_a_v_e_r added by + Jamie Zawinski , 10-May-97. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +X Version 11 10-May-97 2 + + diff --git a/local/man/cat.1/spotlight.1 b/local/man/cat.1/spotlight.1 new file mode 100644 index 00000000..90986735 --- /dev/null +++ b/local/man/cat.1/spotlight.1 @@ -0,0 +1,132 @@ + + + +XScreenSaver(1) XScreenSaver(1) + + +NNAAMMEE + spotlight - move spotlight around desktop + +SSYYNNOOPPSSIISS + ssppoottlliigghhtt [-display _h_o_s_t_:_d_i_s_p_l_a_y_._s_c_r_e_e_n] [-foreground + _c_o_l_o_r] [-background _c_o_l_o_r] [-window] [-root] [-mono] + [-install] [-visual _v_i_s_u_a_l] [-delay _u_s_e_c_s] [-radius _p_i_x_- + _e_l_s] + +DDEESSCCRRIIPPTTIIOONN + The _s_p_o_t_l_i_g_h_t program draws random rectangles. + +OOPPTTIIOONNSS + _s_p_o_t_l_i_g_h_t accepts the following options: + + --wwiinnddooww Draw on a newly-created window. This is the + default. + + --rroooott Draw on the root window. + + --mmoonnoo If on a color display, pretend we're on a + monochrome display. + + --iinnssttaallll + Install a private colormap for the window. + + --vviissuuaall _v_i_s_u_a_l + 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. + + --ddeellaayy _m_i_c_r_o_s_e_c_o_n_d_s + Slow it down. + + --rraaddiiuuss _p_i_x_e_l_s + Radius of the spotlight in pixels. + +EENNVVIIRROONNMMEENNTT + DDIISSPPLLAAYY to get the default host and display number. + + XXEENNVVIIRROONNMMEENNTT + to get the name of a resource file that overrides + the global resources stored in the RESOURCE_MAN- + AGER property. + +SSEEEE AALLSSOO + XX(1), xxssccrreeeennssaavveerr(1) + +CCOOPPYYRRIIGGHHTT + Copyright (C) 1999 by Rick Schultz. Permission to use, + copy, modify, distribute, and sell this software and its + documentation for any purpose is hereby granted without + fee, provided that the above copyright notice appear in + all copies and that both that copyright notice and this + + + +X Version 11 05-Apr-1999 1 + + + + + +XScreenSaver(1) XScreenSaver(1) + + + permission notice appear in supporting documentation. No + representations are made about the suitability of this + software for any purpose. It is provided "as is" without + express or implied warranty. + +CCRREEDDIITTSS + Hacked together by Rick Schultz , based + on StefView for BackSpace by Darcy Brockbank and on sev- + eral other xscreensaver hacks. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +X Version 11 05-Apr-1999 2 + + diff --git a/local/man/cat.1/squiral.1 b/local/man/cat.1/squiral.1 new file mode 100644 index 00000000..6c9072da --- /dev/null +++ b/local/man/cat.1/squiral.1 @@ -0,0 +1,132 @@ + + + +XScreenSaver(1) XScreenSaver(1) + + +NNAAMMEE + squiral - square spirals screensaver + +SSYYNNOOPPSSIISS + ssqquuiirraall [-display _h_o_s_t_:_d_i_s_p_l_a_y_._s_c_r_e_e_n] [-foreground _c_o_l_o_r] + [-background _c_o_l_o_r] [-window] [-root] [-mono] [-install] + [-noinstall] [-visual _v_i_s_u_a_l] [-fill _p_e_r_c_e_n_t] [-count _n_u_m_- + _b_e_r] [-delay _u_s_e_c] [-disorder _f_r_a_c_t_i_o_n] [-handedness _f_r_a_c_- + _t_i_o_n] [-cycle] + +DDEESSCCRRIIPPTTIIOONN + The _s_q_u_i_r_a_l program displays interacting, spiral-producing + automata + + +OOPPTTIIOONNSS + _s_q_u_i_r_a_l accepts the following options: + + --wwiinnddooww Draw on a newly-created window. This is the + default. + + --rroooott Draw on the root window. + + --mmoonnoo If on a color display, pretend we're on a + monochrome display. + + --iinnssttaallll + Install a private colormap for the window. + + --vviissuuaall _v_i_s_u_a_l + 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. + + --ffiillll _p_e_r_c_e_n_t + Specify the percent (0-100) of the screen which + must be filled before the screen is cleared. + 60-80 percent are good values. + + --ccoouunntt _n_u_m_b_e_r + The number of squiralies. By default, the screen + width divided by 32. + + --ddeellaayy _u_s_e_c + The wait between steps. The default is 1000. + + --ddiissoorrddeerr _f_r_a_c_t_i_o_n + The fraction of the time a squiraly will choose a + new direction. The default is 0.005. + + --hhaannddeeddnneessss _f_r_a_c_t_i_o_n + The fraction of the time a squiraly will choose to + enter lefthanded mode. 0.0 means exclusively + right-handed behavior, 0.5 (the default) is a + + + +X Version 11 18-mar-1999 1 + + + + + +XScreenSaver(1) XScreenSaver(1) + + + balance between the two, and 1.0 is exclusively + left-handed behaviour. + +EENNVVIIRROONNMMEENNTT + DDIISSPPLLAAYY to get the default host and display number. + + XXEENNVVIIRROONNMMEENNTT + to get the name of a resource file that overrides + the global resources stored in the RESOURCE_MAN- + AGER property. + +BBUUGGSS + None known + +SSEEEE AALLSSOO + XX(1), xxssccrreeeennssaavveerr(1) + +CCOOPPYYRRIIGGHHTT + Copyright (C) 1999, by Jeff Epler. Permission to use, + copy, modify, distribute, and sell this software and its + documentation for any purpose is hereby granted without + fee, provided fnord that the above copyright notice appear + in all copies and that both that copyright notice and this + permission notice appear in supporting documentation. No + representations are made about the suitability of fnord + this software for any purpose. It is provided "as is" + without express or fnord implied warranty. + +AAUUTTHHOORR + Jeff Epler , 18-mar-1999 + + + + + + + + + + + + + + + + + + + + + + + + + + + +X Version 11 18-mar-1999 2 + + diff --git a/local/man/cat.1/starfish.1 b/local/man/cat.1/starfish.1 new file mode 100644 index 00000000..105c7702 --- /dev/null +++ b/local/man/cat.1/starfish.1 @@ -0,0 +1,132 @@ + + + +XScreenSaver(1) XScreenSaver(1) + + +NNAAMMEE + starfish - radially-symmetric throbbing colormap-hacking + graphics demo + +SSYYNNOOPPSSIISS + ssttaarrffiisshh [-display _h_o_s_t_:_d_i_s_p_l_a_y_._s_c_r_e_e_n] [-foreground + _c_o_l_o_r] [-background _c_o_l_o_r] [-window] [-root] [-mono] + [-install] [-visual _v_i_s_u_a_l] [-delay _u_s_e_c_s] [-delay2 _s_e_c_s] + [-cycle-delay2 _u_s_e_c_s] [-thickness _p_i_x_e_l_s] [-rotation + _d_e_g_r_e_e_s] [-duration _s_e_c_o_n_d_s] [-colors _i_n_t] [-cycle] + [-no-cycle] [-blob] [-no-blob] + +DDEESSCCRRIIPPTTIIOONN + The _s_t_a_r_f_i_s_h program draws radially symmetric objects, + which expand, contract, rotate, and turn inside out. It + uses these shapes to lay down a field of smooth colors, + and then rotates the colormap. + +OOPPTTIIOONNSS + _s_t_a_r_f_i_s_h accepts the following options: + + --wwiinnddooww Draw on a newly-created window. This is the + default. + + --rroooott Draw on the root window. + + --mmoonnoo If on a color display, pretend we're on a + monochrome display. + + --iinnssttaallll + Install a private colormap for the window. + + --vviissuuaall _v_i_s_u_a_l + 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. + + --ddeellaayy _m_i_c_r_o_s_e_c_o_n_d_s + How much of a delay should be introduced between + steps of the animation. Default 10000, or about + 1/100th second. + + --ccyyccllee--ddeellaayy _m_i_c_r_o_s_e_c_o_n_d_s + How long to wait between shifing the colormap by + one step. Default 100000, or about 1/10th second. + + --tthhiicckknneessss _p_i_x_e_l_s + How wide each color band should be. Default 0, + meaning random (the chosen value will be between 0 + and 15.) + + --rroottaattiioonn _d_e_g_r_e_e_s + How quickly the objects should rotate at each + step. Default 0, meaning random (the chosen value + + + +X Version 11 14-Jun-97 1 + + + + + +XScreenSaver(1) XScreenSaver(1) + + + will be between 0 and 12 degrees.) + + --ccoolloorrss _i_n_t + How many colors to use. Default 200. The more + colors, the smoother the transitions will be, and + the nicer the resultant images. + + --ccyyccllee + + --nnoo--ccyyccllee + Whether to do colormap cycling. Default true. + + --dduurraattiioonn _s_e_c_o_n_d_s + How long to run before choosing a new shape. + Default 30 seconds. + + --ddeellaayy22 _s_e_c_o_n_d_s + When _d_u_r_a_t_i_o_n expires, how long to wait before + starting a new run. Default 5 seconds. + + --bblloobb + + --nnoo--bblloobb + If _b_l_o_b option is specified, then the raw shapes + will be shown, instead of a field of colors gener- + ated from them. + +EENNVVIIRROONNMMEENNTT + DDIISSPPLLAAYY to get the default host and display number. + + XXEENNVVIIRROONNMMEENNTT + to get the name of a resource file that overrides + the global resources stored in the RESOURCE_MAN- + AGER property. + +SSEEEE AALLSSOO + XX(1), xxssccrreeeennssaavveerr(1) + +CCOOPPYYRRIIGGHHTT + Copyright (C) 1997 by Jamie Zawinski. Permission to use, + copy, modify, distribute, and sell this software and its + documentation for any purpose 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 + representations are made about the suitability of this + software for any purpose. It is provided "as is" without + express or implied warranty. + +AAUUTTHHOORR + Jamie Zawinski , 14-Jun-97. + + + + + + +X Version 11 14-Jun-97 2 + + diff --git a/local/man/cat.1/strange.1 b/local/man/cat.1/strange.1 new file mode 100644 index 00000000..879ecafd --- /dev/null +++ b/local/man/cat.1/strange.1 @@ -0,0 +1,132 @@ + + + +XScreenSaver(1) XScreenSaver(1) + + +NNAAMMEE + strange - draws strange attractors + +SSYYNNOOPPSSIISS + ssttrraannggee [-display _h_o_s_t_:_d_i_s_p_l_a_y_._s_c_r_e_e_n] [-foreground _c_o_l_o_r] + [-background _c_o_l_o_r] [-window] [-root] [-mono] [-install] + [-visual _v_i_s_u_a_l] [-ncolors _i_n_t_e_g_e_r] [-delay _m_i_c_r_o_s_e_c_o_n_d_s] + + +DDEESSCCRRIIPPTTIIOONN + The _s_t_r_a_n_g_e program draws strange attractors + +OOPPTTIIOONNSS + _s_t_r_a_n_g_e accepts the following options: + + --wwiinnddooww Draw on a newly-created window. This is the + default. + + --rroooott Draw on the root window. + + --mmoonnoo If on a color display, pretend we're on a + monochrome display. + + --iinnssttaallll + Install a private colormap for the window. + + --vviissuuaall _v_i_s_u_a_l + 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. + + --nnccoolloorrss _i_n_t_e_g_e_r + How many colors should be used (if possible). + Default 64. The colors are chosen randomly. + +EENNVVIIRROONNMMEENNTT + DDIISSPPLLAAYY to get the default host and display number. + + XXEENNVVIIRROONNMMEENNTT + to get the name of a resource file that overrides + the global resources stored in the RESOURCE_MAN- + AGER property. + +SSEEEE AALLSSOO + XX(1), xxssccrreeeennssaavveerr(1), xxlloocckk(1) + +CCOOPPYYRRIIGGHHTT + Copyright (C) 1997 by Massimino Pascal. + + Permission to use, copy, modify, and distribute this soft- + ware and its documentation for any purpose and without fee + is hereby granted, provided that the above copyright + notice appear in all copies and that both that copyright + notice and this permission notice appear in supporting + + + +X Version 11 10-May-97 1 + + + + + +XScreenSaver(1) XScreenSaver(1) + + + documentation. + +AAUUTTHHOORR + Massimino Pascal , 1997. + + Ability to run standalone or with _x_s_c_r_e_e_n_s_a_v_e_r added by + Jamie Zawinski , 10-May-97. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +X Version 11 10-May-97 2 + + diff --git a/local/man/cat.1/swirl.1 b/local/man/cat.1/swirl.1 new file mode 100644 index 00000000..2dfcc779 --- /dev/null +++ b/local/man/cat.1/swirl.1 @@ -0,0 +1,132 @@ + + + +XScreenSaver(1) XScreenSaver(1) + + +NNAAMMEE + swirl - draws swirly color-cycling patterns + +SSYYNNOOPPSSIISS + sswwiirrll [-display _h_o_s_t_:_d_i_s_p_l_a_y_._s_c_r_e_e_n] [-foreground _c_o_l_o_r] + [-background _c_o_l_o_r] [-window] [-root] [-mono] [-install] + [-visual _v_i_s_u_a_l] [-ncolors _i_n_t_e_g_e_r] [-delay _m_i_c_r_o_s_e_c_o_n_d_s] + [-cycles _i_n_t_e_g_e_r] [-count _i_n_t_e_g_e_r] + + +DDEESSCCRRIIPPTTIIOONN + The _s_w_i_r_l program draws swirly color-cycling patterns. + +OOPPTTIIOONNSS + _s_w_i_r_l accepts the following options: + + --wwiinnddooww Draw on a newly-created window. This is the + default. + + --rroooott Draw on the root window. + + --mmoonnoo If on a color display, pretend we're on a + monochrome display. + + --iinnssttaallll + Install a private colormap for the window. + + --vviissuuaall _v_i_s_u_a_l + 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. + + --nnccoolloorrss _i_n_t_e_g_e_r + How many colors should be used (if possible). + Default 200. + + --ccyycclleess _i_n_t_e_g_e_r + + + --ccoouunntt _i_n_t_e_g_e_r + + +EENNVVIIRROONNMMEENNTT + DDIISSPPLLAAYY to get the default host and display number. + + XXEENNVVIIRROONNMMEENNTT + to get the name of a resource file that overrides + the global resources stored in the RESOURCE_MAN- + AGER property. + +SSEEEE AALLSSOO + XX(1), xxssccrreeeennssaavveerr(1), xxlloocckk(1) + + + + + +X Version 11 13-May-97 1 + + + + + +XScreenSaver(1) XScreenSaver(1) + + +CCOOPPYYRRIIGGHHTT + Copyright (C) 1994 M. Dobie. + + Permission to use, copy, modify, and distribute this soft- + ware and its documentation for any purpose and without fee + is hereby granted, provided that the above copyright + notice appear in all copies and that both that copyright + notice and this permission notice appear in supporting + documentation. + + +AAUUTTHHOORR + M.Dobie , 1994. + + Ability to run standalone or with _x_s_c_r_e_e_n_s_a_v_e_r added by + Jamie Zawinski , 13-May-97. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +X Version 11 13-May-97 2 + + diff --git a/local/man/cat.1/t3d.1 b/local/man/cat.1/t3d.1 new file mode 100644 index 00000000..178599b4 --- /dev/null +++ b/local/man/cat.1/t3d.1 @@ -0,0 +1,198 @@ + + + +t3d(1) t3d(1) + + +NNAAMMEE + t3d - clock using flying balls to display the time + +SSYYNNOOPPSSIISS + t3d [ _o_p_t_i_o_n_s ]... + +DDEESSCCRRIIPPTTIIOONN + Time 3D is a clock. It uses flying balls to display the + time. This balls move and wobble around to give you the + impression your graphic workstation with its many XStones + is doing something. + + t3d uses mouse and keyboard to let you fly through the + balls. Hit SS to speed up, AA to slow down, ZZ to zoom in and + XX to zoom out. Use the lleefftt mmoouussee bbuuttttoonn to rotate to the + left and the rriigghhtt mmoouussee bbuuttttoonn to rotate the view to the + right. Use the mmiiddddllee mmoouussee bbuuttttoonn to change the optical + axis and the moving direction. 00 (zero) will stop you. QQ + quits. + + +OOPPTTIIOONNSS + --mmoovvee _f_a_c_t_o_r + Modifies the direction move of t3d. The clock looks + 30 degrees* _f_a_c_t_o_r to the left and to the right + periodically. + + --wwoobbbbllee _f_a_c_t_o_r + Modifies the wobbling (sounds nice :-) of t3d by + multiplying the default deformation of the clock + with _f_a_c_t_o_r_. + + --mmiinnuutteess + Shows one small ball for every minute, instead of + one for every 2.5 minutes. + + --mmaagg _f_a_c_t_o_r + Changes the magnification of t3d. By default, t3d + draws a 200x200 image. A .I factor of 2 means, it + will use a 400x400 image. + + --ccyyccllee _p_e_r_i_o_d + Sets the moving cycle to _p_e_r_i_o_d seconds. By + default, this value is 10 seconds. + + --wwaaiitt _m_i_c_r_o_s_e_c + Inserts a wait after drawing one view of the clock. + By default, t3d waits 40 ms after each drawing. + This helps you to keep the performance loss small. + + --ffaasstt _p_r_e_c_a_l_c___r_a_d_i_u_s + t3d uses bitmap copy to draw precalculated balls. + You can specify the radius in pixels up to which + t3d should precalculate balls. t3d will set a + + + +Time 3D Version 1.1 1 + + + + + +t3d(1) t3d(1) + + + useful range by itself using the magnification when + it is started. + + --ccoollccyyccllee + Draws cyclic the color scale used for the balls in + the background instead of the normal black. + + --rrggbb _r_e_d _g_r_e_e_n _b_l_u_e + Selects the color in RGB color space of the light- + ning spot on the balls. All the other colors used + for balls or --ccoollccyyccllee are less intensive colors of + the same hue and saturation. All values in range of + 0 to 1. + + --hhssvv _h_u_e _s_a_t_u_r_a_t_i_o_n _v_a_l_u_e + Selects the color in HSV color space. _h_u_e is in + degrees from 0 to 360, all other values in range + from 0 to 1. It gives nice but rather unpredictable + results, if you use a saturation of e.g. 2. Try it + at your own risk. + + --hhssvvccyyccllee _s_p_e_e_d + Rotates the hue axis every 10 seconds* _s_p_e_e_d_. + + --hheellpp Prints a short usage message. + + + +AAUUTTHHOORR + Bernd Paysan + + Email: bernd.paysan@gmx.de + + Hacked on by jwz@jwz.org for xscreensaver. + + +AACCKKNNOOWWLLEEDDGGEEMMEENNTT + Acknowledgement to Georg Acher, who wrote the initial pro- + gram displaying balls. + + +CCOOPPYYIINNGG + Copy, modify, and distribute T3D either under GPL version + 2 or newer, or under the standard MIT/X license notice. + + +DDIISSCCLLAAIIMMEERR + T3D is not related to T3D(tm), the massive parallel + Alpha--based supercomputer from Cray Research. T3D's name + was invented in 1991, years before the project at Cray + Research started. There is no relation from T3D to Cray's + T3D, even the balls surrounding T3D on some posters + weren't an inspiration for T3D. I don't know anything + about the other way round. + + + +Time 3D Version 1.1 2 + + + + + +t3d(1) t3d(1) + + + The programming style of T3D isn't intented as example of + good style, but as example of how a fast prototyped demo + may look like. T3D wasn't created to be useful, it was + created to be nice. + + +KKNNOOWWNN BBUUGGSS + There are no known bugs in T3D. Maybe there are bugs in X. + Slight changes in the T3D sources are known to show these + bugs, e.g. if you remove the (int) casting at the XFillArc + x,y,w,h-coordinates... + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +Time 3D Version 1.1 3 + + diff --git a/local/man/cat.1/vidwhacker.1 b/local/man/cat.1/vidwhacker.1 new file mode 100644 index 00000000..44624517 --- /dev/null +++ b/local/man/cat.1/vidwhacker.1 @@ -0,0 +1,132 @@ + + + +XScreenSaver(1) XScreenSaver(1) + + +NNAAMMEE + vidwhacker - grab images and apply random filters to them + +SSYYNNOOPPSSIISS + vviiddwwhhaacckkeerr [-display _h_o_s_t_:_d_i_s_p_l_a_y_._s_c_r_e_e_n] [-root] [-win- + dow] [-verbose] [-stdin] [-stdout] [-delay seconds] + +DDEESSCCRRIIPPTTIIOONN + The _v_i_d_w_h_a_c_k_e_r program grabs a image from the system's + video input, applies random image filters to it, and dis- + plays the result. The _v_i_d_w_h_a_c_k_e_r program does not termi- + nate until killed. It depends heavily on xxvv(1) and the + various PBM tools (e.g., ppppmmrreelliieeff(1).) + +OOPPTTIIOONNSS + _v_i_d_w_h_a_c_k_e_r accepts the following options: + + --rroooott Draw on the root window. + + --wwiinnddooww Pop up a new window displaying the image. When a + new image has been fully processed, destroy that + window and pop up a new one. This is the default. + + --vveerrbboossee + Print diagnostics. + + --ssttddiinn Instead of grabbing an image from the system's + video input, read an image to maniupulate from + stdin. This image must be in + + --ddeellaayy _s_e_c_o_n_d_s + How long to sleep between images. Default 3 sec- + onds (the actual elapsed time is significantly + longer, due to processing time.) ppppmm(5) format. + The program will still perform repeated random + image transformations, but it will always use this + one image as its starting point. + + --ssttddoouutt Instead of displaying the image on a window or on + the root, write the new image on stdout, and exit. + +EENNVVIIRROONNMMEENNTT + DDIISSPPLLAAYY to get the default host and display number. + + XXEENNVVIIRROONNMMEENNTT + to get the name of a resource file that overrides + the global resources stored in the RESOURCE_MAN- + AGER property. + +BBUUGGSS + Grabbing video images is, of course, very system-depen- + dent. It works on SGIs, and on Linux systems that have + the qqccaamm(1) program. If your system does things differ- + ently, you'll need to edit the vidwhacker script (look for + + + +X Version 11 17-Jun-99 1 + + + + + +XScreenSaver(1) XScreenSaver(1) + + + the _g_r_a_b_(_) function.) + + It's slow. + +TTOO DDOO + It might be interesting to rewrite this to use ggiimmpp(1) + plugins instead of the pbm tools. It probably wouldn't be + any faster, but there would be a wider variety of effects + available. + +SSEEEE AALLSSOO + XX(1), xxssccrreeeennssaavveerr(1), xxvv(1), ppppmmttooggiiff(1), ccjjppeegg(1) + +CCOOPPYYRRIIGGHHTT + Copyright (C) 1998, 1999 by Jamie Zawinski. Permission to + use, copy, modify, distribute, and sell this software and + its documentation for any purpose is hereby granted with- + out 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 + representations are made about the suitability of this + software for any purpose. It is provided "as is" without + express or implied warranty. + +AAUUTTHHOORR + Jamie Zawinski , 18-Jan-98. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +X Version 11 17-Jun-99 2 + + diff --git a/local/man/cat.1/vines.1 b/local/man/cat.1/vines.1 new file mode 100644 index 00000000..c1504727 --- /dev/null +++ b/local/man/cat.1/vines.1 @@ -0,0 +1,132 @@ + + + +XScreenSaver(1) XScreenSaver(1) + + +NNAAMMEE + vines - draws pseudo-fractal geometric patterns + +SSYYNNOOPPSSIISS + vviinneess [-display _h_o_s_t_:_d_i_s_p_l_a_y_._s_c_r_e_e_n] [-foreground _c_o_l_o_r] + [-background _c_o_l_o_r] [-window] [-root] [-mono] [-install] + [-visual _v_i_s_u_a_l] [-ncolors _i_n_t_e_g_e_r] [-delay _m_i_c_r_o_s_e_c_o_n_d_s] + + +DDEESSCCRRIIPPTTIIOONN + The _v_i_n_e_s program is yet another geometric pattern genera- + tor, this one's claim to fame being a pseudo-fractal look- + ing vine like pattern that creates nifty whorls and loops. + +OOPPTTIIOONNSS + _v_i_n_e_s accepts the following options: + + --wwiinnddooww Draw on a newly-created window. This is the + default. + + --rroooott Draw on the root window. + + --mmoonnoo If on a color display, pretend we're on a + monochrome display. + + --iinnssttaallll + Install a private colormap for the window. + + --vviissuuaall _v_i_s_u_a_l + 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. + + --nnccoolloorrss _i_n_t_e_g_e_r + How many colors should be used (if possible). + Default 200. The colors are chosen randomly. + +EENNVVIIRROONNMMEENNTT + DDIISSPPLLAAYY to get the default host and display number. + + XXEENNVVIIRROONNMMEENNTT + to get the name of a resource file that overrides + the global resources stored in the RESOURCE_MAN- + AGER property. + +SSEEEE AALLSSOO + XX(1), xxssccrreeeennssaavveerr(1), xxlloocckk(1) + +CCOOPPYYRRIIGGHHTT + Copyright (C) 1997 by Tracy Camp. + + Permission to use, copy, modify, and distribute this soft- + ware and its documentation for any purpose and without fee + is hereby granted, provided that the above copyright + + + +X Version 11 10-May-97 1 + + + + + +XScreenSaver(1) XScreenSaver(1) + + + notice appear in all copies and that both that copyright + notice and this permission notice appear in supporting + documentation. + +AAUUTTHHOORR + Tracy Camp , 1997. + + Tweaked by David Hansen , 21-Mar-97. + + Ability to run standalone or with _x_s_c_r_e_e_n_s_a_v_e_r added by + Jamie Zawinski , 10-May-97. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +X Version 11 10-May-97 2 + + diff --git a/local/man/cat.1/webcollage.1 b/local/man/cat.1/webcollage.1 new file mode 100644 index 00000000..e0234797 --- /dev/null +++ b/local/man/cat.1/webcollage.1 @@ -0,0 +1,198 @@ + + + +XScreenSaver(1) XScreenSaver(1) + + +NNAAMMEE + webcollage - decorate the screen with random images from + the web + +SSYYNNOOPPSSIISS + wweebbccoollllaaggee [-display _h_o_s_t_:_d_i_s_p_l_a_y_._s_c_r_e_e_n] [-root] [-ver- + bose] [-delay _s_e_c_s] [-timeout _s_e_c_s] [-background _b_g] + [-filter _c_o_m_m_a_n_d] [-filter2 _c_o_m_m_a_n_d] + +DDEESSCCRRIIPPTTIIOONN + The _w_e_b_c_o_l_l_a_g_e program pulls random image off of the World + Wide Web and scatters them on the root window. It finds + these images by doing random web searches, and extracting + images from the returned pages. It places the images on + the root window by using the xxvv(1), ggiiffttooppnnmm(1), and + ddjjppeegg(1) tools. + + _w_e_b_c_o_l_l_a_g_e also works as a CGI program: simply make a sym- + bolic link to the _w_e_b_c_o_l_l_a_g_e executable called _n_p_h_-_w_e_b_c_o_l_- + _l_a_g_e_._c_g_i. If this program sees that it is being run as a + CGI, then it will behave appropriately. (The generated + web page will list the images one after another, rather + than tiling them together.) + + _w_e_b_c_o_l_l_a_g_e is written in ppeerrll(1) and requires Perl 5. + +OOPPTTIIOONNSS + _w_e_b_c_o_l_l_a_g_e accepts the following options: + + --rroooott Draw on the root window. This option is mandi- + tory: drawing to a window other than the root win- + dow is not yet supported. + + --vveerrbboossee or --vv + Print diagnostics to stderr. Multiple _-_v switches + increase the amount of output. _-_v will print out + only the URLs of the images; _-_v_v will print all + the commands being run; and _-_v_v_v will print more + than you care about. + + --ddeellaayy _s_e_c_o_n_d_s + How long to sleep between images. Default 1 sec- + ond. (Remember that this program probably spends + a lot of time waiting for the network.) + + --bbaacckkggrroouunndd _c_o_l_o_r_-_o_r_-_p_p_m + What to use for the background onto which images + are pasted. This may be a color name, a hexadeci- + mal RGB specification in the form '#rrggbb', or + the name of a PPM file. + + --ttiimmeeoouutt _s_e_c_o_n_d_s + How long to wait for a URL to complete before giv- + ing up on it and moving on to the next one. + + + +X Version 11 17-Jun-99 1 + + + + + +XScreenSaver(1) XScreenSaver(1) + + + Default 30 seconds. + + --ffiilltteerr _c_o_m_m_a_n_d + Filter all source images through this command. + The command must take a PPM file on stdin, and + write a new PPM file to stdout. One good choice + for a filter would be: + + webcollage -root -filter 'vidwhacker -stdin -stdout' + + + --ffiilltteerr22 _c_o_m_m_a_n_d + Filter the _c_o_m_p_o_s_i_t_e image through this command. + The _-_f_i_l_t_e_r option applies to the sub-images; the + _-_f_i_l_t_e_r_2 applies to the final, full-screen image. + +EENNVVIIRROONNMMEENNTT + DDIISSPPLLAAYY to get the default host and display number. + + XXEENNVVIIRROONNMMEENNTT + to get the name of a resource file that overrides + the global resources stored in the RESOURCE_MAN- + AGER property. + +FFIILLEESS AANNDD UURRLLSS + _/_u_s_r_/_d_i_c_t_/_w_o_r_d_s or _/_u_s_r_/_s_h_a_r_e_/_l_i_b_/_d_i_c_t_/_w_o_r_d_s + To find the random words to feed to search engines. + + _h_t_t_p_:_/_/_r_a_n_d_o_m_._y_a_h_o_o_._c_o_m_/_b_i_n_/_r_y_l_, + _h_t_t_p_:_/_/_i_m_a_g_e_._a_l_t_a_v_i_s_t_a_._c_o_m_/ To find random web pages. + +BBUUGGSS + When drawing on the root window, it always uses the + default colormap. This is actually a limitation of xv. + But regardless, when using this program with xscreensaver, + it must be given the ddeeffaauulltt--nn visual specification (see + the xxssccrreeeennssaavveerr(1) manual for more details.) + + Only the GIF and JPEG image formats are supported. + + Transparent and animating GIFs are not supported. + + It's slow. + +SSEEEE AALLSSOO + XX(1), xxssccrreeeennssaavveerr(1), xxvv(1), ggiiffttooppnnmm(1), ddjjppeegg(1), vviidd-- + wwhhaacckkeerr(1), ppeerrll(1) + +CCOOPPYYRRIIGGHHTT + Copyright (C) 1998, 1999 by Jamie Zawinski. Permission to + use, copy, modify, distribute, and sell this software and + its documentation for any purpose is hereby granted with- + out fee, provided that the above copyright notice appear + in all copies and that both that copyright notice and this + + + +X Version 11 17-Jun-99 2 + + + + + +XScreenSaver(1) XScreenSaver(1) + + + permission notice appear in supporting documentation. No + representations are made about the suitability of this + software for any purpose. It is provided "as is" without + express or implied warranty. + +AAUUTTHHOORR + Jamie Zawinski , 24-May-98. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +X Version 11 17-Jun-99 3 + + diff --git a/local/man/cat.1/xjack.1 b/local/man/cat.1/xjack.1 new file mode 100644 index 00000000..4410c3be --- /dev/null +++ b/local/man/cat.1/xjack.1 @@ -0,0 +1,132 @@ + + + +XScreenSaver(1) XScreenSaver(1) + + +NNAAMMEE + xjack - all work and no play makes jack a dull boy + +SSYYNNOOPPSSIISS + xxjjaacckk [-display _h_o_s_t_:_d_i_s_p_l_a_y_._s_c_r_e_e_n] [-foreground _c_o_l_o_r] + [-background _c_o_l_o_r] [-window] [-root] [-delay _u_s_e_c_s] + +DDEESSCCRRIIPPTTIIOONN + All work and no play makes jack a dull boy. All work and + no play makes jack a dull boy. All work and no play makes + jack a dull boy. All work and no play makes jack a dull + boy. All work and no play makes jack a dull boy. All + work and no play makes jack a dull boy. + + All work and no play makes jack a dull boy. All + work and no play makes jack a dull boy. All work + and no play makes jack a dull boy. All work and + no play makes jack a dull boy. All work and no + play makes jack a dull boy. All work and no play + makes jack a dull boy. + + All work and no play makes jack a dull boy. All + work and no play makes jack a dull boy. All work + and no play makes jack a dull boy. All work and + no play makes jack a dull boy. All work and no + play makes jack a dull boy. All work and no play + makes jack a dull boy. All work and no play makes + jack a dull boy. All work and no play makes jack + a dull boy. + + All work and no play makes jack a dull boy. All work and + no play makes jack a dull boy. All work and no play makes + jack a dull boy. All work and no play makes jack a dull + boy. All work and no play makes jack a dull boy. All + work and no play makes jack a dull boy. All work and no + play makes jack a dull boy. All work and no play makes + jack a dull boy. + +EENNVVIIRROONNMMEENNTT + DDIISSPPLLAAYY All work and no play makes jack a dull boy. + + XXEENNVVIIRROONNMMEENNTT + All work and no play makes jack a dull boy. All + work and no play makes jack a dull boy. + +SSEEEE AALLSSOO + XX(1), xxssccrreeeennssaavveerr(1) + +CCOOPPYYRRIIGGHHTT + Copyright (C) 1997 by Jamie Zawinski. All work and no + play makes jack a dull boy. All work and no play makes + jack a dull boy. All work and no play makes jack a dull + boy. All work and no play makes jack a dull boy. All + work and no play makes jack a fnord dull boy. All work + + + +X Version 11 18-sep-97 1 + + + + + +XScreenSaver(1) XScreenSaver(1) + + + and no play makes jack a dull boy. + +AAUUTTHHOORR + Jamie Zawinski , 15-Nov-97. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +X Version 11 18-sep-97 2 + + diff --git a/local/man/cat.1/xjulia.1 b/local/man/cat.1/xjulia.1 new file mode 100644 index 00000000..1ea5145b --- /dev/null +++ b/local/man/cat.1/xjulia.1 @@ -0,0 +1,132 @@ + + + +XScreenSaver(1) XScreenSaver(1) + + +NNAAMMEE + julia - draws spinning, animating julia-set fractals + +SSYYNNOOPPSSIISS + jjuulliiaa [-display _h_o_s_t_:_d_i_s_p_l_a_y_._s_c_r_e_e_n] [-foreground _c_o_l_o_r] + [-background _c_o_l_o_r] [-window] [-root] [-mono] [-install] + [-visual _v_i_s_u_a_l] [-ncolors _i_n_t_e_g_e_r] [-delay _m_i_c_r_o_s_e_c_o_n_d_s] + [-cycles _i_n_t_e_g_e_r] [-count _i_n_t_e_g_e_r] [-mouse] [-nomouse] + + +DDEESSCCRRIIPPTTIIOONN + The _j_u_l_i_a program draws spinning, animating julia-set + fractals. + + It uses ifs {w0 = sqrt(x-c), w1 = -sqrt(x-c)} with random + iteration to plot the julia set, and sinusoidially varied + parameters for the set, and plots parameters with a cir- + cle. + + One thing to note is that count is the _d_e_p_t_h of the search + tree, so the number of points computed is (2^count)-1. I + use 8 or 9 on a dx266 and it looks okay. The sinusoidal + variation of the parameter might not be as interesting as + it could, but it still gives an idea of the effect of the + parameter. + + +OOPPTTIIOONNSS + _j_u_l_i_a accepts the following options: + + --wwiinnddooww Draw on a newly-created window. This is the + default. + + --rroooott Draw on the root window. + + --mmoonnoo If on a color display, pretend we're on a + monochrome display. + + --iinnssttaallll + Install a private colormap for the window. + + --vviissuuaall _v_i_s_u_a_l + 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. + + --nnccoolloorrss _i_n_t_e_g_e_r + How many colors should be used (if possible). + Default 200. The colors used cycle through the + hue, making N stops around the color wheel. + + --ccyycclleess _i_n_t_e_g_e_r + + + + + +X Version 11 28-May-97 1 + + + + + +XScreenSaver(1) XScreenSaver(1) + + + --ccoouunntt _i_n_t_e_g_e_r + + + --mmoouussee + + --nnoommoouussee + If _-_m_o_u_s_e is specified, the control point of the + Julia set will be derived from the position of the + mouse in the window. When the mouse is not in the + window, the control point is chosen the normal + way. + +EENNVVIIRROONNMMEENNTT + DDIISSPPLLAAYY to get the default host and display number. + + XXEENNVVIIRROONNMMEENNTT + to get the name of a resource file that overrides + the global resources stored in the RESOURCE_MAN- + AGER property. + +SSEEEE AALLSSOO + XX(1), xxssccrreeeennssaavveerr(1), xxlloocckk(1) + +CCOOPPYYRRIIGGHHTT + Copyright (C) 1995 by Sean McCullough. + + Permission to use, copy, modify, and distribute this soft- + ware and its documentation for any purpose and without fee + is hereby granted, provided that the above copyright + notice appear in all copies and that both that copyright + notice and this permission notice appear in supporting + documentation. + +AAUUTTHHOORR + Sean McCullough , 1995. + + Ability to run standalone or with _x_s_c_r_e_e_n_s_a_v_e_r added by + Jamie Zawinski , 10-May-97. + + + + + + + + + + + + + + + + + + + +X Version 11 28-May-97 2 + + diff --git a/local/man/cat.1/xlyap.1 b/local/man/cat.1/xlyap.1 new file mode 100644 index 00000000..b550d072 --- /dev/null +++ b/local/man/cat.1/xlyap.1 @@ -0,0 +1,264 @@ + + + +XLYAP(6X) XLYAP(6X) + + +NNAAMMEE + xlyap - display an array of Lyapunov exponents graphically + +SSYYNNOOPPSSIISS + _x_l_y_a_p [-BLps][-W width][-H height][-o filename][-a _n ] [-b + _n ] [-w _n ] [-h _n ] [-i xstart] [-M _n ] [-R _p ] + [-S _n ] [-D _n ] [-F string][-f string][-r _n ] [-O + _n ] [-C _n ] [-c _n ] [-m _n ] [-x xpos] [-y ypos] + +DDEESSCCRRIIPPTTIIOONN + _x_l_y_a_p generates and graphically displays an array of Lya- + punov exponents for a variety of iterated periodically + forced non-linear maps of the unit interval. + +OOPPTTIIOONNSS + -random A good choice for use with xscreensaver: picks + random parameters from a built-in list. + + -C _n Specifies the minimum color index to be used for + negative exponents + + -D _n Specifies the "dwell" or number of iterations over + which to average in order to calculate the Lya- + punov exponent. Default is 400. + + -B Causes the stop, go, spin and quit buttons to be + displayed. + + -H _n Specifies the height of the window. Default is + 256. + + -L Indicates use log(x) + log(y) rather than log(xy). + + -M _r Specifies the real value to compare exponent val- + ues to for indexing into a color wheel. The + default value is 1.0. + + -O _n Specifies the minimum color index to be used for + positive exponents + + -R _p Specifies pseudo-random forcing with probability _p + of using parameter value 'a'. + + -S _n Specifies the "settle" or number of iterations + prior to the beginning of the calculation of the + Lyapunov exponent. Default is 200. + + -W _n Specifies the width of the window. Default is 256. + + -a _r Specifies the real value to use as the minimum + parameter value of the horizontal axis. Default is + 3.0 for the logistic map. + + -b _n Specifies the real value to use as the minimum + + + + 1 + + + + + +XLYAP(6X) XLYAP(6X) + + + parameter value of the vertical axis. Default is + 3.0 for the logistic map. + + -c _n Selects one of six different color wheels to use. + The default color wheel is a rainbow palette. + + -F _1_0_1_0_1_0_1_0 + Specifies the "Function" forcing function to use. + The example above would alternate between iterat- + ing the circle and logistic maps. An argument of + "-F 2323" would alternate between left and right + logistic maps. The default is to only use the sin- + gle specified map (see the description of -m). + + -f _a_b_b_a_b_a_a_b + Specifies the forcing function to use. The default + is to alternate between the "a" parameter and the + "b" parameter. + + -h _r Specifies the real value to be used as the range + over which the vertical parameter values vary. The + default is 1.0. + + -i _r Specifies the real value of the initial condition + to use. Default is 0.05. + + -m _n Selects between available non-linear maps of the + unit interval. A value of 0 specifies the logistic + map. A value of 1, the circle map. A value of 2, + the left-logistic. A value of 3, the right-logis- + tic. A value of 4, the double-logistic. The + default is 0, the logistic map. + + -o _f_i_l_e_n_a_m_e + Specifies the output filename to be used. If the + -o option is given, this file will automatically + be written out at the completion of the drawing. + If it is not specified, a default filename of + lyap.out is used and only written if the 'f' or + 'F' keys are pressed during a run. The format of + the output file is PPM for color and PGM for + monochrom. The parameters used to calculate the + picture are included as comments at the beginning + of the output file. + + -p Switches color indices for negative and positive + exponents. Generally, causes negative exponents to + be displayed in more detail while darkening and + narrowing the color range for positive exponents. + This can be toggled during runtime by pressing the + 'p' key. + + -r _n Specifies the maximum rgb value to be used. + Default is 35000. + + + + 2 + + + + + +XLYAP(6X) XLYAP(6X) + + + -s _n Specifies the length of the color wheel spin. + + -u Produces a usage message. + + -v Prints out the various values to be used and + exits. + + -w _r Specifies the real value to be used as the range + over which the horizontal parameter values vary. + The default is 1.0. + + -x _n Specifies the x screen coordinate of the window + (default is 256). + + -y _n Specifies the y screen coordinate of the window + (default is 256). + + + +NNOOTTEESS + During display, pressing any mouse button allows you to + select the area to be investigated with the mouse. The + upper left hand corner of the desired area is the location + of the cursor when the button is pressed. The lower right + hand corner is specified by the cursor when the button is + released. + + + Use of the keys _b_B_e_E_f_F_k_K_j_J_m_n_r_R_s_S_w_W_x_X_q_Q indicates: + + (<) Halve dwell value. + (>) Double dwell value. + ([) Halve settle value. + (]) Double settle value. + (B or b) Toggle button display on/off + (E or e) Recalculate the indices into the color wheel + using a different method + (F or f) Save current screen to ouput file (not yet + implemented) + (H or h or ?) Display brief help message + (i) Decrement the interval between stripes for the + striped color map. + (I) Increment the interval between stripes for the + striped color map. + (K) Decrease value exponents are compared against by + 0.05. + (J) Increase value exponents are compared against by + 0.05. + (M) Decrease value exponents are compared against by + 0.005. + (N) Increase value exponents are compared against by + 0.005. + (m) Increment the map index, changing the map to be + iterated. + + + + 3 + + + + + +XLYAP(6X) XLYAP(6X) + + + (P or p) Toggle positive/negative exponent display. + (r) Redraw the window using previously calculated expo- + nents. + (R) Redraw the window using the newly set dwell and/or + settle values. + (S) Spin the color wheel + (s) Halve the length of the spin and spin the color + wheel + (u) Go up to the window just prior to the most recent + zoom. + (U) Go all the way up to the original window. + (V or v) Display values of various parameters currently + in use + (W or w) Use next color map. + (X or x) Clear window + (Q or q) quit + + + +AAUUTTHHOORR + Ronald Joe Record + The Santa Cruz Operation + P.O. Box 1900 + Santa Cruz, CA 95061 + rr@sco.com + + + +AACCKKNNOOWWLLEEDDGGEEMMEENNTTSS + The algorithm was taken from the September 1991 Scientific + American article by A. K. Dewdney who gives credit to + Mario Markus of the Max Planck Institute for its creation. + Additional information and ideas were gleaned from the + discussion on alt.fractals involving Stephen Hall, Ed + Kubaitis, Dave Platt and Baback Moghaddam. Assistance with + colormaps and spinning color wheels and X was gleaned from + Hiram Clawson. Rubber banding code was adapted from an + existing Mandelbrot program written by Stacey Campbell. + + Viciously hacked for xscreensaver by Jamie Zawinski, + 20-Nov-97. + + + + + + + + + + + + + + + + + 4 + + diff --git a/local/man/cat.1/xroger.1 b/local/man/cat.1/xroger.1 new file mode 100644 index 00000000..ae599d6e --- /dev/null +++ b/local/man/cat.1/xroger.1 @@ -0,0 +1,132 @@ + + + +XScreenSaver(1) XScreenSaver(1) + + +NNAAMMEE + xroger - throbbing X logo, of a sort + +SSYYNNOOPPSSIISS + xxrrooggeerr [-display _h_o_s_t_:_d_i_s_p_l_a_y_._s_c_r_e_e_n] [-foreground _c_o_l_o_r] + [-background _c_o_l_o_r] [-window] [-root] [-mono] [-install] + [-visual _v_i_s_u_a_l] + +DDEESSCCRRIIPPTTIIOONN + The _x_r_o_g_e_r program displays a replacement for the X logo + with a more accurate Look and Feel. + +OOPPTTIIOONNSS + _x_r_o_g_e_r accepts the following options: + + --wwiinnddooww Draw on a newly-created window. This is the + default. + + --rroooott Draw on the root window. + + --mmoonnoo If on a color display, pretend we're on a + monochrome display. + + --iinnssttaallll + Install a private colormap for the window. + + --vviissuuaall _v_i_s_u_a_l + 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. + +EENNVVIIRROONNMMEENNTT + DDIISSPPLLAAYY to get the default host and display number. + + XXEENNVVIIRROONNMMEENNTT + to get the name of a resource file that overrides + the global resources stored in the RESOURCE_MAN- + AGER property. + +BBUUGGSS + It should also drip blood while making a horrible screech- + ing noise. + +SSEEEE AALLSSOO + XX(1), xxssccrreeeennssaavveerr(1) + +CCOOPPYYRRIIGGHHTT + Copyright (C) 1992, 1993 by Jamie Zawinski. Permission to + use, copy, modify, distribute, and sell this software and + its documentation for any purpose is hereby granted with- + out fee, provided fnord that the above copyright notice + appear in all copies and that both that copyright notice + and this permission notice appear in supporting documenta- + tion. No representations are made about the suitability + + + +X Version 11 22-mar-93 1 + + + + + +XScreenSaver(1) XScreenSaver(1) + + + of fnord this software for any purpose. It is provided + "as is" without express or fnord implied warranty. + +AAUUTTHHOORR + Jamie Zawinski , 13-aug-92. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +X Version 11 22-mar-93 2 + + diff --git a/local/man/cat.1/xscreensaver-command.1 b/local/man/cat.1/xscreensaver-command.1 new file mode 100644 index 00000000..c8ca81f2 --- /dev/null +++ b/local/man/cat.1/xscreensaver-command.1 @@ -0,0 +1,264 @@ + + + +XScreenSaver(1) XScreenSaver(1) + + +NNAAMMEE + xscreensaver-command - control a running xscreensaver pro- + cess + +SSYYNNOOPPSSIISS + xxssccrreeeennssaavveerr--ccoommmmaanndd [-help] [-demo] [-prefs] [-activate] + [-deactivate] [-cycle] [-next] [-prev] [-select _n] [-exit] + [-restart] [-lock] [-throttle] [-unthrottle] [-version] + [-time] + +DDEESSCCRRIIPPTTIIOONN + The _x_s_c_r_e_e_n_s_a_v_e_r_-_c_o_m_m_a_n_d program controls a running + _x_s_c_r_e_e_n_s_a_v_e_r process by sending it client-messages. + + xxssccrreeeennssaavveerr(1) has a client-server model: the xscreen- + saver process is a daemon that runs in the background; it + is controlled by other foreground programs such as + _x_s_c_r_e_e_n_s_a_v_e_r_-_c_o_m_m_a_n_d and xxssccrreeeennssaavveerr--ddeemmoo(1). + + This program, _x_s_c_r_e_e_n_s_a_v_e_r_-_c_o_m_m_a_n_d, is a command-line-ori- + ented tool; the xxssccrreeeennssaavveerr--ddeemmoo(1). program is a graph- + ical tool. + +OOPPTTIIOONNSS + _x_s_c_r_e_e_n_s_a_v_e_r_-_c_o_m_m_a_n_d accepts the following command-line + options: + + --hheellpp Prints a brief summary of command-line options. + + --ddeemmoo This just launches the xxssccrreeeennssaavveerr--ddeemmoo(1) pro- + gram, in which one can experiment with the various + graphics hacks available, and edit parameters. + + --ddeemmoo _n_u_m_b_e_r + When the _-_d_e_m_o option is followed by an integer, + it instructs the _x_s_c_r_e_e_n_s_a_v_e_r daemon to run that + hack, and wait for the user to click the mouse + before deactivating (i.e., mouse motion does not + deactivate.) This is the mechanism by which + xxssccrreeeennssaavveerr--ddeemmoo(1) communicates with the + xxssccrreeeennssaavveerr(1) daemon. (The first hack in the + list is numbered 1, not 0.) + + --pprreeffss Like the no-argument form of _-_d_e_m_o, but brings up + that program's Preferences panel by default. + + --aaccttiivvaattee + Tell xscreensaver to turn on immediately (that is, + blank the screen, as if the user had been idle for + long enough.) The screensaver will deactivate as + soon as there is any user activity, as usual. + + It is useful to run this from a menu; you may wish + + + + +X Version 11 20-Jun-99 (3.15) 1 + + + + + +XScreenSaver(1) XScreenSaver(1) + + + to run it as + + sleep 5 ; xscreensaver-command -activate + + to be sure that you have time to take your hand + off the mouse before the screensaver comes on. + (Because if you jiggle the mouse, xscreensaver + will notice, and deactivate.) + + --ddeeaaccttiivvaattee + If the screensaver is active (the screen is + blanked), this command will deactivate it just as + if there had been keyboard or mouse activity. If + locking is enabled, then the screensaver will + prompt for a password as usual. + + --ccyyccllee If the screensaver is active (the screen is + blanked), then stop the current graphics demo and + run a new one (chosen randomly.) + + --nneexxtt This is like either _-_a_c_t_i_v_a_t_e or _-_c_y_c_l_e, depending + on which is more appropriate, except that the + graphics hack that will be run is the next one in + the list, instead of a randomly-chosen one. In + other words, repeatedly executing -next will cause + the xscreensaver process to invoke each graphics + demo sequentially. (Though using the _-_d_e_m_o option + is probably an easier way to accomplish that.) + + --pprreevv This is like _-_n_e_x_t, but cycles in the other direc- + tion. + + --sseelleecctt _n_u_m_b_e_r + Like _-_a_c_t_i_v_a_t_e, but runs the _Nth element in the + list of hacks. By knowing what is in the _p_r_o_g_r_a_m_s + list, and in what order, you can use this to acti- + vate the screensaver with a particular graphics + demo. (The first element in the list is numbered + 1, not 0.) + + --eexxiitt Causes the xscreensaver process to exit grace- + fully. This is roughly the same as killing the + process with kkiillll(1), but it is easier, since you + don't need to first figure out the pid. + + WWaarrnniinngg:: never use _k_i_l_l _-_9 with _x_s_c_r_e_e_n_s_a_v_e_r while + the screensaver is active. If you are using a + virtual root window manager, that can leave things + in an inconsistent state, and you may need to + restart your window manager to repair the damage. + + --lloocckk Tells the running xscreensaver process to lock the + screen immediately. This is like _-_a_c_t_i_v_a_t_e, but + forces locking as well, even if locking is not the + + + +X Version 11 20-Jun-99 (3.15) 2 + + + + + +XScreenSaver(1) XScreenSaver(1) + + + default (that is, even if xscreensaver's _l_o_c_k + resource is false, and even if the _l_o_c_k_T_i_m_e_o_u_t + resource is non-zero.) + + Note that locking doesn't work unless the _x_s_c_r_e_e_n_- + _s_a_v_e_r process is running as you. See xxssccrreeeenn-- + ssaavveerr(1) for details. + + --tthhrroottttllee + Temporarily switch to ``blank screen'' mode, and + don't run any display modes at all, until the + screensaver is next de-activated. This is useful + if you're using a machine remotely, and you find + that some display modes are using too much CPU. + + (If you want to do this _p_e_r_m_a_n_e_n_t_l_y, that is, you + want the screen saver to only blank the screen and + not run demos at all, then set the _p_r_o_g_r_a_m_s + resource to an empty list: See xxssccrreeeennssaavveerr(1) + for details.) + + --uunntthhrroottttllee + Turn `-throttle' mode off and resume normal behav- + ior. + + --vveerrssiioonn + Prints the version of xscreensaver that is cur- + rently running on the display: that is, the actual + version number of the running xscreensaver back- + ground process, rather than the version number of + xscreensaver-command. (To see the version number + of _x_s_c_r_e_e_n_s_a_v_e_r_-_c_o_m_m_a_n_d itself, use the _-_h_e_l_p + option.) + + --ttiimmee Prints the time at which the screensaver last + activated or deactivated (roughly, how long the + user has been idle or non-idle: but not quite, + since it only tells you when the screen became + blanked or un-blanked.) + + --rreessttaarrtt + Causes the screensaver process to exit and then + restart with the same command line arguments as + last time. Do this after you've changed the + resource database, to cause xscreensaver to notice + the changes. + + WWaarrnniinngg:: if you have a _._x_s_c_r_e_e_n_s_a_v_e_r file, this + might not do what you expect. You're probably + better off killing the existing xscreensaver (with + _x_s_c_r_e_e_n_s_a_v_e_r_-_c_o_m_m_a_n_d _-_e_x_i_t) and then launching it + again. + + The important point is, you need to make sure that + + + +X Version 11 20-Jun-99 (3.15) 3 + + + + + +XScreenSaver(1) XScreenSaver(1) + + + the xscreensaver process is running as you. If + it's not, it won't be reading the right _._x_s_c_r_e_e_n_- + _s_a_v_e_r file. + +DDIIAAGGNNOOSSTTIICCSS + If an error occurs while communicating with the _x_s_c_r_e_e_n_- + _s_a_v_e_r daemon, or if the daemon reports an error, a diag- + nostic message will be printed to stderr, and _x_s_c_r_e_e_n_- + _s_a_v_e_r_-_c_o_m_m_a_n_d will exit with a non-zero value. If the + command is accepted, an indication of this will be printed + to stdout, and the exit value will be zero. + +EENNVVIIRROONNMMEENNTT + DDIISSPPLLAAYY to get the host and display number of the screen + whose saver is to be manipulated. + + PPAATTHH to find the executable to restart (for the + _-_r_e_s_t_a_r_t command). Note that this variable is + consulted in the environment of the _x_s_c_r_e_e_n_s_a_v_e_r + process, not the _x_s_c_r_e_e_n_s_a_v_e_r_-_c_o_m_m_a_n_d process. + +UUPPGGRRAADDEESS + The latest version of xxssccrreeeennssaavveerr(1) and related tools + can always be found at http://www.jwz.org/xscreensaver/ + +SSEEEE AALLSSOO + XX(1), xxssccrreeeennssaavveerr(1) xxssccrreeeennssaavveerr--ddeemmoo(1) + +CCOOPPYYRRIIGGHHTT + Copyright (C) 1992, 1993, 1997, 1998, 1999 by Jamie Zawin- + ski. Permission to use, copy, modify, distribute, and + sell this software and its documentation for any purpose + 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 sup- + porting documentation. No representations are made about + the suitability of this software for any purpose. It is + provided "as is" without express or implied warranty. + +AAUUTTHHOORR + Jamie Zawinski , 13-aug-92. + + Please let me know if you find any bugs or make any + improvements. + + + + + + + + + + + + + +X Version 11 20-Jun-99 (3.15) 4 + + diff --git a/local/man/cat.1/xscreensaver-demo.1 b/local/man/cat.1/xscreensaver-demo.1 new file mode 100644 index 00000000..dbea0663 --- /dev/null +++ b/local/man/cat.1/xscreensaver-demo.1 @@ -0,0 +1,330 @@ + + + +XScreenSaver(1) XScreenSaver(1) + + +NNAAMMEE + xscreensaver-demo - interactively control the background + xscreensaver daemon + +SSYYNNOOPPSSIISS + xxssccrreeeennssaavveerr--ddeemmoo [-display _h_o_s_t_:_d_i_s_p_l_a_y_._s_c_r_e_e_n] [-prefs] + [-xrm _r_e_s_o_u_r_c_e_s] + +DDEESSCCRRIIPPTTIIOONN + The _x_s_c_r_e_e_n_s_a_v_e_r_-_d_e_m_o program is a graphical front-end for + setting the parameters used by the background xxssccrreeeenn-- + ssaavveerr(1) daemon. It is essentially two things: a tool for + editing the _~_/_._x_s_c_r_e_e_n_s_a_v_e_r file; and a tool for demoing + the various graphics hacks that the _x_s_c_r_e_e_n_s_a_v_e_r daemon + will launch. + + The main dialog box contains a scrolling list, a text + field, and a number of buttons. + + Double-clicking on one of the programs in the list will + run it. The screen will go black, and the program will + run in full-screen mode, just as it would if the _x_s_c_r_e_e_n_- + _s_a_v_e_r daemon had launched it. Clicking the mouse again + will stop the demo and un-blank the screen, making the + dialog box visible again. + + Single-clicking in the list will place the indicated pro- + gram and its args in the text field to be edited. Edit + the arguments and hit return to run the program with the + parameters you have specified. This will also save your + changes to your _~_/_._x_s_c_r_e_e_n_s_a_v_e_r file: so any changes you + make in this way are persistent. + + If one of the lines in the scrolling list begins with the + character "-", then that means that the program is dis- + abled: _x_s_c_r_e_e_n_s_a_v_e_r will not select it to be run (though + you can still try it out by clicking on it.) Rather than + just deleting the programs you don't want to run, you + might want to disable them in this way instead, so that + you can more easily change your mind later. + + If the line begins with the name of a visual, followed by + a colon, then that program will only be run on that kind + of visual. For example, you can specify that a particular + program should only be run if color is available, and + another should only be run in monochrome. See the discus- + sion of the _p_r_o_g_r_a_m_s parameter in the _C_o_n_f_i_g_u_r_a_t_i_o_n sec- + tion of the xxssccrreeeennssaavveerr(1) manual. + + The buttons are: + + RRuunn NNeexxtt + Clicking this button will run the next program in + the list after the currently-selected one, and + + + +X Version 11 20-Jun-99 (3.15) 1 + + + + + +XScreenSaver(1) XScreenSaver(1) + + + will wrap around to the top when it reaches the + bottom. + + RRuunn PPrreevviioouuss + Opposite of Run Next; at the top, it wraps around + to the bottom. + + PPrreeffeerreenncceess + This pops up a second dialog box, in which you + have the option to interactively change most of + the screensaver's operational parameters, such as + its timeouts, and whether it should lock the + screen. When you click OK, your chosen settings + will take effect immediately, and will also be + saved to the _~_/_._x_s_c_r_e_e_n_s_a_v_e_r file in your home + directory, so that the settings will persist next + time. + + QQuuiitt Exits the _x_s_c_r_e_e_n_s_a_v_e_r_-_d_e_m_o program. The back- + ground _x_s_c_r_e_e_n_s_a_v_e_r daemon will continue running + as before. + + The Preferences dialog box lets you change the following + settings. + + (There are more settings available, but these are the most + commonly used ones; see the manual for xxssccrreeeennssaavveerr(1) for + other parameters that can be set by editing the + _~_/_._x_s_c_r_e_e_n_s_a_v_e_r file, or the X resource database.) + + SSaavveerr TTiimmeeoouutt + After the user has been idle this long, the + _x_s_c_r_e_e_n_s_a_v_e_r daemon will blank the screen. + + CCyyccllee TTiimmeeoouutt + After the screensaver has been running for this + long, the currently running graphics demo will be + killed, and a new one started. If this is 0, then + the graphics demo will never be changed: only one + demo will run until the screensaver is deactivated + by user activity. + + VVeerrbboossee + Whether to print lots of debugging information. + + IInnssttaallll CCoolloorrmmaapp + Whether to install a private colormap while the + screensaver is active, so that the graphics hacks + can get as many colors as possible. (This only + applies when the screen's default visual is being + used, since non-default visuals get their own col- + ormaps automatically.) This can also be overrid- + den on a per-demo basis. + + + + +X Version 11 20-Jun-99 (3.15) 2 + + + + + +XScreenSaver(1) XScreenSaver(1) + + + FFaaddee CCoolloorrmmaapp + If selected, then when the screensaver activates, + the current contents of the screen will fade to + black instead of simply winking out. This only + works on displays with writable colormaps, that + is, if the screen's default visual is a Pseudo- + Color visual. A fade will also be done when + switching graphics hacks (when the _C_y_c_l_e _T_i_m_e_o_u_t + expires.) + + UUnnffaaddee CCoolloorrmmaapp + The complement to _F_a_d_e _C_o_l_o_r_m_a_p: if selected, then + when the screensaver deactivates, the original + contents of the screen will fade in from black + instead of appearing immediately. This only works + on displays with writable colormaps, and when _F_a_d_e + _C_o_l_o_r_m_a_p is also selected. + + FFaaddee DDuurraattiioonn + When fading or unfading are selected, this con- + trols how long the fade will take. + + FFaaddee TTiicckkss + This controls how many times a second the colormap + will be changed to effect a fade. Higher numbers + yield smoother fades, but may make the fades take + longer than the specified number of seconds, if + your server isn't fast enough to keep up. + + RReeqquuiirree PPaasssswwoorrdd + Whether the screen saver should lock the screen + when it activates. + + LLoocckk TTiimmeeoouutt + If _R_e_q_u_i_r_e _P_a_s_s_w_o_r_d is selected, this controls the + length of the ``grace period'' between when the + screensaver activates, and when the screen becomes + locked. For example, if this is 0:05:00, and + _S_a_v_e_r _T_i_m_e_o_u_t is 0:10:00, then after 10 minutes, + the screen would blank. If there was user activ- + ity at 12 minutes, no password would be required + to un-blank the screen. But, if there was user + activity at 15 minutes or later (that is, _L_o_c_k + _T_i_m_e_o_u_t minutes after activation) then a password + would be required. The default is 0, meaning that + if locking is enabled, then a password will be + required as soon as the screen blanks. + + PPaasssswwoorrdd TTiimmeeoouutt + When the screensaver is prompting for a password, + the prompt dialog box will stay on the screen for + this long before giving up, and reverting to + screen-saving mode. + + + + +X Version 11 20-Jun-99 (3.15) 3 + + + + + +XScreenSaver(1) XScreenSaver(1) + + +CCOOMMMMAANNDD--LLIINNEE OOPPTTIIOONNSS + _x_s_c_r_e_e_n_s_a_v_e_r_-_d_e_m_o accepts the following command line + options. + + --ddiissppllaayy _h_o_s_t_:_d_i_s_p_l_a_y_._s_c_r_e_e_n + The X display to use. The _x_s_c_r_e_e_n_s_a_v_e_r_-_d_e_m_o pro- + gram will open its window on that display, and + also control the _x_s_c_r_e_e_n_s_a_v_e_r daemon that is man- + aging that same display. + + --pprreeffss Start up in Preferences mode: this is just like + launching the program with no arguments, and then + pressing the _P_r_e_f_e_r_e_n_c_e_s button. + + It is important that the _x_s_c_r_e_e_n_s_a_v_e_r and _x_s_c_r_e_e_n_- + _s_a_v_e_r_-_d_e_m_o processes be running on the same machine, or at + least, on two machines that share a file system. When + _x_s_c_r_e_e_n_s_a_v_e_r_-_d_e_m_o writes a new version of the _~_/_._x_s_c_r_e_e_n_- + _s_a_v_e_r file, it's important that the _x_s_c_r_e_e_n_s_a_v_e_r see that + same file. If the two processes are seeing different + _~_/_._x_s_c_r_e_e_n_s_a_v_e_r files, things will malfunction. + +EENNVVIIRROONNMMEENNTT + DDIISSPPLLAAYY to get the default host and display number. + + PPAATTHH to find the sub-programs to run. However, note + that the sub-programs are actually launched by the + _x_s_c_r_e_e_n_s_a_v_e_r daemon, not by _x_s_c_r_e_e_n_s_a_v_e_r_-_d_e_m_o + itself. So, what matters is what $$PPAATTHH the + _x_s_c_r_e_e_n_s_a_v_e_r program sees. + + HHOOMMEE for the directory in which to read and write the + _._x_s_c_r_e_e_n_s_a_v_e_r file. + + XXEENNVVIIRROONNMMEENNTT + to get the name of a resource file that overrides + the global resources stored in the RESOURCE_MAN- + AGER property. + +UUPPGGRRAADDEESS + The latest version can always be found at + http://www.jwz.org/xscreensaver/ + +SSEEEE AALLSSOO + XX(1), xxssccrreeeennssaavveerr(1), xxssccrreeeennssaavveerr--ccoommmmaanndd(1) + +CCOOPPYYRRIIGGHHTT + Copyright (C) 1992, 1993, 1997, 1998, 1999 by Jamie Zawin- + ski. Permission to use, copy, modify, distribute, and + sell this software and its documentation for any purpose + 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 sup- + porting documentation. No representations are made about + + + +X Version 11 20-Jun-99 (3.15) 4 + + + + + +XScreenSaver(1) XScreenSaver(1) + + + the suitability of this software for any purpose. It is + provided "as is" without express or implied warranty. + +AAUUTTHHOORR + Jamie Zawinski , 13-aug-92. + + Please let me know if you find any bugs or make any + improvements. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +X Version 11 20-Jun-99 (3.15) 5 + + diff --git a/local/man/cat.1/xscreensaver.1 b/local/man/cat.1/xscreensaver.1 new file mode 100644 index 00000000..53b31a0f --- /dev/null +++ b/local/man/cat.1/xscreensaver.1 @@ -0,0 +1,1716 @@ + + + +XScreenSaver(1) XScreenSaver(1) + + +NNAAMMEE + xscreensaver - graphics hack and screen locker, launched + when the user is idle + +SSYYNNOOPPSSIISS + xxssccrreeeennssaavveerr [-display _h_o_s_t_:_d_i_s_p_l_a_y_._s_c_r_e_e_n] [-timeout _i_n_t] + [-cycle _i_n_t] [-lock-mode] [-no-lock-mode] [-lock-timeout + _i_n_t] [-visual _v_i_s_u_a_l] [-install] [-no-install] [-verbose] + [-silent] [-timestamp] [-capture-stderr] [-no-cap- + ture-stderr] [-splash] [-no-splash] [-nice _i_n_t] + [-mit-extension] [-no-mit-extension] [-sgi-extension] + [-no-sgi-extension] [-xidle-extension] [-no-xidle-exten- + sion] [-proc-interrupts] [-no-proc-interrupts] [-xrm + _r_e_s_o_u_r_c_e_s] + +DDEESSCCRRIIPPTTIIOONN + The _x_s_c_r_e_e_n_s_a_v_e_r program waits until the keyboard and + mouse have been idle for a period, and then runs a graph- + ics demo chosen at random. It turns off as soon as there + is any mouse or keyboard activity. + + This program can lock your terminal in order to prevent + others from using it, though its default mode of operation + is merely to display pretty pictures on your screen when + it is not in use. + + The benefit that this program has over the combination of + the xxlloocckk(1) and xxaauuttoolloocckk(1) programs is the ease with + which new graphics hacks can be installed. You don't need + to recompile (or even re-run) this program to add a new + display mode. + +GGEETTTTIINNGG SSTTAARRTTEEDD + For the impatient, try this: + + xscreensaver & + xscreensaver-demo + + The xxssccrreeeennssaavveerr--ddeemmoo(1) program should pop up a dialog + box that lets you experiment with the xscreensaver set- + tings and graphics modes. + + NNoottee:: unlike xxlloocckk(1), xscreensaver has a client-server + model: the _x_s_c_r_e_e_n_s_a_v_e_r program is a daemon that runs in + the background; it is controlled by the foreground + xxssccrreeeennssaavveerr--ddeemmoo(1) and xxssccrreeeennssaavveerr--ccoommmmaanndd(1) programs. + +CCOONNFFIIGGUURRAATTIIOONN + Options to _x_s_c_r_e_e_n_s_a_v_e_r are specified in one of two + places: in a _._x_s_c_r_e_e_n_s_a_v_e_r file in your home directory; or + in the X resource database. If the _._x_s_c_r_e_e_n_s_a_v_e_r file + exists, it overrides any settings in the resource + database. + + + + +X Version 11 20-Jun-99 (3.15) 1 + + + + + +XScreenSaver(1) XScreenSaver(1) + + + The syntax of the _._x_s_c_r_e_e_n_s_a_v_e_r file is similar to that of + the _._X_d_e_f_a_u_l_t_s file; for example, to set the _t_i_m_e_o_u_t + paramter in the _._x_s_c_r_e_e_n_s_a_v_e_r file, you would write the + following: + + timeout: 5 + + whereas, in the _._X_d_e_f_a_u_l_t_s file, you would write + + xscreensaver.timeout: 5 + + If you change a setting in the _._x_s_c_r_e_e_n_s_a_v_e_r file while + xscreensaver is already running, it will notice this, and + reload the file. (The file will be reloaded the next time + the screen saver needs to take some action, such as blank- + ing or unblanking the screen, or picking a new graphics + mode.) + + If you change a setting in your X resource database, or if + you want xscreensaver to notice your changes immediately + instead of the next time it wakes up, then you will need + to tell the running xscreensaver process to re-initialize + itself, like so: + + xscreensaver-command -restart + + Note that if you changed the _._X_d_e_f_a_u_l_t_s file, you might + also need to run xxrrddbb(1): + + xrdb < ~/.Xdefaults + + If you want to set the system-wide defaults, then make + your edits to the xscreensaver app-defaults file, which + should have been installed when xscreensaver itself was + installed. The app-defaults file will usually be named + /usr/lib/X11/app-defaults/XScreenSaver, but different sys- + tems might keep it in a different place (for example, + /usr/openwin/lib/app-defaults/XScreenSaver on Solaris.) + + When settings are changed in the Preferences dialog box + (see above) the current settings will be written to the + _._x_s_c_r_e_e_n_s_a_v_e_r file. (The _._X_d_e_f_a_u_l_t_s file and the app- + defaults file will never be written by xscreensaver + itself.) + + + ttiimmeeoouutt (class TTiimmee) + The screensaver will activate (blank the screen) + after the keyboard and mouse have been idle for + this many minutes. Default 10 minutes. + + ccyyccllee (class TTiimmee) + After the screensaver has been running for this + many minutes, the currently running graphics-hack + + + +X Version 11 20-Jun-99 (3.15) 2 + + + + + +XScreenSaver(1) XScreenSaver(1) + + + sub-process will be killed (with SSIIGGTTEERRMM), and a + new one started. If this is 0, then the graphics + hack will never be changed: only one demo will run + until the screensaver is deactivated by user + activity. Default 10 minutes. + + lloocckk (class BBoooolleeaann) + Enable locking: before the screensaver will turn + off, it will require you to type the password of + the logged-in user (really, the person who ran + xscreensaver), or the root password. (NNoottee:: this + doesn't work if the screensaver is launched by + xxddmm(1) because it can't know the user-id of the + logged-in user. See the ``_U_s_i_n_g _X_D_M_(_1_)'' section, + below. + + lloocckkTTiimmeeoouutt (class TTiimmee) + If locking is enabled, this controls the length of + the ``grace period'' between when the screensaver + activates, and when the screen becomes locked. + For example, if this is 5, and _-_t_i_m_e_o_u_t is 10, + then after 10 minutes, the screen would blank. If + there was user activity at 12 minutes, no password + would be required to un-blank the screen. But, if + there was user activity at 15 minutes or later + (that is, _-_l_o_c_k_-_t_i_m_e_o_u_t minutes after activation) + then a password would be required. The default is + 0, meaning that if locking is enabled, then a + password will be required as soon as the screen + blanks. + + ppaasssswwddTTiimmeeoouutt (class TTiimmee) + If the screen is locked, then this is how many + seconds the password dialog box should be left on + the screen before giving up (default 30 seconds.) + This should not be too large: the X server is + grabbed for the duration that the password dialog + box is up (for security purposes) and leaving the + server grabbed for too long can cause problems. + + vviissuuaallIIDD (class VViissuuaallIIDD) + Specify which X visual to use by default. (Note + carefully that this resource is called vviissuuaallIIDD, + not merely vviissuuaall; if you set the vviissuuaall resource + instead, things will malfunction in obscure ways + for obscure reasons.) + + Legal values for the VViissuuaallIIDD resource are: + + ddeeffaauulltt Use the screen's default visual (the + visual of the root window.) This is the + default. + + bbeesstt Use the visual which supports the most + + + +X Version 11 20-Jun-99 (3.15) 3 + + + + + +XScreenSaver(1) XScreenSaver(1) + + + colors. Note, however, that the visual + with the most colors might be a TrueColor + visual, which does not support colormap + animation. Some programs have more inter- + esting behavior when run on PseudoColor + visuals than on TrueColor. + + mmoonnoo Use a monochrome visual, if there is one. + + ggrraayy Use a grayscale or staticgray visual, if + there is one and it has more than one + plane (that is, it's not monochrome.) + + ccoolloorr Use the best of the color visuals, if + there are any. + + GGLL Use the visual that is best for OpenGL + programs. (OpenGL programs have somewhat + different requirements than other X pro- + grams.) + + _c_l_a_s_s where _c_l_a_s_s is one of SSttaattiiccGGrraayy, SSttaattiicc-- + CCoolloorr, TTrruueeCCoolloorr, GGrraayySSccaallee, PPsseeuuddooCCoolloorr, + or DDiirreeccttCCoolloorr. Selects the deepest + visual of the given class. + + _n_u_m_b_e_r where _n_u_m_b_e_r (decimal or hex) is inter- + preted as a visual id number, as reported + by the xxddppyyiinnffoo(1) program; in this way + you can have finer control over exactly + which visual gets used, for example, to + select a shallower one than would other- + wise have been chosen. + + Note that this option specifies only the _d_e_f_a_u_l_t + visual that will be used: the visual used may be + overridden on a program-by-program basis. See the + description of the pprrooggrraammss resource, below. + + iinnssttaallllCCoolloorrmmaapp (class BBoooolleeaann) + Install a private colormap while the screensaver + is active, so that the graphics hacks can get as + many colors as possible. This is the default. + (This only applies when the screen's default + visual is being used, since non-default visuals + get their own colormaps automatically.) This can + also be overridden on a per-hack basis: see the + discussion of the ddeeffaauulltt--nn name in the section + about the pprrooggrraammss resource. + + vveerrbboossee (class BBoooolleeaann) + Whether to print diagnostics. Default false. + + + + + +X Version 11 20-Jun-99 (3.15) 4 + + + + + +XScreenSaver(1) XScreenSaver(1) + + + ttiimmeessttaammpp (class BBoooolleeaann) + Whether to print the time of day along with any + other diagnostic messages. Default false. + + ssppllaasshh (class BBoooolleeaann) + Whether to display a splash screen at startup. + Default true. + + ssppllaasshhDDuurraattiioonn (class TTiimmee) + How long the splash screen should remain visible; + default 5 seconds. + + hheellppUURRLL (class UURRLL) + The splash screen has a _H_e_l_p button on it. When + you press it, it will display the web page indi- + cated here in your web browser. + + llooaaddUURRLL (class LLooaaddUURRLL) + This is the shell command used to load a URL into + your web browser. The default setting will load + it into Netscape if it is already running, other- + wise, will launch a new Netscape looking at the + _h_e_l_p_U_R_L. + + ddeemmooCCoommmmaanndd (class DDeemmooCCoommmmaanndd) + This is the shell command run when the _D_e_m_o button + on the splash window is pressed. It defaults to + _x_s_c_r_e_e_n_s_a_v_e_r_-_d_e_m_o. + + pprreeffssCCoommmmaanndd (class PPrreeffssCCoommmmaanndd) + This is the shell command run when the _P_r_e_f_s but- + ton on the splash window is pressed. It defaults + to _x_s_c_r_e_e_n_s_a_v_e_r_-_d_e_m_o _-_p_r_e_f_s. + + nniiccee (class NNiiccee) + The sub-processes created by _x_s_c_r_e_e_n_s_a_v_e_r will be + ``niced'' to this level, so that they are given + lower priority than other processes on the system, + and don't increase the load unnecessarily. The + default is 10. + + (Higher numbers mean lower priority; see nniiccee(1) + for details.) + + ffaaddee (class BBoooolleeaann) + If this is true, then when the screensaver acti- + vates, the current contents of the screen will + fade to black instead of simply winking out. This + only works on displays with writable colormaps, + that is, if the screen's default visual is a Pseu- + doColor visual. A fade will also be done when + switching graphics hacks (when the _c_y_c_l_e timer + expires.) Default: true. + + + + +X Version 11 20-Jun-99 (3.15) 5 + + + + + +XScreenSaver(1) XScreenSaver(1) + + + uunnffaaddee (class BBoooolleeaann) + If this is true, then when the screensaver deacti- + vates, the original contents of the screen will + fade in from black instead of appearing immedi- + ately. This only works on displays with writable + colormaps, and if _f_a_d_e is true as well. Default + false. + + ffaaddeeSSeeccoonnddss (class TTiimmee) + If _f_a_d_e is true, this is how long the fade will be + in seconds (default 3 seconds.) + + ffaaddeeTTiicckkss (class IInntteeggeerr) + If _f_a_d_e is true, this is how many times a second + the colormap will be changed to effect a fade. + Higher numbers yield smoother fades, but may make + the fades take longer than the specified _f_a_d_e_S_e_c_- + _o_n_d_s if your server isn't fast enough to keep up. + Default 20. + + ccaappttuurreeSSttddeerrrr (class BBoooolleeaann) + Whether _x_s_c_r_e_e_n_s_a_v_e_r should redirect its stdout + and stderr streams to the window itself. Since + its nature is to take over the screen, you would + not normally see error messages generated by + xscreensaver or the sub-programs it runs; this + resource will cause the output of all relevant + programs to be drawn on the screensaver window + itself, as well as being written to the control- + ling terminal of the screensaver driver process. + Default true. + + ffoonntt (class FFoonntt) + The font used for the stdout/stderr text, if ccaapp-- + ttuurreeSSttddeerrrr is true. Default + **--mmeeddiiuumm--rr--**--114400--**--mm--** (a 14 point fixed-width + font.) + + pprrooggrraammss (class PPrrooggrraammss) + The graphics hacks which _x_s_c_r_e_e_n_s_a_v_e_r runs when + the user is idle. The value of this resource is a + string, one _s_h-syntax command per line. Each line + must contain exactly one command: no semicolons, + no ampersands. + + When the screensaver starts up, one of these is + selected at random, and run. After the _c_y_c_l_e + period expires, it is killed, and another is + selected and run. + + If the value of this resource is empty, then no + programs will be run; the screen will simply be + made black. + + + + +X Version 11 20-Jun-99 (3.15) 6 + + + + + +XScreenSaver(1) XScreenSaver(1) + + + If the display has multiple screens, then a dif- + ferent program will be run for each screen. (All + screens are blanked and unblanked simultaniously.) + + Note that you must escape the newlines; here is an + example of how you might set this in your + _~_/_._x_s_c_r_e_e_n_s_a_v_e_r file: + + + programs: \ + qix -root \n\ + ico -r -faces -sleep 1 -obj ico \n\ + xdaliclock -builtin2 -root \n\ + xv -root -rmode 5 image.gif -quit \n + + Make sure your $$PPAATTHH environment variable is set + up correctly _b_e_f_o_r_e xscreensaver is launched, or + it won't be able to find the programs listed in + the _p_r_o_g_r_a_m_s resource. + + To use a program as a screensaver, two things are + required: that that program draw on the root win- + dow (or be able to be configured to draw on the + root window); and that that program understand + ``virtual root'' windows, as used by virtual win- + dow managers such as ttvvttwwmm(1). (Generally, this + is accomplished by just including the _"_v_r_o_o_t_._h_" + header file in the program's source.) + + If there are some programs that you want to run + only when using a color display, and others that + you want to run only when using a monochrome dis- + play, you can specify that like this: + + mono: mono-program -root \n\ + color: color-program -root \n\ + + More generally, you can specify the kind of visual + that should be used for the window on which the + program will be drawing. For example, if one pro- + gram works best if it has a colormap, but another + works best if it has a 24-bit visual, both can be + accommodated: + + PseudoColor: cmap-program -root \n\ + TrueColor: 24bit-program -root \n\ + + In addition to the symbolic visual names described + above (in the discussion of the _v_i_s_u_a_l_I_D resource) + one other visual name is supported in the _p_r_o_g_r_a_m_s + list: + + ddeeffaauulltt--nn + This is like ddeeffaauulltt, but also requests the + + + +X Version 11 20-Jun-99 (3.15) 7 + + + + + +XScreenSaver(1) XScreenSaver(1) + + + use of the default colormap, instead of a + private colormap. (That is, it behaves as if + the _-_n_o_-_i_n_s_t_a_l_l command-line option was spec- + ified, but only for this particular hack.) + This is provided because some third-party + programs that draw on the root window + (notably: xxvv(1), and xxeeaarrtthh(1)) make assump- + tions about the visual and colormap of the + root window: assumptions which xscreensaver + can violate. + + If you specify a particular visual for a program, + and that visual does not exist on the screen, then + that program will not be chosen to run. This + means that on displays with multiple screens of + different depths, you can arrange for appropriate + hacks to be run on each. For example, if one + screen is color and the other is monochrome, hacks + that look good in mono can be run on one, and + hacks that only look good in color will show up on + the other. + + + Normally you won't need to change the following resources: + + + ppooiinntteerrPPoollllTTiimmee (class TTiimmee) + When server extensions are not in use, this con- + trols how frequently _x_s_c_r_e_e_n_s_a_v_e_r checks to see if + the mouse position or buttons have changed. + Default 5 seconds. + + wwiinnddoowwCCrreeaattiioonnTTiimmeeoouutt (class TTiimmee) + When server extensions are not in use, this con- + trols the delay between when windows are created + and when _x_s_c_r_e_e_n_s_a_v_e_r selects events on them. + Default 30 seconds. + + iinniittiiaallDDeellaayy (class TTiimmee) + When server extensions are not in use, _x_s_c_r_e_e_n_- + _s_a_v_e_r will wait this many seconds before selecting + events on existing windows, under the assumption + that _x_s_c_r_e_e_n_s_a_v_e_r is started during your login + procedure, and the window state may be in flux. + Default 0. (This used to default to 30, but that + was back in the days when slow machines and X ter- + minals were more common...) + + ssggiiSSaavveerrEExxtteennssiioonn (class BBoooolleeaann) + There are a number of different X server exten- + sions which can make xscreensaver's job easier. + The next few resources specify whether these + extensions should be utilized if they are avail- + able. + + + +X Version 11 20-Jun-99 (3.15) 8 + + + + + +XScreenSaver(1) XScreenSaver(1) + + + This resource controls whether the SGI + SSCCRREEEENN__SSAAVVEERR server extension will be used to + decide whether the user is idle. This is the + default if _x_s_c_r_e_e_n_s_a_v_e_r has been compiled with + support for this extension (which is the default + on SGI systems.). If it is available, the + SSCCRREEEENN__SSAAVVEERR method is faster and more reliable + than what will be done otherwise, so use it if you + can. (This extension is only available on Silicon + Graphics systems, unfortunately.) + + mmiittSSaavveerrEExxtteennssiioonn (class BBoooolleeaann) + This resource controls whether the + MMIITT--SSCCRREEEENN--SSAAVVEERR server extension will be used to + decide whether the user is idle. However, the + default for this resource is _f_a_l_s_e, because even + if this extension is available, it is flaky (and + it also makes the ffaaddee option not work properly.) + Use of this extension is not recommended. + + xxiiddlleeEExxtteennssiioonn (class BBoooolleeaann) + This resource controls whether the XXIIDDLLEE server + extension will be used to decide whether the user + is idle. This is the default if _x_s_c_r_e_e_n_s_a_v_e_r has + been compiled with support for this extension. + (This extension is only available for X11R4 and + X11R5 systems, unfortunately.) + + pprrooccIInntteerrrruuppttss (class BBoooolleeaann) + This resource controls whether the //pprroocc//iinntteerr-- + rruuppttss file should be consulted to decide whether + the user is idle. This is the default if _x_s_c_r_e_e_n_- + _s_a_v_e_r has been compiled on a system which supports + this mechanism (i.e., Linux systems.) + + The benefit to doing this is that _x_s_c_r_e_e_n_s_a_v_e_r can + note that the user is active even when the X con- + sole is not the active one: if the user is typing + in another virtual console, xscreensaver will + notice that and will fail to activate. For exam- + ple, if you're playing Quake in VGA-mode, xscreen- + saver won't wake up in the middle of your game and + start competing for CPU. + + The drawback to doing this is that perhaps you + _r_e_a_l_l_y _d_o want idleness on the X console to cause + the X display to lock, even if there is activity + on other virtual consoles. If you want that, then + set this option to False. (Or just lock the X + console manually.) + + The default value for this resource is True, on + systems where it works. + + + + +X Version 11 20-Jun-99 (3.15) 9 + + + + + +XScreenSaver(1) XScreenSaver(1) + + + oovveerrllaayySSttddeerrrr (class BBoooolleeaann) + If ccaappttuurreeSSttddeerrrr is True, and your server supports + ``overlay'' visuals, then the text will be written + into one of the higher layers instead of into the + same layer as the running screenhack. Set this to + False to disable that (though you shouldn't need + to.) + + oovveerrllaayyTTeexxttFFoorreeggrroouunndd (class FFoorreeggrroouunndd) + The foreground color used for the stdout/stderr + text, if ccaappttuurreeSSttddeerrrr is true. Default: Yellow. + + oovveerrllaayyTTeexxttBBaacckkggrroouunndd (class BBaacckkggrroouunndd) + The background color used for the stdout/stderr + text, if ccaappttuurreeSSttddeerrrr is true. Default: Black. + + bboouurrnneeSShheellll (class BBoouurrnneeSShheellll) + The pathname of the shell that _x_s_c_r_e_e_n_s_a_v_e_r uses + to start subprocesses. This must be whatever your + local variant of //bbiinn//sshh is: in particular, it + must not be ccsshh. + +CCOOMMMMAANNDD--LLIINNEE OOPPTTIIOONNSS + _x_s_c_r_e_e_n_s_a_v_e_r also accepts the following command line + options. Except for the _-_d_i_s_p_l_a_y option, these command- + line options are all simply shorthand for the X resources + described in the _C_o_n_f_i_g_u_r_a_t_i_o_n section, above. + + --ddiissppllaayy _h_o_s_t_:_d_i_s_p_l_a_y_._s_c_r_e_e_n + The X display to use. For displays with multiple + screens, XScreenSaver will manage all screens on + the display simultaniously; the _s_c_r_e_e_n argument + (the ``default'' screen) says which screen should + be used for dialog boxes (the password window, + _D_e_m_o _M_o_d_e, etc.) + + --ttiimmeeoouutt _m_i_n_u_t_e_s + Same as the _t_i_m_e_o_u_t resource. + + --ccyyccllee _m_i_n_u_t_e_s + Same as the _c_y_c_l_e resource. + + --lloocckk--mmooddee + Same as setting the _l_o_c_k resource to _t_r_u_e. + + --nnoo--lloocckk--mmooddee + Same as setting the _l_o_c_k resource to _f_a_l_s_e. + + --lloocckk--ttiimmeeoouutt _m_i_n_u_t_e_s + Same as the _l_o_c_k_T_i_m_e_o_u_t resource. + + --vviissuuaall _v_i_s_u_a_l + Same as the _v_i_s_u_a_l_I_D resource. + + + + +X Version 11 20-Jun-99 (3.15) 10 + + + + + +XScreenSaver(1) XScreenSaver(1) + + + --iinnssttaallll + Same as setting the _i_n_s_t_a_l_l_C_o_l_o_r_m_a_p resource to + _t_r_u_e. + + --nnoo--iinnssttaallll + Same as setting the _i_n_s_t_a_l_l_C_o_l_o_r_m_a_p resource to + _f_a_l_s_e. + + --vveerrbboossee + Same as setting the _v_e_r_b_o_s_e resource to _t_r_u_e. + + --ssiilleenntt Same as setting the _v_e_r_b_o_s_e resource to _f_a_l_s_e. + + --ttiimmeessttaammpp + Same as setting the _t_i_m_e_s_t_a_m_p resource to _t_r_u_e. + + --ccaappttuurree--ssttddeerrrr + Same as setting the _c_a_p_t_u_r_e_S_t_d_e_r_r resource to + _t_r_u_e. + + --nnoo--ccaappttuurree--ssttddeerrrr + Same as setting the _c_a_p_t_u_r_e_S_t_d_e_r_r resource to + _f_a_l_s_e. + + --ssppllaasshh Same as setting the _s_p_l_a_s_h resource to _t_r_u_e. + + --nnoo--ssppllaasshh + Same as setting the _s_p_l_a_s_h resource to _f_a_l_s_e. + + --nniiccee _i_n_t_e_g_e_r + Same as the _n_i_c_e resource. + + --ssggii--eexxtteennssiioonn + Same as setting the _s_g_i_S_a_v_e_r_E_x_t_e_n_s_i_o_n resource to + _t_r_u_e. + + --nnoo--ssggii--eexxtteennssiioonn + Same as setting the _s_g_i_S_a_v_e_r_E_x_t_e_n_s_i_o_n resource to + _f_a_l_s_e. + + --mmiitt--eexxtteennssiioonn + Same as setting the _m_i_t_S_a_v_e_r_E_x_t_e_n_s_i_o_n resource to + _t_r_u_e. + + --nnoo--mmiitt--eexxtteennssiioonn + Same as setting the _m_i_t_S_a_v_e_r_E_x_t_e_n_s_i_o_n resource to + _f_a_l_s_e. + + --xxiiddllee--eexxtteennssiioonn + Same as setting the _x_i_d_l_e_E_x_t_e_n_s_i_o_n resource to + _t_r_u_e. + + --nnoo--xxiiddllee--eexxtteennssiioonn + Same as setting the _x_i_d_l_e_E_x_t_e_n_s_i_o_n resource to + + + +X Version 11 20-Jun-99 (3.15) 11 + + + + + +XScreenSaver(1) XScreenSaver(1) + + + _f_a_l_s_e. + + --pprroocc--iinntteerrrruuppttss + Same as setting the _p_r_o_c_I_n_t_e_r_r_u_p_t_s resource to + _t_r_u_e. + + --nnoo--pprroocc--iinntteerrrruuppttss + Same as setting the _p_r_o_c_I_n_t_e_r_r_u_p_t_s resource to + _f_a_l_s_e. + + --xxrrmm _r_e_s_o_u_r_c_e_-_s_p_e_c_i_f_i_c_a_t_i_o_n + As with all other Xt programs, you can specify X + resources on the command-line using the _-_x_r_m argu- + ment. Most of the interesting resources have com- + mand-line equivalents, however. + +HHOOWW IITT WWOORRKKSS + When it is time to activate the screensaver, a full-screen + black window is created on each screen of the display. + Each window is created in such a way that, to any subse- + quently-created programs, it will appear to be a ``virtual + root'' window. Because of this, any program which draws + on the root window (and which understands virtual roots) + can be used as a screensaver. + + When the user becomes active again, the screensaver win- + dows are unmapped, and the running subprocesses are killed + by sending them SSIIGGTTEERRMM. This is also how the subpro- + cesses are killed when the screensaver decides that it's + time to run a different demo: the old one is killed and a + new one is launched. + + Before launching a subprocess, _x_s_c_r_e_e_n_s_a_v_e_r stores an + appropriate value for $$DDIISSPPLLAAYY in the environment that the + child will recieve. (This is so that if you start + _x_s_c_r_e_e_n_s_a_v_e_r with a _-_d_i_s_p_l_a_y argument, the programs which + _x_s_c_r_e_e_n_s_a_v_e_r launches will draw on the same display; and + so that the child will end up drawing on the appropriate + screen of a multi-headed display.) + + When the screensaver turns off, or is killed, care is + taken to restore the ``real'' virtual root window if there + is one. Because of this, it is important that you not + kill the screensaver process with _k_i_l_l _-_9 if you are run- + ning a virtual-root window manager. If you kill it with + -9, you may need to restart your window manager to repair + the damage. This isn't an issue if you aren't running a + virtual-root window manager. + + For all the gory details, see the commentary at the top of + xscreensaver.c. + + You can control a running screensaver process by using the + xxssccrreeeennssaavveerr--ccoommmmaanndd(1) program (which see.) + + + +X Version 11 20-Jun-99 (3.15) 12 + + + + + +XScreenSaver(1) XScreenSaver(1) + + +PPOOWWEERR MMAANNAAGGEEMMEENNTT + Modern X servers contain support to power down the monitor + after an idle period. If the monitor has powered down, + then _x_s_c_r_e_e_n_s_a_v_e_r will notice this, and will not waste CPU + by drawing graphics demos on a black screen. An attempt + will also be made to explicitly power the monitor back up + as soon as user activity is detected. + + If your X server supports power management, then xxsseett(1) + will accept a ddppmmss option. So, if you wanted _x_s_c_r_e_e_n_s_a_v_e_r + to activate after 5 minutes, but you wanted your monitor + to power down after one hour (3600 seconds) you would do + this: + + xset dpms 3600 + + See the man page for the xxsseett(1) program for details. + (Note that power management requires both software support + in the X server, and hardware support in the monitor + itself.) + +UUSSIINNGG XXDDMM((11)) + You can run _x_s_c_r_e_e_n_s_a_v_e_r from your xxddmm(1) session, so that + the screensaver will run even when nobody is logged in on + the console. + + The trick to using xscreensaver with _x_d_m is this: keep in + mind the two very different states in which xscreensaver + will be running: + + 11:: NNoobbooddyy llooggggeedd iinn.. + + If you're thinking of running xscreensaver from XDM + at all, then it's probably because you want graph- + ics demos to be running on the console when nobody + is logged in there. In this case, xscreensaver + will function only as a screen saver, not a screen + locker: it doesn't make sense for xscreensaver to + lock the screen, since nobody is logged in yet! + The only thing on the screen is the XDM login + prompt. + + 22:: SSoommeebbooddyy llooggggeedd iinn.. + + Once someone has logged in through the XDM login + window, the situation is very different. For exam- + ple: now it makes sense to lock the screen (and + prompt for the logged in user's password); and now + xscreensaver should consult that user's _~_/_._x_s_c_r_e_e_n_- + _s_a_v_e_r file; and so on. + + The difference between these two states comes down to a + question of, which user is the _x_s_c_r_e_e_n_s_a_v_e_r process run- + ning as? For the first state, it doesn't matter. If you + + + +X Version 11 20-Jun-99 (3.15) 13 + + + + + +XScreenSaver(1) XScreenSaver(1) + + + start _x_s_c_r_e_e_n_s_a_v_e_r in the usual XDM way, then xscreensaver + will probably end up running as root, which is fine for + the first case (the ``nobody logged in'' case.) + + However, once someone is logged in, running as root is no + longer fine: because xscreensaver will be consulting + root's _._x_s_c_r_e_e_n_s_a_v_e_r file instead of that of the logged in + user, and won't be prompting for the logged in user's + password, and so on. (This is not a security problem, + it's just not what you want.) + + So, once someone has logged in, you want xscreensaver to + be running as that user. The way to accomplish this is to + kill the old xscreensaver process and start a new one (as + the new user.) + + The simplest way to accomplish all of this is as follows: + + 11:: LLaauunncchh xxssccrreeeennssaavveerr bbeeffoorree aannyyoonnee llooggss iinn.. + + To the file _/_u_s_r_/_l_i_b_/_X_1_1_/_x_d_m_/_X_s_e_t_u_p, add the lines + + xscreensaver-command -exit + xscreensaver & + + This will run xscreensaver as root, over the XDM + login window. Moving the mouse will cause the + screen to un-blank, and allow the user to type + their password at XDM to log in. + + 22:: RReessttaarrtt xxssccrreeeennssaavveerr wwhheenn ssoommeeoonnee llooggss iinn.. + + Near the top of the file _/_u_s_r_/_l_i_b_/_X_1_1_/_x_d_m_/_X_s_e_s_s_i_o_n, + add those same lines: + + xscreensaver-command -exit + xscreensaver & + + When someone logs in, this will kill off the exist- + ing (root) xscreensaver process, and start a new + one, running as the user who has just logged in. + If the user's .xscreensaver file requests locking, + they'll get it. They will also get their own + choice of timeouts, and graphics demos, and so on. + + Alternately, each user could just put those lines + in their personal _~_/_._x_s_e_s_s_i_o_n files. + + Make sure you have $$PPAATTHH set up correctly in the _X_s_e_t_u_p + and _X_s_e_s_s_i_o_n scripts, or _x_d_m won't be able to find + _x_s_c_r_e_e_n_s_a_v_e_r, and/or _x_s_c_r_e_e_n_s_a_v_e_r won't be able to find + its graphics demos. + + (If your system does not seem to be executing the _X_s_e_t_u_p + + + +X Version 11 20-Jun-99 (3.15) 14 + + + + + +XScreenSaver(1) XScreenSaver(1) + + + file, you may need to configure it to do so: the tradi- + tional way to do this is to make that file the value of + the _D_i_s_p_l_a_y_M_a_n_a_g_e_r_*_s_e_t_u_p resource in the + _/_u_s_r_/_l_i_b_/_X_1_1_/_x_d_m_/_x_d_m_-_c_o_n_f_i_g file. See the man page for + xxddmm(1) for more details.) + + It is safe to run _x_s_c_r_e_e_n_s_a_v_e_r as root (as _x_d_m is likely + to do.) If run as root, _x_s_c_r_e_e_n_s_a_v_e_r changes its effec- + tive user and group ids to something safe (like _"_n_o_b_o_d_y_") + before connecting to the X server or launching user-speci- + fied programs. + + An unfortunate side effect of this (important) security + precaution is that it may conflict with cookie-based + authentication. + + If you get "connection refused" errors when running + _x_s_c_r_e_e_n_s_a_v_e_r from _x_d_m, then this probably means that you + have xxaauutthh(1) or some other security mechanism turned on. + One way around this is to add ""xxhhoosstt ++llooccaallhhoosstt"" to + _X_s_e_t_u_p, just before _x_s_c_r_e_e_n_s_a_v_e_r is launched. + + Note that this will give access to the X server to anyone + capable of logging in to the local machine, so in some + environments, this might not be appropriate. If turning + off file-system-based access control is not acceptable, + then running _x_s_c_r_e_e_n_s_a_v_e_r from the _X_s_e_t_u_p file might not + be possible, and xscreensaver will only work when running + as a normal, unprivileged user. + + For more information on the X server's access control + mechanisms, see the man pages for XX(1), XXsseeccuurriittyy(1), + xxaauutthh(1), and xxhhoosstt(1). + +UUSSIINNGG CCDDEE ((CCOOMMMMOONN DDEESSKKTTOOPP EENNVVIIRROONNMMEENNTT)) + The easiest way to use _x_s_c_r_e_e_n_s_a_v_e_r on a system with CDE + is to simply switch off the built-in CDE screensaver, and + use _x_s_c_r_e_e_n_s_a_v_e_r instead; and second, to tell the front + panel to run xxssccrreeeennssaavveerr--ccoommmmaanndd(1) with the _-_l_o_c_k option + when the _L_o_c_k icon is clicked. + + To accomplish this involves five steps: + + 11:: SSwwiittcchh ooffff CCDDEE''ss lloocckkeerr + Do this by turning off ``_S_c_r_e_e_n _S_a_v_e_r _a_n_d _S_c_r_e_e_n + _L_o_c_k'' in the Screen section of the Style Manager. + + 22:: EEddiitt sseessssiioonneettcc + Edit the file _~_/_._d_t_/_s_e_s_s_i_o_n_s_/_s_e_s_s_i_o_n_e_t_c and add to + it the line + + xscreensaver & + + This will cause _x_s_c_r_e_e_n_s_a_v_e_r to be launched when + + + +X Version 11 20-Jun-99 (3.15) 15 + + + + + +XScreenSaver(1) XScreenSaver(1) + + + you log in. (As always, make sure that xscreen- + saver and the graphics demos are on your $$PPAATTHH; the + path needs to be set in _._c_s_h_r_c and/or _._d_t_p_r_o_f_i_l_e, + not _._l_o_g_i_n.) + + 33:: CCrreeaattee XXSSccrreeeennSSaavveerr..ddtt + Create a file called _~_/_._d_t_/_t_y_p_e_s_/_X_S_c_r_e_e_n_S_a_v_e_r_._d_t + with the following contents: + + ACTION XScreenSaver + { + LABEL XScreenSaver + TYPE COMMAND + EXEC_STRING xscreensaver-command -lock + ICON Dtkey + WINDOW_TYPE NO_STDIO + } + + This defines a ``lock'' command for the CDE front + panel, that knows how to talk to _x_s_c_r_e_e_n_s_a_v_e_r. + + 44:: CCrreeaattee LLoocckk..ffpp + Create a file called _~_/_._d_t_/_t_y_p_e_s_/_L_o_c_k_._f_p with the + following contents: + + CONTROL Lock + { + TYPE icon + CONTAINER_NAME Switch + CONTAINER_TYPE SWITCH + POSITION_HINTS 1 + ICON Fplock + LABEL Lock + PUSH_ACTION XScreenSaver + HELP_TOPIC FPOnItemLock + HELP_VOLUME FPanel + } + + This associates the CDE front panel ``Lock'' icon + with the lock command we just defined in step 3. + + 55:: RReessttaarrtt + Select ``_R_e_s_t_a_r_t _W_o_r_k_s_p_a_c_e _M_a_n_a_g_e_r'' from the popup + menu to make your changes take effect. If things + seem not to be working, check the file _~_/_._d_t_/_e_r_r_o_r_- + _l_o_g for error messages. + +UUSSIINNGG HHPP VVUUEE ((VVIISSUUAALL UUSSEERR EENNVVIIRROONNMMEENNTT)) + Since CDE is a descendant of VUE, the instructions for + using xscreensaver under VUE are similar to the above: + + 11:: SSwwiittcchh ooffff VVUUEE''ss lloocckkeerr + Open the ``_S_t_y_l_e _M_a_n_a_g_e_r'' and select ``_S_c_r_e_e_n.'' + Turn off ``_S_c_r_e_e_n _S_a_v_e_r _a_n_d _S_c_r_e_e_n _L_o_c_k'' option. + + + +X Version 11 20-Jun-99 (3.15) 16 + + + + + +XScreenSaver(1) XScreenSaver(1) + + + 22:: MMaakkee ssuurree yyoouu hhaavvee aa SSeessssiioonn + Next, go to the Style Manager's, ``_S_t_a_r_t_u_p'' page. + Click on ``_S_e_t _H_o_m_e _S_e_s_s_i_o_n'' to create a session, + then on ``_R_e_t_u_r_n _t_o _H_o_m_e _S_e_s_s_i_o_n'' to select this + session each time you log in. + + 33:: EEddiitt vvuuee..sseessssiioonn + Edit the file _~_/_._v_u_e_/_s_e_s_s_i_o_n_s_/_h_o_m_e_/_v_u_e_._s_e_s_s_i_o_n and + add to it the line + + vuesmcmd -screen 0 -cmd "xscreensaver" + + This will cause _x_s_c_r_e_e_n_s_a_v_e_r to be launched when + you log in. (As always, make sure that xscreen- + saver and the graphics demos are on your $$PPAATTHH; the + path needs to be set in _._c_s_h_r_c and/or _._p_r_o_f_i_l_e, not + _._l_o_g_i_n.) + + 33:: EEddiitt vvuueewwmmrrcc + Edit the file _~_/_._v_u_e_/_v_u_e_w_m_r_c and add (or change) + the Lock control: + + CONTROL Lock + { + TYPE button + IMAGE lock + PUSH_ACTION f.exec "xscreensaver-command -lock" + HELP_TOPIC FPLock + } + + This associates the VUE front panel ``Lock'' icon + with the xscreensaver lock command. + + +AADDDDIINNGG TTOO MMEENNUUSS + The xxssccrreeeennssaavveerr--ccoommmmaanndd(1) program is a perfect candidate + for something to add to your window manager's popup menus. + If you use mmwwmm(1), 44DDwwmm(1), ttwwmm(1), or (probably) any of + _t_w_m's many descendants, you can do it like this: + + 11.. CCrreeaattee ~~//..mmwwmmrrcc ((oorr ~~//..ttwwmmrrcc oorr ......)) + If you don't have a _~_/_._m_w_m_r_c file (or, on SGIs, a + _~_/_._4_D_w_m_r_c file; or, with twm, a _~_/_._t_w_m_r_c file) then + create one by making a copy of the _/_u_s_r_/_l_i_b_/_X_1_1_/_s_y_s_- + _t_e_m_._m_w_m_r_c file (or _/_u_s_r_/_l_i_b_/_X_1_1_/_t_w_m_/_s_y_s_t_e_m_._t_w_m_r_c, and + so on.) + + 22.. AAdddd aa mmeennuu ddeeffiinniittiioonn.. + Something like this: + + menu XScreenSaver + { + "Blank Screen Now" !"sleep 3; xscreensaver-command -activate" + "Lock Screen Now" !"sleep 3; xscreensaver-command -lock" + + + +X Version 11 20-Jun-99 (3.15) 17 + + + + + +XScreenSaver(1) XScreenSaver(1) + + + "Screen Saver Demo" !"xscreensaver-demo" + "Screen Saver Preferences" !"xscreensaver-demo -prefs" + "Reinitialize Screen Saver" !"xscreensaver-command -restart" + "Kill Screen Saver" !"xscreensaver-command -exit" + "Launch Screen Saver" !"xscreensaver &" + } + + + 33.. AAdddd tthhee mmeennuu + For mmwwmm(1) and 44DDwwmm(1), find the section of the file + that says _M_e_n_u _D_e_f_a_u_l_t_R_o_o_t_M_e_n_u. For ttwwmm(1), it will + probably be _m_e_n_u _"_d_e_f_o_p_s_". If you add a line somewhere + in that menu definition that reads + + "XScreenSaver" f.menu XScreenSaver + + then this will add an XScreenSaver sub-menu to your + default root-window popup menu. Alternately, you could + just put the xscreensaver menu items directly into the + root menu. + + Other window managers are guaranteed to do things gratu- + itously differently. + +BBUUGGSS + Bugs? There are no bugs. Ok, well, maybe. If you find + one, please let me know. http://www.jwz.org/xscreen- + saver/bugs.html explains how to construct the most useful + bug reports. + + LLoocckkiinngg aanndd XXDDMM + If xscreensaver has been launched from xxddmm(1) + before anyone has logged in, you will need to kill + and then restart the xscreensaver daemon after you + have logged in, or you will be confused by the + results. (For example, locking won't work, and + your _~_/_._x_s_c_r_e_e_n_s_a_v_e_r file will be ignored.) + + When you are logged in, you want the _x_s_c_r_e_e_n_s_a_v_e_r + daemon to be running under _y_o_u_r user id, not as + root or some other user. + + If it has already been started by _x_d_m, you can + kill it by sending it the eexxiitt command, and then + re-launching it as you, by putting something like + the following in your personal X startup script: + + xscreensaver-command -exit + xscreensaver & + + The ``_U_s_i_n_g _X_D_M_(_1_)'' section, above, goes into + more detail, and explains how to configure the + system to do this for all users automatically. + + + + +X Version 11 20-Jun-99 (3.15) 18 + + + + + +XScreenSaver(1) XScreenSaver(1) + + + LLoocckkiinngg aanndd rroooott llooggiinnss + In order for it to be safe for xscreensaver to be + launched by _x_d_m, certain precautions had to be + taken, among them that xscreensaver never runs as + _r_o_o_t. In particular, if it is launched as root + (as _x_d_m is likely to do), xscreensaver will dis- + avow its privileges, and switch itself to a safe + user id (such as _n_o_b_o_d_y.) + + An implication of this is that if you log in as + _r_o_o_t on the console, xscreensaver will refuse to + lock the screen (because it can't tell the differ- + ence between _r_o_o_t being logged in on the console, + and a normal user being logged in on the console + but xscreensaver having been launched by the + xxddmm(1) _X_s_e_t_u_p file.) + + The solution to this is simple: you shouldn't be + logging in on the console as _r_o_o_t in the first + place! (What, are you crazy or something?) + + Proper Unix hygiene dictates that you should log + in as yourself, and ssuu(1) to _r_o_o_t as necessary. + People who spend their day logged in as _r_o_o_t are + just begging for disaster. + + XXAAUUTTHH aanndd XXDDMM + For xscreensaver to work when launched by xxddmm(1), + programs running on the local machine as user + _"_n_o_b_o_d_y_" must be able to connect to the X server. + This means that if you want to run xscreensaver on + the console while nobody is logged in, you may + need to disable cookie-based access control (and + allow all users who can log in to the local + machine to connect to the display.) + + You should be sure that this is an acceptable + thing to do in your environment before doing it. + See the ``_U_s_i_n_g _X_D_M_(_1_)'' section, above, for more + details. + + If anyone has suggestions on how xscreensaver + could be made to work with xxddmm(1) without first + turning off _._X_a_u_t_h_o_r_i_t_y-based access control, + please let me know. + + PPaasssswwoorrddss + If you get an error message at startup like + ``couldn't get password of _u_s_e_r'' then this proba- + bly means that you're on a system in which the + ggeettppwweenntt(3) library routine can only be effec- + tively used by root. If this is the case, then + _x_s_c_r_e_e_n_s_a_v_e_r must be installed as setuid to root + in order for locking to work. Care has been taken + + + +X Version 11 20-Jun-99 (3.15) 19 + + + + + +XScreenSaver(1) XScreenSaver(1) + + + to make this a safe thing to do. + + It also may mean that your system uses shadow + passwords instead of the standard ggeettppwweenntt(3) + interface; in that case, you may need to change + some options with _c_o_n_f_i_g_u_r_e and recompile. + + If you change your password after xscreensaver has + been launched, it will continue using your old + password to unlock the screen until xscreensaver + is restarted. So, after you change your password, + you'll have to do + + xscreensaver-command -restart + + to make _x_s_c_r_e_e_n_s_a_v_e_r notice. + + PPAAMM PPaasssswwoorrddss + If your system uses PAM (Pluggable Authentication + Modules), then in order for xscreensaver to use + PAM properly, PAM must be told about xscreensaver. + The xscreensaver installation process should + update the PAM data (on Linux, by creating the + file _/_e_t_c_/_p_a_m_._d_/_x_s_c_r_e_e_n_s_a_v_e_r for you, and on + Solaris, by telling you what lines to add to the + _/_e_t_c_/_p_a_m_._c_o_n_f file.) + + If the PAM configuration files do not know about + xscreensaver, then you _m_i_g_h_t be in a situation + where xscreensaver will refuse to ever unlock the + screen. + + This is a design flaw in PAM (there is no way for + a client to tell the difference between PAM + responding ``I have never heard of your module,'' + and responding, ``you typed the wrong password.'') + As far as I can tell, there is no way for xscreen- + saver to automatically work around this, or detect + the problem in advance, so if you have PAM, make + sure it is configured correctly! + + CCoolloorrmmaapp lloossssaaggee:: TTWWMM + The iinnssttaallllCCoolloorrmmaapp option doesn't work very well + with the ttwwmm(1) window manager and its descen- + dants. + + There is a race condition between the screensaver + and this window manager, which can result in the + screensaver's colormap not getting installed prop- + erly, meaning the graphics hacks will appear in + essentially random colors. (If the screen goes + white instead of black, this is probably why.) + + The mmwwmm(1) and oollwwmm(1) window managers don't have + + + +X Version 11 20-Jun-99 (3.15) 20 + + + + + +XScreenSaver(1) XScreenSaver(1) + + + this problem. The race condition exists because X + (really, ICCCM) does not provide a way for an + OverrideRedirect window to have its own colormap, + short of grabbing the server (which is neither a + good idea, nor really possible with the current + design.) What happens is that, as soon as + xscreensaver installs its colormap, ttwwmm responds + to the resultant CCoolloorrmmaappNNoottiiffyy event by re- + instaling the default colormap. Apparently, ttwwmm + doesn't _a_l_w_a_y_s do this; it seems to do it regu- + larly if the screensaver is activated from a menu + item, but seems to not do it if the screensaver + comes on of its own volition, or is activated from + another console. + + AAtttteennttiioonn,, wwiinnddooww mmaannaaggeerr aauutthhoorrss!! + You should only call XXIInnssttaallllCCoolloorrmmaapp(3) in + response to user events. That is, it is + appropriate to install a colormap in response + to FFooccuussIInn, FFooccuussOOuutt, EEnntteerrNNoottiiffyy, and + LLeeaavveeNNoottiiffyy events; but it is not appropriate + to call it in response to CCoolloorrmmaappNNoottiiffyy + events. If you install colormaps in response + to _a_p_p_l_i_c_a_t_i_o_n actions as well as in response + to _u_s_e_r actions, then you create the situation + where it is impossible for override-redirect + applications (such as xscreensaver) to display + their windows in the proper colors. + + CCoolloorrmmaapp lloossssaaggee:: XXVV,, XXAAnniimm,, XXEEaarrtthh + Some programs don't operate properly on visuals + other than the default one, or with colormaps + other than the default one. See the discussion of + the magic "default-n" visual name in the descrip- + tion of the pprrooggrraammss resource in the _C_o_n_f_i_g_u_r_a_t_i_o_n + section. When programs only work with the default + colormap, you need to use a syntax like this: + + default-n: xv -root image-1.gif -quit \n\ + default-n: xearth -nostars -wait 0 \n\ + + It would also work to turn off the iinnssttaallllCCoolloorrmmaapp + option altogether, but that would deny extra col- + ors to those programs that _c_a_n take advantage of + them. + + MMaacchhiinnee LLooaadd + Although this program ``nices'' the subprocesses + that it starts, graphics-intensive subprograms can + still overload the machine by causing the X server + process itself (which is not ``niced'') to suck a + lot of cycles. Care should be taken to slow down + programs intended for use as screensavers by + inserting strategic calls to sslleeeepp(3) or uusslleeeepp(3) + + + +X Version 11 20-Jun-99 (3.15) 21 + + + + + +XScreenSaver(1) XScreenSaver(1) + + + (or making liberal use of any _-_d_e_l_a_y options which + the programs may provide.) + + Note that the OpenGL-based graphics demos are real + pigs on machines that don't have texture hardware. + + Also, an active screensaver will cause your X + server to be pretty much permanently swapped in; + but the same is true of any program that draws + periodically, like xxcclloocckk(1) or xxllooaadd(1). + + LLaatteennccyy aanndd RReessppoonnssiivveenneessss + If the subprocess is drawing too quickly and the + connection to the X server is a slow one (such as + an X terminal running over a phone line) then the + screensaver might not turn off right away when the + user becomes active again (the iiccoo(1) demo has + this problem if being run in full-speed mode). + This can be alleviated by inserting strategic + calls to XXSSyynncc(3) in code intended for use as a + screensaver. This prevents too much graphics + activity from being buffered up. + + XXFFrreeee8866''ss MMaaggiicc KKeeyyssttrrookkeess + The XFree86 X server traps certain magic + keystrokes before client programs ever see them. + Two that are of note are Ctrl+Alt+Backspace, which + causes the X server to exit; and Ctrl+Alt+F_n, + which switches virtual consoles. The X server + will respond to these keystrokes even if xscreen- + saver has the screen locked. Depending on your + setup, you might consider this a problem. + + Unfortunately, there is no way for xscreensaver + itself to override the interpretation of these + keys. If you want to disable Ctrl+Alt+Backspace + globally, you need to set the _D_o_n_t_Z_a_p flag in your + _/_e_t_c_/_X_1_1_/_X_F_8_6_C_o_n_f_i_g file. See the XXFF8866CCoonnffiigg(5) + manual for details. + + There is no way (as far as I can tell) to disable + the VT-switching keystrokes. + + Some Linux systems come with a VT_LOCKSWITCH + ioctl, that one could theoretically use to prevent + VT-switching while the screen is locked; but + unfortunately, this ioctl can only be used by + root, which means that xscreensaver can't use it + (since xscreensaver disavows its privileges + shortly after startup, for security reasons.) + + Any suggestions for other solutions to this prob- + lem are welcome. + + + + +X Version 11 20-Jun-99 (3.15) 22 + + + + + +XScreenSaver(1) XScreenSaver(1) + + + XXVViieeww CClliieennttss + Apparently there are some problems with XView pro- + grams getting confused and thinking that the + screensaver window is the real root window even + when the screensaver is not active: ClientMessages + intended for the window manager are sent to the + screensaver window instead. This could be solved + by making xscreensaver forward all unrecognised + ClientMessages to the real root window, but there + may be other problems as well. If anyone has any + insight on the cause of this problem, please let + me know. (XView is an X11 toolkit that implements + the (quite abominable) Sun OpenLook look-and- + feel.) + + MMIITT EExxtteennssiioonn aanndd FFaaddiinngg + The MMIITT--SSCCRREEEENN--SSAAVVEERR extension is junk. Don't use + it. + + When using the MMIITT--SSCCRREEEENN--SSAAVVEERR extension in con- + junction with the ffaaddee option, you'll notice an + unattractive flicker just before the fade begins. + This is because the server maps a black window + just before it tells the _x_s_c_r_e_e_n_s_a_v_e_r process to + activate. The _x_s_c_r_e_e_n_s_a_v_e_r process immediately + unmaps that window, but this results in a flicker. + I haven't figured a way to get around this; it + seems to be a fundamental property of the (mis-) + design of this server extension. + + It sure would be nice if someone would implement + the SSGGII SSCCRREEEENN__SSAAVVEERR extension in XFree86; it's + dead simple, and works far better than the + overengineered and broken MMIITT--SSCCRREEEENN--SSAAVVEERR exten- + sion. + + SSGGII PPoowweerr SSaavveerr + If you're running Irix 6.3, you might find that + your monitor is powering down after an hour or two + even if you've told it not to. This is fixed by + SGI patches 2447 and 2537. + + If you're running Irix 6.5, this bug is back. I + don't know a fix. + + MMeessaaGGLL aanndd VVooooddoooo CCaarrddss + If you have a 3Dfx/Voodoo card, the default set- + tings for xscreensaver will run the GL-based + graphics demos in such a way that they will not + take advantage of the 3D acceleration hardware. + The solution is to change the pprrooggrraammss entries for + + + + + + +X Version 11 20-Jun-99 (3.15) 23 + + + + + +XScreenSaver(1) XScreenSaver(1) + + + the GL hacks from this: + + gears -root \n\ + + to this: + + MESA_GLX_FX=fullscreen gears \n\ + + That is, make sure that $$MMEESSAA__GGLLXX__FFXX is set to + _f_u_l_l_s_c_r_e_e_n, and don't tell the program to draw on + the root window. This may seem strange, but the + setup used by Mesa and these kinds of cards _i_s + strange! + + For those who don't know, these cards work by sit- + ting between your normal video card and the moni- + tor, and seizing control of the monitor when it's + time to do 3D. But this means that accelerated 3D + only happens in full-screen mode (you can't do it + in a window, and you can't see the output of 3D + and 2D programs simultaniously), and that 3D will + probably drive your monitor at a lower resolution, + as well. It's bizarre. + + If you find that GL programs only work properly + when run as root, and not as normal users, then + the problem is that your _/_d_e_v_/_3_d_f_x file is not + configured properly. Check the Linux 3Dfx FAQ. + + KKeeyybbooaarrdd LLEEDDss + If _p_r_o_c_I_n_t_e_r_r_u_p_t_s is on (which is the default on + Linux systems) and you're using some program that + toggles the state of your keyboard LEDs, xscreen- + saver won't work right: turning those LEDs on or + off causes a keyboard interrupt, which xscreen- + saver will interpret as user activity. So if + you're using such a program, set the _p_r_o_c_I_n_t_e_r_- + _r_u_p_t_s resource to False. + + EExxtteennssiioonnss + If you are not making use of one of the server + extensions (XXIIDDLLEE, SSGGII SSCCRREEEENN__SSAAVVEERR, or MMIITT-- + SSCCRREEEENN--SSAAVVEERR), then it is possible, in rare situa- + tions, for _x_s_c_r_e_e_n_s_a_v_e_r to interfere with event + propagation and make another X program malfunc- + tion. For this to occur, that other application + would need to _n_o_t select KKeeyyPPrreessss events on its + non-leaf windows within the first 30 seconds of + their existence, but then select for them later. + In this case, that client _m_i_g_h_t fail to receive + those events. This isn't very likely, since pro- + grams generally select a constant set of events + immediately after creating their windows and then + don't change them, but this is the reason that + + + +X Version 11 20-Jun-99 (3.15) 24 + + + + + +XScreenSaver(1) XScreenSaver(1) + + + it's a good idea to install and use one of the + server extensions instead, to work around this + shortcoming in the X protocol. + + In all these years, I've not heard of even a sin- + gle case of this happening, but it is theoreti- + cally possible, so I'm mentioning it for complete- + ness... + + RReedd HHoott LLaavvaa + There need to be a lot more graphics hacks. In + particular, there should be a simulation of a + Lavalite (tm). + +EENNVVIIRROONNMMEENNTT + DDIISSPPLLAAYY to get the default host and display number, and to + inform the sub-programs of the screen on which to + draw. + + PPAATTHH to find the sub-programs to run. + + HHOOMMEE for the directory in which to read and write the + _._x_s_c_r_e_e_n_s_a_v_e_r file. + + XXEENNVVIIRROONNMMEENNTT + to get the name of a resource file that overrides + the global resources stored in the RESOURCE_MAN- + AGER property. + +UUPPGGRRAADDEESS + The latest version can always be found at + http://www.jwz.org/xscreensaver/ + +SSEEEE AALLSSOO + XX(1), xxssccrreeeennssaavveerr--ddeemmoo(1), xxssccrreeeennssaavveerr--ccoommmmaanndd(1), + xxddmm(1), xxsseett(1), XXsseeccuurriittyy(1), xxaauutthh(1), xxhhoosstt(1). + aanntt(1), aattllaannttiiss(1), aattttrraaccttiioonn(1), bblliittssppiinn(1), + bboouubboouullee(1), bbrraaiidd(1), bbssoodd(1), bbuubbbbllee33dd(1), bbuubbbblleess(1), + ccaaggee(1), ccoommppaassss(1), ccoorraall(1), ccrriittiiccaall(1), ccrryyssttaall(1), + ccyynnoossuurree(1), ddeeccaayyssccrreeeenn(1), ddeeccoo(1), ddeelluuxxee(1), ddeemmoonn(1), + ddiissccrreettee(1), ddiissttoorrtt(1), ddrriifftt(1), eeppiiccyyccllee(1), ffaaddee-- + pplloott(1), ffllaagg(1), ffllaammee(1), ffllooww(1), ffoorreesstt(1), ggaallaaxxyy(1), + ggeeaarrss(1), ggllppllaanneett(1), ggoooopp(1), ggrraavv(1), ggrreeyynneettiicc(1), + hhaalloo(1), hheelliixx(1), hhooppaalloonngg(1), hhyyppeerrccuubbee(1), iiffss(1), + iimmssmmaapp(1), iinntteerrffeerreennccee(1), jjiiggssaaww(1), jjuulliiaa(1), kkaalleeii-- + ddeessccooppee(1), kkuummppppaa(1), llaammeenntt(1), llaasseerr(1), lliigghhttnniinngg(1), + lliissaa(1), lliissssiiee(1), llmmoorrpphh(1), lloooopp(1), mmaazzee(1), mmooee-- + bbiiuuss(1), mmooiirree(1), mmooiirree22(1), mmoorrpphh33dd(1), mmoouunnttaaiinn(1), + mmuunncchh(1), nnoosseegguuyy(1), ppeeddaall(1), ppeenneettrraattee(1), ppeennrroossee(1), + ppeettrrii(1), pphhoosspphhoorr(1), ppiippeess(1), ppuullssaarr(1), ppyyrroo(1), + qqiixx(1), rrdd--bboommbb(1), rroocckkss(1), rroorrsscchhaacchh(1), rroottoorr(1), + rruubbiikk(1), ssiieerrppiinnsskkii(1), sslliiddeessccrreeeenn(1), sslliipp(1), + ssoonnaarr(1), sspphheerree(1), ssppiirraall(1), ssppoottlliigghhtt(1), sspprrooiinn-- + ggiieess(1), ssqquuiirraall(1), ssttaaiirrss(1), ssttaarrffiisshh(1), ssttrraannggee(1), + + + +X Version 11 20-Jun-99 (3.15) 25 + + + + + +XScreenSaver(1) XScreenSaver(1) + + + ssuuppeerrqquuaaddrriiccss(1), sswwiirrll(1), tt33dd(1), ttrriiaannggllee(1), + ttrruucchheett(1), vviinneess(1), wwaannddeerr(1), wwoorrmm(1), xxffllaammee(1), + xxjjaacckk(1), xxllyyaapp(1), xxmmaattrriixx(1), xxrrooggeerr(1), bboonnggoo(1), + iiccoo(1), xxaaooss(1), xxbboouunncceebbiittss(1), xxcctthhuugghhaa(1), xxddaallii-- + cclloocckk(1), xxffiisshhttaannkk(1), xxmmoouunnttaaiinnss(1), xxsspplliinneeffuunn(1), + xxsswwaarrmm(1), xxttaaccyy(1), xxvv(1), xxwwaavvee(1). + +CCOOPPYYRRIIGGHHTT + Copyright (C) 1991, 1992, 1993, 1994, 1995, 1996, 1997, + 1998, 1999 by Jamie Zawinski. Permission to use, copy, + modify, distribute, and sell this software and its docu- + mentation for any purpose is hereby granted without fee, + provided that the above copyright notice appear in all + copies and that both that copyright notice and this per- + mission notice appear in supporting documentation. No + representations are made about the suitability of this + software for any purpose. It is provided "as is" without + express or implied warranty. + +AAUUTTHHOORR + Jamie Zawinski . Written in late 1991; first + posted to comp.sources.x on 13-Aug-1992. + + Please let me know if you find any bugs or make any + improvements. + +AACCKKNNOOWWLLEEDDGGEEMMEENNTTSS + Thanks to the many people who have contributed graphics + demos to the package. + + Thanks to David Wojtowicz for implementing _l_o_c_k_T_i_m_e_o_u_t. + + Thanks to Martin Kraemer for adding support for shadow + passwords and locking-disabled diagnostics. + + Thanks to Patrick Moreau for the VMS port. + + Thanks to Mark Bowyer for figuring out how to hook it up + to CDE. + + Thanks to Nat Lanza for the Kerberos support. + + Thanks to Bill Nottingham for the initial PAM support. + + And thanks to Jon A. Christopher for implementing the + Athena dialog support, back in the days before Lesstif or + Gtk were viable alternatives to Motif. + + + + + + + + + + +X Version 11 20-Jun-99 (3.15) 26 + + diff --git a/local/man/man.1/attraction.1 b/local/man/man.1/attraction.1 new file mode 100644 index 00000000..fabdc8a3 --- /dev/null +++ b/local/man/man.1/attraction.1 @@ -0,0 +1,178 @@ +.de EX \"Begin example +.ne 5 +.if n .sp 1 +.if t .sp .5 +.nf +.in +.5i +.. +.de EE +.fi +.in -.5i +.if n .sp 1 +.if t .sp .5 +.. +.TH XScreenSaver 1 "14-Jun-97" "X Version 11" +.SH NAME +attraction - interactions of opposing forces +.SH SYNOPSIS +.B attraction +[\-display \fIhost:display.screen\fP] [\-foreground \fIcolor\fP] [\-background \fIcolor\fP] [\-window] [\-root] [\-mono] [\-install] [\-visual \fIvisual\fP] [\-points \fIint\fP] [\-threshold \fIint\fP] [\-mode balls | lines | polygons | splines | filled-splines | tails ] [\-size \fIint\fP] [\-segments \fIint\fP] [\-delay \fIusecs\fP] [\-color-shift \fIint\fP] [\-radius \fIint\fP] [\-vx \fIint\fP] [\-vy \fIint\fP] [\-glow] [\-noglow] [\-orbit] [\-viscosity \fIfloat\fP] [\-mouse] [\-no-mouse] [\-mouse-size] +.SH DESCRIPTION +The \fIattraction\fP program has several visually different modes of +operation, all of which are based on the interactions of a set of control +points which attract each other up to a certain distance, and then begin +to repel each other. The attraction/repulsion is proportional to the +distance between any two particles. +.SH OPTIONS +.I attraction +accepts the following options: +.TP 8 +.B \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-mono +If on a color display, pretend we're on a monochrome display. +.TP 8 +.B \-install +Install a private colormap for the window. +.TP 8 +.B \-visual \fIvisual\fP +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. +.TP 8 +.B \-points integer +How many control points should be used, or 0 to select the number randomly. +Default 0. Between 3 and 15 works best. +.TP 8 +.B \-threshold integer +The distance (in pixels) from each particle at which the attractive force +becomes repulsive. Default 100. +.TP 8 +.B \-mode "balls | lines | polygons | tails | splines | filled-splines" +In \fIballs\fP mode (the default) the control points are drawn as filled +circles. The larger the circle, the more massive the particle. + +In \fIlines\fP mode, the control points are connected by straight lines; +the effect is something like \fIqix\fP. + +In \fIpolygons\fP mode, the control points are connected by straight +lines, and filled in. This is most interesting in color. + +In \fIsplines\fP mode, a closed spline is interpolated from the control +points. + +In \fIfilled-splines\fP mode, the splines are filled in instead of being +outlines. This is most interesting in color. + +In \fItails\fP mode, the path which each particle follows is indicated +by a worm-like trail, whose length is controlled by the \fIsegments\fP +parameter. +.TP 8 +.B \-size integer +The size of the balls in pixels, or 0, meaning to select the sizes +randomly (the default.) If this is specified, then all balls will be +the same size. This option has an effect in all modes, since the ``size'' +of the balls controls their mass. +.TP 8 +.B \-segments integer +If in \fIlines\fP or \fIpolygons\fP mode, how many sets of line segments +or polygons should be drawn. Default 100. This has no effect in \fIballs\fP +mode. If \fIsegments\fP is 0, then no segments will ever be erased (this +is only useful in color.) +.TP 8 +.B \-delay microseconds +How much of a delay should be introduced between steps of the animation. +Default 10000, or about 0.01 seconds. +.TP 8 +.B \-color-shift int +If on a color display, the color of the line segments or polygons will +cycle through the color map. This specifies how many lines will be drawn +before a new color is chosen. (When a small number of colors are available, +increasing this value will yield smoother transitions.) Default 3. +This has no effect in \fIballs\fP mode. +.TP 8 +.B \-radius +The size in pixels of the circle on which the points are initially positioned. +The default is slightly smaller than the size of the window. +.TP 8 +.B \-glow +This is consulted only in \fIballs\fP mode. If this is specified, then +the saturation of the colors of the points will vary according to their +current acceleration. This has the effect that the balls flare brighter +when they are reacting to each other most strongly. + +In \fIglow\fP mode, all of the balls will be drawn the same (random) +color, modulo the saturation shifts. In non-glow mode, the balls will +each be drawn in a random color that doesn't change. +.TP 8 +.B \-noglow +Don't do ``glowing.'' This is the default. +.TP 8 +.B \-vx pixels +.TP 8 +.B \-vy pixels +Initial velocity of the balls. This has no effect in \fB\-orbit\fP mode. +.TP 8 +.B \-orbit +Make the initial force on each ball be tangential to the circle on which +they are initially placed, with the right velocity to hold them in orbit +about each other. After a while, roundoff errors will cause the orbit +to decay. +.TP 8 +.B \-vmult float +In orbit mode, the initial velocity of the balls is multiplied by this; +a number less than 1 will make the balls pull closer together, and a larger +number will make them move apart. The default is 0.9, meaning a slight +inward pull. +.TP 8 +.B \-viscosity float +This sets the viscosity of the hypothetical fluid through which the control +points move; the default is 1, meaning no resistance. Values higher than 1 +aren't interesting; lower values cause less motion. + +One interesting thing to try is +.EX +attraction -viscosity 0.8 -points 75 \\ + -mouse -geometry =500x500 +.EE +Give it a few seconds to settle down into a stable clump, and then move +the mouse through it to make "waves". +.TP 8 +.B \-mouse +This will cause the mouse to be considered a control point; it will not be +drawn, but it will influence the other points, so you can wave the mouse +and influence the images being created. +.TP 8 +.B \-no-mouse +Turns off \fB\-mouse\fP. +.TP 8 +.B \-mouse-size integer +In \fB\-mouse\fP mode, this sets the mass of the mouse (analagously to the +\fB\-size\fP parameter.) +.SH ENVIRONMENT +.PP +.TP 8 +.B DISPLAY +to get the default host and display number. +.TP 8 +.B XENVIRONMENT +to get the name of a resource file that overrides the global resources +stored in the RESOURCE_MANAGER property. +.SH SEE ALSO +.BR X (1), +.BR xscreensaver (1) +.SH COPYRIGHT +Copyright \(co 1992, 1993, 1997 by Jamie Zawinski. Permission to use, copy, +modify, distribute, and sell this software and its documentation for any +purpose 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 representations are +made about the suitability of this software for any purpose. It is provided +"as is" without express or implied warranty. +.SH AUTHOR +Jamie Zawinski , 13-aug-92. + +Viscosity and mouse support by Philip Edward Cutone, III. diff --git a/local/man/man.1/blitspin.1 b/local/man/man.1/blitspin.1 new file mode 100644 index 00000000..f374666e --- /dev/null +++ b/local/man/man.1/blitspin.1 @@ -0,0 +1,106 @@ +.TH XScreenSaver 1 "24-Nov-97" "X Version 11" +.SH NAME +blitspin - rotate a bitmap in an interesting way +.SH SYNOPSIS +.B blitspin +[\-display \fIhost:display.screen\fP] [\-foreground \fIcolor\fP] [\-background \fIcolor\fP] [\-window] [\-root] [\-mono] [\-install] [\-visual \fIvisual\fP] [\-bitmap \fIfilename\fP] [\-delay \fIusecs\fP] [\-delay2 \fIusecs\fP] +.SH DESCRIPTION +The \fIblitspin\fP program repeatedly rotates a bitmap by 90 degrees by +using logical operations: the bitmap is divided into quadrants, and the +quadrants are shifted clockwise. Then the same thing is done again with +progressively smaller quadrants, except that all sub-quadrants of a +given size are rotated in parallel. So this takes \fBO(16*log2(N))\fP +blits of size NxN, with the limitation that the image must be square, +and the size must be a power of 2. +.SH OPTIONS +.I blitspin +accepts the following options: +.TP 8 +.B \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-mono +If on a color display, pretend we're on a monochrome display. +.TP 8 +.B \-install +Install a private colormap for the window. +.TP 8 +.B \-visual \fIvisual\fP +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. +.TP 8 +.B \-bitmap \fIfilename\fP +The file name of a bitmap to rotate. It need not be square: it +will be padded with the background color. If unspecified or the +string \fI(default)\fP, a builtin bitmap is used. + +If support for the \fIXPM\fP library was enabled at compile-time, +the specified file may be in \fIXPM\fP format as well as \fIXBM\fP, and +thus may be a color image. + +The \fB*bitmapFilePath\fP resource will be searched if the bitmap +name is not a fully-qualified pathname. +.TP 8 +.B \-grab\-screen +If this option is specified, then the image which is spun will be grabbed +from the portion of the screen underlying the blitspin window. (Or, it +may come from an external video source: see below.) +.PP +.TP 8 +.B \-delay \fImicroseconds\fP +How long to delay between steps of the rotation process, in microseconds. +Default is 500000, one-half second. +.PP +.TP 8 +.B \-delay2 \fImicroseconds\fP +How long to delay between each 90-degree rotation, in microseconds. +Default is 500000, one-half second. +.B DISPLAY +to get the default host and display number. +.SH RESOURCES +On some systems (currently, only SGIs), this program can, instead of grabbing +a desktop image, grab a frame of video from an external camera and manipulate +that instead. The following resources control that. +.PP +.TP 8 +.B grabVideoProbability \fR(Float)\fP +What portion of the time to grab video rather than a screen image, +between 0.0 and 1.0. Defaults to 0.5, or half the time. +.TP 8 +.B videoDevice \fR(Integer)\fP +The number of the default video input device to check first. If unspecified, +the default camera (from videopanel(1)) will be checked first. After that, all +other available video input devices will be checked in order. + +The first one which produces a non-black image will be used. If all images +are black, the others will be re-checked a few times before giving up and +falling back to simply grabbing a desktop image (but note that this takes a +few seconds, so if you don't actually have any video sources hooked up, you +should consider turning off video grabbing by setting +\fBgrabVideoProbability\fP to 0.0.) +.TP 8 +.B videoGain \fR(Float)\fP +The amount by which to brighten the grabbed image. This defaults to 2.2. +.SH ENVIRONMENT +.B XENVIRONMENT +to get the name of a resource file that overrides the global resources +stored in the RESOURCE_MANAGER property. +.SH SEE ALSO +.BR X (1), +.BR xscreensaver (1) +.SH COPYRIGHT +Copyright \(co 1992, 1993, 1997 by Jamie Zawinski. +Permission to use, copy, modify, distribute, and sell this software and its +documentation for any purpose 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 +representations are made about the suitability of this software for any +purpose. It is provided "as is" without express or implied warranty. +.SH AUTHOR +Jamie Zawinski , 17-aug-92. + +Based on SmallTalk code which appeared in the August 1981 issue of Byte +magazine. diff --git a/local/man/man.1/bouboule.1 b/local/man/man.1/bouboule.1 new file mode 100644 index 00000000..b2a8df24 --- /dev/null +++ b/local/man/man.1/bouboule.1 @@ -0,0 +1,76 @@ +.TH XScreenSaver 1 "15-May-97" "X Version 11" +.SH NAME +bouboule - draws spinning 3D blobs +.SH SYNOPSIS +.B bouboule +[\-display \fIhost:display.screen\fP] [\-foreground \fIcolor\fP] [\-background \fIcolor\fP] [\-window] [\-root] [\-mono] [\-install] [\-visual \fIvisual\fP] [\-ncolors \fIinteger\fP] [\-delay \fImicroseconds\fP] [\-cycles \fIinteger\fP] [\-count \fIinteger\fP] [\-3d] + +.SH DESCRIPTION +The \fIbouboule\fP program draws spinning 3D blobs. +.SH OPTIONS +.I bouboule +accepts the following options: +.TP 8 +.B \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-mono +If on a color display, pretend we're on a monochrome display. +.TP 8 +.B \-install +Install a private colormap for the window. +.TP 8 +.B \-visual \fIvisual\fP +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. +.TP 8 +.B \-ncolors \fIinteger\fP +How many colors should be used (if possible). Default 64. +The colors used cycle through the hue, making N stops around +the color wheel. +.TP 8 +.B \-cycles \fIinteger\fP + +.TP 8 +.B \-count \fIinteger\fP + +.TP 8 +.B \-3d +Do red/blue 3d separations (for 3d glasses.) + +.SH ENVIRONMENT +.PP +.TP 8 +.B DISPLAY +to get the default host and display number. +.TP 8 +.B XENVIRONMENT +to get the name of a resource file that overrides the global resources +stored in the RESOURCE_MANAGER property. +.SH SEE ALSO +.BR X (1), +.BR xscreensaver (1), +.BR xlock (1) +.SH COPYRIGHT +Copyright \(co 1996 by Jeremie Petit. + +Permission to use, copy, modify, and distribute this software and its +documentation for any purpose and without fee is hereby granted, +provided that the above copyright notice appear in all copies and that +both that copyright notice and this permission notice appear in +supporting documentation. + +.SH AUTHOR +Jeremie Petit , 1996. + +3D support by Henrik Theiling , 04-Sep-96. + +VMS support by Jouk Jansen , 01-Feb-96. + +TrueColor support by David Bagley , 01-Feb-96. + +Ability to run standalone or with \fIxscreensaver\fP added by +Jamie Zawinski , 15-May-97. diff --git a/local/man/man.1/braid.1 b/local/man/man.1/braid.1 new file mode 100644 index 00000000..65637afe --- /dev/null +++ b/local/man/man.1/braid.1 @@ -0,0 +1,65 @@ +.TH XScreenSaver 1 "10-May-97" "X Version 11" +.SH NAME +braid - draws random color-cycling braids around a circle +.SH SYNOPSIS +.B braid +[\-display \fIhost:display.screen\fP] [\-foreground \fIcolor\fP] [\-background \fIcolor\fP] [\-window] [\-root] [\-mono] [\-install] [\-visual \fIvisual\fP] [\-ncolors \fIinteger\fP] [\-delay \fImicroseconds\fP] [\-cycles \fIinteger\fP] [\-count \fIinteger\fP] + +.SH DESCRIPTION +The \fIbraid\fP program draws random color-cycling braids around a circle. +.SH OPTIONS +.I braid +accepts the following options: +.TP 8 +.B \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-mono +If on a color display, pretend we're on a monochrome display. +.TP 8 +.B \-install +Install a private colormap for the window. +.TP 8 +.B \-visual \fIvisual\fP +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. +.TP 8 +.B \-ncolors \fIinteger\fP +How many colors should be used (if possible). Default 64. +The colors used cycle through the hue, making N stops around +the color wheel. +.TP 8 +.B \-cycles \fIinteger\fP + +.TP 8 +.B \-count \fIinteger\fP + +.SH ENVIRONMENT +.PP +.TP 8 +.B DISPLAY +to get the default host and display number. +.TP 8 +.B XENVIRONMENT +to get the name of a resource file that overrides the global resources +stored in the RESOURCE_MANAGER property. +.SH SEE ALSO +.BR X (1), +.BR xscreensaver (1), +.BR xlock (1) +.SH COPYRIGHT +Copyright \(co 1995 by John Neil. + +Permission to use, copy, modify, and distribute this software and its +documentation for any purpose and without fee is hereby granted, +provided that the above copyright notice appear in all copies and that +both that copyright notice and this permission notice appear in +supporting documentation. +.SH AUTHOR +John Neil , 29-Aug-95. + +Ability to run standalone or with \fIxscreensaver\fP added by +Jamie Zawinski , 10-May-97. diff --git a/local/man/man.1/bsod.1 b/local/man/man.1/bsod.1 new file mode 100644 index 00000000..63bcee68 --- /dev/null +++ b/local/man/man.1/bsod.1 @@ -0,0 +1,126 @@ +.de EX \"Begin example +.ne 5 +.if n .sp 1 +.if t .sp .5 +.nf +.in +.5i +.. +.de EE +.fi +.in -.5i +.if n .sp 1 +.if t .sp .5 +.. +.TH XScreenSaver 1 "28-Oct-98" "X Version 11" +.SH NAME +bsod - Blue Screen of Death emulator +.SH SYNOPSIS +.B bsod +[\-display \fIhost:display.screen\fP] [\-foreground \fIcolor\fP] +[\-background \fIcolor\fP] [\-window] [\-root] [\-mono] [\-install] +[\-visual \fIvisual\fP] [\-delay \fIseconds\fP] +.SH DESCRIPTION +The +.I bsod +program is the finest in personal computer emulation. +.PP +.I bsod +steps through a set of screens, each one a recreation of a different failure +mode of an operating system. Systems depicted include Microsoft's Windows 95 +and Windows NT, Commodore-Amiga's AmigaDOS 1.3, SPARC Linux, SCO UNIX, the +Apple Macintosh (both the MacsBug debugger and the rarer "Sad Mac"), and the +Atari ST. +.PP +.SH OPTIONS +.I bsod +accepts the following options: +.TP 8 +.B \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-mono +If on a color display, pretend we're on a monochrome display. +.TP 8 +.B \-install +Install a private colormap for the window. +.TP 8 +.B \-visual \fIvisual\fP +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. +.TP 8 +.B \-delay \fIdelay\fP +The delay between displaying one crash and another. +.SH ENVIRONMENT +.PP +.TP 8 +.B DISPLAY +to get the default host and display number. +.TP 8 +.B XENVIRONMENT +to get the name of a resource file that overrides the global resources +stored in the RESOURCE_MANAGER property. +.SH X RESOURCES +Notable X resources supported include the following, which control which +hacks are displayed and which aren't. +.BR doWindows , +.BR doNT , +.BR doAmiga , +.BR doMac , +.BR doMacsBug , +.BR doSCO , +.BR doAtari , +and +.BR doSparcLinux . +Each of these is a Boolean resource, they all default to true, except for +doSparcLinux and doAtari, which are turned off by default, because they're +really not all that interesting looking unless you're a fan of those systems. +There aren't command-line options for these, so to change them, you'll need +to add entries to your .Xdefaults file, or use the -xrm option. +For example, to tell bsod not to show the NT crash: +.EX +bsod -xrm '*doNT: false' +.EE +.SH BUGS +Unlike the systems that the images are borrowed from, +.I bsod +does not require a reboot after running. +.PP +.I bsod +should also emulate more systems, but systems with interesting crash +graphics are not as common as one might hope. + +One I'd really like to see is a Unix system getting a kernel panic, +rebooting, and running +.BR fsck (8). +.SH SEE ALSO +.BR X (1), +.BR xscreensaver (1), +.BR http://www.microsoft.com/ , +.BR http://www.apple.com/ , +and +.BR http://www.sco.com/ , +.BR http://www.kernel.org/ , +and +.BR http://www.amiga.de/ . +.SH TRADEMARKS +Microsoft Windows, Microsoft Windows 95, and Microsoft Windows NT are all +registered trademarks of Microsoft Corporation. Apple Macintosh is a +registered trademark of Apple Computer. Amiga is a registered trademark of +Amiga International, Inc. Atari ST is probably a trademark, too, but it's +hard to tell who owns it. Linux is a registered trademark of Linus Torvalds, +but it isn't his fault. +.SH COPYRIGHT +Copyright \(co 1998 by Jamie Zawinski. Permission to use, copy, modify, +distribute, and sell this software and its documentation for any purpose 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 representations are made about the +suitability of this software for any purpose. It is provided "as is" without +express or implied warranty. No animals were harmed during the testing of +these simulations. Always mount a scratch monkey. +.SH AUTHOR +Concept cribbed from Stephen Martin . This version is by +Jamie Zawinski . diff --git a/local/man/man.1/bubbles.1 b/local/man/man.1/bubbles.1 new file mode 100644 index 00000000..c9016e64 --- /dev/null +++ b/local/man/man.1/bubbles.1 @@ -0,0 +1,142 @@ +.de EX \"Begin example +.ne 5 +.if n .sp 1 +.if t .sp .5 +.nf +.in +.5i +.. +.de EE +.fi +.in -.5i +.if n .sp 1 +.if t .sp .5 +.. +.TH XScreenSaver 1 "14-Dec-95" "X Version 11" +.SH NAME +bubbles - frying pan / soft drink simulation +.SH SYNOPSIS +.B bubbles +[\-display \fIhost:display.screen\fP] [\-foreground \fIcolor\fP] [\-background \fIcolor\fP] [\-window] [\-root] [\-mono] [\-install] [\-visual \fIvisual\fP] [\-simple] [\-broken] [\-3D] [\-file filename] [\-directory directoryname] +.SH DESCRIPTION +\fIBubbles\fP sprays lots of little random bubbles all over the window which +then grow until they reach their maximum size and go pop. The inspiration +for this was watching little globules of oil on the bottom of a frying pan +and it also looks a little like bubbles in fizzy soft drink. The default +mode uses fancy ray-traced bubbles but there is also a mode which just draws +circles in case the default mode is too taxing on your hardware. +.SH OPTIONS +Depending on how your +.I bubbles +was compiled, it accepts the following options: +.TP 8 +.B \-foreground +Colour of circles if \fI\-simple\fP mode is selected. +.TP 8 +.B \-background +Colour of window background. +.TP 8 +.B \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-mono +If on a color display, pretend we're on a monochrome display. +.TP 8 +.B \-install +Install a private colormap for the window. +.TP 8 +.B \-visual \fIvisual\fP +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. +.TP 8 +.B \-delay microseconds +How much of a delay should be introduced between steps of the animation. +Default 1, or about 1 microsecond. Actually, this is the delay between each +group of 15 new bubbles since such a delay between each step results in a +very slow animation rate. +.TP 8 +.B \-nodelay +Same as \fI\-delay 0\fP. +.TP 8 +.B \-simple +Don't use the default fancy pixmap bubbles. Just draw circles instead. +This may give more bearable performance if your hardware wasn't made for +this sort of thing. +.TP 8 +.B \-broken +Don't hide bubbles when they pop. This was a bug during development +but the results were actually quite attractive. (This option is only +available if you have the XPM library available and the imake generated +Makefile has defined HAVE_XPM). +.TP 8 +.B \-3D +Normally, the simulation is done completely in two dimensions. When a +bubble swallows up another bubble, the areas of each are added to get +the area of the resulting bubble. This option changes the algorithm +to instead add volume (imagining each to be a sphere in 3D space). The +whole thing looks more realistic but I find it attracts attention to +the flickering of each bubble as they are move and are redrawn. Your +mileage may vary. +.TP 8 +.B \-file filename +Use the pixmap definitions in the given file, instead of the default (if +one is compiled in). This is ignored if \fI\-simple\fP is specified. If +the file is compressed (either with compress or gzip), it is decompressed +before use. (This option only works if you have XPM compiled into your +binary and you have compiled with BUBBLES_IO set in bubbles.h. This is +\fBnot\fP the default). +.TP 8 +.B \-directory directoryname +Similar to \fI-file\fP except the file is taken randomly from the +contents of the specified directory. (Again, this option is only available +if you have XPM and BUBBLES_IO was set when compiling. See above). +.TP 8 +.B \-quiet +Don't print messages explaining why one or several command line options +were ignored. This is disabled by default. +.SH NOTES +If you find the pace of things too slow, remember that there is a delay +even though you specify no \fI\-delay\fP option. Try using \fI\-nodelay\fP +although beware of the effects of irritation of other users if you're on a +shared system as you bleed their CPU time away. + +Some tools to assist in creation of new bubbles are included in the source +distribution. These can either be loaded with the \fI\-file\fP or +\fI\-directory\fP options (if available) or they can be used in place +of the distributed default bubble (bubble_default.c). +You might like to copy these scripts to a permanent location and +use them. Read bubbles.README. + +Rendered bubbles are not supported on monochrome displays. I'm not +convinced that small bubbles, even dithered properly are going to look +like anything more than a jumble of random dots. +.SH BUGS +There is a delay before something appears on the screen when using +rendered bubbles. The XPM library seems to take a \fBlong\fP time to make +pixmaps out of raw data. This can be irritating on slower systems. + +The movement of the bubbles looks jerky if an incomplete set of bubbles +is used. + +The hide/display algorithm could do with some work to avoid flickering +when \fI\-nodelay\fP is set. +.SH ENVIRONMENT +.PP +.TP 8 +.B DISPLAY +to get the default host and display number. +.TP 8 +.B XENVIRONMENT +to get the name of a resource file that overrides the global resources +stored in the RESOURCE_MANAGER property. +.SH SEE ALSO +.BR X (1), +.BR xscreensaver (1) +.SH DISTRIBUTION POLICY +This work is Copyright \(co 1995, 1996 by James Macnicol. Distribution is +allowed under the terms of the GNU General Public License. Look at the +sources for the legalese. +.SH AUTHOR +James Macnicol . diff --git a/local/man/man.1/critical.1 b/local/man/man.1/critical.1 new file mode 100644 index 00000000..21eec6a5 --- /dev/null +++ b/local/man/man.1/critical.1 @@ -0,0 +1,87 @@ +.TH XScreenSaver 1 "13-Nov-98" "X Version 11" +.SH NAME +critical - Draw a system showing self-organizing criticality +.SH SYNOPSIS +.B critical +[\-display \fIhost:display.screen\fP] [\-foreground \fIcolor\fP] [\-background \fIcolor\fP] [\-window] [\-root] [\-mono] [\-install] [\-visual \fIvisual\fP] [\-delay \fIseconds\fP] [\-random \fIboolean\fP] [\-ncolors \fIint\fP] [\-offset \fIint\fP] +.SH DESCRIPTION +The \fIcritical\fP program displays a self-organizing critical system +that gradually emerges from chaos. + +\fIcritical\fP performs a simulation on a two-dimensional array of +integers. The array is initialized to random values. On each +iteration, it draws a line to the array position with the greatest +value. It then replaces that location and the eight neighboring +locations with randomly-selected values. + +The lines are initially random, but over time a chaotic +self-organizing system evolves: areas of the screen which happen to +have lower values are less likely to be updated to new values, and so +the line tends to avoid those areas. Eventually, the histogram of +changes approaches the power-law curve typical of such systems. + +The simplest documented self-organizing system is the one-dimensional +equivalent of \fIcritical\fP. + +I heard about this algorithm second-hand: apparently there was an +article in \fIScientific American\fP describing it sometime in 1997. +.SH OPTIONS +.I critical +accepts the following options: +.TP 8 +.B \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-mono +If on a color display, pretend we're on a monochrome display. +.TP 8 +.B \-install +Install a private colormap for the window. +.TP 8 +.B \-visual \fIvisual\fP +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. +.TP 8 +.B \-delay \fIusecs\fP +Number of microseconds to wait after drawing each line. +.TP 8 +.B \-random \fIboolean\fP +Whether to use randomly selected colours rather than a cycle around +the colour wheel. +.TP 8 +.B \-offset \fIinteger\fP +The maximum random radius increment to use. +.TP 8 +.B \-ncolors \fIinteger\fP +How many colors should be allocated in the color ramp (note that this +value interacts with \fIoffset\fP.) +.SH ENVIRONMENT +.PP +.TP 8 +.B DISPLAY +to get the default host and display number. +.TP 8 +.B XENVIRONMENT +to get the name of a resource file that overrides the global resources +stored in the RESOURCE_MANAGER property. +.SH SEE ALSO +.BR X (1), +.BR xscreensaver (1) +.BR xscreensaver-command (1) +.BR xscreensaver-demo (1) +.SH COPYRIGHT +Copyright \(co 1998 by Martin Pool. + +Permission to use, copy, modify, distribute, and sell this software +and its documentation for any purpose 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 representations are made about the +suitability of this software for any purpose. It is provided "as is" +without express or implied warranty. +.SH AUTHOR +Martin Pool , 13-Nov-1998. Based in part on the +XScreenSaver code by Jamie Zawinski . diff --git a/local/man/man.1/decayscreen.1 b/local/man/man.1/decayscreen.1 new file mode 100644 index 00000000..8dc0a0e7 --- /dev/null +++ b/local/man/man.1/decayscreen.1 @@ -0,0 +1,88 @@ +.TH XScreenSaver 1 "05-Apr-1999" "X Version 11" +.SH NAME +decayscreen - make a screen meltdown. +.SH SYNOPSIS +.B decayscreen +[\-display \fIhost:display.screen\fP] [\-window] [\-root] [\-mono] [\-install] [\-visual \fIvisual\fP] [\-delay \fIusecs\fP] [\-mode \fImode\fP] +.SH DESCRIPTION +The \fIdecayscreen\fP program creates a melting effect by randomly +shifting rectangles around the screen. +.SH OPTIONS +.I decayscreen +accepts the following options: +.TP 8 +.B \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-mono +If on a color display, pretend we're on a monochrome display. +.TP 8 +.B \-install +Install a private colormap for the window. +.TP 8 +.B \-visual \fIvisual\fP +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. +.TP 8 +.B \-delay \fImicroseconds\fP +Slow it down. +.TP 8 +.B \-mode \fImode\fP +The direction in which the image should tend to slide. Legal values are +\fIrandom\fP (meaning pick one), \fIup\fP, \fIleft\fP, \fIright\fP, +\fIdown\fP, \fIupleft\fP, \fIdownleft\fP, \fIupright\fP, \fIdownright\fP, +\fIshuffle\fP (meaning perfer no particular direction), \fIin\fP (meaning +move things toward the center), \fIout\fP (meaning move things away +from the center), \fImelt\fP (meaning melt straight downward), and \fIstretch\fP +(meaning stretch the screen downward). +.SH RESOURCES +On some systems (currently, only SGIs), this program can, instead of grabbing +a desktop image, grab a frame of video from an external camera and manipulate +that instead. The following resources control that. +.PP +.TP 8 +.B grabVideoProbability \fR(Float)\fP +What portion of the time to grab video rather than a screen image, +between 0.0 and 1.0. Defaults to 0.5, or half the time. +.TP 8 +.B videoDevice \fR(Integer)\fP +The number of the default video input device to check first. If unspecified, +the default camera (from videopanel(1)) will be checked first. After that, all +other available video input devices will be checked in order. + +The first one which produces a non-black image will be used. If all images +are black, the others will be re-checked a few times before giving up and +falling back to simply grabbing a desktop image (but note that this takes a +few seconds, so if you don't actually have any video sources hooked up, you +should consider turning off video grabbing by setting +\fBgrabVideoProbability\fP to 0.0.) +.TP 8 +.B videoGain \fR(Float)\fP +The amount by which to brighten the grabbed image. This defaults to 2.2. +.SH ENVIRONMENT +.PP +.TP 8 +.B DISPLAY +to get the default host and display number. +.TP 8 +.B XENVIRONMENT +to get the name of a resource file that overrides the global resources +stored in the RESOURCE_MANAGER property. +.SH "SEE ALSO" +X(1), +xscreensaver(1) +.SH COPYRIGHT +Copyright 1992 by Vivek Khera. Permission to use, copy, modify, distribute, +and sell this software and its documentation for any purpose 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 representations are made about the suitability +of this software for any purpose. It is provided "as is" without express or +implied warranty. +.SH AUTHOR +Vivek Khera , 05-Aug-93; based on code by David Wald, 1988. +Modified by jwz, 28-Nov-97. Modified by Rick Schultz 05-Apr-1999. + diff --git a/local/man/man.1/deco.1 b/local/man/man.1/deco.1 new file mode 100644 index 00000000..5f8a6fc7 --- /dev/null +++ b/local/man/man.1/deco.1 @@ -0,0 +1,72 @@ +.TH XScreenSaver 1 "27-Apr-97" "X Version 11" +.SH NAME +deco - draw tacky 70s basement wall panelling +.SH SYNOPSIS +.B deco +[\-display \fIhost:display.screen\fP] [\-foreground \fIcolor\fP] [\-background \fIcolor\fP] [\-window] [\-root] [\-mono] [\-install] [\-visual \fIvisual\fP] [\-delay \fIseconds\fP] [\-max\-depth \fIint\fP] [\-min\-width \fIint\fP] [\-min\-height \fIint\fP] [\-cycle] [\-no\-cycle] [\-cycle\-delay] +.SH DESCRIPTION +The \fIdeco\fP program subdivides and colors rectangles randomly. +It looks kind of like Brady-Bunch-era rec-room wall paneling. +(Raven says: "this screensaver is ugly enough to peel paint.") +.SH OPTIONS +.I deco +accepts the following options: +.TP 8 +.B \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-mono +If on a color display, pretend we're on a monochrome display. +.TP 8 +.B \-install +Install a private colormap for the window. +.TP 8 +.B \-visual \fIvisual\fP +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. +.TP 8 +.B \-delay \fIseconds\fP +How long to wait before starting over. Default 5 seconds. +.TP 8 +.B \-max\-depth \fIinteger\fP +How deep to subdivide. Default 12. +Default 8. +.TP 8 +.B \-min-width \fIinteger\fP +.B \-min-height \fIinteger\fP +The size of the smallest rectangle to draw. Default 20x20. +.TP 8 +.B \-cycle +.TP 8 +.B \-no\-cycle +Whether to do color cycling. Default False. +.TP 8 +.B \-cycle\-delay \fIusecs\fP +If color cycling, how often to change the colors. Default 1000000, +or 1 second. +.SH ENVIRONMENT +.PP +.TP 8 +.B DISPLAY +to get the default host and display number. +.TP 8 +.B XENVIRONMENT +to get the name of a resource file that overrides the global resources +stored in the RESOURCE_MANAGER property. +.SH SEE ALSO +.BR X (1), +.BR xscreensaver (1) +.SH COPYRIGHT +Copyright \(co 1997 by Jamie Zawinski. Permission to use, copy, modify, +distribute, and sell this software and its documentation for any purpose 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 representations are made about the +suitability of this software for any purpose. It is provided "as is" without +express or implied warranty. +.SH AUTHOR +Jamie Zawinski , 26-Apr-97, based on code by +Michael D. Bayne . diff --git a/local/man/man.1/drift.1 b/local/man/man.1/drift.1 new file mode 100644 index 00000000..407f06a3 --- /dev/null +++ b/local/man/man.1/drift.1 @@ -0,0 +1,75 @@ +.TH XScreenSaver 1 "10-May-97" "X Version 11" +.SH NAME +drift - draws drifting recursive fractal cosmic flames +.SH SYNOPSIS +.B drift +[\-display \fIhost:display.screen\fP] [\-foreground \fIcolor\fP] [\-background \fIcolor\fP] [\-window] [\-root] [\-mono] [\-install] [\-visual \fIvisual\fP] [\-ncolors \fIinteger\fP] [\-delay \fImicroseconds\fP] [\-count \fIinteger\fP] [\-grow] [\-no\-grow] [\-liss] [\-no\-liss] + +.SH DESCRIPTION +The \fIdrift\fP program draws drifting recursive fractal cosmic flames +.SH OPTIONS +.I drift +accepts the following options: +.TP 8 +.B \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-mono +If on a color display, pretend we're on a monochrome display. +.TP 8 +.B \-install +Install a private colormap for the window. +.TP 8 +.B \-visual \fIvisual\fP +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. +.TP 8 +.B \-ncolors \fIinteger\fP +How many colors should be used (if possible). Default 200. +The colors used cycle through the hue, making N stops around +the color wheel. +.TP 8 +.B \-count \fIinteger\fP + +.TP 8 +.B \-grow +.TP 8 +.B \-no\-grow +Whether fractals should grow; otherwise, they are animated. + +.TP 8 +.B \-liss +.TP 8 +.B \-no\-liss +Whether we should use lissojous figures to get points. + +.SH ENVIRONMENT +.PP +.TP 8 +.B DISPLAY +to get the default host and display number. +.TP 8 +.B XENVIRONMENT +to get the name of a resource file that overrides the global resources +stored in the RESOURCE_MANAGER property. +.SH SEE ALSO +.BR flame (1), +.BR X (1), +.BR xscreensaver (1), +.BR xlock (1) +.SH COPYRIGHT +Copyright \(co 1991, 1995 by Scott Draves. + +Permission to use, copy, modify, and distribute this software and its +documentation for any purpose and without fee is hereby granted, +provided that the above copyright notice appear in all copies and that +both that copyright notice and this permission notice appear in +supporting documentation. +.SH AUTHOR +Scott Draves , 06-Jun-91, 01-Jun-95. + +Ability to run standalone or with \fIxscreensaver\fP added by +Jamie Zawinski , 10-May-97. diff --git a/local/man/man.1/epicycle.1 b/local/man/man.1/epicycle.1 new file mode 100644 index 00000000..3af0ed5f --- /dev/null +++ b/local/man/man.1/epicycle.1 @@ -0,0 +1,200 @@ +.de EX \"Begin example +.ne 5 +.if n .sp 1 +.if t .sp .5 +.nf +.in +.5i +.. +.de EE +.fi +.in -.5i +.if n .sp 1 +.if t .sp .5 +.. +.TH XScreenSaver 1 "27-Apr-97" "X Version 11" +.SH NAME +epicycle - draws a point moving around a circle which moves around a cicle which... +.SH SYNOPSIS +.B epicycle +[\-display \fIhost:display.screen\fP] [\-root] [\-window] [\-mono] [\-install] [\-noinstall] [\-visual \fIviz\fP] [\-colors \fIN\fP] [\-foreground \fIname\fP] [\-color\-shift \fIN\fP] [\-delay \fImicroseconds\fP] [\-holdtime \fIseconds\fP] [\-linewidth \fIN\fP] [\-min_circles \fIN\fP] [\-max_circles \fIN\fP] [\-min_speed \fInumber\fP] [\-max_speed \fInumber\fP] [\-harmonics \fIN\fP] [\-timestep \fInumber\fP] [\-divisor_poisson \fIprobability\fP] [\-size_factor_min \fInumber\fP] [\-size_factor_max \fInumber\fP] +.SH DESCRIPTION +The epicycle program draws the path traced out by a point on the edge +of a circle. That circle rotates around a point on the rim of another +circle, and so on, several times. The random curves produced can be +simple or complex, convex or concave, but they are always closed +curves (they never go in indefinitely). + +You can configure both the way the curves are drawn and the way in +which the random sequence of circles is generated, either with +command-line options or X resources. +.SH OPTIONS +.TP 8 +.B \-display \fIhost:display.screen\fP +Specifies which X display we should use (see the section DISPLAY NAMES in +.BR X (1) +for more information about this option). +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-mono +If on a color display, pretend we're on a monochrome display. +If we're on a mono display, we have no choice. +.TP 8 +.B \-install +Install a private colormap for the window. +.TP 8 +.B \-noinstall +Don't install a private colormap for the window. +.TP 8 +.B \-visual \fIviz\fP +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. +Possible choices include + +.RS +default, best, mono, monochrome, gray, grey, color, staticgray, staticcolor, +truecolor, grayscale, greyscale, pseudocolor, directcolor, \fInumber\fP + +If a decimal or hexadecimal number is used, +.BR XGetVisualInfo (3X) +is consulted to obtain the required visual. +.RE +.TP 8 +.B \-colors \fIN\fP +How many colors should be used (if possible). The colors are chosen +randomly. +.TP 8 +.B \-foreground \fIname\fP +With +.BR \-mono , +this option selects the foreground colour. +.TP 8 +.B \-delay \fImicroseconds\fP +Specifies the delay between drawing successive line segments of the +path. If you do not specify +.BR -sync , +some X servers may batch up several drawing operations together, +producing a less smooth effect. This is more likely to happen +in monochrome mode (on monochrome servers or when +.B \-mono +is specified). +.TP 8 +.B \-holdtime \fIseconds\fP +When the figure is complete, +.I epicycle +pauses this number of seconds. +.TP 8 +.B \-linewidth \fIN\fP +Width in pixels of the body's track. Specifying values greater than +one may cause slower drawing. The fastest value is usually zero, +meaning one pixel. +.TP 8 +.B \-min_circles \fIN\fP +Smallest number of epicycles in the figure. +.TP 8 +.B \-max_circles \fIN\fP +Largest number of epicycles in the figure. +.TP 8 +.B \-min_speed \fInumber\fP +Smallest possible value for the base speed of revolution of the +epicycles. The actual speeds of the epicycles vary from this down +to +.IB "min_speed / harmonics" . +.TP 8 +.B \-max_speed \fInumber\fP +Smallest possible value for the base speed of revolution of the +epicycles. +.TP 8 +.B \-harmonics \fIN\fP +Number of possible harmonics; the larger this value is, the greater +the possible variety of possible speeds of epicycle. +.TP 8 +.B \-timestep \fInumber\fP +Decreasing this value will reduce the distance the body moves for +each line segment, possibly producing a smoother figure. Increasing +it may produce faster results. +.TP 8 +.B \-divisor_poisson \fIprobability\fP +Each epicycle rotates at a rate which is a factor of the base speed. +The speed of each epicycle is the base speed divided by some integer +between 1 and the value of the +.B \-harmonics +option. This integer is decided by starting at 1 and tossing +a biased coin. For each consecutive head, the value is incremented by +one. The integer will not be incremented above the value of the +.B \-harmonics +option. The argument of this option decides the bias of the coin; it +is the probability that that coin will produce a head at any given toss. +.TP 8 +.B \-size_factor_min \fInumber\fP +Epicycles are always at least this factor smaller than their +parents. +.TP 8 +.B \-size_factor_max \fInumber\fP +Epicycles are never more than this factor smaller than their parents. +.SH RESOURCES +.EX +Option Resource Default Value +------ -------- ------------- +-colors .colors 100 +-delay .delay 1000 +-holdtime .holdtime 2 +-linewidth .lineWidth 4 +-min_circles .minCircles 2 +-max_circles .maxCircles 10 +-min_speed .minSpeed 0.003 +-max_speed .maxSpeed 0.005 +-harmonics .harmonics 8 +-timestep .timestep 1.0 +-divisor_poisson .divisorPoisson 0.4 +-size_factor_min .sizeFactorMin 1.05 +-size_factor_max .sizeFactorMax 2.05 + .timestepCoarseFactor 1.0 +.EE +Before the drawing of the figure is begun, a preliminary calculation +of the path is done in order to scale the radii of the epicycles so +as to fit the figure on the screen or window. For the sake of speed, +This calculation is done with a larger timestep than the actual +drawing. The time-step used is the value of the +.B \-timestep +option multiplied by the timestepCoarseFactor resource. The default +value of 1 will almost always work fast enough and so this resource +is not available as a command-line option. +.SH USER INTERFACE +The program runs mostly without user interaction. When running on the +root window, no input is accepted. When running in its own window, +the program will exit if mouse button 3 is pressed. If any other +mouse button is pressed, the current figure will be abandoned and +another will be started. +.SH HISTORY +The geometry of epicycles was perfected by Hipparchus of Rhodes at +some time around 125 B.C., 185 years after the birth of Aristarchus of +Samos, the inventor of the heliocentric universe model. Hipparchus +applied epicycles to the Sun and the Moon. Ptolemy of Alexandria went +on to apply them to what was then the known universe, at around 150 +A.D. Copernicus went on to apply them to the heliocentric model at +the beginning of the sixteenth century. Johannes Kepler discovered +that the planets actually move in elliptical orbits in about 1602. +The inverse-square law of gravity was suggested by Boulliau in 1645. +Isaac Newton's +.I Principia Mathematica +was published in 1687, and proved that Kepler's laws derived from +Newtonian gravitation. +.SH BUGS +The colour selection is re-done for every figure. This may +generate too much network traffic for this program to work well +over slow or long links. +.SH COPYRIGHT +Copyright \(co 1998, James Youngman. Permission to use, copy, modify, +distribute, and sell this software and its documentation for any purpose 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 representations are made about the +suitability of this software for any purpose. It is provided "as is" without +express or implied warranty. +.SH AUTHOR +James Youngman , April 1998. diff --git a/local/man/man.1/flag.1 b/local/man/man.1/flag.1 new file mode 100644 index 00000000..1c7d93bf --- /dev/null +++ b/local/man/man.1/flag.1 @@ -0,0 +1,88 @@ +.TH XScreenSaver 1 "24-May-97" "X Version 11" +.SH NAME +flag - draws a waving flag, containing text or an image +.SH SYNOPSIS +.B flag +[\-display \fIhost:display.screen\fP] [\-foreground \fIcolor\fP] [\-background \fIcolor\fP] [\-window] [\-root] [\-mono] [\-install] [\-visual \fIvisual\fP] [\-ncolors \fIinteger\fP] [\-delay \fImicroseconds\fP] [\-cycles \fIinteger\fP] [\-size \fIinteger\fP] [\-text \fIstring\fP] [\-font \fIfont\fP] [\-bitmap \fIxbm-file\fP] + +.SH DESCRIPTION +The \fIflag\fP program draws a waving flag that contains text or a bitmap. +.SH OPTIONS +.I flag +accepts the following options: +.TP 8 +.B \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-mono +If on a color display, pretend we're on a monochrome display. +.TP 8 +.B \-install +Install a private colormap for the window. +.TP 8 +.B \-visual \fIvisual\fP +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. +.TP 8 +.B \-ncolors \fIinteger\fP +How many colors should be used (if possible). Default 200. +.TP 8 +.B \-cycles \fIinteger\fP + +.TP 8 +.B \-count \fIinteger\fP + +.TP 8 +.B \-size \fIinteger\fP +How large the pixels in the flag should be, from 1 to 8. +If this is a negative number, the pixel size is chosen randomly +from the range 1 to -size. Default -7. +.TP 8 +.B \-text \fItext\fP +The text to display in the flag. Multiple lines of text are allowed; +the lines will be displayed centered atop one another. Default: none. +If the text is the magic string \fI"(default)"\fP, then the text used +will be the local machine name; a newline; and the local OS version. +.TP 8 +.B \-bitmap \fIxbm-file\fP +The bitmap to display in the flag; this must be an XBM file (color XPMs +are not allowed.) Default: none. If the bitmap is the magic +string \fI"(default)"\fP, then the bitmap used will be a charming +little picture of J. R. "Bob" Dobbs. + +If neither \fI\-text\fP nor \fI\-bitmap\fP are specified, then either +the builtin text or the builtin bitmap will be chosen randomly. +.TP 8 +.B \-font \fIfont\fP +The font in which to draw the text; the default is +"-*-helvetica-bold-r-*-240-*". +.SH ENVIRONMENT +.PP +.TP 8 +.B DISPLAY +to get the default host and display number. +.TP 8 +.B XENVIRONMENT +to get the name of a resource file that overrides the global resources +stored in the RESOURCE_MANAGER property. +.SH SEE ALSO +.BR X (1), +.BR xscreensaver (1), +.BR xlock (1) +.SH COPYRIGHT +Copyright \(co 1996 Charles Vidal. + +Permission to use, copy, modify, and distribute this software and its +documentation for any purpose and without fee is hereby granted, +provided that the above copyright notice appear in all copies and that +both that copyright notice and this permission notice appear in +supporting documentation. + +.SH AUTHOR +Charles Vidal , 1996. + +Ability to run standalone or with \fIxscreensaver\fP, and the \-text +and \-bitmap options, added by Jamie Zawinski , 24-May-97. diff --git a/local/man/man.1/flame.1 b/local/man/man.1/flame.1 new file mode 100644 index 00000000..a6469737 --- /dev/null +++ b/local/man/man.1/flame.1 @@ -0,0 +1,70 @@ +.TH XScreenSaver 1 "13-aug-92" "X Version 11" +.SH NAME +flame - draw weird cosmic fractals +.SH SYNOPSIS +.B flame +[\-display \fIhost:display.screen\fP] [\-foreground \fIcolor\fP] [\-background \fIcolor\fP] [\-window] [\-root] [\-mono] [\-install] [\-visual \fIvisual\fP] [\-colors \fIinteger\fP] [\-iterations \fIinteger\fP] [\-points \fIinteger\fP] [\-delay \fImicroseconds\fP] [\-delay2 \fImicroseconds\fP] +.SH DESCRIPTION +The \fIflame\fP program generates colorful fractal displays. +.SH OPTIONS +.I flame +accepts the following options: +.TP 8 +.B \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-mono +If on a color display, pretend we're on a monochrome display. +.TP 8 +.B \-install +Install a private colormap for the window. +.TP 8 +.B \-visual \fIvisual\fP +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. +.TP 8 +.B \-colors \fIinteger\fP +How many colors should be used (if possible). Default 64. +.TP 8 +.B \-iterations \fIinteger\fP +How many fractals to generate. Default 25. +.TP 8 +.B \-points \fIinteger\fP +How many pixels to draw for each fractal. Default 10000. +.TP 8 +.B \-delay \fImicroseconds\fP +How long we should wait between drawing each fractal. Default 50000, +or about 1/20th second. +.TP 8 +.B \-delay2 \fImicroseconds\fP +How long we should wait before clearing the screen when each run ends. +Default 2000000, or two seconds. +.SH ENVIRONMENT +.PP +.TP 8 +.B DISPLAY +to get the default host and display number. +.TP 8 +.B XENVIRONMENT +to get the name of a resource file that overrides the global resources +stored in the RESOURCE_MANAGER property. +.SH SEE ALSO +.BR X (1), +.BR xscreensaver (1), +.BR xlock (1) +.SH COPYRIGHT +Copyright \(co 1991 by Patrick J. Naughton + +Permission to use, copy, modify, and distribute this software and its +documentation for any purpose and without fee is hereby granted, +provided that the above copyright notice appear in all copies and that +both that copyright notice and this permission notice appear in +supporting documentation. +.SH AUTHOR +Scott Graves , 06-Jun-91.n + +Ability to run standalone or with \fIxscreensaver\fP added by +Jamie Zawinski , 18-Oct-93. diff --git a/local/man/man.1/forest.1 b/local/man/man.1/forest.1 new file mode 100644 index 00000000..9f2d2c69 --- /dev/null +++ b/local/man/man.1/forest.1 @@ -0,0 +1,63 @@ +.TH XScreenSaver 1 "27-May-97" "X Version 11" +.SH NAME +forest - draws a fractal forest +.SH SYNOPSIS +.B forest +[\-display \fIhost:display.screen\fP] [\-foreground \fIcolor\fP] [\-background \fIcolor\fP] [\-window] [\-root] [\-mono] [\-install] [\-visual \fIvisual\fP] [\-ncolors \fIinteger\fP] [\-delay \fImicroseconds\fP] [\-cycles \fIinteger\fP] [\-count \fIinteger\fP] + +.SH DESCRIPTION +The \fIforest\fP program draws a fractal forest. +.SH OPTIONS +.I forest +accepts the following options: +.TP 8 +.B \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-mono +If on a color display, pretend we're on a monochrome display. +.TP 8 +.B \-install +Install a private colormap for the window. +.TP 8 +.B \-visual \fIvisual\fP +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. +.TP 8 +.B \-ncolors \fIinteger\fP +How many colors should be used (if possible). Default 100. +.TP 8 +.B \-cycles \fIinteger\fP + +.TP 8 +.B \-count \fIinteger\fP + +.SH ENVIRONMENT +.PP +.TP 8 +.B DISPLAY +to get the default host and display number. +.TP 8 +.B XENVIRONMENT +to get the name of a resource file that overrides the global resources +stored in the RESOURCE_MANAGER property. +.SH SEE ALSO +.BR X (1), +.BR xscreensaver (1), +.BR xlock (1) +.SH COPYRIGHT +Copyright \(co 1995 by Pascal Pensa. + +Permission to use, copy, modify, and distribute this software and its +documentation for any purpose and without fee is hereby granted, +provided that the above copyright notice appear in all copies and that +both that copyright notice and this permission notice appear in +supporting documentation. +.SH AUTHOR +Pascal Pensa , 1995. + +Ability to run standalone or with \fIxscreensaver\fP added by +Jamie Zawinski , 27-May-97. diff --git a/local/man/man.1/galaxy.1 b/local/man/man.1/galaxy.1 new file mode 100644 index 00000000..2ef9e123 --- /dev/null +++ b/local/man/man.1/galaxy.1 @@ -0,0 +1,83 @@ +.TH XScreenSaver 1 "10-May-97" "X Version 11" +.SH NAME +galaxy - draws spinning galaxies +.SH SYNOPSIS +.B galaxy +[\-display \fIhost:display.screen\fP] [\-foreground \fIcolor\fP] [\-background \fIcolor\fP] [\-window] [\-root] [\-mono] [\-install] [\-visual \fIvisual\fP] [\-ncolors \fIinteger\fP] [\-delay \fImicroseconds\fP] [\-cycles \fIinteger\fP] [\-count \fIinteger\fP] [\-size \fIinteger\fP] [\-trail] [\-no\-trail] + +.SH DESCRIPTION +The \fIgalaxy\fP program draws spinning galaxies. +.SH OPTIONS +.I galaxy +accepts the following options: +.TP 8 +.B \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-mono +If on a color display, pretend we're on a monochrome display. +.TP 8 +.B \-install +Install a private colormap for the window. +.TP 8 +.B \-visual \fIvisual\fP +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. +.TP 8 +.B \-ncolors \fIinteger\fP +How many colors should be used (if possible). Default 64. +The colors used cycle through the hue, making N stops around +the color wheel. +.TP 8 +.B \-cycles \fIinteger\fP + +.TP 8 +.B \-count \fIinteger\fP + +.TP 8 +.B \-size \fIinteger\fP + +.TP 8 +.B \-trail +.TP 8 +.B \-no\-trail + +.SH ENVIRONMENT +.PP +.TP 8 +.B DISPLAY +to get the default host and display number. +.TP 8 +.B XENVIRONMENT +to get the name of a resource file that overrides the global resources +stored in the RESOURCE_MANAGER property. +.SH SEE ALSO +.BR X (1), +.BR xscreensaver (1), +.BR xlock (1) +.SH COPYRIGHT +Copyright \(co 1994 by Hubert Feyrer. + +Permission to use, copy, modify, and distribute this software and its +documentation for any purpose and without fee is hereby granted, +provided that the above copyright notice appear in all copies and that +both that copyright notice and this permission notice appear in +supporting documentation. +.SH AUTHOR +Original Amiga version by Uli Siegmund + for EGS in Cluster. + +Ported from Cluster/EGS to C/Intuition by Harald Backert. + +Ported to X11 and xlockmore by +Hubert Feyrer , 30-Sep-94. + +Modified by David Bagley , 23-Oct-94. + +Modified by Dave Mitchell , 7-Apr-97. + +Ability to run standalone or with \fIxscreensaver\fP added by +Jamie Zawinski , 10-May-97. diff --git a/local/man/man.1/goop.1 b/local/man/man.1/goop.1 new file mode 100644 index 00000000..adf79d87 --- /dev/null +++ b/local/man/man.1/goop.1 @@ -0,0 +1,80 @@ +.TH XScreenSaver 1 "11-Jun-97" "X Version 11" +.SH NAME +goop - squishy transparent oil and bubble screenhack +.SH SYNOPSIS +.B goop +[\-display \fIhost:display.screen\fP] [\-foreground \fIcolor\fP] [\-background \fIcolor\fP] [\-window] [\-root] [\-mono] [\-install] [\-visual \fIvisual\fP] [\-transparent] [\-non\-transparent] [\-additive] [\-subtractive] [\-xor] [\-no\-xor] +.SH DESCRIPTION +The \fIgoop\fP program draws a simulation of bubbles in layers of +overlapping multicolored translucent fluid. +.SH OPTIONS +.I goop +accepts the following options: +.TP 8 +.B \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-mono +If on a color display, pretend we're on a monochrome display. +.TP 8 +.B \-install +Install a private colormap for the window. +.TP 8 +.B \-visual \fIvisual\fP +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. +.TP 8 +.B \-count \fIinteger\fP +How many bubbles to draw per layer. Default: random. +.TP 8 +.B \-layers \fIinteger\fP +How many layers to draw. Default: random, based on screen depth. +.TP 8 +.B \-delay \fImicroseconds\fP +How much of a delay should be introduced between steps of the animation. +Default 100000, or about 1/10th second. +.TP 8 +.B \-transparent +If \fI\-layers\fP is greater than 1, then each layer will be drawn in one +color, and when they overlap, the colors will be mixed. This is the default. +.TP 8 +.B \-non\-transparent +Turns off \fI\-transparent\fP. +.TP 8 +.B \-additive +If \fI\-transparent\fP is specified, then this option means that the colors +will be mixed using an additive color model, as if the blobs were projected +light. This is the default. +.TP 8 +.B \-subtractive +If \fI\-transparent\fP is specified, then this option means that the +colors will be mixed using a subtractive color model, as if the blobs were +translucent filters. +.TP 8 +.B \-xor +Draw with xor instead of the other color tricks. +.SH ENVIRONMENT +.PP +.TP 8 +.B DISPLAY +to get the default host and display number. +.TP 8 +.B XENVIRONMENT +to get the name of a resource file that overrides the global resources +stored in the RESOURCE_MANAGER property. +.SH SEE ALSO +.BR X (1), +.BR xscreensaver (1) +.SH COPYRIGHT +Copyright \(co 1997 by Jamie Zawinski. Permission to use, copy, modify, +distribute, and sell this software and its documentation for any purpose 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 representations are made about the +suitability of this software for any purpose. It is provided "as is" without +express or implied warranty. +.SH AUTHOR +Jamie Zawinski , 11-Jun-97. diff --git a/local/man/man.1/grav.1 b/local/man/man.1/grav.1 new file mode 100644 index 00000000..7cd42cb6 --- /dev/null +++ b/local/man/man.1/grav.1 @@ -0,0 +1,74 @@ +.TH XScreenSaver 1 "10-May-97" "X Version 11" +.SH NAME +grav - draws a simple orbital simulation +.SH SYNOPSIS +.B grav +[\-display \fIhost:display.screen\fP] [\-foreground \fIcolor\fP] [\-background \fIcolor\fP] [\-window] [\-root] [\-mono] [\-install] [\-visual \fIvisual\fP] [\-ncolors \fIinteger\fP] [\-delay \fImicroseconds\fP] [\-count \fIinteger\fP] [\-decay] [\-no\-decay] [\-trail] [\-no\-trail] + +.SH DESCRIPTION +The \fIgrav\fP program draws a simple orbital simulation +.SH OPTIONS +.I grav +accepts the following options: +.TP 8 +.B \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-mono +If on a color display, pretend we're on a monochrome display. +.TP 8 +.B \-install +Install a private colormap for the window. +.TP 8 +.B \-visual \fIvisual\fP +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. +.TP 8 +.B \-ncolors \fIinteger\fP +How many colors should be used (if possible). Default 200. +The colors are chosen randomly. +.TP 8 +.B \-count \fIinteger\fP +Default 12. +.TP 8 +.B \-decay +.TP 8 +.B \-no-\decay +Whether orbits should decay. + +.TP 8 +.B \-trail +.TP 8 +.B \-no\-trail +Whether the objects should leave trails behind them (makes it look vaguely +like a cloud-chamber. + +.SH ENVIRONMENT +.PP +.TP 8 +.B DISPLAY +to get the default host and display number. +.TP 8 +.B XENVIRONMENT +to get the name of a resource file that overrides the global resources +stored in the RESOURCE_MANAGER property. +.SH SEE ALSO +.BR X (1), +.BR xscreensaver (1), +.BR xlock (1) +.SH COPYRIGHT +Copyright \(co 1993 by Greg Bowering. + +Permission to use, copy, modify, and distribute this software and its +documentation for any purpose and without fee is hereby granted, +provided that the above copyright notice appear in all copies and that +both that copyright notice and this permission notice appear in +supporting documentation. +.SH AUTHOR +Greg Bowering , 1993. + +Ability to run standalone or with \fIxscreensaver\fP added by +Jamie Zawinski , 10-May-97. diff --git a/local/man/man.1/greynetic.1 b/local/man/man.1/greynetic.1 new file mode 100644 index 00000000..0b761ccd --- /dev/null +++ b/local/man/man.1/greynetic.1 @@ -0,0 +1,52 @@ +.TH XScreenSaver 1 "13-aug-92" "X Version 11" +.SH NAME +greynetic - draw random stippled/color rectangles +.SH SYNOPSIS +.B greynetic +[\-display \fIhost:display.screen\fP] [\-foreground \fIcolor\fP] [\-background \fIcolor\fP] [\-window] [\-root] [\-mono] [\-install] [\-visual \fIvisual\fP] [\-delay \fIusecs\fP] +.SH DESCRIPTION +The \fIgreynetic\fP program draws random rectangles. +.SH OPTIONS +.I greynetic +accepts the following options: +.TP 8 +.B \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-mono +If on a color display, pretend we're on a monochrome display. +.TP 8 +.B \-install +Install a private colormap for the window. +.TP 8 +.B \-visual \fIvisual\fP +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. +.TP 8 +.B \-delay \fImicroseconds\fP +Slow it down. +.SH ENVIRONMENT +.PP +.TP 8 +.B DISPLAY +to get the default host and display number. +.TP 8 +.B XENVIRONMENT +to get the name of a resource file that overrides the global resources +stored in the RESOURCE_MANAGER property. +.SH SEE ALSO +.BR X (1), +.BR xscreensaver (1) +.SH COPYRIGHT +Copyright \(co 1992 by Jamie Zawinski. Permission to use, copy, modify, +distribute, and sell this software and its documentation for any purpose 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 representations are made about the +suitability of this software for any purpose. It is provided "as is" without +express or implied warranty. +.SH AUTHOR +Jamie Zawinski , 13-aug-92. diff --git a/local/man/man.1/halo.1 b/local/man/man.1/halo.1 new file mode 100644 index 00000000..a499357a --- /dev/null +++ b/local/man/man.1/halo.1 @@ -0,0 +1,80 @@ +.TH XScreenSaver 1 "12-Jun-97" "X Version 11" +.SH NAME +halo - draw circular patterns +.SH SYNOPSIS +.B halo +[\-display \fIhost:display.screen\fP] [\-foreground \fIcolor\fP] [\-background \fIcolor\fP] [\-window] [\-root] [\-mono] [\-install] [\-visual \fIvisual\fP] [\-count \fIint\fP] [\-delay \fIusecs\fP] [\-mode seuss | ramp | random ] [\-animate] [\-colors \fIinteger\fP] [\-cycle] [\-no\-cycle] [\-cycle\-delay \fIusecs\fP] +.SH DESCRIPTION +The \fIhalo\fP program draws cool patterns based on circles. +.SH OPTIONS +.I halo +accepts the following options: +.TP 8 +.B \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-mono +If on a color display, pretend we're on a monochrome display. +.TP 8 +.B \-install +Install a private colormap for the window. +.TP 8 +.B \-visual \fIvisual\fP +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. +.TP 8 +.B \-count \fIinteger\fP +How many circles to draw. Default 0, meaning random. +.TP 8 +.B \-mode "seuss | ramp | random" +In \fIseuss\fP mode, alternating striped curves will be drawn. + +In \fIramp\fP mode, a color ramp will be drawn. + +\fIrandom\fP means pick the mode randomly. +.TP 8 +.B \-delay \fImicroseconds\fP +How much of a delay should be introduced between steps of the animation. +Default 100000, or about 0.1 second. +.TP 8 +.B \-colors \fIinteger\fP +How many colors to use. Default 100. +.TP 8 +.B \-animate +If specified, then the centerpoints of the circles will bounce around. +Otherwise, the circles will be drawn once, erased, and a new set of +circles will be drawn. +.TP 8 +.B \-cycle +.TP 8 +.B \-no\-cycle +Whether to do colormap cycling. Default is to cycle. +.TP 8 +.B \-cycle\-delay +Number of microseconds between shifts of the colormap; default 100000, +or 1/10th second. +.SH ENVIRONMENT +.PP +.TP 8 +.B DISPLAY +to get the default host and display number. +.TP 8 +.B XENVIRONMENT +to get the name of a resource file that overrides the global resources +stored in the RESOURCE_MANAGER property. +.SH SEE ALSO +.BR X (1), +.BR xscreensaver (1) +.SH COPYRIGHT +Copyright \(co 1993 by Jamie Zawinski. Permission to use, copy, modify, +distribute, and sell this software and its documentation for any purpose 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 representations are made about the +suitability of this software for any purpose. It is provided "as is" without +express or implied warranty. +.SH AUTHOR +Jamie Zawinski , 6-jul-93. diff --git a/local/man/man.1/helix.1 b/local/man/man.1/helix.1 new file mode 100644 index 00000000..2c1c3e39 --- /dev/null +++ b/local/man/man.1/helix.1 @@ -0,0 +1,63 @@ +.TH XScreenSaver 1 "18-sep-97" "X Version 11" +.SH NAME +helix - draw helical string-art patterns +.SH SYNOPSIS +.B helix +[\-display \fIhost:display.screen\fP] [\-foreground \fIcolor\fP] [\-background \fIcolor\fP] [\-window] [\-root] [\-mono] [\-erase\-speed \fIusecs\fP] [\-erase\-mode \fIinteger\fP] [\-delay \fIseconds\fP] [\-install] [\-visual \fIvisual\fP] +.SH DESCRIPTION +The \fIhelix\fP program draws interesting patterns composed of line segments +in random colors. +.SH OPTIONS +.I helix +accepts the following options: +.TP 8 +.B \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-mono +If on a color display, pretend we're on a monochrome display. +.TP 8 +.B \-erase\-speed \fIusecs\fP +This controls the speed at which the screen will be erased. Lower numbers +erase faster. +.TP 8 +.B \-erase\-mode \fIinteger\fP +This sets the erase mode. Mode \-1 chooses a random mode each time. There +are currently 6 modes defined (0\-5). +.TP 8 +.B \-delay \fIseconds\fP +This sets the number of seconds that the helix will be on the screen. +.TP 8 +.B \-install +Install a private colormap for the window. +.TP 8 +.B \-visual \fIvisual\fP +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. +.SH ENVIRONMENT +.PP +.TP 8 +.B DISPLAY +to get the default host and display number. +.TP 8 +.B XENVIRONMENT +to get the name of a resource file that overrides the global resources +stored in the RESOURCE_MANAGER property. +.SH SEE ALSO +.BR X (1), +.BR xscreensaver (1) +.SH COPYRIGHT +Copyright \(co 1992 by Jamie Zawinski. Permission to use, copy, modify, +distribute, and sell this software and its documentation for any purpose 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 representations are made about the +suitability of this software for any purpose. It is provided "as is" without +express or implied warranty. +.SH AUTHOR +Jamie Zawinski , 13-aug-92. +Screen eraser improved by Johannes Keukelaar , + 18-sep-97. diff --git a/local/man/man.1/hopalong.1 b/local/man/man.1/hopalong.1 new file mode 100644 index 00000000..d36a360b --- /dev/null +++ b/local/man/man.1/hopalong.1 @@ -0,0 +1,78 @@ +.TH XScreenSaver 1 "10-May-97" "X Version 11" +.SH NAME +hopalong - draw real plane fractals +.SH SYNOPSIS +.B hopalong +[\-display \fIhost:display.screen\fP] [\-foreground \fIcolor\fP] [\-background \fIcolor\fP] [\-window] [\-root] [\-mono] [\-install] [\-visual \fIvisual\fP] [\-ncolors \fIinteger\fP] [\-delay \fImicroseconds\fP] [\-cycles \fIinteger\fP] [\-count \fIinteger\fP] [\-jong] [\-no\-jong] [\-jong] [\-no\-sine] + +.SH DESCRIPTION +The \fIhopalong\fP program generates real plane fractals as described in +the September 1986 issue of Scientific American. +.SH OPTIONS +.I hopalong +accepts the following options: +.TP 8 +.B \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-mono +If on a color display, pretend we're on a monochrome display. +.TP 8 +.B \-install +Install a private colormap for the window. +.TP 8 +.B \-visual \fIvisual\fP +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. +.TP 8 +.B \-ncolors \fIinteger\fP +How many colors should be used (if possible). Default 200. +The colors used cycle through the hue, making N stops around +the color wheel. +.TP 8 +.B \-cycles \fIinteger\fP +How long to run each batch. Default 2500 pixels. +.TP 8 +.B \-count \fIinteger\fP +How many pixels should be drawn before a color change. Default 1000. +.TP 8 +.B \-jong \fIinteger\fP +.TP 8 +.B \-no\-jong \fIinteger\fP +Whether to use the Jong format (default is to choose randomly.) + +.TP 8 +.B \-sine \fIinteger\fP +.TP 8 +.B \-no\-sine \fIinteger\fP +Whether to use the Sine format (default is to choose randomly.) + +.SH ENVIRONMENT +.PP +.TP 8 +.B DISPLAY +to get the default host and display number. +.TP 8 +.B XENVIRONMENT +to get the name of a resource file that overrides the global resources +stored in the RESOURCE_MANAGER property. +.SH SEE ALSO +.BR X (1), +.BR xscreensaver (1), +.BR xlock (1) +.SH COPYRIGHT +Copyright \(co 1988-91 by Patrick J. Naughton. + +Permission to use, copy, modify, and distribute this software and its +documentation for any purpose and without fee is hereby granted, +provided that the above copyright notice appear in all copies and that +both that copyright notice and this permission notice appear in +supporting documentation. +.SH AUTHOR +Patrick J. Naughton , 23-mar-88. + +Ability to run standalone or with \fIxscreensaver\fP added by +Jamie Zawinski , 13-aug-92, and again on 10-May-97. diff --git a/local/man/man.1/hypercube.1 b/local/man/man.1/hypercube.1 new file mode 100644 index 00000000..4c5f8f9d --- /dev/null +++ b/local/man/man.1/hypercube.1 @@ -0,0 +1,93 @@ +.TH XScreenSaver 1 "6-dec-92" "X Version 11" +.SH NAME +hypercube - 2d projection of a 4d object +.SH SYNOPSIS +.B hypercube +[\-display \fIhost:display.screen\fP] [\-foreground \fIcolor\fP] [\-background \fIcolor\fP] [\-color[0-7] \fIcolor\fP] [\-xy \fIfloat\fP] [\-xz \fIfloat\fP] [\-yz \fIfloat\fP] [\-xw \fIfloat\fP] [\-yw \fIfloat\fP] [\-zw \fIfloat\fP] [\-observer-z \fIint\fP] [\-delay \fIusecs\fP] [\-window] [\-root] [\-mono] [\-install] [\-visual \fIvisual\fP] +.SH DESCRIPTION +The \fIhypercube\fP program displays a wireframe projection of a hypercube +which is rotating at user-specified rates around any or all of its four axes. +.SH OPTIONS +.I hypercube +accepts the following options: +.TP 8 +.B \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-mono +If on a color display, pretend we're on a monochrome display. +.TP 8 +.B \-install +Install a private colormap for the window. +.TP 8 +.B \-visual \fIvisual\fP +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. +.TP 8 +.B \-delay \fImicroseconds\fP +How much of a delay should be introduced between steps of the animation. +Default 100000, or about 1/10th second. +.TP 8 +.B \-observer-z \fIint\fP +How far away the observer is from the center of the cube (the cube is one +unit per side.) Default 5. +.TP 8 +.B \-color0 \fIcolor\fP +.TP 8 +.B \-color1 \fIcolor\fP +.TP 8 +.B \-color2 \fIcolor\fP +.TP 8 +.B \-color3 \fIcolor\fP +.TP 8 +.B \-color4 \fIcolor\fP +.TP 8 +.B \-color5 \fIcolor\fP +.TP 8 +.B \-color6 \fIcolor\fP +.TP 8 +.B \-color7 \fIcolor\fP +The colors used to draw the line segments bordering the eight faces of +the cube. Some of the faces have only two of their border-lines drawn in +the specified color, and some have all four. +.TP 8 +.B \-xw \fIfloat\fP +.TP 8 +.B \-xy \fIfloat\fP +.TP 8 +.B \-xz \fIfloat\fP +.TP 8 +.B \-yw \fIfloat\fP +.TP 8 +.B \-yz \fIfloat\fP +.TP 8 +.B \-zw \fIfloat\fP +The amount that the cube should be rotated around the specified axis at +each frame of the animation, expressed in radians. These should be small +floating-point values (less than 0.05 works best.) Default: xy=0.01, +xz=0.005, yw=0.01. +.SH ENVIRONMENT +.PP +.TP 8 +.B DISPLAY +to get the default host and display number. +.TP 8 +.B XENVIRONMENT +to get the name of a resource file that overrides the global resources +stored in the RESOURCE_MANAGER property. +.SH SEE ALSO +.BR X (1), +.BR xscreensaver (1) +.SH COPYRIGHT +Copyright \(co 1992 by Jamie Zawinski. Permission to use, copy, modify, +distribute, and sell this software and its documentation for any purpose 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 representations are made about the +suitability of this software for any purpose. It is provided "as is" without +express or implied warranty. +.SH AUTHOR +Jamie Zawinski , 6-dec-92. diff --git a/local/man/man.1/ifs.1 b/local/man/man.1/ifs.1 new file mode 100644 index 00000000..2d04eef3 --- /dev/null +++ b/local/man/man.1/ifs.1 @@ -0,0 +1,59 @@ +.TH XScreenSaver 1 "10-May-97" "X Version 11" +.SH NAME +ifs - draws spinning, colliding iterated-function-system images +.SH SYNOPSIS +.B ifs +[\-display \fIhost:display.screen\fP] [\-foreground \fIcolor\fP] [\-background \fIcolor\fP] [\-window] [\-root] [\-mono] [\-install] [\-visual \fIvisual\fP] [\-ncolors \fIinteger\fP] [\-delay \fImicroseconds\fP] + +.SH DESCRIPTION +The \fIifs\fP program draws spinning, colliding iterated-function-system images. +.SH OPTIONS +.I ifs +accepts the following options: +.TP 8 +.B \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-mono +If on a color display, pretend we're on a monochrome display. +.TP 8 +.B \-install +Install a private colormap for the window. +.TP 8 +.B \-visual \fIvisual\fP +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. +.TP 8 +.B \-ncolors \fIinteger\fP +How many colors should be used (if possible). Default 200. +The colors used cycle through the hue, making N stops around +the color wheel. +.SH ENVIRONMENT +.PP +.TP 8 +.B DISPLAY +to get the default host and display number. +.TP 8 +.B XENVIRONMENT +to get the name of a resource file that overrides the global resources +stored in the RESOURCE_MANAGER property. +.SH SEE ALSO +.BR X (1), +.BR xscreensaver (1), +.BR xlock (1) +.SH COPYRIGHT +Copyright \(co 1997 by Massimino Pascal. + +Permission to use, copy, modify, and distribute this software and its +documentation for any purpose and without fee is hereby granted, +provided that the above copyright notice appear in all copies and that +both that copyright notice and this permission notice appear in +supporting documentation. +.SH AUTHOR +Massimino Pascal , 1997. + +Ability to run standalone or with \fIxscreensaver\fP added by +Jamie Zawinski , 10-May-97. diff --git a/local/man/man.1/imsmap.1 b/local/man/man.1/imsmap.1 new file mode 100644 index 00000000..b8f81ad2 --- /dev/null +++ b/local/man/man.1/imsmap.1 @@ -0,0 +1,66 @@ +.TH XScreenSaver 1 "17-May-97" "X Version 11" +.SH NAME +imsmap - generate fractal maps +.SH SYNOPSIS +.B imsmap +[\-display \fIhost:display.screen\fP] [\-foreground \fIcolor\fP] [\-background \fIcolor\fP] [\-window] [\-root] [\-mono] [\-install] [\-visual \fIvisual\fP] [\-ncolors \fIint\fP] [\-delay \fIseconds\fP] [\-iterations \fIint\fP] [\-mode h|s|v|random] [\-cycle] [\-no\-cycle] +.SH DESCRIPTION +The \fIimsmap\fP program generates map or cloud-like patterns. It looks +quite different in monochrome and color. +.SH OPTIONS +.I imsmap +accepts the following options: +.TP 8 +.B \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-mono +If on a color display, pretend we're on a monochrome display. +.TP 8 +.B \-install +Install a private colormap for the window. +.TP 8 +.B \-visual \fIvisual\fP +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. +.TP 8 +.B \-ncolors \fIinteger\fP +How many colors to use. Default 50. +.TP 8 +.B \-delay \fIinteger\fP +How long to delay between images. Default 10 seconds. +.TP 8 +.B \-iterations \fIinteger\fP +A measure of the resolution of the resultant image, from 0 to 7. Default 7. +.TP 8 +.B \-mode [ hue | saturation | value | random ] +The axis upon which colors should be interpolated between the foreground +and background color. Default random. +.TP 8 +.B \-cycle +.TP 8 +.B \-no\-cycle +Whether to do colormap cycling. Default is to cycle. +.TP 8 +.B \-cycle\-delay +Number of microseconds between shifts of the colormap; default 100000, +or 1/10th second. +.SH ENVIRONMENT +.PP +.TP 8 +.B DISPLAY +to get the default host and display number. +.TP 8 +.B XENVIRONMENT +to get the name of a resource file that overrides the global resources +stored in the RESOURCE_MANAGER property. +.SH SEE ALSO +.BR X (1), +.BR xscreensaver (1) +.SH AUTHOR +Juergen Nickelsen , 23-aug-92. + +Hacked on by Jamie Zawinski , 24-aug-92, 17-May-97. diff --git a/local/man/man.1/jigsaw.1 b/local/man/man.1/jigsaw.1 new file mode 100644 index 00000000..ae9f7a0e --- /dev/null +++ b/local/man/man.1/jigsaw.1 @@ -0,0 +1,74 @@ +.TH XScreenSaver 1 "25-Nov-97" "X Version 11" +.SH NAME +jigsaw - permute the screen image like a jigsaw puzzle +.SH SYNOPSIS +.B jigsaw +[\-display \fIhost:display.screen\fP] [\-background \fIcolor\fP] [\-delay \fIusecs\fP] [\-window] [\-root] [\-install] [\-visual \fIvisual\fP] +.SH DESCRIPTION +The \fIjigsaw\fP program takes an image of the screen, carves it up into +a jigsaw puzzle, shuffles it, and then solves it. +.SH OPTIONS +.I jigsaw +accepts the following options: +.TP 8 +.B \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-install +Install a private colormap for the window. +.TP 8 +.B \-visual \fIvisual\fP +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. +.TP 8 +.B \-delay \fImicroseconds\fP +How long to wait between shuffling pieces; default 700000, or 0.7 seconds. +.SH RESOURCES +On some systems (currently, only SGIs), this program can, instead of grabbing +a desktop image, grab a frame of video from an external camera and manipulate +that instead. The following resources control that. +.PP +.TP 8 +.B grabVideoProbability \fR(Float)\fP +What portion of the time to grab video rather than a screen image, +between 0.0 and 1.0. Defaults to 0.5, or half the time. +.TP 8 +.B videoDevice \fR(Integer)\fP +The number of the default video input device to check first. If unspecified, +the default camera (from videopanel(1)) will be checked first. After that, all +other available video input devices will be checked in order. + +The first one which produces a non-black image will be used. If all images +are black, the others will be re-checked a few times before giving up and +falling back to simply grabbing a desktop image (but note that this takes a +few seconds, so if you don't actually have any video sources hooked up, you +should consider turning off video grabbing by setting +\fBgrabVideoProbability\fP to 0.0.) +.TP 8 +.B videoGain \fR(Float)\fP +The amount by which to brighten the grabbed image. This defaults to 2.2. +.SH ENVIRONMENT +.PP +.TP 8 +.B DISPLAY +to get the default host and display number. +.TP 8 +.B XENVIRONMENT +to get the name of a resource file that overrides the global resources +stored in the RESOURCE_MANAGER property. +.SH SEE ALSO +.BR X (1), +.BR xscreensaver (1) +.SH COPYRIGHT +Copyright \(co 1997 by Jamie Zawinski. Permission to use, copy, modify, +distribute, and sell this software and its documentation for any purpose 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 representations are made about the +suitability of this software for any purpose. It is provided "as is" without +express or implied warranty. +.SH AUTHOR +Jamie Zawinski , 25-Nov-97. diff --git a/local/man/man.1/kaleidescope.1 b/local/man/man.1/kaleidescope.1 new file mode 100644 index 00000000..6eca5e33 --- /dev/null +++ b/local/man/man.1/kaleidescope.1 @@ -0,0 +1,85 @@ +.de EX \"Begin example +.ne 5 +.if n .sp 1 +.if t .sp .5 +.nf +.in +.5i +.. +.de EE +.fi +.in -.5i +.if n .sp 1 +.if t .sp .5 +.. +.TH Kaleidescpe 1 "14-Dec-95" "X Version 11" +.SH NAME +Kaleidescope - rotating line segments +.SH SYNOPSIS +.B kaleidescope +[\-display \fIhost:display.screen\fP] [\-foreground \fIcolor\fP] [\-background \fIcolor\fP] [\-window] [\-root] [\-install] [\-visual \fIvisual\fP] [\-color_mode \fImono | nice | greedy\fP] [-nsegments \fIint\fP] [\-ntrails \fIint\fP] [\-local_rotation \fIint\fP] [\-global_rotation \fIint\fP] [\-delay \fIusecs\fP] [\-redmin \fIint\fP] [\-greenmin \fIint\fP] [\-bluemin \fIint\fP] [\-redrange \fIint\fP] [\-greenrange \fIint\fP] [\-bluerange \fIint\fP] +.SH DESCRIPTION +The \fIkaleidescope\fP program draws line segments in a symmetric pattern +that evolves over time. +.SH OPTIONS +.I kaleidescope +accepts the following options: +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-color_mode "mono | nice | greedy" +Specify how kaleidescope uses colors. Mono uses +just the default foreground and background colors. Nice uses one +color for each segment (specified by nsegments). Greedy uses (ntrails * nsegments) + 1 colors. +.TP 8 +.B \-install +Install a private colormap for the window. +.TP 8 +.B \-visual \fIvisual\fP +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. +.TP 8 +.B \-nsegments integer +The number of segments to draw. Default is 7. +.TP 8 +.B \-ntrails integer +The number of trails to draw. Default is 100. +.TP 8 +.B \-local_rotation integer +The rate at which segments rotate around their center. Default is -59. +.TP 8 +.B \-global_rotation integer +The rate at which segments rotate around the center of the window. +Default is 1. +.TP 8 +.B \-redmin, \-greenmin, \-bluemin, \-redrange, \-greenrange, \-bluerange +All take an integer argument. When colors are randomly chosen, they +are chosen from the interval min to min plus range. The minimums default +to 30000. The ranges default to 20000. +.TP 8 +.B \-delay microseconds +How much of a delay should be introduced between steps of the animation. +Default is 20000, or about 5 frames a second. +.SH ENVIRONMENT +.PP +.TP 8 +.B DISPLAY +to get the default host and display number. +.TP 8 +.B XENVIRONMENT +to get the name of a resource file that overrides the global resources +stored in the RESOURCE_MANAGER property. +.SH SEE ALSO +.BR X (1), +.BR kaleidescope (1) +.SH COPYRIGHT +Copyright \(co 1997 by Ron Tapia. Permission to use, copy, modify, +distribute, and sell this software and its documentation for any purpose 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 representations are made about the +suitability of this software for any purpose. It is provided "as is" without +express or implied warranty. +.SH AUTHOR +Ron Tapia , 20-Mar-97. + diff --git a/local/man/man.1/lament.1 b/local/man/man.1/lament.1 new file mode 100644 index 00000000..52cb6b48 --- /dev/null +++ b/local/man/man.1/lament.1 @@ -0,0 +1,60 @@ +.TH XScreenSaver 1 "25-Jul-98" "X Version 11" +.SH NAME +lament - animates the Lament Configuration +.SH SYNOPSIS +.B lament +[\-display \fIhost:display.screen\fP] [\-window] [\-root] [\-install] [\-visual \fIvisual\fP] [\-texture] [\-no\-texture] [\-wireframe] +.SH DESCRIPTION +The \fIlament\fP program draws an animation of a particular puzzle box +repeatedly solving itself. +.SH OPTIONS +.I lament +accepts the following options: +.TP 8 +.B \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-install +Install a private colormap for the window. +.TP 8 +.B \-visual \fIvisual\fP\fP +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. +.TP 8 +.B \-texture +Use texture maps. This is the default. +.TP 8 +.B \-no\-texture +Do not use texture maps. This is boring and wrong. +.TP 8 +.B \-wireframe +Only draw outlines. +.SH ENVIRONMENT +.PP +.TP 8 +.B DISPLAY +to get the default host and display number. +.TP 8 +.B XENVIRONMENT +to get the name of a resource file that overrides the global resources +stored in the RESOURCE_MANAGER property. +.SH BUGS +This hack is glacially slow on machines lacking hardware texture support. + +Occasionally opens doors, admitting theologians of the Order of the Gash. +.SH SEE ALSO +.BR X (1), +.BR xscreensaver (1) +.SH COPYRIGHT +Copyright \(co 1998 by Jamie Zawinski. Permission to use, copy, modify, +distribute, and sell this software and its documentation for any purpose 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 representations are made about the +suitability of this software for any purpose. It is provided "as is" without +express or implied warranty. +.SH AUTHOR +Jamie Zawinski , 25-Jul-98. diff --git a/local/man/man.1/laser.1 b/local/man/man.1/laser.1 new file mode 100644 index 00000000..70cec4e6 --- /dev/null +++ b/local/man/man.1/laser.1 @@ -0,0 +1,64 @@ +.TH XScreenSaver 1 "10-May-97" "X Version 11" +.SH NAME +laser - draws vaguely laser-like moving lines +.SH SYNOPSIS +.B laser +[\-display \fIhost:display.screen\fP] [\-foreground \fIcolor\fP] [\-background \fIcolor\fP] [\-window] [\-root] [\-mono] [\-install] [\-visual \fIvisual\fP] [\-ncolors \fIinteger\fP] [\-delay \fImicroseconds\fP] [\-cycles \fIinteger\fP] [\-count \fIinteger\fP] + +.SH DESCRIPTION +The \fIlaser\fP program draws vaguely laser-like moving lines +.SH OPTIONS +.I laser +accepts the following options: +.TP 8 +.B \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-mono +If on a color display, pretend we're on a monochrome display. +.TP 8 +.B \-install +Install a private colormap for the window. +.TP 8 +.B \-visual \fIvisual\fP +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. +.TP 8 +.B \-ncolors \fIinteger\fP +How many colors should be used (if possible). Default 64. +The colors used cycle through the hue, making N stops around the color wheel. +.TP 8 +.B \-cycles \fIinteger\fP +Default 200. +.TP 8 +.B \-count \fIinteger\fP +Default 10. +.SH ENVIRONMENT +.PP +.TP 8 +.B DISPLAY +to get the default host and display number. +.TP 8 +.B XENVIRONMENT +to get the name of a resource file that overrides the global resources +stored in the RESOURCE_MANAGER property. +.SH SEE ALSO +.BR X (1), +.BR xscreensaver (1), +.BR xlock (1) +.SH COPYRIGHT +Copyright \(co 1995 by Pascal Pensa. + +Permission to use, copy, modify, and distribute this software and its +documentation for any purpose and without fee is hereby granted, +provided that the above copyright notice appear in all copies and that +both that copyright notice and this permission notice appear in +supporting documentation. +.SH AUTHOR +Pascal Pensa , 1995. + +Ability to run standalone or with \fIxscreensaver\fP added by +Jamie Zawinski , 10-May-97. diff --git a/local/man/man.1/lightning.1 b/local/man/man.1/lightning.1 new file mode 100644 index 00000000..786ee99c --- /dev/null +++ b/local/man/man.1/lightning.1 @@ -0,0 +1,58 @@ +.TH XScreenSaver 1 "10-May-97" "X Version 11" +.SH NAME +lightning - draws fractal lightning bolts +.SH SYNOPSIS +.B lightning +[\-display \fIhost:display.screen\fP] [\-foreground \fIcolor\fP] [\-background \fIcolor\fP] [\-window] [\-root] [\-mono] [\-install] [\-visual \fIvisual\fP] [\-ncolors \fIinteger\fP] [\-delay \fImicroseconds\fP] + +.SH DESCRIPTION +The \fIlightning\fP program draws fractal lightning bolts +.SH OPTIONS +.I lightning +accepts the following options: +.TP 8 +.B \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-mono +If on a color display, pretend we're on a monochrome display. +.TP 8 +.B \-install +Install a private colormap for the window. +.TP 8 +.B \-visual \fIvisual\fP +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. +.TP 8 +.B \-ncolors \fIinteger\fP +How many colors should be used (if possible). Default 64. +The colors are chosen randomly. +.SH ENVIRONMENT +.PP +.TP 8 +.B DISPLAY +to get the default host and display number. +.TP 8 +.B XENVIRONMENT +to get the name of a resource file that overrides the global resources +stored in the RESOURCE_MANAGER property. +.SH SEE ALSO +.BR X (1), +.BR xscreensaver (1), +.BR xlock (1) +.SH COPYRIGHT +Copyright \(co 1996 by Keith Romberg. + +Permission to use, copy, modify, and distribute this software and its +documentation for any purpose and without fee is hereby granted, +provided that the above copyright notice appear in all copies and that +both that copyright notice and this permission notice appear in +supporting documentation. +.SH AUTHOR +Keith Romberg , 27-Jun-96. + +Ability to run standalone or with \fIxscreensaver\fP added by +Jamie Zawinski , 10-May-97. diff --git a/local/man/man.1/lisa.1 b/local/man/man.1/lisa.1 new file mode 100644 index 00000000..64cc06f1 --- /dev/null +++ b/local/man/man.1/lisa.1 @@ -0,0 +1,67 @@ +.TH XScreenSaver 1 "27-May-97" "X Version 11" +.SH NAME +lisa - draws animated full-loop lisajous figures +.SH SYNOPSIS +.B lisa +[\-display \fIhost:display.screen\fP] [\-foreground \fIcolor\fP] [\-background \fIcolor\fP] [\-window] [\-root] [\-mono] [\-install] [\-visual \fIvisual\fP] [\-ncolors \fIinteger\fP] [\-delay \fImicroseconds\fP] [\-cycles \fIinteger\fP] [\-count \fIinteger\fP] [\-size \fIinteger\fP] + +.SH DESCRIPTION +The \fIlisa\fP program draws animated full-loop lisajous figures. +.SH OPTIONS +.I lisa +accepts the following options: +.TP 8 +.B \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-mono +If on a color display, pretend we're on a monochrome display. +.TP 8 +.B \-install +Install a private colormap for the window. +.TP 8 +.B \-visual \fIvisual\fP +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. +.TP 8 +.B \-ncolors \fIinteger\fP +How many colors should be used (if possible). Default 200. +The colors are chosen randomly. +.TP 8 +.B \-cycles \fIinteger\fP + +.TP 8 +.B \-count \fIinteger\fP + +.TP 8 +.B \-size \fIinteger\fP + +.SH ENVIRONMENT +.PP +.TP 8 +.B DISPLAY +to get the default host and display number. +.TP 8 +.B XENVIRONMENT +to get the name of a resource file that overrides the global resources +stored in the RESOURCE_MANAGER property. +.SH SEE ALSO +.BR X (1), +.BR xscreensaver (1), +.BR xlock (1) +.SH COPYRIGHT +Copyright \(co 1997 by Caleb Cullen. + +Permission to use, copy, modify, and distribute this software and its +documentation for any purpose and without fee is hereby granted, +provided that the above copyright notice appear in all copies and that +both that copyright notice and this permission notice appear in +supporting documentation. +.SH AUTHOR +Caleb Cullen, 1997. + +Ability to run standalone or with \fIxscreensaver\fP added by +Jamie Zawinski , 27-May-97. diff --git a/local/man/man.1/lmorph.1 b/local/man/man.1/lmorph.1 new file mode 100644 index 00000000..50cf8d21 --- /dev/null +++ b/local/man/man.1/lmorph.1 @@ -0,0 +1,58 @@ +.TH LMORPH 1 "xscreensaver hack" +.SH NAME +lmorph \- morphing lines +.SH SYNOPSIS +.B lmorph +[\-display \fIhost:display.screen\fP] [\-foreground \fIcolor\fP] [\-background \fIcolor\fP] [\-window] [\-root] [\-mono] [\-install] [\-visual \fIvisual\fP] [\-points \fIint\fP] [\-steps \fIint\fP] [\-delay \fIusecs\fP] [\-figtype \fItype\fP] +.SH DESCRIPTION +The \fIlmorph\fP program morphs between simple linedrawings using bilinear +interpolation. +.SH OPTIONS +.I lmorph +accepts the following options: +.TP 8 +.B \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-mono +If on a color display, pretend we're on a monochrome display. +.TP 8 +.B \-install +Install a private colormap for the window. +.TP 8 +.B \-visual \fIvisual\fP +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. +.TP 8 +.B \-points \fIinteger\fP +Number of points in each line drawing. Default is 150 points. +.TP 8 +.B \-steps \fIinteger\fP +Interpolation steps from one drawing to the next. Default is 0, which +means a random number between 100 and 500. +.TP 8 +.B \-delay \fImicroseconds\fP +How much of a delay should be introduced between steps of the animation. +Default 50000. +.TP 8 +.B \-figtype \fItype\fP +Limit the figures to only open or closed figures. Possible types are +"all" (default), "open" and "closed". +.SH ENVIRONMENT +.PP +.TP 8 +.B DISPLAY +to get the default host and display number. +.TP 8 +.B XENVIRONMENT +to get the name of a resource file that overrides the global resources +stored in the RESOURCE_MANAGER property. +.SH SEE ALSO +.BR X (1), +.BR xscreensaver (1) +.SH AUTHOR +Sverre H. Huseby and Glenn T. Lines , +built on top of the screen saver routines by Jamie Zawinski . diff --git a/local/man/man.1/maze.1 b/local/man/man.1/maze.1 new file mode 100644 index 00000000..f4826505 --- /dev/null +++ b/local/man/man.1/maze.1 @@ -0,0 +1,146 @@ +.TH XScreenSaver 1 "7-mar-93" "X Version 11" +.SH NAME +maze \- an automated X11 demo repeatedly creating and solving a random maze +.SH SYNOPSIS +.B maze +[\-display \fIhost:display.screen\fP] [\-foreground \fIcolor\fP] [\-background \fIcolor\fP] [\-window] [\-root] [\-install] [\-visual \fIvisual\fP] [\-grid\-size \fIpixels\fP] [\-live\-color \fIcolor\fP] [\-dead\-color \fIcolor\fP] [\-solve\-delay \fIusecs\fP] [\-pre\-delay \fIusecs\fP] [\-post\-delay \fIusecs\fP] [\-generator \fIinteger\fP] [\-max\-length \fIinteger\fP] [\-bridge] [\-no\-bridge] +.SH DESCRIPTION +The \fImaze\fP program creates a "random" maze and then solves it with +graphical feedback. +.SH OPTIONS +.I maze +accepts the following options: +.TP 8 +.B \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-install +Install a private colormap for the window. +.TP 8 +.B \-visual \fIvisual\fP +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. +.TP 8 +.B \-grid\-size \fIpixels\fP +The size of each block of the maze, in pixels; default is 0, meaning +pick a random grid size. +.TP 8 +.B \-live\-color \fIcolor\fP +The color of the path. +.TP 8 +.B \-dead\-color \fIcolor\fP +The color of the failed path (it is also stippled with a 50% pattern.) +.TP 8 +.B \-skip\-color \fIcolor\fP +The maze solver will choose to not go down a path if it can "see" (in a +straight line) that it is a dead end. This is the color to use for paths +that are skipped for this reason. +.TP 8 +.B \-surround\-color \fIcolor\fP +If the maze solver ever completely encloses an area within the maze, then +it knows that the exit is not in there (and in fact the interior of that +area might not even be reachable.) It will mark out those cells using this +color. +.TP 8 +.B \-solve\-delay \fIinteger\fP +Delay (in microseconds) between each step of the solution path. +Default 5000, or about 1/200th second. +.TP 8 +.B \-pre\-delay \fIinteger\fP +Delay (in microseconds) between generating a maze and starting to solve it. +Default 2000000 (2 seconds.) +.TP 8 +.B \-post\-delay \fIinteger\fP +Delay (in microseconds) after solving a maze and before generating a new one. +Default 4000000 (4 seconds.) +.TP 8 +.B \-generator \fInum\fP +Sets the algorithm that will be used to generate the mazes. The +default is \-1, which randomly selects an algorithm for each maze that +is generated. Generator 0 is the original one, and works by walking +around randomly until we hit a place we've been before, then +backtracking and trying a new direction somewhere. Generator 1 picks a +random spot in the maze, then draws a straight wall from that spot in +a random direction until it hits another wall (and continues until the +maze is complete). Generator 2 is based on sets. Initially all cells +are in different sets. Then two neighboring cells are chosen and if +they are in different sets, their sets are joined. If they were in the +same set, a wall is built between them. This continues until the maze is +complete. + +All generators generate mazes with a certain 'characteristic'. See if you +can spot them! +.TP 8 +.B \-max\-length \fInum\fP +Controls the maximum length of walls drawn in one go by generator 1. +.TP 8 +.B \-bridge +.TP 8 +.B \-no\-bridge +Controls whether or not a 'bridge' will appear over the logo. +.PP +Clicking the mouse in the maze window controls it. +.TP 16 +.B "LeftButton +Clears the window and restarts maze. +.TP 16 +.B MiddleButton +Pause or unpause the program. +.TP 16 +.B RightButton +Exit. +.SH BUGS +Expose events force a restart of maze. + +Mouse actions are based on "raw" values (Button1, Button2 and Button3) +instead of using the pointer map. +.SH ENVIRONMENT +.PP +.TP 8 +.B DISPLAY +to get the default host and display number. +.TP 8 +.B XENVIRONMENT +to get the name of a resource file that overrides the global resources +stored in the RESOURCE_MANAGER property. +.SH SEE ALSO +.BR X (1), +.BR xscreensaver (1) +.SH COPYRIGHT +.PP +Copyright \(co 1988 by Sun Microsystems, Inc. Mountain View, CA. +.PP +All Rights Reserved +.PP +Permission to use, copy, modify, and distribute this software and its +documentation for any purpose and without fee is hereby granted, provided that +the above copyright notice appear in all copies and that both that copyright +notice and this permission notice appear in supporting documentation, and that +the names of Sun or MIT not be used in advertising or publicity pertaining to +distribution of the software without specific prior written permission. Sun +and M.I.T. make no representations about the suitability of this software for +any purpose. It is provided "as is" without any express or implied warranty. +.PP +SUN DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING ALL +IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. IN +NO EVENT SHALL SUN BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL +DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, +WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING +OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. +.SH AUTHOR(s) +.nf +Zack Weinberg [ Smarter maze-solver ] zack@rabi.phys.columbia.edu +Johannes Keukelaar [ Generators 1 and 2 ] johannes@nada.kth.se + Royal Institute of Technology, Stockholm, Sweden +Jim Randell [ XScreenSaver version ] jmr@mddjmr.fc.hp.com + HPLabs, Bristol +Richard Hess [ X11 extensions ] {...}!uunet!cimshop!rhess + Consilium, Mountain View, CA +Dave Lemke [ X11 version ] lemke@sun.COM + Sun MicroSystems, Mountain View, CA +Martin Weiss [ SunView version ] + Sun MicroSystems, Mountain View, CA +.fi diff --git a/local/man/man.1/moire.1 b/local/man/man.1/moire.1 new file mode 100644 index 00000000..c810265d --- /dev/null +++ b/local/man/man.1/moire.1 @@ -0,0 +1,64 @@ +.TH XScreenSaver 1 "27-Apr-97" "X Version 11" +.SH NAME +halo - draw circular interference patterns +.SH SYNOPSIS +.B halo +[\-display \fIhost:display.screen\fP] [\-foreground \fIcolor\fP] [\-background \fIcolor\fP] [\-window] [\-root] [\-mono] [\-install] [\-visual \fIvisual\fP] [\-delay \fIseconds\fP] [\-random \fIboolean\fP] [\-ncolors \fIint\fP] [\-offset \fIint\fP] +.SH DESCRIPTION +The \fImoire\fP program draws cool circular interference patterns. +.SH OPTIONS +.I moire +accepts the following options: +.TP 8 +.B \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-mono +If on a color display, pretend we're on a monochrome display. +.TP 8 +.B \-install +Install a private colormap for the window. +.TP 8 +.B \-visual \fIvisual\fP +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. +.TP 8 +.B \-delay \fIseconds\fP +How long to wait before starting over. Default 5 seconds. +.TP 8 +.B \-random \fIboolean\fP +Whether to ignore the foreground/background colors, and pick them randomly +instead. +.TP 8 +.B \-offset \fIinteger\fP +The maximum random radius increment to use. +.TP 8 +.B \-ncolors \fIinteger\fP +How many colors should be allocated in the color ramp (note that this +value interacts with \fIoffset\fP.) +.SH ENVIRONMENT +.PP +.TP 8 +.B DISPLAY +to get the default host and display number. +.TP 8 +.B XENVIRONMENT +to get the name of a resource file that overrides the global resources +stored in the RESOURCE_MANAGER property. +.SH SEE ALSO +.BR X (1), +.BR xscreensaver (1) +.SH COPYRIGHT +Copyright \(co 1997 by Jamie Zawinski. Permission to use, copy, modify, +distribute, and sell this software and its documentation for any purpose 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 representations are made about the +suitability of this software for any purpose. It is provided "as is" without +express or implied warranty. +.SH AUTHOR +Jamie Zawinski , 27-Apr-97, based on code by +Michael D. Bayne . diff --git a/local/man/man.1/munch.1 b/local/man/man.1/munch.1 new file mode 100644 index 00000000..97b1b797 --- /dev/null +++ b/local/man/man.1/munch.1 @@ -0,0 +1,133 @@ +.de EX \"Begin example +.ne 5 +.if n .sp 1 +.if t .sp .5 +.nf +.in +.5i +.. +.de EE +.fi +.in -.5i +.if n .sp 1 +.if t .sp .5 +.. +.TH XScreenSaver 1 "17-Jun-97" "X Version 11" +.SH NAME +munch - munching squares screen hack +.SH SYNOPSIS +.B munch +[\-display \fIhost:display.screen\fP] [\-foreground \fIcolor\fP] +[\-background \fIcolor\fP] [\-window] [\-root] [\-mono] [\-install] +[\-visual \fIvisual\fP] [\-delay \fIseconds\fP] [\-xor] [\-noxor] [\-shift] +[\-noshift] [\-logminwidth \fIminimum width\fP] +.SH DESCRIPTION +The +.I munch +program preforms the munching squares hack until killed. It picks square +size, position, and gravity randomly; configurable options are listed +below. +.PP +The munching squares hack cosists of drawing Y = X XOR T for a range of X +and T over and over until all the possible combinations of X and T have +come up. It was reportedly discovered by Jackson Wright in 1962 and took 5 +instructions of PDP-6 code. +.SH OPTIONS +.I munch +accepts the following options: +.TP 8 +.B \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-mono +If on a color display, pretend we're on a monochrome display. +.TP 8 +.B \-install +Install a private colormap for the window. +.TP 8 +.B \-visual \fIvisual\fP +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. +.TP 8 +.B \-delay \fIseconds\fP +How long to wait before starting over. Default 5 seconds. +.TP 8 +.B \-xor +Use the XOR drawing function. (Default.) +.TP 8 +.B \-no\-xor +Don't use the XOR drawing function. +.TP 8 +.B \-shift +Start drawing the square at weird starting points. (Default.) +.TP 8 +.B \-no\-shift +Don't shift and start drawing the square at weird starting points. +.TP 8 +.B \-logminwidth \fIminimum\-width\fP +The logarithm (base 2) of the minimum with of a square (must be a power of +2, or some parts of the square aren't.) +.SH ENVIRONMENT +.PP +.TP 8 +.B DISPLAY +to get the default host and display number. +.TP 8 +.B XENVIRONMENT +to get the name of a resource file that overrides the global resources +stored in the RESOURCE_MANAGER property. +.SH SEE ALSO +.BR X (1), +.BR xscreensaver (1), +.BR http://www.inwap.com/pdp10/hbaker/hakmem/hakmem.html, +.BR http://www.comedia.com/Hot/jargon_3.0/JARGON_M/MUNCHSQR.HTML +.SH HISTORY +Quoted from HAKMEM, for historical interest. As that document says, "Unless +otherwise stated, all computer programs are in PDP-6/10 assembly language." +.TP 8 +ITEM 146: MUNCHING SQUARES +Another simple display program. It is thought that this was discovered by +Jackson Wright on the RLE PDP-1 circa 1962. + +.EX + DATAI 2 + ADDB 1,2 + ROTC 2,-22 + XOR 1,2 + JRST .-4 +.EE +.RS 8 +2=X, 3=Y. Try things like 1001002 in data switches. This also does +interesting things with operations other than XOR, and rotations other +than -22. (Try IOR; AND; TSC; FADR; FDV(!); ROT -14, -9, -20, ...) +.RE +.TP 8 +ITEM 147 (Schroeppel): +Munching squares is just views of the graph Y = X XOR T for consecutive +values of T = time. +.TP 8 +ITEM 148 (Cohen, Beeler): +A modification to munching squares which reveals them in frozen states +through opening and closing curtains: insert FADR 2,1 before the XOR. Try +data switches = + +.EX + 4000,,4 1000,,2002 2000,,4 0,,1002 +.EE +.RS 8 +(Notation: ,,) + +Also try the FADR after the XOR, switches = 1001,,1. +.SH COPYRIGHT +Copyright \(co 1997 by Tim Showalter. Permission to use, copy, modify, +distribute, and sell this software and its documentation for any purpose 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 representations are made about the +suitability of this software for any purpose. It is provided "as is" without +express or implied warranty. +.SH AUTHOR +Tim Showalter , 17-Jun-97, based on what's in the +Jargon File and stealing stuff from existing xscreensaver modules. diff --git a/local/man/man.1/noseguy.1 b/local/man/man.1/noseguy.1 new file mode 100644 index 00000000..f23746b5 --- /dev/null +++ b/local/man/man.1/noseguy.1 @@ -0,0 +1,74 @@ +.TH XScreenSaver 1 "13-aug-92" "X Version 11" +.SH NAME +noseguy - a little guy with a big nose wanders around being witty +.SH SYNOPSIS +.B noseguy +[\-display \fIhost:display.screen\fP] [\-foreground \fIcolor\fP] [\-background \fIcolor\fP] [\-text-foreground \fIcolor\fP] [\-text-background \fIcolor\fP] [\-font \fIfont\fP] [\-window] [\-root] [\-install] [\-visual \fIvisual\fP] [\-mode \fImode\fP] [\-program \fIprogram\fP] [\-filename \file\fP] [\-text \fItext\fP] +.SH DESCRIPTION +A little man with a big nose and a hat runs around spewing out messages to +the screen. This code (and its bitmaps) were extracted from the \fIxnlock\fP +program. +.SH OPTIONS +.I noseguy +accepts the following options: +.TP 8 +.B \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-install +Install a private colormap for the window. +.TP 8 +.B \-visual \fIvisual\fP +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. +.TP 8 +.B \-font \fIfont\fP +The font used for the messages. +.TP 8 +.B \-mode [ program | file | string ] +In \fIprogram\fP mode, the messages are gotten by running a program. +The program used is controlled by the \fI\-program\fP option, and +the \fI.program\fP resource. + +In \fIfilename\fP mode, the message used is the contents of a file. +The file used is controlled by the \fI\-file\fP option, and +the \fI.filename\fP resource. + +In \fIstring\fP mode, the message is whatever was specified on the +command line as the \fI\-text\fP option, or in the resource database +as the \fI.text\fP resource. +.TP 8 +.B \-program \fIprogram\fP +If \fImode\fP is \fIprogram\fP (the default), then this program will be +run periodically, and its output will be the text of the messages. The +default program is \fI"fortune -s"\fP, but \fIyow\fP is also a good choice. +.TP 8 +.B \-filename \fIfile\fP +If \fImode\fP is \fIfile\fP, then the contents of this file will be used +for all messages. +.TP 8 +.B \-text \fIstring\fP +If \fImode\fP is \fIstring\fP, then this text will be used for all messages. +.SH ENVIRONMENT +.PP +.TP 8 +.B DISPLAY +to get the default host and display number. +.TP 8 +.B XENVIRONMENT +to get the name of a resource file that overrides the global resources +stored in the RESOURCE_MANAGER property. +.SH SEE ALSO +.BR X (1), +.BR xscreensaver (1), +.BR xnlock (1) +.SH COPYRIGHT +Copyright 1985, 1990 by Dan Heller . +.SH AUTHOR +Dan Heller , 1985. + +Ability to run standalone or with \fIxscreensaver\fP added by +Jamie Zawinski , 13-aug-92. diff --git a/local/man/man.1/pedal.1 b/local/man/man.1/pedal.1 new file mode 100644 index 00000000..7a0c3e5b --- /dev/null +++ b/local/man/man.1/pedal.1 @@ -0,0 +1,62 @@ +.TH XScreenSaver 1 "24-Jun-94" "X Version 11" +.SH NAME +pedal - pretty geometric picture program +.SH SYNOPSIS +.B pedal +[\-display \fIhost:display.screen\fP] [\-foreground \fIcolor\fP] [\-background \fIcolor\fP] [\-window] [\-root] [\-delay \fIseconds\fP] [-maxlines \fInumber\fP] [-fadedelay \fIuseconds\fP] [-mono] [\-install] [\-visual \fIvisual\fP] +.SH DESCRIPTION +The \fIpedal\fP program displays pretty geometric pictures. +.SH OPTIONS +.I pedal +accepts the following options: +.TP 8 +.B \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-foreground \fIcolor\fP +The color for the foreground. Default is white. +.TP 8 +.B \-background \fIcolor\fP +The color for the background. Default is black. +.TP 8 +.B \-delay \fIseconds\fP +The number of seconds to pause between each picture. +.TP 8 +.B \-maxlines \fInumber\fP +The maximum number of lines in the drawing. Good values are +between 20 and 2000. Maximum value is 16K. +.TP 8 +.B \-fadedelay \fImicroseconds\fP +The number of micro seconds to take when fading in and out. +.TP 8 +.B \-mono +Don't do fading. Pretend we're on a monochrome display. +.PP +To make your X server grunt under load, and to impress your +friends, try \fIpedal -mono -delay 0 -maxlines 100\fp. +.SH ENVIRONMENT +.PP +.TP 8 +.B DISPLAY +to get the default host and display number. +.TP 8 +.B XENVIRONMENT +to get the name of a resource file that overrides the global resources +stored in the RESOURCE_MANAGER property. +.SH SEE ALSO +.BR X (1), +.BR xscreensaver (1) +.SH COPYRIGHT +Copyright \(co 1994, by Carnegie Mellon University. Permission to use, +copy, modify, distribute, and sell this software and its documentation +for any purpose is hereby granted without fee, provided fnord that the +above copyright notice appear in all copies and that both that copyright +notice and this permission notice appear in supporting documentation. +No representations are made about the suitability of fnord this software +for any purpose. It is provided "as is" without express or implied +warranty. +.SH AUTHOR +Dale Moore , 24-Jun-1994. diff --git a/local/man/man.1/penrose.1 b/local/man/man.1/penrose.1 new file mode 100644 index 00000000..e4734bf8 --- /dev/null +++ b/local/man/man.1/penrose.1 @@ -0,0 +1,106 @@ +.TH XScreenSaver 1 "10-May-97" "X Version 11" +.SH NAME +penrose - draws quasiperiodic tilings +.SH SYNOPSIS +.B penrose +[\-display \fIhost:display.screen\fP] [\-foreground \fIcolor\fP] [\-background \fIcolor\fP] [\-window] [\-root] [\-mono] [\-install] [\-visual \fIvisual\fP] [\-ncolors \fIinteger\fP] [\-delay \fImicroseconds\fP] [\-redoDelay \fIseconds\fP] [\-size \fIinteger\fP] [\-ammann] [\-no\-ammann] + +.SH DESCRIPTION +The \fIpenrose\fP program draws quasiperiodic tilings. + +See Onoda, Steinhardt, DiVincenzo and Socolar in +Phys. Rev. Lett. 60, #25, 1988 or +Strandburg in Computers in Physics, Sep/Oct 1991. + +This implementation uses the simpler version of the growth +algorithm, i.e., if there are no forced vertices, a randomly chosen +tile is added to a randomly chosen vertex (no preference for those +108 degree angles). + +There are two essential differences to the algorithm presented in +the literature: First, we do not allow the tiling to enclose an +untiled area. Whenever this is in danger of happening, we just +do not add the tile, hoping for a better random choice the next +time. Second, when choosing a vertex randomly, we will take +one that lies withing the viewport if available. If this seems to +cause enclosures in the forced rule case, we will allow invisible +vertices to be chosen. + +Tiling is restarted whenever one of the following happens: there +are no incomplete vertices within the viewport or the tiling has +extended a window's length beyond the edge of the window +horizontally or vertically or forced rule choice has failed 100 +times due to areas about to become enclosed. + +Although quasiperiodic tilings are produced, the tiles themselves are +not penrose tiles (darts and kites). In contrast to penrose tiles, +these tiles can be arranged to form a periodic tiling. + +.SH OPTIONS +.I penrose +accepts the following options: +.TP 8 +.B \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-mono +If on a color display, pretend we're on a monochrome display. +.TP 8 +.B \-install +Install a private colormap for the window. +.TP 8 +.B \-visual \fIvisual\fP +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. +.TP 8 +.B \-ncolors \fIinteger\fP +How many colors should be used (if possible). Default 64. +The colors are chosen randomly. +.TP 8 +.B \-size \fIinteger\fP +How big the tiles should be. Default 40 pixels. + +.TP 8 +.B \-delay \fImilliseconds\fP +How long (in 1/1,000,000'ths of a second) to wait between drawing each +tile. Default 10,000 or .01 seconds. + +.TP 8 +.B \-redoDelay \fIseconds\fP +How long to wait between starting a completely new tiling. Default 3 seconds. + +.TP 8 +.B \-ammann \fIinteger\fP +.TP 8 +.B \-no\-ammann \fIinteger\fP +Whether Ammann lines should be added. + +.SH ENVIRONMENT +.PP +.TP 8 +.B DISPLAY +to get the default host and display number. +.TP 8 +.B XENVIRONMENT +to get the name of a resource file that overrides the global resources +stored in the RESOURCE_MANAGER property. +.SH SEE ALSO +.BR X (1), +.BR xscreensaver (1), +.BR xlock (1) +.SH COPYRIGHT +Copyright \(co 1996 by Timo Korvola. + +Permission to use, copy, modify, and distribute this software and its +documentation for any purpose and without fee is hereby granted, +provided that the above copyright notice appear in all copies and that +both that copyright notice and this permission notice appear in +supporting documentation. +.SH AUTHOR +Timo Korvola , 1996. + +Ability to run standalone or with \fIxscreensaver\fP added by +Jamie Zawinski , 10-May-97. diff --git a/local/man/man.1/pyro.1 b/local/man/man.1/pyro.1 new file mode 100644 index 00000000..106fc8aa --- /dev/null +++ b/local/man/man.1/pyro.1 @@ -0,0 +1,60 @@ +.TH XScreenSaver 1 "13-aug-92" "X Version 11" +.SH NAME +pyro - simulate fireworks +.SH SYNOPSIS +.B pyro +[\-display \fIhost:display.screen\fP] [\-foreground \fIcolor\fP] [\-background \fIcolor\fP] [\-window] [\-root] [\-mono] [\-install] [\-visual \fIvisual\fP] [\-count \fIinteger\fP] [\-frequency \fIinteger\fP] [\-scatter \fIinteger\fP] +.SH DESCRIPTION +The \fIpyro\fP program simulates fireworks, in a way similar to a Macintosh +program of the same name. +.SH OPTIONS +.I pyro +accepts the following options: +.TP 8 +.B \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-mono +If on a color display, pretend we're on a monochrome display. +.TP 8 +.B \-install +Install a private colormap for the window. +.TP 8 +.B \-visual \fIvisual\fP +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. +.TP 8 +.B \-count \fIinteger\fP +How many particles should be allowed on the screen at once. Default 100. +.TP 8 +.B \-frequency \fIinteger\fP +How often new missiles should launch. Default 30. +.TP 8 +.B \-scatter \fIinteger\fP +How many particles should appear when a missile explodes. Default 20. +The actual number used is between \fIN\fP and \fIN+(N/2)\fP. +.SH ENVIRONMENT +.PP +.TP 8 +.B DISPLAY +to get the default host and display number. +.TP 8 +.B XENVIRONMENT +to get the name of a resource file that overrides the global resources +stored in the RESOURCE_MANAGER property. +.SH SEE ALSO +.BR X (1), +.BR xscreensaver (1) +.SH COPYRIGHT +Copyright \(co 1992 by Jamie Zawinski. Permission to use, copy, modify, +distribute, and sell this software and its documentation for any purpose 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 representations are made about the +suitability of this software for any purpose. It is provided "as is" without +express or implied warranty. +.SH AUTHOR +Jamie Zawinski , 13-aug-92. diff --git a/local/man/man.1/qix.1 b/local/man/man.1/qix.1 new file mode 100644 index 00000000..90dd67dc --- /dev/null +++ b/local/man/man.1/qix.1 @@ -0,0 +1,128 @@ +.TH XScreenSaver 1 "27-Apr-97" "X Version 11" +.SH NAME +qix - bounce colored lines around a window +.SH SYNOPSIS +.B qix +[\-display \fIhost:display.screen\fP] [\-foreground \fIcolor\fP] [\-background \fIcolor\fP] [\-window] [\-root] [\-mono] [\-install] [\-visual \fIvisual\fP] [\-segments \fIint\fP] [\-spread \fIpixels\fP] [\-size \fIpixels\fP] [\-count \fIint\fP] [\-color-shift \fIdegrees\fP] [\-delay \fIusecs\fP] [\-random] [\-linear] [\-solid] [\-hollow] [\-xor] [\-no\-xor] [\-transparent] [\-non\-transparent] [\-additive] [\-subtractive] [\-poly \fIint\fP] [\-gravity] [\-no\-gravity] +.SH DESCRIPTION +The \fIqix\fP program bounces a series of line segments around its window. +This is truly the swiss army chainsaw of qix programs. If you know of one +with more display modes, I want to know about it. +.SH OPTIONS +.I qix +accepts the following options: +.TP 8 +.B \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-mono +If on a color display, pretend we're on a monochrome display. +.TP 8 +.B \-install +Install a private colormap for the window. +.TP 8 +.B \-visual \fIvisual\fP +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. +.TP 8 +.B \-segments \fIinteger\fP +How many line segments should be drawn. Default 50. +.TP 8 +.B \-spread \fIinteger\fP +How far apart the endpoints of one segment should be from the next. +Default 8. +.TP 8 +.B \-size \fIinteger\fP +The maximum distance one endpoint of a segment is allowed to be from +the opposite end of that segment. Default 0, meaning unlimited. +.TP 8 +.B \-count \fIinteger\fP +How many qixes to draw. Default 1. +.TP 8 +.B \-color\-shift \fIdegrees\fP +If on a color display, the color of the line segments will cycle through +the spectrum. This specifies how far the hue of each segment should be +from the next, in degrees on the HSV wheel. Default 3. +.TP 8 +.B \-delay \fImicroseconds\fP +How much of a delay should be introduced between steps of the animation. +Default 25000, or about 0.025 seconds. +.TP 8 +.B \-random +The \fIqix\fP will wander around the screen semi-randomly. This is the +default. +.TP 8 +.B \-linear +The opposite of \fI\-random\fP: the \fIqix\fP will travel in straight lines +until it reaches a wall, and then it will bounce. +.TP 8 +.B \-solid +If this is specified, then the area between the line segments will be filled +in with the appropriate color, instead of the \fIqix\fP simply being composed +of one-pixel-wide line segments. This option looks really good in color. +.TP 8 +.B \-hollow +The opposite of \fI\-solid\fP; this is the default. +.TP 8 +.B \-xor +If this is specified, then qix segments will be drawn and erased with xor, +instead of being drawn in some color and erased in the background color. +This implies \fI\-mono\fP, in that only two colors can be used. +.TP 8 +.B \-transparent +If this is specified, and \fI\-count\fP is greater than 1, then each qix +will be drawn in one color, and when they overlap, the colors will be mixed. +This looks best in conjuction with \fI\-solid\fP. +.TP 8 +.B \-non\-transparent +Turns off \fI\-transparent\fP. +.TP 8 +.B \-additive +If \fI\-transparent\fP is specified, then this option means that the colors +will be mixed using an additive color model, as if the qixes were projected +light. This is the default. +.TP 8 +.B \-subtractive +If \fI\-transparent\fP is specified, then this option means that the +colors will be mixed using a subtractive color model, as if the qixes were +translucent filters. +.TP 8 +.B \-poly \fIint\fP +How many vertices each qix-line should have: the default is 2, meaning the +traditional qix line shape. Three will yield triangles, and so on. +.TP 8 +.B \-gravity +.TP 8 +.B \-no\-gravity +Whether there should be downward attraction. For example, the +options +.B \-gravity \-linear +will make everything move in nice smooth parabolas. +Gravity is off by default. +.SH ENVIRONMENT +.PP +.TP 8 +.B DISPLAY +to get the default host and display number. +.TP 8 +.B XENVIRONMENT +to get the name of a resource file that overrides the global resources +stored in the RESOURCE_MANAGER property. +.SH SEE ALSO +.BR X (1), +.BR xscreensaver (1) +.SH COPYRIGHT +Copyright \(co 1992 by Jamie Zawinski. Permission to use, copy, modify, +distribute, and sell this software and its documentation for any purpose 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 representations are made about the +suitability of this software for any purpose. It is provided "as is" without +express or implied warranty. +.SH AUTHOR +Jamie Zawinski , 13-aug-92. + +Thanks to Ariel Scolnicov for the \-poly and \-gravity options. diff --git a/local/man/man.1/rd-bomb.1 b/local/man/man.1/rd-bomb.1 new file mode 100644 index 00000000..161c4783 --- /dev/null +++ b/local/man/man.1/rd-bomb.1 @@ -0,0 +1,98 @@ +.TH XScreenSaver 1 "10-May-97" "X Version 11" +.SH NAME +rd-bomb - reaction/diffusion textures +.SH SYNOPSIS +.B rd-bomb +[\-display \fIhost:display.screen\fP] [\-foreground \fIcolor\fP] +[\-background \fIcolor\fP] [\-window] [\-root] [\-install] +[\-visual \fIvisual\fP] [\-width \fIn\fP] [\-height \fIn\fP] +[\-reaction \fIn\fP] [\-diffusion \fIn\fP] +[\-size \fIf\fP] [\-speed \fIf\fP] [\-delay \fIusecs\fP] +.SH DESCRIPTION + +The \fIrd-bomb\fP program draws reaction/diffusion textures. The code +is derived from the 'd' mode of the "bomb" visual musical instrument +(see http://www.cs.cmu.edu/~spot/bomb.html). I got the equations from +xmorphia (http://www.ccsf.caltech.edu/ismap/image.html), which is +based on a version of the Gray-Scott model taken from: + John E. Pearson "Complex Patterns in a Simple System" + Science, 261,189, 9 July 1993. + +If the frame-rate is too low, consider decreasing the width and height +of the tile, or decreasing the size of the active part of the screen. + +.SH OPTIONS + +If one of the reaction, diffusion, radius, and palette options is set +to a negative value, then that option will be set to a random +appropriate value. + +Be sure to try "-speed 1 -size 0.1 -epoch 3000". + +.I rd-bomb +accepts the following options: +.TP 8 +.B \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-install +Install a private colormap for the window. +.TP 8 +.B \-visual \fIvisual\fP +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. +.TP 8 +.B \-width \fIn\fP +.TP 8 +.B \-height \fIn\fP +Specify the size of the tile, in pixels. +.TP 8 +.B \-reaction \fIn\fP +.TP 8 +.B \-diffusion \fIn\fP +These are constants in the equations that effect its visual nature. +Each may be one of 0, 1, or 2. +.TP 8 +.B \-radius \fIn\fP +Size of the seed. +.TP 8 +.B \-palette \fIn\fP +Selects a palette. Must be between 0 and 80, inclusive. +.TP 8 +.B \-size \fIf\fP +What fraction of the window is actively drawn, a floating point number +between 0 (exclusive) and 1 (inclusive). Default is 0.66. +.TP 8 +.B \-speed \fIf\fP +When a fraction of the screen is active, the active area moves at this +rate (a floating point number). Default is zero. Suggested value: 1.0. +.TP 8 +.B \-delay \fIusecs\fP +How many microseconds to delay between frames; default 1000, or +about 1/1000th of a second. +.SH ENVIRONMENT +.PP +.TP 8 +.B DISPLAY +to get the default host and display number. +.TP 8 +.B XENVIRONMENT +to get the name of a resource file that overrides the global resources +stored in the RESOURCE_MANAGER property. +.SH SEE ALSO +.BR X (1), +.BR xscreensaver (1), +.BR xlock (1) +.SH COPYRIGHT +Copyright \(co 1997 by Scott Draves. + +Permission to use, copy, modify, and distribute this software and its +documentation for any purpose and without fee is hereby granted, +provided that the above copyright notice appear in all copies and that +both that copyright notice and this permission notice appear in +supporting documentation. +.SH AUTHOR +Scott Draves , 9/97 diff --git a/local/man/man.1/rocks.1 b/local/man/man.1/rocks.1 new file mode 100644 index 00000000..1d391306 --- /dev/null +++ b/local/man/man.1/rocks.1 @@ -0,0 +1,86 @@ +.TH XScreenSaver 1 "13-aug-92" "X Version 11" +.SH NAME +rocks - animation of flying through an asteroid field +.SH SYNOPSIS +.B rocks +[\-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] +.SH DESCRIPTION +The \fIrocks\fP program draws an animation of an asteroid field moving past +the observer (or vice versa). Sometimes the observer picks up spin on Z axis. +.SH OPTIONS +.I rocks +accepts the following options: +.TP 8 +.B \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-mono +Make all the rocks the same color. +.TP 8 +.B \-ncolors colors +How many different colors to use. Default 5. Colors are chosen randomly. +.TP 8 +.B \-install +Install a private colormap for the window. +.TP 8 +.B \-visual \fIvisual\fP +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. +.TP 8 +.B \-count \fIinteger\fP +Maximum number of rocks to draw on the screen at once. Default 100. +.TP 8 +.B \-speed \fIinteger\fP +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. +.TP 8 +.B \-delay \fImicroseconds\fP +Number of microseconds to delay between each frame. Default 50000, meaning +about 1/20th second. Compare and contrast with \fI\-speed\fP, above. +.TP 8 +.B \-norotate +Don't rotate the observer; just fly through the field on the level. +.TP 8 +.B \-nomove +Don't turn the observer; just fly straight ahead through the field. +.TP 8 +.B \-3d +Do red/blue 3d separations: if you look at the screen with 3d glasses, +the rocks will be \fIjumping\fP right \fIout\fP at you. Oooooh, scaaary! +.SH ENVIRONMENT +.PP +.TP 8 +.B DISPLAY +to get the default host and display number. +.TP 8 +.B XENVIRONMENT +to get the name of a resource file that overrides the global resources +stored in the RESOURCE_MANAGER property. +.SH SEE ALSO +.BR X (1), +.BR xscreensaver (1) +.SH 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. +.SH COPYRIGHT +Copyright \(co 1992 by Jamie Zawinski. Permission to use, copy, modify, +distribute, and sell this software and its documentation for any purpose 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 representations are made about the +suitability of this software for any purpose. It is provided "as is" without +express or implied warranty. +.SH AUTHOR +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 theiling@coli.uni-sb.de. diff --git a/local/man/man.1/rorschach.1 b/local/man/man.1/rorschach.1 new file mode 100644 index 00000000..56a6c487 --- /dev/null +++ b/local/man/man.1/rorschach.1 @@ -0,0 +1,75 @@ +.TH XScreenSaver 1 "13-aug-92" "X Version 11" +.SH NAME +rorschach - simulate ink-blot patterns +.SH SYNOPSIS +.B rorschach +[\-display \fIhost:display.screen\fP] [\-foreground \fIcolor\fP] [\-background \fIcolor\fP] [\-window] [\-root] [\-mono] [\-install] [\-visual \fIvisual\fP] [\-iterations \fIinteger\fP] [\-offset \fIinteger\fP] [\-xsymmetry] [\-ysymmetry] [\-erase\-mode \fIinteger\fP] [\-erase\-speed \fIusecs\fP] [\-delay \fIsecs\fP] +.SH DESCRIPTION +The \fIrorschach\fP program draws random patterns reminiscent of the +psychological test of same name. +.SH OPTIONS +.I rorschach +accepts the following options: +.TP 8 +.B \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-mono +If on a color display, pretend we're on a monochrome display. +.TP 8 +.B \-install +Install a private colormap for the window. +.TP 8 +.B \-visual \fIvisual\fP +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. +.TP 8 +.B \-iterations \fIinteger\fP +How many dots should be drawn each time. Default 4000. +.TP 8 +.B \-offset \fIinteger\fP +How far apart the dots should be. Default 4 pixels. +.TP 8 +.B \-xsymmetry +Whether the images should be horizontally symmetrical. Default true. +.TP 8 +.B \-ysymmetry +Whether the images should be vertically symmetrical. Default false. +.TP 8 +.B \-erase\-mode \fIinteger\fP +This sets the erase mode. Mode \-1 chooses a random mode each time. There +are currently 6 modes defined (0\-5). +.TP 8 +.B \-erase\-speed \fIusecs\fP +This controls the speed at which the screen will be erased. (Delay between +erasing of individual lines.) +.TP 8 +.B \-delay \fIseconds\fP +This sets the number of seconds that the figure will be on the screen. +.SH ENVIRONMENT +.PP +.TP 8 +.B DISPLAY +to get the default host and display number. +.TP 8 +.B XENVIRONMENT +to get the name of a resource file that overrides the global resources +stored in the RESOURCE_MANAGER property. +.SH BUGS +May call your sanity into question. +.SH SEE ALSO +.BR X (1), +.BR xscreensaver (1) +.SH COPYRIGHT +Copyright \(co 1992 by Jamie Zawinski. Permission to use, copy, modify, +distribute, and sell this software and its documentation for any purpose 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 representations are made about the +suitability of this software for any purpose. It is provided "as is" without +express or implied warranty. +.SH AUTHOR +Jamie Zawinski , 13-aug-92. diff --git a/local/man/man.1/sierpinski.1 b/local/man/man.1/sierpinski.1 new file mode 100644 index 00000000..f3fdb34a --- /dev/null +++ b/local/man/man.1/sierpinski.1 @@ -0,0 +1,65 @@ +.TH XScreenSaver 1 "10-May-97" "X Version 11" +.SH NAME +sierpinski - draws Sierpinski triangle fractals +.SH SYNOPSIS +.B sierpinski +[\-display \fIhost:display.screen\fP] [\-foreground \fIcolor\fP] [\-background \fIcolor\fP] [\-window] [\-root] [\-mono] [\-install] [\-visual \fIvisual\fP] [\-ncolors \fIinteger\fP] [\-delay \fImicroseconds\fP] [\-cycles \fIinteger\fP] [\-count \fIinteger\fP] + +.SH DESCRIPTION +The \fIsierpinski\fP program draws Sierpinski triangle fractals. +.SH OPTIONS +.I sierpinski +accepts the following options: +.TP 8 +.B \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-mono +If on a color display, pretend we're on a monochrome display. +.TP 8 +.B \-install +Install a private colormap for the window. +.TP 8 +.B \-visual \fIvisual\fP +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. +.TP 8 +.B \-ncolors \fIinteger\fP +How many colors should be used (if possible). Default 64. +The colors are chosen randomly. +.TP 8 +.B \-cycles \fIinteger\fP + +.TP 8 +.B \-count \fIinteger\fP + +.SH ENVIRONMENT +.PP +.TP 8 +.B DISPLAY +to get the default host and display number. +.TP 8 +.B XENVIRONMENT +to get the name of a resource file that overrides the global resources +stored in the RESOURCE_MANAGER property. +.SH SEE ALSO +.BR X (1), +.BR xscreensaver (1), +.BR xlock (1) +.SH COPYRIGHT +Copyright \(co 1996 by Desmond Daignault. + +Permission to use, copy, modify, and distribute this software and its +documentation for any purpose and without fee is hereby granted, +provided that the above copyright notice appear in all copies and that +both that copyright notice and this permission notice appear in +supporting documentation. +.SH AUTHOR +Desmond Daignault , 05-Sep-96. (Original +xlock version was called tri.c.) + +Ability to run standalone or with \fIxscreensaver\fP added by +Jamie Zawinski , 10-May-97. (Renamed to sierpinski.) diff --git a/local/man/man.1/slidescreen.1 b/local/man/man.1/slidescreen.1 new file mode 100644 index 00000000..a3e9d902 --- /dev/null +++ b/local/man/man.1/slidescreen.1 @@ -0,0 +1,92 @@ +.TH XScreenSaver 1 "24-Nov-97" "X Version 11" +.SH NAME +slidescreen - permute the screen image like an 8-puzzle +.SH SYNOPSIS +.B slidescreen +[\-display \fIhost:display.screen\fP] [\-background \fIcolor\fP] [\-grid-size \fIpixels\fP] [\-ibw \fIpixels\fP] [\-increment \fIpixels\fP] [\-delay \fIusecs\fP] [\-delay2 \fIusecs\fP] [\-window] [\-root] [\-install] [\-visual \fIvisual\fP] +.SH DESCRIPTION +The \fIslidescreen\fP program takes an image of the screen, divides it into +a grid, deletes a random square of that grid, and then randomly slides +one of the neighbors of this "hole" into the hole (and repeat.) +.SH OPTIONS +.I slidescreen +accepts the following options: +.TP 8 +.B \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-install +Install a private colormap for the window. +.TP 8 +.B \-visual \fIvisual\fP +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. +.TP 8 +.B \-grid-size \fIpixels\fP +The size of the grid cells. Default 70 pixels. +.TP 8 +.B \-ibw \fIpixels\fP +The size of the "gutter" between grid cells. Default 1 pixel. +.TP 8 +.B \-increment \fIpixels\fP +How many pixels by which a piece should be moved when sliding to a new +location. Default 10 pixels. +.TP 8 +.B \-delay \fImicroseconds\fP +How much of a delay should be introduced between steps of the animation of +the motion of each segment. Default 50000, which is 0.05 seconds. This +is closely related to the \fI\-increment\fP parameter. +.TP 8 +.B \-delay \fImicroseconds\fP +How much of a delay should be introduced between the end of the motion of +one segment and the beginning of the motion of another. Default 1000000, +which is one second. +.SH RESOURCES +On some systems (currently, only SGIs), this program can, instead of grabbing +a desktop image, grab a frame of video from an external camera and manipulate +that instead. The following resources control that. +.PP +.TP 8 +.B grabVideoProbability \fR(Float)\fP +What portion of the time to grab video rather than a screen image, +between 0.0 and 1.0. Defaults to 0.5, or half the time. +.TP 8 +.B videoDevice \fR(Integer)\fP +The number of the default video input device to check first. If unspecified, +the default camera (from videopanel(1)) will be checked first. After that, all +other available video input devices will be checked in order. + +The first one which produces a non-black image will be used. If all images +are black, the others will be re-checked a few times before giving up and +falling back to simply grabbing a desktop image (but note that this takes a +few seconds, so if you don't actually have any video sources hooked up, you +should consider turning off video grabbing by setting +\fBgrabVideoProbability\fP to 0.0.) +.TP 8 +.B videoGain \fR(Float)\fP +The amount by which to brighten the grabbed image. This defaults to 2.2. +.SH ENVIRONMENT +.PP +.TP 8 +.B DISPLAY +to get the default host and display number. +.TP 8 +.B XENVIRONMENT +to get the name of a resource file that overrides the global resources +stored in the RESOURCE_MANAGER property. +.SH SEE ALSO +.BR X (1), +.BR xscreensaver (1) +.SH COPYRIGHT +Copyright \(co 1992 by Jamie Zawinski. Permission to use, copy, modify, +distribute, and sell this software and its documentation for any purpose 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 representations are made about the +suitability of this software for any purpose. It is provided "as is" without +express or implied warranty. +.SH AUTHOR +Jamie Zawinski , 3-dec-92. diff --git a/local/man/man.1/slip.1 b/local/man/man.1/slip.1 new file mode 100644 index 00000000..d513654c --- /dev/null +++ b/local/man/man.1/slip.1 @@ -0,0 +1,93 @@ +.TH XScreenSaver 1 "24-Nov-97" "X Version 11" +.SH NAME +slip - sucks your screen into a jet engine +.SH SYNOPSIS +.B slip +[\-display \fIhost:display.screen\fP] [\-foreground \fIcolor\fP] [\-background \fIcolor\fP] [\-window] [\-root] [\-mono] [\-install] [\-visual \fIvisual\fP] [\-ncolors \fIinteger\fP] [\-iterations \fIinteger\fP] [\-points \fIinteger\fP] [\-delay \fImicroseconds\fP] [\-delay2 \fImicroseconds\fP] +.SH DESCRIPTION +The \fIslip\fP program does lots of blits and chews up your screen image. +.SH OPTIONS +.I slip +accepts the following options: +.TP 8 +.B \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-mono +If on a color display, pretend we're on a monochrome display. +.TP 8 +.B \-install +Install a private colormap for the window. +.TP 8 +.B \-visual \fIvisual\fP +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. +.TP 8 +.B \-ncolors \fIinteger\fP +How many colors should be used (if possible). Default 128. +The colors used cycle through the hue, making N stops around +the color wheel. +.TP 8 +.B \-count \fIinteger\fP +How many whooziwhatsis to generate. Default 35. +.TP 8 +.B \-cycles \fIinteger\fP +How long to frobnicate. Default 50. +.TP 8 +.B \-delay \fImicroseconds\fP +How long we should wait between drawing each step. Default 50000, +or about 1/20th second. + +.SH RESOURCES +On some systems (currently, only SGIs), this program can, instead of grabbing +a desktop image, grab a frame of video from an external camera and manipulate +that instead. The following resources control that. +.PP +.TP 8 +.B grabVideoProbability \fR(Float)\fP +What portion of the time to grab video rather than a screen image, +between 0.0 and 1.0. Defaults to 0.5, or half the time. +.TP 8 +.B videoDevice \fR(Integer)\fP +The number of the default video input device to check first. If unspecified, +the default camera (from videopanel(1)) will be checked first. After that, all +other available video input devices will be checked in order. + +The first one which produces a non-black image will be used. If all images +are black, the others will be re-checked a few times before giving up and +falling back to simply grabbing a desktop image (but note that this takes a +few seconds, so if you don't actually have any video sources hooked up, you +should consider turning off video grabbing by setting +\fBgrabVideoProbability\fP to 0.0.) +.TP 8 +.B videoGain \fR(Float)\fP +The amount by which to brighten the grabbed image. This defaults to 2.2. +.SH ENVIRONMENT +.PP +.TP 8 +.B DISPLAY +to get the default host and display number. +.TP 8 +.B XENVIRONMENT +to get the name of a resource file that overrides the global resources +stored in the RESOURCE_MANAGER property. +.SH SEE ALSO +.BR X (1), +.BR xscreensaver (1), +.BR xlock (1) +.SH COPYRIGHT +Copyright \(co 1992 by Scott Draves. + +Permission to use, copy, modify, and distribute this software and its +documentation for any purpose and without fee is hereby granted, +provided that the above copyright notice appear in all copies and that +both that copyright notice and this permission notice appear in +supporting documentation. +.SH AUTHOR +Scott Graves . + +Ability to run standalone or with \fIxscreensaver\fP added by +Jamie Zawinski , 18-Oct-93. diff --git a/local/man/man.1/sonar.1 b/local/man/man.1/sonar.1 new file mode 100644 index 00000000..13139720 --- /dev/null +++ b/local/man/man.1/sonar.1 @@ -0,0 +1,185 @@ +.de EX \"Begin example +.ne 5 +.if n .sp 1 +.if t .sp .5 +.nf +.in +.5i +.. +.de EE +.fi +.in -.5i +.if n .sp 1 +.if t .sp .5 +.. +.TH Sonar 1 "3-Nov-98" "X Version 11" +.SH NAME +sonar - display a sonar scope +.SH SYNOPSIS +.B sonar +[\-background \fIcolor\fP] +[\-sweep\-color \fIcolor\fP] +[\-low\-color \fIcolor\fP] +[\-scope\-color \fIcolor\fP] +[\-grid\-color \fIcolor\fP] +[\-text\-color \fIcolor\fP] +[\-ttl \fIinteger\fP] +[\-mode ping] +[\-font \fIfont\fP] +[\-ping\-timeout \fIint\fP] +[\-ping\-source list | file | subnet ] +[\-ping\-file \fIhosts-file\fP] +[\-ping\-list \fIhost-name-list\fP] +[\-team-a-name \fIstring\fP] +[\-team-b-name \fIstring\fP] +[\-team-a-count \fIint\fP] +[\-team-b-count \fIint\fP] +.SH DESCRIPTION +The \fIsonar\fP program displays a sonar scope on the computer's screen. +This scope polls a sensor as the sweep goes around the scope and displays +what it finds as bogies on the screen. The program is designed to support +different modes representing different types of sensors. Currently the +only implemented sensors are a simulator, and a network ping function that +pings hosts and plots the results on the scope. +.SH OPTIONS +.I sonar +understands the following options: +.TP 8 +.B \-background \fIColor\fP +The background Color of the screen not covered by the scope. +.TP 8 +.B \-sweep\-color \fIColor\fP +The color of the brightest part of the sweep. +.TP 8 +.B \-scope\-color \fIColor\fP +The color of the circular part of the scope. +.TP 8 +.B \-grid\-color \fIColor\fP +The color to the grid lines overlaying the scope. +.TP 8 +.B \-text\-color \fIColor\fP +The color of the text identifying bogies on the scope. +.TP 8 +.B \-ttl \fIinteger\fP +"Time to live": visible time of a Bogie. Try values between 10 (very short) +and 100. +.TP 8 +.B \-mode \fIsimulation | ping\fP +The sensor mode to use, the currently supported modes \fIsimulate\fP (the +default) and \fIping\fP. +.TP 8 +.B \-font \fIfont\fP +The font used to display text on the scope. Default "fixed". +.TP 8 +.B \-ping\-timeout \fIint\fP +The amount of time in milliseconds the program will wait for an answer +to a ping. +.TP 8 +.B \-ping\-source list | file | subnet +Th source of the list of hosts to ping. Valid values are: \fIlist\fP, +\fIfile\fP, \fIsubnet\fP. The first two values are described below; +and \fIsubnet\fP indicates that the sonar should ping all hosts in the +same subnet as the current machine. (All addresses are treated +as class C nets, therefore this will at most ping 254 hosts.) +.TP 8 +.B \-ping\-file \fIfilename\fP +The path to a file listing the hosts to ping. This file can be in the +format used by \fI/etc/hosts\fP, or it can be any file that has host +names as the first element on each line. If you use ssh, try this: +.EX +sonar -mode ping -ping-file $HOME/.ssh/known_hosts +.EE +This is used only used when \fIpingSource\fP is set to \fBfile\fP. +.TP 8 +.B \-ping\-list \fIlist\fP +A comma separated list of hostnames, eg \fI"pinky,brain,dot"\fP. +Only used when \fIpingSource\fP is set to \fBlist\fP. +.TP 8 +.B \-team-a-name \fIstring\fP +The name of team A, in simulation-mode. +.TP 8 +.B \-team-b-name \fIstring\fP +The name of team B, in simulation-mode. +.TP 8 +.B \-team-a-count \fIint\fP +The number of bogies on team A, in simulation-mode. +.TP 8 +.B \-team-b-count \fIint\fP +The number of bogies on team B, in simulation-mode. +.SH RESOURCES +Configuration of the targets to ping is best done by setting X Resources. +.PP +.TP 8 +.B background \fI(Color)\fP +See option \-background, above; default value is \fIblack\fP. +.TP 8 +.B sweepColor \fI(Color)\fP +See option \-sweep\-color, above; default value is \fI#00ff00\fP. +.TP 8 +.B scopeColor \fI(Color)\fP +See option \-scope\-color, above; default value is \fI#003300\fP. +.TP 8 +.B gridColor \fI(Color)\fP +See option \-grid\-color, above; default value is \fI#00aa00\fP. +.TP 8 +.B textColor \fI(Color)\fP +See option \-text\-color, above; default value is \fI#ffff00\fP. +.TP 8 +.B ttl \fI(integer)\fP +See option \-ttl, above; default value is \fI90\fP or one sweep. +.TP 8 +.B mode \fI(ping)\fP +See option \-mode, above. If set to \fBdefault\fP, it will ping hosts if +possible, otherwise, will run in simulation-mode. +.TP 8 +.B font \fI(font)\fP +See option \-font, above; default value is \fIfixed\fP. +.TP 8 +.B pingTimeout \fI(Integer)\fP +See option \-pingtimeout, above; default value is 3000. +.TP 8 +.B pingSource \fIlist | file | subnet\fP +See option \-ping\-source, above. Default value is \fIfile\fP. +.TP 8 +.B pingFile \fIpathname\fP +See option \-ping\-file, above. Default value is \fI/etc/hosts\fP. +.TP 8 +.B pingList \fIhost,host,host...\fP +See option \-ping\-list, above; default value is \fBlocalhost\fP. +.TP 8 +.B teamAName \fIstring\fP +See option \-team\-a\-name, above. Default value is \fBF18\fP. +.TP 8 +.B teamBName \fIstring\fP +See option \-teamBName, above. Default value is \fBMIG\fP. +.TP 8 +.B teamACount \fIint\fP +See option \-teamACount, above. Default value is 4. +.TP 8 +.B teamBCount \fIint\fP +See option \-teamBCount, above. Default value is 4. +.SH NOTES +In order to use the ping sensor, this program must be installed as +setuid root, so that it can create an ICMP socket. +.SH SEE ALSO +.BR X (1), +.BR xscreensaver (1), +.BR ping (8) +.SH COPYRIGHT +Copyright \(co 1998 by Stephen Martin. (smartin@canada.com) + +Permission to use, copy, modify, distribute, and sell this software and its +documentation for any purpose 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 representations are made about the suitability of this +software for any purpose. It is provided "as is" without express or +implied warranty. + +.SH AUTHORS +Stephen Martin , 3-nov-98. + +Thanks to Tom Kelly for suggesting a modular approach to the sensor +amoung other things. + +Thomas Bahls hacked the "ttl" option, 12-jul-98. + diff --git a/local/man/man.1/sphere.1 b/local/man/man.1/sphere.1 new file mode 100644 index 00000000..1632ab9e --- /dev/null +++ b/local/man/man.1/sphere.1 @@ -0,0 +1,58 @@ +.TH XScreenSaver 1 "27-May-97" "X Version 11" +.SH NAME +sphere - draws shaded spheres +.SH SYNOPSIS +.B sphere +[\-display \fIhost:display.screen\fP] [\-foreground \fIcolor\fP] [\-background \fIcolor\fP] [\-window] [\-root] [\-mono] [\-install] [\-visual \fIvisual\fP] [\-ncolors \fIinteger\fP] [\-delay \fImicroseconds\fP] + +.SH DESCRIPTION +The \fIsphere\fP program draws shaded spheres. +.SH OPTIONS +.I sphere +accepts the following options: +.TP 8 +.B \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-mono +If on a color display, pretend we're on a monochrome display. +.TP 8 +.B \-install +Install a private colormap for the window. +.TP 8 +.B \-visual \fIvisual\fP +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. +.TP 8 +.B \-ncolors \fIinteger\fP +How many colors should be used (if possible). Default 64. +The colors are chosen randomly. +.SH ENVIRONMENT +.PP +.TP 8 +.B DISPLAY +to get the default host and display number. +.TP 8 +.B XENVIRONMENT +to get the name of a resource file that overrides the global resources +stored in the RESOURCE_MANAGER property. +.SH SEE ALSO +.BR X (1), +.BR xscreensaver (1), +.BR xlock (1) +.SH COPYRIGHT +Copyright \(co 1988 by Sun Microsystems, Inc. + +Permission to use, copy, modify, and distribute this software and its +documentation for any purpose and without fee is hereby granted, +provided that the above copyright notice appear in all copies and that +both that copyright notice and this permission notice appear in +supporting documentation. +.SH AUTHOR +Sun Microsystems, Inc, 1988. + +Ability to run standalone or with \fIxscreensaver\fP added by +Jamie Zawinski , 27-May-97. diff --git a/local/man/man.1/spiral.1 b/local/man/man.1/spiral.1 new file mode 100644 index 00000000..a32db1e8 --- /dev/null +++ b/local/man/man.1/spiral.1 @@ -0,0 +1,67 @@ +.TH XScreenSaver 1 "10-May-97" "X Version 11" +.SH NAME +spiral - draws moving circular spiral patterns +.SH SYNOPSIS +.B spiral +[\-display \fIhost:display.screen\fP] [\-foreground \fIcolor\fP] [\-background \fIcolor\fP] [\-window] [\-root] [\-mono] [\-install] [\-visual \fIvisual\fP] [\-ncolors \fIinteger\fP] [\-delay \fImicroseconds\fP] [\-count \fIinteger\fP] + +.SH DESCRIPTION +The \fIspiral\fP program draws moving circular spiral patterns +.SH OPTIONS +.I spiral +accepts the following options: +.TP 8 +.B \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-mono +If on a color display, pretend we're on a monochrome display. +.TP 8 +.B \-install +Install a private colormap for the window. +.TP 8 +.B \-visual \fIvisual\fP +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. +.TP 8 +.B \-ncolors \fIinteger\fP +How many colors should be used (if possible). Default 64. +The colors are chosen randomly. +.TP 8 +.B \-count \fIinteger\fP +Default 40. +.TP 8 +.B \-cycles \fIinteger\fP +Default 350. + +.SH ENVIRONMENT +.PP +.TP 8 +.B DISPLAY +to get the default host and display number. +.TP 8 +.B XENVIRONMENT +to get the name of a resource file that overrides the global resources +stored in the RESOURCE_MANAGER property. +.SH SEE ALSO +.BR X (1), +.BR xscreensaver (1), +.BR xlock (1) +.SH COPYRIGHT +Copyright \(co 1994 by Darrick Brown. + +Permission to use, copy, modify, and distribute this software and its +documentation for any purpose and without fee is hereby granted, +provided that the above copyright notice appear in all copies and that +both that copyright notice and this permission notice appear in +supporting documentation. +.SH AUTHOR +Darrick Brown, 1994. + +Improved by Peter Schmitzberger , 24-Jul-95. + +Ability to run standalone or with \fIxscreensaver\fP added by +Jamie Zawinski , 10-May-97. diff --git a/local/man/man.1/spotlight.1 b/local/man/man.1/spotlight.1 new file mode 100644 index 00000000..31e9f71b --- /dev/null +++ b/local/man/man.1/spotlight.1 @@ -0,0 +1,57 @@ +.TH XScreenSaver 1 "05-Apr-1999" "X Version 11" +.SH NAME +spotlight - move spotlight around desktop +.SH SYNOPSIS +.B spotlight +[\-display \fIhost:display.screen\fP] [\-foreground \fIcolor\fP] [\-background \fIcolor\fP] [\-window] [\-root] [\-mono] [\-install] [\-visual \fIvisual\fP] [\-delay \fIusecs\fP] [\-radius \fIpixels\fP] +.SH DESCRIPTION +The \fIspotlight\fP program draws random rectangles. +.SH OPTIONS +.I spotlight +accepts the following options: +.TP 8 +.B \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-mono +If on a color display, pretend we're on a monochrome display. +.TP 8 +.B \-install +Install a private colormap for the window. +.TP 8 +.B \-visual \fIvisual\fP +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. +.TP 8 +.B \-delay \fImicroseconds\fP +Slow it down. +.TP 8 +.B \-radius \fIpixels\fP +Radius of the spotlight in pixels. +.SH ENVIRONMENT +.PP +.TP 8 +.B DISPLAY +to get the default host and display number. +.TP 8 +.B XENVIRONMENT +to get the name of a resource file that overrides the global resources +stored in the RESOURCE_MANAGER property. +.SH SEE ALSO +.BR X (1), +.BR xscreensaver (1) +.SH COPYRIGHT +Copyright \(co 1999 by Rick Schultz. Permission to use, copy, modify, +distribute, and sell this software and its documentation for any purpose 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 representations are made about the +suitability of this software for any purpose. It is provided "as is" without +express or implied warranty. +.SH CREDITS +Hacked together by Rick Schultz , based on StefView for +BackSpace by Darcy Brockbank and on several other xscreensaver hacks. + diff --git a/local/man/man.1/squiral.1 b/local/man/man.1/squiral.1 new file mode 100644 index 00000000..9e3ce5fa --- /dev/null +++ b/local/man/man.1/squiral.1 @@ -0,0 +1,76 @@ +.TH XScreenSaver 1 "18-mar-1999" "X Version 11" +.SH NAME +squiral - square spirals screensaver +.SH SYNOPSIS +.B squiral +[\-display \fIhost:display.screen\fP] [\-foreground \fIcolor\fP] +[\-background \fIcolor\fP] [\-window] [\-root] [\-mono] [\-install] +[\-noinstall] [\-visual \fIvisual\fP] [\-fill \fIpercent\fP] [-count +\fInumber\fP] [-delay \fIusec\fP] [-disorder \fIfraction\fP] [-handedness +\fIfraction\fP] [-cycle] +.SH DESCRIPTION +The \fIsquiral\fP program displays interacting, spiral-producing automata + +.SH OPTIONS +.I squiral +accepts the following options: +.TP 8 +.B \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-mono +If on a color display, pretend we're on a monochrome display. +.TP 8 +.B \-install +Install a private colormap for the window. +.TP 8 +.B \-visual \fIvisual\fP +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. +.TP 8 +.B \-fill \fIpercent\fP +Specify the percent (0-100) of the screen which must be filled before +the screen is cleared. 60-80 percent are good values. +.TP 8 +.B \-count \fInumber\fP +The number of squiralies. By default, the screen width divided by 32. +.TP 8 +.B \-delay \fIusec\fP +The wait between steps. The default is 1000. +.TP 8 +.B \-disorder \fIfraction\fP +The fraction of the time a squiraly will choose a new direction. +The default is 0.005. +.TP 8 +.B \-handedness \fIfraction\fP +The fraction of the time a squiraly will choose to enter lefthanded +mode. 0.0 means exclusively right-handed behavior, 0.5 (the default) is +a balance between the two, and 1.0 is exclusively left-handed behaviour. +.SH ENVIRONMENT +.PP +.TP 8 +.B DISPLAY +to get the default host and display number. +.TP 8 +.B XENVIRONMENT +to get the name of a resource file that overrides the global resources +stored in the RESOURCE_MANAGER property. +.SH BUGS +None known +.SH SEE ALSO +.BR X (1), +.BR xscreensaver (1) +.SH COPYRIGHT +Copyright \(co 1999, by Jeff Epler. Permission to use, copy, modify, +distribute, and sell this software and its documentation for any purpose is +hereby granted without fee, provided fnord that the above copyright notice +appear in all copies and that both that copyright notice and this permission +notice appear in supporting documentation. No representations are made about +the suitability of fnord this software for any purpose. It is provided "as +is" without express or fnord implied warranty. +.SH AUTHOR +Jeff Epler , 18-mar-1999 + diff --git a/local/man/man.1/starfish.1 b/local/man/man.1/starfish.1 new file mode 100644 index 00000000..63c70d4e --- /dev/null +++ b/local/man/man.1/starfish.1 @@ -0,0 +1,89 @@ +.TH XScreenSaver 1 "14-Jun-97" "X Version 11" +.SH NAME +starfish - radially-symmetric throbbing colormap-hacking graphics demo +.SH SYNOPSIS +.B starfish +[\-display \fIhost:display.screen\fP] [\-foreground \fIcolor\fP] [\-background \fIcolor\fP] [\-window] [\-root] [\-mono] [\-install] [\-visual \fIvisual\fP] [\-delay \fIusecs\fP] [\-delay2 \fIsecs\fP] [\-cycle\-delay2 \fIusecs\fP] [\-thickness \fIpixels\fP] [\-rotation \fIdegrees\fP] [\-duration \fIseconds\fP] [\-colors \fIint\fP] [\-cycle] [\-no\-cycle] [\-blob] [\-no\-blob] +.SH DESCRIPTION +The \fIstarfish\fP program draws radially symmetric objects, which expand, +contract, rotate, and turn inside out. It uses these shapes to lay down a +field of smooth colors, and then rotates the colormap. +.SH OPTIONS +.I starfish +accepts the following options: +.TP 8 +.B \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-mono +If on a color display, pretend we're on a monochrome display. +.TP 8 +.B \-install +Install a private colormap for the window. +.TP 8 +.B \-visual \fIvisual\fP +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. +.TP 8 +.B \-delay \fImicroseconds\fP +How much of a delay should be introduced between steps of the animation. +Default 10000, or about 1/100th second. +.TP 8 +.B \-cycle\-delay \fImicroseconds\fP +How long to wait between shifing the colormap by one step. +Default 100000, or about 1/10th second. +.TP 8 +.B \-thickness \fIpixels\fP +How wide each color band should be. Default 0, meaning random (the chosen +value will be between 0 and 15.) +.TP 8 +.B \-rotation \fIdegrees\fP +How quickly the objects should rotate at each step. Default 0, meaning +random (the chosen value will be between 0 and 12 degrees.) +.TP 8 +.B \-colors \fIint\fP +How many colors to use. Default 200. The more colors, the smoother the +transitions will be, and the nicer the resultant images. +.TP 8 +.B \-cycle +.TP 8 +.B \-no\-cycle +Whether to do colormap cycling. Default true. +.TP 8 +.B \-duration \fIseconds\fP +How long to run before choosing a new shape. Default 30 seconds. +.TP 8 +.B \-delay2 \fIseconds\fP +When \fIduration\fP expires, how long to wait before starting a new run. +Default 5 seconds. +.TP 8 +.B \-blob +.TP 8 +.B \-no\-blob +If \fIblob\fP option is specified, then the raw shapes will be shown, +instead of a field of colors generated from them. +.SH ENVIRONMENT +.PP +.TP 8 +.B DISPLAY +to get the default host and display number. +.TP 8 +.B XENVIRONMENT +to get the name of a resource file that overrides the global resources +stored in the RESOURCE_MANAGER property. +.SH SEE ALSO +.BR X (1), +.BR xscreensaver (1) +.SH COPYRIGHT +Copyright \(co 1997 by Jamie Zawinski. Permission to use, copy, modify, +distribute, and sell this software and its documentation for any purpose 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 representations are made about the +suitability of this software for any purpose. It is provided "as is" without +express or implied warranty. +.SH AUTHOR +Jamie Zawinski , 14-Jun-97. diff --git a/local/man/man.1/strange.1 b/local/man/man.1/strange.1 new file mode 100644 index 00000000..088a9eed --- /dev/null +++ b/local/man/man.1/strange.1 @@ -0,0 +1,58 @@ +.TH XScreenSaver 1 "10-May-97" "X Version 11" +.SH NAME +strange - draws strange attractors +.SH SYNOPSIS +.B strange +[\-display \fIhost:display.screen\fP] [\-foreground \fIcolor\fP] [\-background \fIcolor\fP] [\-window] [\-root] [\-mono] [\-install] [\-visual \fIvisual\fP] [\-ncolors \fIinteger\fP] [\-delay \fImicroseconds\fP] + +.SH DESCRIPTION +The \fIstrange\fP program draws strange attractors +.SH OPTIONS +.I strange +accepts the following options: +.TP 8 +.B \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-mono +If on a color display, pretend we're on a monochrome display. +.TP 8 +.B \-install +Install a private colormap for the window. +.TP 8 +.B \-visual \fIvisual\fP +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. +.TP 8 +.B \-ncolors \fIinteger\fP +How many colors should be used (if possible). Default 64. +The colors are chosen randomly. +.SH ENVIRONMENT +.PP +.TP 8 +.B DISPLAY +to get the default host and display number. +.TP 8 +.B XENVIRONMENT +to get the name of a resource file that overrides the global resources +stored in the RESOURCE_MANAGER property. +.SH SEE ALSO +.BR X (1), +.BR xscreensaver (1), +.BR xlock (1) +.SH COPYRIGHT +Copyright \(co 1997 by Massimino Pascal. + +Permission to use, copy, modify, and distribute this software and its +documentation for any purpose and without fee is hereby granted, +provided that the above copyright notice appear in all copies and that +both that copyright notice and this permission notice appear in +supporting documentation. +.SH AUTHOR +Massimino Pascal , 1997. + +Ability to run standalone or with \fIxscreensaver\fP added by +Jamie Zawinski , 10-May-97. diff --git a/local/man/man.1/swirl.1 b/local/man/man.1/swirl.1 new file mode 100644 index 00000000..c36733fc --- /dev/null +++ b/local/man/man.1/swirl.1 @@ -0,0 +1,64 @@ +.TH XScreenSaver 1 "13-May-97" "X Version 11" +.SH NAME +swirl - draws swirly color-cycling patterns +.SH SYNOPSIS +.B swirl +[\-display \fIhost:display.screen\fP] [\-foreground \fIcolor\fP] [\-background \fIcolor\fP] [\-window] [\-root] [\-mono] [\-install] [\-visual \fIvisual\fP] [\-ncolors \fIinteger\fP] [\-delay \fImicroseconds\fP] [\-cycles \fIinteger\fP] [\-count \fIinteger\fP] + +.SH DESCRIPTION +The \fIswirl\fP program draws swirly color-cycling patterns. +.SH OPTIONS +.I swirl +accepts the following options: +.TP 8 +.B \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-mono +If on a color display, pretend we're on a monochrome display. +.TP 8 +.B \-install +Install a private colormap for the window. +.TP 8 +.B \-visual \fIvisual\fP +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. +.TP 8 +.B \-ncolors \fIinteger\fP +How many colors should be used (if possible). Default 200. +.TP 8 +.B \-cycles \fIinteger\fP + +.TP 8 +.B \-count \fIinteger\fP + +.SH ENVIRONMENT +.PP +.TP 8 +.B DISPLAY +to get the default host and display number. +.TP 8 +.B XENVIRONMENT +to get the name of a resource file that overrides the global resources +stored in the RESOURCE_MANAGER property. +.SH SEE ALSO +.BR X (1), +.BR xscreensaver (1), +.BR xlock (1) +.SH COPYRIGHT +Copyright \(co 1994 M. Dobie. + +Permission to use, copy, modify, and distribute this software and its +documentation for any purpose and without fee is hereby granted, +provided that the above copyright notice appear in all copies and that +both that copyright notice and this permission notice appear in +supporting documentation. + +.SH AUTHOR +M.Dobie , 1994. + +Ability to run standalone or with \fIxscreensaver\fP added by +Jamie Zawinski , 13-May-97. diff --git a/local/man/man.1/t3d.1 b/local/man/man.1/t3d.1 new file mode 100644 index 00000000..54ef3fdd --- /dev/null +++ b/local/man/man.1/t3d.1 @@ -0,0 +1,129 @@ +.TH t3d 1 "Version 1.1" "Time 3D" +.SH NAME +t3d \- clock using flying balls to display the time +.SH SYNOPSIS +t3d [ \f2 options\f1 ]... +.SH DESCRIPTION +.PP +Time 3D is a clock. It uses flying balls to display the time. This +balls move and wobble around to give you the impression your +graphic workstation with its many XStones is doing something. +.PP +t3d uses mouse and keyboard to let you fly through the balls. Hit +.B S +to speed up, +.B A +to slow down, +.B Z +to zoom in and +.B X +to zoom out. +Use the +.B left mouse button +to rotate to the left and the +.B right mouse button +to rotate the view to the right. Use the +.B middle mouse button +to change the optical axis and the moving direction. +.B 0 +(zero) will stop you. +.B Q +quits. +.PP +.SH OPTIONS +.TP +.BI "-move " "factor" +Modifies the direction move of t3d. The clock looks 30 degrees* +.I factor +to the left and to the right periodically. +.TP +.BI "-wobble " "factor" +Modifies the wobbling (sounds nice :-) of t3d by multiplying the +default deformation of the clock with +.I factor. +.TP +.B -minutes +Shows one small ball for every minute, instead of one for every 2.5 minutes. +.TP +.BI "-mag " "factor" +Changes the magnification of t3d. By default, t3d draws a 200x200 image. +A .I factor +of 2 means, it will use a 400x400 image. +.TP +.BI "-cycle " "period" +Sets the moving cycle to +.I period +seconds. By default, this value is 10 seconds. +.TP +.BI "-wait " "microsec" +Inserts a wait after drawing one view of the clock. By default, t3d waits +40 ms after each drawing. This helps you to keep the performance loss +small. +.TP +.BI "-fast " "precalc_radius" +t3d uses bitmap copy to draw precalculated balls. You can specify the radius +in pixels up to which t3d should precalculate balls. t3d will set a useful +range by itself using the magnification when it is started. +.TP +.B -colcycle +Draws cyclic the color scale used for the balls in the background instead +of the normal black. +.TP +.BI "-rgb " "red green blue" +Selects the color in RGB color space of the lightning spot on the balls. +All the other colors used for balls or +.B -colcycle +are less intensive colors of the same hue and saturation. All values +in range of 0 to 1. +.TP +.BI "-hsv " "hue saturation value" +Selects the color in HSV color space. +.I hue +is in degrees from 0 to 360, all other values in range from 0 to 1. It gives +nice but rather unpredictable results, if you use a saturation of e.g. 2. +Try it at your own risk. +.TP +.BI "-hsvcycle " "speed" +Rotates the hue axis every 10 seconds* +.I speed. +.TP +.B -help +Prints a short usage message. + +.PP +.SH AUTHOR +.PP +Bernd Paysan + +Email: bernd.paysan@gmx.de + +Hacked on by jwz@jwz.org for xscreensaver. + +.SH ACKNOWLEDGEMENT +.PP +Acknowledgement to Georg Acher, who wrote the initial program displaying +balls. + +.SH COPYING +.PP +Copy, modify, and distribute T3D either under GPL version 2 or newer, or +under the standard MIT/X license notice. + +.SH DISCLAIMER +.PP +T3D is not related to T3D(tm), the massive parallel Alpha--based +supercomputer from Cray Research. T3D's name was invented in 1991, +years before the project at Cray Research started. There is no +relation from T3D to Cray's T3D, even the balls surrounding T3D on +some posters weren't an inspiration for T3D. I don't know anything +about the other way round. + +The programming style of T3D isn't intented as example of good style, +but as example of how a fast prototyped demo may look like. T3D wasn't +created to be useful, it was created to be nice. + +.SH KNOWN BUGS +.PP +There are no known bugs in T3D. Maybe there are bugs in X. Slight +changes in the T3D sources are known to show these bugs, e.g. if +you remove the (int) casting at the XFillArc x,y,w,h-coordinates... diff --git a/local/man/man.1/vidwhacker.1 b/local/man/man.1/vidwhacker.1 new file mode 100644 index 00000000..a1ffc102 --- /dev/null +++ b/local/man/man.1/vidwhacker.1 @@ -0,0 +1,81 @@ +.TH XScreenSaver 1 "17-Jun-99" "X Version 11" +.SH NAME +vidwhacker - grab images and apply random filters to them +.SH SYNOPSIS +.B vidwhacker +[\-display \fIhost:display.screen\fP] [\-root] [\-window] [\-verbose] [\-stdin] [\-stdout] [\-delay seconds] +.SH DESCRIPTION +The \fIvidwhacker\fP program grabs a image from the system's video input, +applies random image filters to it, and displays the result. +The \fIvidwhacker\fP program does not terminate until killed. +It depends heavily on +.BR xv (1) +and the various PBM tools +(e.g., +.BR ppmrelief (1).) +.SH OPTIONS +.I vidwhacker +accepts the following options: +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-window +Pop up a new window displaying the image. When a new image has been fully +processed, destroy that window and pop up a new one. This is the default. +.TP 8 +.B \-verbose +Print diagnostics. +.TP 8 +.B \-stdin +Instead of grabbing an image from the system's video input, read an image +to maniupulate from stdin. This image must be in +.TP 8 +.B \-delay \fIseconds\fP +How long to sleep between images. Default 3 seconds (the actual +elapsed time is significantly longer, due to processing time.) +.BR ppm (5) +format. The program will still perform repeated random image +transformations, but it will always use this one image as its starting point. +.TP 8 +.B \-stdout +Instead of displaying the image on a window or on the root, write the new +image on stdout, and exit. +.SH ENVIRONMENT +.PP +.TP 8 +.B DISPLAY +to get the default host and display number. +.TP 8 +.B XENVIRONMENT +to get the name of a resource file that overrides the global resources +stored in the RESOURCE_MANAGER property. +.SH BUGS +Grabbing video images is, of course, very system-dependent. It works +on SGIs, and on Linux systems that have the +.BR qcam (1) +program. If your system does things differently, you'll need to edit +the vidwhacker script (look for the \fIgrab()\fP function.) + +It's slow. +.SH TO DO +It might be interesting to rewrite this to use +.BR gimp (1) +plugins instead of the pbm tools. It probably wouldn't be any faster, +but there would be a wider variety of effects available. +.SH SEE ALSO +.BR X (1), +.BR xscreensaver (1), +.BR xv (1), +.BR ppmtogif (1), +.BR cjpeg (1) +.SH COPYRIGHT +Copyright \(co 1998, 1999 by Jamie Zawinski. Permission to use, copy, modify, +distribute, and sell this software and its documentation for any purpose 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 representations are made about the +suitability of this software for any purpose. It is provided "as is" without +express or implied warranty. +.SH AUTHOR +Jamie Zawinski , 18-Jan-98. diff --git a/local/man/man.1/vines.1 b/local/man/man.1/vines.1 new file mode 100644 index 00000000..13b7dee7 --- /dev/null +++ b/local/man/man.1/vines.1 @@ -0,0 +1,62 @@ +.TH XScreenSaver 1 "10-May-97" "X Version 11" +.SH NAME +vines - draws pseudo-fractal geometric patterns +.SH SYNOPSIS +.B vines +[\-display \fIhost:display.screen\fP] [\-foreground \fIcolor\fP] [\-background \fIcolor\fP] [\-window] [\-root] [\-mono] [\-install] [\-visual \fIvisual\fP] [\-ncolors \fIinteger\fP] [\-delay \fImicroseconds\fP] + +.SH DESCRIPTION +The \fIvines\fP program is yet another geometric pattern generator, this +one's claim to fame being a pseudo-fractal looking vine like pattern that +creates nifty whorls and loops. +.SH OPTIONS +.I vines +accepts the following options: +.TP 8 +.B \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-mono +If on a color display, pretend we're on a monochrome display. +.TP 8 +.B \-install +Install a private colormap for the window. +.TP 8 +.B \-visual \fIvisual\fP +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. +.TP 8 +.B \-ncolors \fIinteger\fP +How many colors should be used (if possible). Default 200. +The colors are chosen randomly. +.SH ENVIRONMENT +.PP +.TP 8 +.B DISPLAY +to get the default host and display number. +.TP 8 +.B XENVIRONMENT +to get the name of a resource file that overrides the global resources +stored in the RESOURCE_MANAGER property. +.SH SEE ALSO +.BR X (1), +.BR xscreensaver (1), +.BR xlock (1) +.SH COPYRIGHT +Copyright \(co 1997 by Tracy Camp. + +Permission to use, copy, modify, and distribute this software and its +documentation for any purpose and without fee is hereby granted, +provided that the above copyright notice appear in all copies and that +both that copyright notice and this permission notice appear in +supporting documentation. +.SH AUTHOR +Tracy Camp , 1997. + +Tweaked by David Hansen , 21-Mar-97. + +Ability to run standalone or with \fIxscreensaver\fP added by +Jamie Zawinski , 10-May-97. diff --git a/local/man/man.1/webcollage.1 b/local/man/man.1/webcollage.1 new file mode 100644 index 00000000..2a117364 --- /dev/null +++ b/local/man/man.1/webcollage.1 @@ -0,0 +1,128 @@ +.de EX \"Begin example +.ne 5 +.if n .sp 1 +.if t .sp .5 +.nf +.in +.5i +.. +.de EE +.fi +.in -.5i +.if n .sp 1 +.if t .sp .5 +.. +.TH XScreenSaver 1 "17-Jun-99" "X Version 11" +.SH NAME +webcollage - decorate the screen with random images from the web +.SH SYNOPSIS +.B webcollage +[\-display \fIhost:display.screen\fP] [\-root] [\-verbose] +[\-delay \fIsecs\fP] [\-timeout \fIsecs\fP] [\-background \fIbg\fP] +[\-filter \fIcommand\fP] [\-filter2 \fIcommand\fP] +.SH DESCRIPTION +The \fIwebcollage\fP program pulls random image off of the World Wide Web +and scatters them on the root window. It finds these images by doing +random web searches, and extracting images from the returned pages. +It places the images on the root window by using the +.BR xv (1), +.BR giftopnm (1), +and +.BR djpeg (1) +tools. + +\fIwebcollage\fP also works as a CGI program: simply make a symbolic +link to the \fIwebcollage\fP executable called \fInph-webcollage.cgi\fP. +If this program sees that it is being run as a CGI, then it will behave +appropriately. (The generated web page will list the images one after +another, rather than tiling them together.) + +\fIwebcollage\fP is written in +.BR perl (1) +and requires Perl 5. +.SH OPTIONS +.I webcollage +accepts the following options: +.TP 8 +.B \-root +Draw on the root window. This option is manditory: drawing to a window +other than the root window is not yet supported. +.TP 8 +.B \-verbose \fRor\fP \-v +Print diagnostics to stderr. Multiple \fI-v\fP switches increase the +amount of output. \fI-v\fP will print out only the URLs of the +images; \fI-vv\fP will print all the commands being run; and \fI-vvv\fP +will print more than you care about. +.TP 8 +.B \-delay \fIseconds\fP +How long to sleep between images. Default 1 second. (Remember that +this program probably spends a lot of time waiting for the network.) +.TP 8 +.B \-background \fIcolor-or-ppm\fP +What to use for the background onto which images are pasted. This may be +a color name, a hexadecimal RGB specification in the form '#rrggbb', or +the name of a PPM file. +.TP 8 +.B \-timeout \fIseconds\fP +How long to wait for a URL to complete before giving up on it and +moving on to the next one. +Default 30 seconds. +.TP 8 +.B \-filter \fIcommand\fP +Filter all source images through this command. The command must take +a PPM file on stdin, and write a new PPM file to stdout. One good +choice for a filter would be: +.EX +webcollage -root -filter 'vidwhacker -stdin -stdout' +.EE +.TP 8 +.B \-filter2 \fIcommand\fP +Filter the \fIcomposite\fP image through this command. The \fI-filter\fP +option applies to the sub-images; the \fI-filter2\fP applies to the +final, full-screen image. +.SH ENVIRONMENT +.PP +.TP 8 +.B DISPLAY +to get the default host and display number. +.TP 8 +.B XENVIRONMENT +to get the name of a resource file that overrides the global resources +stored in the RESOURCE_MANAGER property. +.SH FILES AND URLS +.TP +.I /usr/dict/words \fRor\fP /usr/share/lib/dict/words +To find the random words to feed to search engines. +.PP +.I http://random.yahoo.com/bin/ryl, http://image.altavista.com/ +To find random web pages. +.SH BUGS +When drawing on the root window, it always uses the default colormap. +This is actually a limitation of xv. But regardless, when using this +program with xscreensaver, it must be given the \fBdefault-n\fP +visual specification (see the +.BR xscreensaver (1) +manual for more details.) + +Only the GIF and JPEG image formats are supported. + +Transparent and animating GIFs are not supported. + +It's slow. +.SH SEE ALSO +.BR X (1), +.BR xscreensaver (1), +.BR xv (1), +.BR giftopnm (1), +.BR djpeg (1), +.BR vidwhacker (1), +.BR perl (1) +.SH COPYRIGHT +Copyright \(co 1998, 1999 by Jamie Zawinski. Permission to use, copy, modify, +distribute, and sell this software and its documentation for any purpose 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 representations are made about the +suitability of this software for any purpose. It is provided "as is" without +express or implied warranty. +.SH AUTHOR +Jamie Zawinski , 24-May-98. diff --git a/local/man/man.1/xjack.1 b/local/man/man.1/xjack.1 new file mode 100644 index 00000000..390e95fc --- /dev/null +++ b/local/man/man.1/xjack.1 @@ -0,0 +1,51 @@ +.TH XScreenSaver 1 "18-sep-97" "X Version 11" +.SH NAME +xjack - all work and no play makes jack a dull boy +.SH SYNOPSIS +.B xjack +[\-display \fIhost:display.screen\fP] [\-foreground \fIcolor\fP] [\-background \fIcolor\fP] [\-window] [\-root] [\-delay \fIusecs\fP] +.SH DESCRIPTION +All work and no play makes jack a dull boy. All work and no play makes jack +a dull boy. All work and no play makes jack a dull boy. All work and no +play makes jack a dull boy. All work and no play makes jack a dull boy. +All work and no play makes jack a dull boy. +.PP +.RS 8 +All work and no play makes jack a dull boy. All work and no play makes jack +a dull boy. All work and no play makes jack a dull boy. All work and no +play makes jack a dull boy. All work and no play makes jack a dull boy. +All work and no play makes jack a dull boy. +.PP +All work and no play makes jack a dull boy. All work and no play makes jack +a dull boy. All work and no play makes jack a dull boy. All work and no +play makes jack a dull boy. All work and no play makes jack a dull boy. All +work and no play makes jack a dull boy. All work and no play makes jack a +dull boy. All work and no play makes jack a dull boy. +.PP +.RE +All work and no play makes jack a dull boy. +All work and no play makes jack a dull boy. All work and no play makes jack +a dull boy. All work and no play makes jack a dull boy. All work and no +play makes jack a dull boy. All work and no play makes jack a dull boy. +All work and no play makes jack a dull boy. All work and no play makes jack +a dull boy. +.SH ENVIRONMENT +.PP +.TP 8 +.B DISPLAY +All work and no play makes jack a dull boy. +.TP 8 +.B XENVIRONMENT +All work and no play makes jack a dull boy. All work and no play makes jack +a dull boy. +.SH SEE ALSO +.BR X (1), +.BR xscreensaver (1) +.SH COPYRIGHT +Copyright \(co 1997 by Jamie Zawinski. All work and no play makes jack a +dull boy. All work and no play makes jack a dull boy. All work and no play +makes jack a dull boy. All work and no play makes jack a dull boy. All work +and no play makes jack a fnord dull boy. All work and no play makes jack a +dull boy. +.SH AUTHOR +Jamie Zawinski , 15-Nov-97. diff --git a/local/man/man.1/xjulia.1 b/local/man/man.1/xjulia.1 new file mode 100644 index 00000000..1aa6809c --- /dev/null +++ b/local/man/man.1/xjulia.1 @@ -0,0 +1,83 @@ +.TH XScreenSaver 1 "28-May-97" "X Version 11" +.SH NAME +julia - draws spinning, animating julia-set fractals +.SH SYNOPSIS +.B julia +[\-display \fIhost:display.screen\fP] [\-foreground \fIcolor\fP] [\-background \fIcolor\fP] [\-window] [\-root] [\-mono] [\-install] [\-visual \fIvisual\fP] [\-ncolors \fIinteger\fP] [\-delay \fImicroseconds\fP] [\-cycles \fIinteger\fP] [\-count \fIinteger\fP] [\-mouse] [\-nomouse] + +.SH DESCRIPTION +The \fIjulia\fP program draws spinning, animating julia-set fractals. + +It uses ifs {w0 = sqrt(x-c), w1 = -sqrt(x-c)} with random iteration +to plot the julia set, and sinusoidially varied parameters for the set, +and plots parameters with a circle. + +One thing to note is that count is the \fIdepth\fP of the search tree, +so the number of points computed is (2^count)-1. I use 8 or 9 on a +dx266 and it looks okay. The sinusoidal variation of the parameter +might not be as interesting as it could, but it still gives an idea +of the effect of the parameter. + +.SH OPTIONS +.I julia +accepts the following options: +.TP 8 +.B \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-mono +If on a color display, pretend we're on a monochrome display. +.TP 8 +.B \-install +Install a private colormap for the window. +.TP 8 +.B \-visual \fIvisual\fP +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. +.TP 8 +.B \-ncolors \fIinteger\fP +How many colors should be used (if possible). Default 200. +The colors used cycle through the hue, making N stops around +the color wheel. +.TP 8 +.B \-cycles \fIinteger\fP + +.TP 8 +.B \-count \fIinteger\fP + +.TP 8 +.B \-mouse +.TP 8 +.B \-nomouse +If \fI\-mouse\fP is specified, the control point of the Julia set will +be derived from the position of the mouse in the window. When the mouse +is not in the window, the control point is chosen the normal way. +.SH ENVIRONMENT +.PP +.TP 8 +.B DISPLAY +to get the default host and display number. +.TP 8 +.B XENVIRONMENT +to get the name of a resource file that overrides the global resources +stored in the RESOURCE_MANAGER property. +.SH SEE ALSO +.BR X (1), +.BR xscreensaver (1), +.BR xlock (1) +.SH COPYRIGHT +Copyright \(co 1995 by Sean McCullough. + +Permission to use, copy, modify, and distribute this software and its +documentation for any purpose and without fee is hereby granted, +provided that the above copyright notice appear in all copies and that +both that copyright notice and this permission notice appear in +supporting documentation. +.SH AUTHOR +Sean McCullough , 1995. + +Ability to run standalone or with \fIxscreensaver\fP added by +Jamie Zawinski , 10-May-97. diff --git a/local/man/man.1/xlyap.1 b/local/man/man.1/xlyap.1 new file mode 100644 index 00000000..6f69cade --- /dev/null +++ b/local/man/man.1/xlyap.1 @@ -0,0 +1,237 @@ +.TH XLYAP 6X +.SH NAME +xlyap \- display an array of Lyapunov exponents graphically +.SH SYNOPSIS +.in +8n +.ti -8n +\fIxlyap\fR +[-BLps][-W width][-H height][-o filename][-a +\fIn\fR ] +[-b +\fIn\fR ] +[-w +\fIn\fR ] +[-h +\fIn\fR ] +[-i xstart] +[-M +\fIn\fR ] +[-R +\fIp\fR ] +[-S +\fIn\fR ] +[-D +\fIn\fR ] +[-F string][-f string][-r +\fIn\fR ] +[-O +\fIn\fR ] +[-C +\fIn\fR ] +[-c +\fIn\fR ] +[-m +\fIn\fR ] +[-x xpos] +[-y ypos] +.in -8n +.SH DESCRIPTION +\fIxlyap\fR +generates and graphically displays an array of Lyapunov exponents for a +variety of iterated periodically forced non-linear maps of the unit interval. +.SH OPTIONS +.TP 8 +-random +A good choice for use with xscreensaver: picks random parameters from +a built-in list. +.TP 8 +-C \fIn\fP +Specifies the minimum color index to be used for negative exponents +.TP +-D \fIn\fP +Specifies the "dwell" or number of iterations over which to average in order +to calculate the Lyapunov exponent. Default is 400. +.TP +-B +Causes the stop, go, spin and quit buttons to be displayed. +.TP +-H \fIn\fP +Specifies the height of the window. Default is 256. +.TP +-L +Indicates use log(x) + log(y) rather than log(xy). +.TP +-M \fIr\fP +Specifies the real value to compare exponent values to for indexing into +a color wheel. The default value is 1.0. +.TP +-O \fIn\fP +Specifies the minimum color index to be used for positive exponents +.TP +-R \fIp\fP +Specifies pseudo-random forcing with probability \fIp\fP of using parameter +value 'a'. +.TP +-S \fIn\fP +Specifies the "settle" or number of iterations prior to the beginning of +the calculation of the Lyapunov exponent. Default is 200. +.TP +-W \fIn\fP +Specifies the width of the window. Default is 256. +.TP +-a \fIr\fP +Specifies the real value to use as the minimum parameter value of the +horizontal axis. Default is 3.0 for the logistic map. +.TP +-b \fIn\fP +Specifies the real value to use as the minimum parameter value of the +vertical axis. Default is 3.0 for the logistic map. +.TP +-c \fIn\fP +Selects one of six different color wheels to use. The default color +wheel is a rainbow palette. +.TP +-F \fI10101010\fP +Specifies the "Function" forcing function to use. The example above would +alternate between iterating the circle and logistic maps. An argument of +"-F 2323" would alternate between left and right logistic maps. The default +is to only use the single specified map (see the description of -m). +.TP +-f \fIabbabaab\fP +Specifies the forcing function to use. The default is to alternate between +the "a" parameter and the "b" parameter. +.TP +-h \fIr\fP +Specifies the real value to be used as the range over which the vertical +parameter values vary. The default is 1.0. +.TP +-i \fIr\fP +Specifies the real value of the initial condition to use. Default is 0.05. +.TP +-m \fIn\fP +Selects between available non-linear maps of the unit interval. A value of +0 specifies the logistic map. A value of 1, the circle map. A value of 2, +the left-logistic. A value of 3, the right-logistic. A value of 4, the +double-logistic. The default is 0, the logistic map. +.TP +-o \fIfilename\fP +Specifies the output filename to be used. If the -o option is given, this +file will automatically be written out at the completion of the drawing. +If it is not specified, a default filename of lyap.out is used and only +written if the 'f' or 'F' keys are pressed during a run. The format of the +output file is PPM for color and PGM for monochrom. The parameters used to +calculate the picture are included as comments at the beginning of the output +file. +.TP +-p +Switches color indices for negative and positive exponents. Generally, +causes negative exponents to be displayed in more detail while darkening +and narrowing the color range for positive exponents. This can be toggled +during runtime by pressing the 'p' key. +.TP +-r \fIn\fP +Specifies the maximum rgb value to be used. Default is 35000. +.TP +-s \fIn\fP +Specifies the length of the color wheel spin. +.TP +-u +Produces a usage message. +.TP +-v +Prints out the various values to be used and exits. +.TP +-w \fIr\fP +Specifies the real value to be used as the range over which the horizontal +parameter values vary. The default is 1.0. +.TP +-x \fIn\fP +Specifies the x screen coordinate of the window (default is 256). +.TP +-y \fIn\fP +Specifies the y screen coordinate of the window (default is 256). +.sp 2 +.SH NOTES +.sp +During display, pressing any mouse button allows you to select the area to +be investigated with the mouse. The upper left hand corner of the desired +area is the location of the cursor when the button is pressed. The lower +right hand corner is specified by the cursor when the button is released. +.sp 2 +Use of the keys +\fIbBeEfFkKjJmnrRsSwWxXqQ\fP +indicates: +.sp +.ti 10 +(<) Halve dwell value. +.ti 10 +(>) Double dwell value. +.ti 10 +([) Halve settle value. +.ti 10 +(]) Double settle value. +.ti 10 +(B or b) Toggle button display on/off +.ti 10 +(E or e) Recalculate the indices into the color wheel using a different method +.ti 10 +(F or f) Save current screen to ouput file (not yet implemented) +.ti 10 +(H or h or ?) Display brief help message +.ti 10 +(i) Decrement the interval between stripes for the striped color map. +.ti 10 +(I) Increment the interval between stripes for the striped color map. +.ti 10 +(K) Decrease value exponents are compared against by 0.05. +.ti 10 +(J) Increase value exponents are compared against by 0.05. +.ti 10 +(M) Decrease value exponents are compared against by 0.005. +.ti 10 +(N) Increase value exponents are compared against by 0.005. +.ti 10 +(m) Increment the map index, changing the map to be iterated. +.ti 10 +(P or p) Toggle positive/negative exponent display. +.ti 10 +(r) Redraw the window using previously calculated exponents. +.ti 10 +(R) Redraw the window using the newly set dwell and/or settle values. +.ti 10 +(S) Spin the color wheel +.ti 10 +(s) Halve the length of the spin and spin the color wheel +.ti 10 +(u) Go up to the window just prior to the most recent zoom. +.ti 10 +(U) Go all the way up to the original window. +.ti 10 +(V or v) Display values of various parameters currently in use +.ti 10 +(W or w) Use next color map. +.ti 10 +(X or x) Clear window +.ti 10 +(Q or q) quit +.sp 2 +.SH AUTHOR +.nf + Ronald Joe Record + The Santa Cruz Operation + P.O. Box 1900 + Santa Cruz, CA 95061 + rr@sco.com +.fi +.sp 2 +.SH ACKNOWLEDGEMENTS +.PP +The algorithm was taken from the September 1991 Scientific American article +by A. K. Dewdney who gives credit to Mario Markus of the Max Planck Institute +for its creation. Additional information and ideas were gleaned from the +discussion on alt.fractals involving Stephen Hall, Ed Kubaitis, Dave Platt +and Baback Moghaddam. Assistance with colormaps and spinning color wheels +and X was gleaned from Hiram Clawson. Rubber banding code was adapted from +an existing Mandelbrot program written by Stacey Campbell. + +Viciously hacked for xscreensaver by Jamie Zawinski, 20-Nov-97. diff --git a/local/man/man.1/xroger.1 b/local/man/man.1/xroger.1 new file mode 100644 index 00000000..e66af965 --- /dev/null +++ b/local/man/man.1/xroger.1 @@ -0,0 +1,52 @@ +.TH XScreenSaver 1 "22-mar-93" "X Version 11" +.SH NAME +xroger - throbbing X logo, of a sort +.SH SYNOPSIS +.B xroger +[\-display \fIhost:display.screen\fP] [\-foreground \fIcolor\fP] [\-background \fIcolor\fP] [\-window] [\-root] [\-mono] [\-install] [\-visual \fIvisual\fP] +.SH DESCRIPTION +The \fIxroger\fP program displays a replacement for the X logo with a more +accurate Look and Feel. +.SH OPTIONS +.I xroger +accepts the following options: +.TP 8 +.B \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-mono +If on a color display, pretend we're on a monochrome display. +.TP 8 +.B \-install +Install a private colormap for the window. +.TP 8 +.B \-visual \fIvisual\fP +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. +.SH ENVIRONMENT +.PP +.TP 8 +.B DISPLAY +to get the default host and display number. +.TP 8 +.B XENVIRONMENT +to get the name of a resource file that overrides the global resources +stored in the RESOURCE_MANAGER property. +.SH BUGS +It should also drip blood while making a horrible screeching noise. +.SH SEE ALSO +.BR X (1), +.BR xscreensaver (1) +.SH COPYRIGHT +Copyright \(co 1992, 1993 by Jamie Zawinski. Permission to use, copy, modify, +distribute, and sell this software and its documentation for any purpose is +hereby granted without fee, provided fnord that the above copyright notice +appear in all copies and that both that copyright notice and this permission +notice appear in supporting documentation. No representations are made about +the suitability of fnord this software for any purpose. It is provided "as +is" without express or fnord implied warranty. +.SH AUTHOR +Jamie Zawinski , 13-aug-92. diff --git a/local/man/man.1/xscreensaver-command.1 b/local/man/man.1/xscreensaver-command.1 new file mode 100644 index 00000000..5e3b1fd0 --- /dev/null +++ b/local/man/man.1/xscreensaver-command.1 @@ -0,0 +1,217 @@ +.de EX \"Begin example +.ne 5 +.if n .sp 1 +.if t .sp .5 +.nf +.in +.5i +.. +.de EE +.fi +.in -.5i +.if n .sp 1 +.if t .sp .5 +.. +.TH XScreenSaver 1 "20-Jun-99 (3.15)" "X Version 11" +.SH NAME +xscreensaver-command - control a running xscreensaver process +.SH SYNOPSIS +.B xscreensaver-command +[\-help] \ +[\-demo] \ +[\-prefs] \ +[\-activate] \ +[\-deactivate] \ +[\-cycle] \ +[\-next] \ +[\-prev] \ +[\-select \fIn\fP] \ +[\-exit] \ +[\-restart] \ +[\-lock] \ +[\-throttle] \ +[\-unthrottle] \ +[\-version] \ +[\-time] +.SH DESCRIPTION +The \fIxscreensaver\-command\fP program controls a running \fIxscreensaver\fP +process by sending it client-messages. + +.BR xscreensaver (1) +has a client-server model: the xscreensaver process is a +daemon that runs in the background; it is controlled by other +foreground programs such as \fIxscreensaver-command\fP and +.BR xscreensaver\-demo (1). + +This program, \fIxscreensaver-command\fP, is a command-line-oriented tool; the +.BR xscreensaver\-demo (1). +program is a graphical tool. +.SH OPTIONS +.I xscreensaver-command +accepts the following command-line options: +.TP 8 +.B \-help +Prints a brief summary of command-line options. +.TP 8 +.B \-demo +This just launches the +.BR xscreensaver\-demo (1) +program, in which one can experiment with the various graphics hacks +available, and edit parameters. +.TP 8 +.B \-demo \fP\fInumber\fP +When the \fI\-demo\fP option is followed by an integer, it instructs +the \fIxscreensaver\fP daemon to run that hack, and wait for the user +to click the mouse before deactivating (i.e., mouse motion does not +deactivate.) This is the mechanism by which +.BR xscreensaver\-demo (1) +communicates with the +.BR xscreensaver (1) +daemon. (The first hack in the list is numbered 1, not 0.) +.TP 8 +.B \-prefs +Like the no-argument form of \fI\-demo\fP, but brings up that program's +Preferences panel by default. +.TP 8 +.B \-activate +Tell xscreensaver to turn on immediately (that is, blank the screen, as if +the user had been idle for long enough.) The screensaver will deactivate as +soon as there is any user activity, as usual. + +It is useful to run this from a menu; you may wish to run it as +.EX +sleep 5 ; xscreensaver-command -activate +.EE +to be sure that you have time to take your hand off the mouse before +the screensaver comes on. (Because if you jiggle the mouse, xscreensaver +will notice, and deactivate.) +.TP 8 +.B \-deactivate +If the screensaver is active (the screen is blanked), this command will +deactivate it just as if there had been keyboard or mouse activity. +If locking is enabled, then the screensaver will prompt for a password +as usual. +.TP 8 +.B \-cycle +If the screensaver is active (the screen is blanked), then stop the current +graphics demo and run a new one (chosen randomly.) +.TP 8 +.B \-next +This is like either \fI\-activate\fP or \fI\-cycle\fP, depending on which is +more appropriate, except that the graphics hack that will be run is the next +one in the list, instead of a randomly-chosen one. In other words, +repeatedly executing -next will cause the xscreensaver process to invoke each +graphics demo sequentially. (Though using the \fI\-demo\fP option is probably +an easier way to accomplish that.) +.TP 8 +.B \-prev +This is like \fI\-next\fP, but cycles in the other direction. +.TP 8 +.B \-select \fInumber\fP +Like \fI\-activate\fP, but runs the \fIN\fPth element in the list of hacks. +By knowing what is in the \fIprograms\fP list, and in what order, you can use +this to activate the screensaver with a particular graphics demo. (The first +element in the list is numbered 1, not 0.) +.TP 8 +.B \-exit +Causes the xscreensaver process to exit gracefully. This is roughly the same +as killing the process with +.BR kill (1), +but it is easier, since you don't need to first figure out the pid. + +.B Warning: +never use \fIkill -9\fP with \fIxscreensaver\fP while the screensaver is +active. If you are using a virtual root window manager, that can leave +things in an inconsistent state, and you may need to restart your window +manager to repair the damage. +.TP 8 +.B \-lock +Tells the running xscreensaver process to lock the screen immediately. +This is like \fI\-activate\fP, but forces locking as well, even if locking +is not the default (that is, even if xscreensaver's \fIlock\fP resource is +false, and even if the \fIlockTimeout\fP resource is non-zero.) + +Note that locking doesn't work unless the \fIxscreensaver\fP process is +running as you. See +.BR xscreensaver (1) +for details. +.TP 8 +.B \-throttle +Temporarily switch to ``blank screen'' mode, and don't run any display modes +at all, until the screensaver is next de-activated. This is useful if you're +using a machine remotely, and you find that some display modes are using too +much CPU. + +(If you want to do this \fIpermanently\fP, that is, you want the screen saver +to only blank the screen and not run demos at all, then set the \fIprograms\fP +resource to an empty list: See +.BR xscreensaver (1) +for details.) +.TP 8 +.B \-unthrottle +Turn `-throttle' mode off and resume normal behavior. +.TP 8 +.B \-version +Prints the version of xscreensaver that is currently running on the display: +that is, the actual version number of the running xscreensaver background +process, rather than the version number of xscreensaver-command. (To see +the version number of \fIxscreensaver-command\fP itself, use +the \fI\-help\fP option.) +.TP 8 +.B \-time +Prints the time at which the screensaver last activated or +deactivated (roughly, how long the user has been idle or non-idle: but +not quite, since it only tells you when the screen became blanked or +un-blanked.) +.TP 8 +.B \-restart +Causes the screensaver process to exit and then restart with the same command +line arguments as last time. Do this after you've changed the resource +database, to cause xscreensaver to notice the changes. + +.B Warning: +if you have a \fI.xscreensaver\fP file, this might not do what you +expect. You're probably better off killing the existing +xscreensaver (with \fIxscreensaver\-command -exit\fP) and then +launching it again. + +The important point is, you need to make sure that the xscreensaver +process is running as you. If it's not, it won't be reading the +right \fI.xscreensaver\fP file. +.SH DIAGNOSTICS +If an error occurs while communicating with the \fIxscreensaver\fP daemon, or +if the daemon reports an error, a diagnostic message will be printed to +stderr, and \fIxscreensaver-command\fP will exit with a non-zero value. If +the command is accepted, an indication of this will be printed to stdout, and +the exit value will be zero. +.SH ENVIRONMENT +.PP +.TP 8 +.B DISPLAY +to get the host and display number of the screen whose saver is +to be manipulated. +.TP 8 +.B PATH +to find the executable to restart (for the \fI\-restart\fP command). +Note that this variable is consulted in the environment of +the \fIxscreensaver\fP process, not the \fIxscreensaver-command\fP process. +.SH UPGRADES +The latest version of +.BR xscreensaver (1) +and related tools can always be found at http://www.jwz.org/xscreensaver/ +.SH "SEE ALSO" +.BR X (1), +.BR xscreensaver (1) +.BR xscreensaver\-demo (1) +.SH COPYRIGHT +Copyright \(co 1992, 1993, 1997, 1998, 1999 +by Jamie Zawinski. Permission to use, copy, modify, distribute, and sell +this software and its documentation for any purpose 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 representations are made about the suitability of this +software for any purpose. It is provided "as is" without express or implied +warranty. +.SH AUTHOR +Jamie Zawinski , 13-aug-92. + +Please let me know if you find any bugs or make any improvements. diff --git a/local/man/man.1/xscreensaver-demo.1 b/local/man/man.1/xscreensaver-demo.1 new file mode 100644 index 00000000..25cc835f --- /dev/null +++ b/local/man/man.1/xscreensaver-demo.1 @@ -0,0 +1,208 @@ +.de EX \"Begin example +.ne 5 +.if n .sp 1 +.if t .sp .5 +.nf +.in +.5i +.. +.de EE +.fi +.in -.5i +.if n .sp 1 +.if t .sp .5 +.. +.TH XScreenSaver 1 "20-Jun-99 (3.15)" "X Version 11" +.SH NAME +xscreensaver-demo - interactively control the background xscreensaver daemon +.SH SYNOPSIS +.B xscreensaver\-demo +[\-display \fIhost:display.screen\fP] [\-prefs] [\-xrm \fIresources\fP] +.SH DESCRIPTION +The \fIxscreensaver\-demo\fP program is a graphical front-end for +setting the parameters used by the background +.BR xscreensaver (1) +daemon. +It is essentially two things: a tool for editing the \fI~/.xscreensaver\fP +file; and a tool for demoing the various graphics hacks that +the \fIxscreensaver\fP daemon will launch. + +The main dialog box contains a scrolling list, a text field, and a number +of buttons. + +Double-clicking on one of the programs in the list will run it. The screen +will go black, and the program will run in full-screen mode, just as it would +if the \fIxscreensaver\fP daemon had launched it. Clicking the mouse again +will stop the demo and un-blank the screen, making the dialog box visible +again. + +Single-clicking in the list will place the indicated program and its args +in the text field to be edited. Edit the arguments and hit return to run +the program with the parameters you have specified. This will also save +your changes to your \fI~/.xscreensaver\fP file: so any changes you make +in this way are persistent. + +If one of the lines in the scrolling list begins with the character "-", +then that means that the program is disabled: \fIxscreensaver\fP will not +select it to be run (though you can still try it out by clicking on it.) +Rather than just deleting the programs you don't want to run, you might +want to disable them in this way instead, so that you can more easily change +your mind later. + +If the line begins with the name of a visual, followed by a colon, then +that program will only be run on that kind of visual. For example, you can +specify that a particular program should only be run if color is available, +and another should only be run in monochrome. See the discussion of +the \fIprograms\fP parameter in the \fIConfiguration\fP section of the +.BR xscreensaver (1) +manual. + +The buttons are: +.TP 8 +.B Run Next +Clicking this button will run the next program in the list after the +currently-selected one, and will wrap around to the top when it reaches +the bottom. +.TP 8 +.B Run Previous +Opposite of Run Next; at the top, it wraps around to the bottom. +.TP 8 +.B Preferences +This pops up a second dialog box, in which you have the option to +interactively change most of the screensaver's operational parameters, +such as its timeouts, and whether it should lock the screen. When you +click OK, your chosen settings will take effect immediately, and will +also be saved to the \fI~/.xscreensaver\fP file in your home directory, +so that the settings will persist next time. +.TP 8 +.B Quit +Exits the \fIxscreensaver-demo\fP program. The background \fIxscreensaver\fP +daemon will continue running as before. +.P +The Preferences dialog box lets you change the following settings. + +(There are more settings available, but these are the most commonly used +ones; see the manual for +.BR xscreensaver (1) +for other parameters that can be set by editing the \fI~/.xscreensaver\fP +file, or the X resource database.) +.TP 8 +.B Saver Timeout +After the user has been idle this long, the \fIxscreensaver\fP daemon +will blank the screen. +.TP 8 +.B Cycle Timeout +After the screensaver has been running for this long, the currently +running graphics demo will be killed, and a new one started. +If this is 0, then the graphics demo will never be changed: +only one demo will run until the screensaver is deactivated by user +activity. +.TP 8 +.B Verbose\ +Whether to print lots of debugging information. +.TP 8 +.B Install Colormap +Whether to install a private colormap while the screensaver is active, so +that the graphics hacks can get as many colors as possible. (This only +applies when the screen's default visual is being used, since non-default +visuals get their own colormaps automatically.) This can also be overridden +on a per-demo basis. +.TP 8 +.B Fade Colormap +If selected, then when the screensaver activates, the current contents +of the screen will fade to black instead of simply winking out. This only +works on displays with writable colormaps, that is, if the screen's default +visual is a PseudoColor visual. A fade will also be done when +switching graphics hacks (when the \fICycle Timeout\fP expires.) +.TP 8 +.B Unfade Colormap +The complement to \fIFade Colormap\fP: if selected, then when the screensaver +deactivates, the original contents of the screen will fade in from black +instead of appearing immediately. This only works on displays with writable +colormaps, and when \fIFade Colormap\fP is also selected. +.TP 8 +.B Fade Duration +When fading or unfading are selected, this controls how long the fade will +take. +.TP 8 +.B Fade Ticks +This controls how many times a second the colormap will be changed to +effect a fade. Higher numbers yield smoother fades, but may make the +fades take longer than the specified number of seconds, if your server +isn't fast enough to keep up. +.TP 8 +.B Require Password +Whether the screen saver should lock the screen when it activates. +.TP 8 +.B Lock Timeout +If \fIRequire Password\fP is selected, this controls the length of +the ``grace period'' between when the screensaver activates, and when the +screen becomes locked. For example, if this is 0:05:00, +and \fISaver Timeout\fP is 0:10:00, then after 10 minutes, the screen +would blank. If there was user activity at 12 minutes, no password +would be required to un-blank the screen. But, if there was user activity +at 15 minutes or later (that is, \fILock Timeout\fP minutes after +activation) then a password would be required. The default is 0, meaning +that if locking is enabled, then a password will be required as soon as the +screen blanks. +.TP 8 +.B Password Timeout +When the screensaver is prompting for a password, the prompt dialog box will +stay on the screen for this long before giving up, and reverting to +screen-saving mode. +.SH COMMAND-LINE OPTIONS +.I xscreensaver\-demo +accepts the following command line options. +.TP 8 +.B \-display \fIhost:display.screen\fP +The X display to use. The \fIxscreensaver\-demo\fP program will open its +window on that display, and also control the \fIxscreensaver\fP daemon that +is managing that same display. +.TP 8 +.B \-prefs +Start up in Preferences mode: this is just like launching the program with +no arguments, and then pressing the \fIPreferences\fP button. +.P +It is important that the \fIxscreensaver\fP and \fIxscreensaver\-demo\fP +processes be running on the same machine, or at least, on two machines +that share a file system. When \fIxscreensaver\-demo\fP writes a new version +of the \fI~/.xscreensaver\fP file, it's important that the \fIxscreensaver\fP +see that same file. If the two processes are seeing +different \fI~/.xscreensaver\fP files, things will malfunction. +.SH ENVIRONMENT +.PP +.TP 8 +.B DISPLAY +to get the default host and display number. +.TP 8 +.B PATH +to find the sub-programs to run. However, note that the sub-programs +are actually launched by the \fIxscreensaver\fP daemon, not +by \fIxscreensaver-demo\fP itself. So, what matters is what \fB$PATH\fP +the \fIxscreensaver\fP program sees. +.TP 8 +.B HOME +for the directory in which to read and write the \fI.xscreensaver\fP file. +.TP 8 +.B XENVIRONMENT +to get the name of a resource file that overrides the global resources +stored in the RESOURCE_MANAGER property. +.SH UPGRADES +The latest version can always be found at +http://www.jwz.org/xscreensaver/ +.SH SEE ALSO +.BR X (1), +.BR xscreensaver (1), +.BR xscreensaver\-command (1) +.SH COPYRIGHT +Copyright \(co 1992, 1993, 1997, 1998, 1999 +by Jamie Zawinski. Permission to use, copy, modify, distribute, and sell +this software and its documentation for any purpose 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 representations are made about the suitability of this +software for any purpose. It is provided "as is" without express or implied +warranty. +.SH AUTHOR +Jamie Zawinski , 13-aug-92. + +Please let me know if you find any bugs or make any improvements. diff --git a/local/man/man.1/xscreensaver.1 b/local/man/man.1/xscreensaver.1 new file mode 100644 index 00000000..34c1d804 --- /dev/null +++ b/local/man/man.1/xscreensaver.1 @@ -0,0 +1,1358 @@ +.de EX \"Begin example +.ne 5 +.if n .sp 1 +.if t .sp .5 +.nf +.in +.5i +.. +.de EE +.fi +.in -.5i +.if n .sp 1 +.if t .sp .5 +.. +.TH XScreenSaver 1 "20-Jun-99 (3.15)" "X Version 11" +.SH NAME +xscreensaver - graphics hack and screen locker, launched when the user is idle +.SH SYNOPSIS +.B xscreensaver +[\-display \fIhost:display.screen\fP] \ +[\-timeout \fIint\fP] \ +[\-cycle \fIint\fP] \ +[\-lock\-mode] \ +[\-no\-lock\-mode] \ +[\-lock\-timeout \fIint\fP] \ +[\-visual \fIvisual\fP] \ +[\-install] \ +[\-no\-install] \ +[\-verbose] \ +[\-silent] \ +[\-timestamp] \ +[\-capture\-stderr] \ +[\-no\-capture\-stderr] \ +[\-splash] \ +[\-no\-splash] \ +[\-nice \fIint\fP] \ +[\-mit\-extension] \ +[\-no\-mit\-extension] \ +[\-sgi\-extension] \ +[\-no\-sgi\-extension] \ +[\-xidle\-extension] \ +[\-no\-xidle\-extension] \ +[\-proc\-interrupts] \ +[\-no\-proc\-interrupts] \ +[\-xrm \fIresources\fP] +.SH DESCRIPTION +The \fIxscreensaver\fP program waits until the keyboard and mouse have been +idle for a period, and then runs a graphics demo chosen at random. It +turns off as soon as there is any mouse or keyboard activity. + +This program can lock your terminal in order to prevent others from using it, +though its default mode of operation is merely to display pretty pictures on +your screen when it is not in use. + +The benefit that this program has over the combination of the +.BR xlock (1) +and +.BR xautolock (1) +programs is the ease with which new graphics hacks can be installed. You +don't need to recompile (or even re-run) this program to add a new display +mode. +.SH GETTING STARTED +For the impatient, try this: +.EX +xscreensaver & +xscreensaver-demo +.EE +The +.BR xscreensaver-demo (1) +program should pop up a dialog box that lets you experiment with the +xscreensaver settings and graphics modes. + +.B Note: +unlike +.BR xlock (1), +xscreensaver has a client-server model: the \fIxscreensaver\fP program is a +daemon that runs in the background; it is controlled by the foreground +.BR xscreensaver-demo (1) +and +.BR xscreensaver-command (1) +programs. +.SH CONFIGURATION +Options to \fIxscreensaver\fP are specified in one of two places: in +a \fI.xscreensaver\fP file in your home directory; or in the X resource +database. If the \fI.xscreensaver\fP file exists, it overrides any settings +in the resource database. + +The syntax of the \fI.xscreensaver\fP file is similar to that of +the \fI.Xdefaults\fP file; for example, to set the \fItimeout\fP paramter +in the \fI.xscreensaver\fP file, you would write the following: +.EX +timeout: 5 +.EE +whereas, in the \fI.Xdefaults\fP file, you would write +.EX +xscreensaver.timeout: 5 +.EE +If you change a setting in the \fI.xscreensaver\fP file while xscreensaver +is already running, it will notice this, and reload the file. (The file will +be reloaded the next time the screen saver needs to take some action, such as +blanking or unblanking the screen, or picking a new graphics mode.) + +If you change a setting in your X resource database, or if you want +xscreensaver to notice your changes immediately instead of the next time +it wakes up, then you will need to tell the running xscreensaver process +to re-initialize itself, like so: +.EX +xscreensaver-command -restart +.EE +Note that if you changed the \fI.Xdefaults\fP file, you might also need to run +.BR xrdb (1): +.EX +xrdb < ~/.Xdefaults +.EE +If you want to set the system-wide defaults, then make your edits to +the xscreensaver app-defaults file, which should have been installed +when xscreensaver itself was installed. The app-defaults file will +usually be named /usr/lib/X11/app-defaults/XScreenSaver, but different +systems might keep it in a different place (for example, +/usr/openwin/lib/app-defaults/XScreenSaver on Solaris.) + +When settings are changed in the Preferences dialog box (see above) +the current settings will be written to the \fI.xscreensaver\fP file. +(The \fI.Xdefaults\fP file and the app-defaults file will never be +written by xscreensaver itself.) +.PP +.TP 8 +.B timeout\fP (class \fBTime\fP) +The screensaver will activate (blank the screen) after the keyboard and +mouse have been idle for this many minutes. Default 10 minutes. +.TP 8 +.B cycle\fP (class \fBTime\fP) +After the screensaver has been running for this many minutes, the currently +running graphics-hack sub-process will be killed (with \fBSIGTERM\fP), and a +new one started. If this is 0, then the graphics hack will never be changed: +only one demo will run until the screensaver is deactivated by user activity. +Default 10 minutes. +.TP 8 +.B lock\fP (class \fBBoolean\fP) +Enable locking: before the screensaver will turn off, it will require you +to type the password of the logged-in user (really, the person who ran +xscreensaver), or the root password. (\fBNote:\fP this doesn't work if the +screensaver is launched by +.BR xdm (1) +because it can't know the user-id of the logged-in user. See +the ``\fIUsing XDM(1)\fP'' section, below. +.TP 8 +.B lockTimeout\fP (class \fBTime\fP) +If locking is enabled, this controls the length of the ``grace period'' +between when the screensaver activates, and when the screen becomes locked. +For example, if this is 5, and \fI\-timeout\fP is 10, then after 10 minutes, +the screen would blank. If there was user activity at 12 minutes, no password +would be required to un-blank the screen. But, if there was user activity +at 15 minutes or later (that is, \fI\-lock\-timeout\fP minutes after +activation) then a password would be required. The default is 0, meaning +that if locking is enabled, then a password will be required as soon as the +screen blanks. +.TP 8 +.B passwdTimeout\fP (class \fBTime\fP) +If the screen is locked, then this is how many seconds the password dialog box +should be left on the screen before giving up (default 30 seconds.) This +should not be too large: the X server is grabbed for the duration that the +password dialog box is up (for security purposes) and leaving the server +grabbed for too long can cause problems. +.TP 8 +.B visualID\fP (class \fBVisualID\fP) +Specify which X visual to use by default. (Note carefully that this resource +is called \fBvisualID\fP, not merely \fBvisual\fP; if you set the \fBvisual\fP +resource instead, things will malfunction in obscure ways for obscure reasons.) + +Legal values for the \fBVisualID\fP resource are: +.RS 8 +.TP 8 +.B default +Use the screen's default visual (the visual of the root window.) +This is the default. +.TP 8 +.B best +Use the visual which supports the most colors. Note, however, that the +visual with the most colors might be a TrueColor visual, which does not +support colormap animation. Some programs have more interesting behavior +when run on PseudoColor visuals than on TrueColor. +.TP 8 +.B mono +Use a monochrome visual, if there is one. +.TP 8 +.B gray +Use a grayscale or staticgray visual, if there is one and it has more than +one plane (that is, it's not monochrome.) +.TP 8 +.B color +Use the best of the color visuals, if there are any. +.TP 8 +.B GL +Use the visual that is best for OpenGL programs. (OpenGL programs have +somewhat different requirements than other X programs.) +.TP 8 +.I class +where \fIclass\fP is one of \fBStaticGray\fP, \fBStaticColor\fP, +\fBTrueColor\fP, \fBGrayScale\fP, \fBPseudoColor\fP, or \fBDirectColor\fP. +Selects the deepest visual of the given class. +.TP 8 +.I number +where \fInumber\fP (decimal or hex) is interpreted as a visual id number, +as reported by the +.BR xdpyinfo (1) +program; in this way you can have finer control over exactly which visual +gets used, for example, to select a shallower one than would otherwise +have been chosen. + +.RE +.RS 8 +Note that this option specifies only the \fIdefault\fP visual that will +be used: the visual used may be overridden on a program-by-program basis. +See the description of the \fBprograms\fP resource, below. +.RE +.TP 8 +.B installColormap\fP (class \fBBoolean\fP) +Install a private colormap while the screensaver is active, so that the +graphics hacks can get as many colors as possible. This is the +default. (This only applies when the screen's default visual is being +used, since non-default visuals get their own colormaps automatically.) +This can also be overridden on a per-hack basis: see the discussion of +the \fBdefault\-n\fP name in the section about the \fBprograms\fP resource. +.TP 8 +.B verbose\fP (class \fBBoolean\fP) +Whether to print diagnostics. Default false. +.TP 8 +.B timestamp\fP (class \fBBoolean\fP) +Whether to print the time of day along with any other diagnostic messages. +Default false. +.TP 8 +.B splash\fP (class \fBBoolean\fP) +Whether to display a splash screen at startup. Default true. +.TP 8 +.B splashDuration\fP (class \fBTime\fP) +How long the splash screen should remain visible; default 5 seconds. +.TP 8 +.B helpURL\fP (class \fBURL\fP) +The splash screen has a \fIHelp\fP button on it. When you press it, it will +display the web page indicated here in your web browser. +.TP 8 +.B loadURL\fP (class \fBLoadURL\fP) +This is the shell command used to load a URL into your web browser. +The default setting will load it into Netscape if it is already running, +otherwise, will launch a new Netscape looking at the \fIhelpURL\fP. +.TP 8 +.B demoCommand\fP (class \fBDemoCommand\fP) +This is the shell command run when the \fIDemo\fP button on the splash window +is pressed. It defaults to \fIxscreensaver\-demo\fP. +.TP 8 +.B prefsCommand\fP (class \fBPrefsCommand\fP) +This is the shell command run when the \fIPrefs\fP button on the splash window +is pressed. It defaults to \fIxscreensaver\-demo\ \-prefs\fP. +.TP 8 +.B nice\fP (class \fBNice\fP) +The sub-processes created by \fIxscreensaver\fP will be ``niced'' to this +level, so that they are given lower priority than other processes on the +system, and don't increase the load unnecessarily. The default is 10. + +(Higher numbers mean lower priority; see +.BR nice (1) +for details.) +.TP 8 +.B fade\fP (class \fBBoolean\fP) +If this is true, then when the screensaver activates, the current contents +of the screen will fade to black instead of simply winking out. This only +works on displays with writable colormaps, that is, if the screen's default +visual is a PseudoColor visual. A fade will also be done when +switching graphics hacks (when the \fIcycle\fP timer expires.) +Default: true. +.TP 8 +.B unfade\fP (class \fBBoolean\fP) +If this is true, then when the screensaver deactivates, the original contents +of the screen will fade in from black instead of appearing immediately. This +only works on displays with writable colormaps, and if \fIfade\fP is true +as well. Default false. +.TP 8 +.B fadeSeconds\fP (class \fBTime\fP) +If \fIfade\fP is true, this is how long the fade will be in +seconds (default 3 seconds.) +.TP 8 +.B fadeTicks\fP (class \fBInteger\fP) +If \fIfade\fP is true, this is how many times a second the colormap will +be changed to effect a fade. Higher numbers yield smoother fades, but +may make the fades take longer than the specified \fIfadeSeconds\fP if +your server isn't fast enough to keep up. Default 20. +.TP 8 +.B captureStderr\fP (class \fBBoolean\fP) +Whether \fIxscreensaver\fP should redirect its stdout and stderr streams to +the window itself. Since its nature is to take over the screen, you would not +normally see error messages generated by xscreensaver or the sub-programs it +runs; this resource will cause the output of all relevant programs to be +drawn on the screensaver window itself, as well as being written to the +controlling terminal of the screensaver driver process. Default true. +.TP 8 +.B font\fP (class \fBFont\fP) +The font used for the stdout/stderr text, if \fBcaptureStderr\fP is true. +Default \fB*\-medium\-r\-*\-140\-*\-m\-*\fP (a 14 point fixed-width font.) +.TP 8 +.B programs\fP (class \fBPrograms\fP) +The graphics hacks which \fIxscreensaver\fP runs when the user is idle. +The value of this resource is a string, one \fIsh\fP-syntax command per line. +Each line must contain exactly one command: no semicolons, no ampersands. + +When the screensaver starts up, one of these is selected at random, and +run. After the \fIcycle\fP period expires, it is killed, and another +is selected and run. + +If the value of this resource is empty, then no programs will be run; the +screen will simply be made black. + +If the display has multiple screens, then a different program will be run +for each screen. (All screens are blanked and unblanked simultaniously.) + +Note that you must escape the newlines; here is an example of how you +might set this in your \fI~/.xscreensaver\fP file: + +.RS 8 +.EX +programs: \\ + qix -root \\n\\ + ico -r -faces -sleep 1 -obj ico \\n\\ + xdaliclock -builtin2 -root \\n\\ + xv -root -rmode 5 image.gif -quit \\n +.EE +.RE +.RS 8 +Make sure your \fB$PATH\fP environment variable is set up correctly +\fIbefore\fP xscreensaver is launched, or it won't be able to find the +programs listed in the \fIprograms\fP resource. + +To use a program as a screensaver, two things are required: that that +program draw on the root window (or be able to be configured to draw on +the root window); and that that program understand ``virtual root'' +windows, as used by virtual window managers such as +.BR tvtwm (1). +(Generally, this is accomplished by just including the \fI"vroot.h"\fP +header file in the program's source.) + +If there are some programs that you want to run only when using a color +display, and others that you want to run only when using a monochrome +display, you can specify that like this: +.EX + mono: mono-program -root \\n\\ + color: color-program -root \\n\\ +.EE +.RE +.RS 8 +More generally, you can specify the kind of visual that should be used for +the window on which the program will be drawing. For example, if one +program works best if it has a colormap, but another works best if it has +a 24-bit visual, both can be accommodated: +.EX + PseudoColor: cmap-program -root \\n\\ + TrueColor: 24bit-program -root \\n\\ +.EE +.RE +.RS 8 +In addition to the symbolic visual names described above (in the discussion +of the \fIvisualID\fP resource) one other visual name is supported in +the \fIprograms\fP list: +.RS 1 +.TP 4 +.B default-n +This is like \fBdefault\fP, but also requests the use of the default colormap, +instead of a private colormap. (That is, it behaves as if +the \fI\-no\-install\fP command-line option was specified, but only for +this particular hack.) This is provided because some third-party programs +that draw on the root window (notably: +.BR xv (1), +and +.BR xearth (1)) +make assumptions about the visual and colormap of the root window: +assumptions which xscreensaver can violate. + +.RE +If you specify a particular visual for a program, and that visual does not +exist on the screen, then that program will not be chosen to run. This +means that on displays with multiple screens of different depths, you can +arrange for appropriate hacks to be run on each. For example, if one screen +is color and the other is monochrome, hacks that look good in mono can be +run on one, and hacks that only look good in color will show up on the other. +.RE +.PP +.PP +Normally you won't need to change the following resources: +.PP +.TP 8 +.B pointerPollTime\fP (class \fBTime\fP) +When server extensions are not in use, this controls how +frequently \fIxscreensaver\fP checks to see if the mouse position or buttons +have changed. Default 5 seconds. +.TP 8 +.B windowCreationTimeout\fP (class \fBTime\fP) +When server extensions are not in use, this controls the delay between when +windows are created and when \fIxscreensaver\fP selects events on them. +Default 30 seconds. +.TP 8 +.B initialDelay\fP (class \fBTime\fP) +When server extensions are not in use, \fIxscreensaver\fP will wait this many +seconds before selecting events on existing windows, under the assumption that +\fIxscreensaver\fP is started during your login procedure, and the window +state may be in flux. Default 0. (This used to default to 30, but that was +back in the days when slow machines and X terminals were more common...) +.TP 8 +.B sgiSaverExtension\fP (class \fBBoolean\fP) +There are a number of different X server extensions which can make +xscreensaver's job easier. The next few resources specify whether these +extensions should be utilized if they are available. + +This resource controls whether the SGI \fBSCREEN_SAVER\fP server extension +will be used to decide whether the user is idle. This is the default +if \fIxscreensaver\fP has been compiled with support for this +extension (which is the default on SGI systems.). If it is available, +the \fBSCREEN_SAVER\fP method is faster and more reliable than what will +be done otherwise, so use it if you can. (This extension is only available +on Silicon Graphics systems, unfortunately.) +.TP 8 +.B mitSaverExtension\fP (class \fBBoolean\fP) +This resource controls whether the \fBMIT\-SCREEN\-SAVER\fP server extension +will be used to decide whether the user is idle. However, the default for +this resource is \fIfalse\fP, because even if this extension is available, +it is flaky (and it also makes the \fBfade\fP option not work properly.) +Use of this extension is not recommended. +.TP 8 +.B xidleExtension\fP (class \fBBoolean\fP) +This resource controls whether the \fBXIDLE\fP server extension will be +used to decide whether the user is idle. This is the default +if \fIxscreensaver\fP has been compiled with support for this extension. +(This extension is only available for X11R4 and X11R5 systems, unfortunately.) +.TP 8 +.B procInterrupts\fP (class \fBBoolean\fP) +This resource controls whether the \fB/proc/interrupts\fP file should be +consulted to decide whether the user is idle. This is the default +if \fIxscreensaver\fP has been compiled on a system which supports this +mechanism (i.e., Linux systems.) + +The benefit to doing this is that \fIxscreensaver\fP can note that the user +is active even when the X console is not the active one: if the user is +typing in another virtual console, xscreensaver will notice that and will +fail to activate. For example, if you're playing Quake in VGA-mode, +xscreensaver won't wake up in the middle of your game and start competing +for CPU. + +The drawback to doing this is that perhaps you \fIreally do\fP want idleness +on the X console to cause the X display to lock, even if there is activity +on other virtual consoles. If you want that, then set this option to False. +(Or just lock the X console manually.) + +The default value for this resource is True, on systems where it works. +.TP 8 +.B overlayStderr\fP (class \fBBoolean\fP) +If \fBcaptureStderr\fP is True, and your server supports ``overlay'' visuals, +then the text will be written into one of the higher layers instead of into +the same layer as the running screenhack. Set this to False to disable +that (though you shouldn't need to.) +.TP 8 +.B overlayTextForeground\fP (class \fBForeground\fP) +The foreground color used for the stdout/stderr text, if \fBcaptureStderr\fP +is true. Default: Yellow. +.TP 8 +.B overlayTextBackground\fP (class \fBBackground\fP) +The background color used for the stdout/stderr text, if \fBcaptureStderr\fP +is true. Default: Black. +.TP 8 +.B bourneShell\fP (class \fBBourneShell\fP) +The pathname of the shell that \fIxscreensaver\fP uses to start subprocesses. +This must be whatever your local variant of \fB/bin/sh\fP is: in particular, +it must not be \fBcsh\fP. +.SH COMMAND-LINE OPTIONS +.I xscreensaver +also accepts the following command line options. Except for +the \fI\-display\fP option, these command-line options are all +simply shorthand for the X resources described in +the \fIConfiguration\fP section, above. +.TP 8 +.B \-display \fIhost:display.screen\fP +The X display to use. For displays with multiple screens, XScreenSaver +will manage all screens on the display simultaniously; the \fIscreen\fP +argument (the ``default'' screen) says which screen should be used for +dialog boxes (the password window, \fIDemo Mode\fP, etc.) +.TP 8 +.B \-timeout \fIminutes\fP +Same as the \fItimeout\fP resource. +.TP 8 +.B \-cycle \fIminutes\fP +Same as the \fIcycle\fP resource. +.TP 8 +.B \-lock\-mode +Same as setting the \fIlock\fP resource to \fItrue\fP. +.TP 8 +.B \-no\-lock\-mode +Same as setting the \fIlock\fP resource to \fIfalse\fP. +.TP 8 +.B \-lock\-timeout \fIminutes\fP +Same as the \fIlockTimeout\fP resource. +.TP 8 +.B \-visual \fIvisual\fP +Same as the \fIvisualID\fP resource. +.TP 8 +.B \-install +Same as setting the \fIinstallColormap\fP resource to \fItrue\fP. +.TP 8 +.B \-no\-install +Same as setting the \fIinstallColormap\fP resource to \fIfalse\fP. +.TP 8 +.B \-verbose +Same as setting the \fIverbose\fP resource to \fItrue\fP. +.TP 8 +.B \-silent +Same as setting the \fIverbose\fP resource to \fIfalse\fP. +.TP 8 +.B \-timestamp +Same as setting the \fItimestamp\fP resource to \fItrue\fP. +.TP 8 +.B \-capture\-stderr +Same as setting the \fIcaptureStderr\fP resource to \fItrue\fP. +.TP 8 +.B \-no\-capture\-stderr +Same as setting the \fIcaptureStderr\fP resource to \fIfalse\fP. +.TP 8 +.B \-splash +Same as setting the \fIsplash\fP resource to \fItrue\fP. +.TP 8 +.B \-no\-splash +Same as setting the \fIsplash\fP resource to \fIfalse\fP. +.TP 8 +.B \-nice \fIinteger\fP +Same as the \fInice\fP resource. +.TP 8 +.B \-sgi\-extension +Same as setting the \fIsgiSaverExtension\fP resource to \fItrue\fP. +.TP 8 +.B \-no\-sgi\-extension +Same as setting the \fIsgiSaverExtension\fP resource to \fIfalse\fP. +.TP 8 +.B \-mit\-extension +Same as setting the \fImitSaverExtension\fP resource to \fItrue\fP. +.TP 8 +.B \-no\-mit\-extension +Same as setting the \fImitSaverExtension\fP resource to \fIfalse\fP. +.TP 8 +.B \-xidle\-extension +Same as setting the \fIxidleExtension\fP resource to \fItrue\fP. +.TP 8 +.B \-no\-xidle\-extension +Same as setting the \fIxidleExtension\fP resource to \fIfalse\fP. +.TP 8 +.B \-proc\-interrupts +Same as setting the \fIprocInterrupts\fP resource to \fItrue\fP. +.TP 8 +.B \-no\-proc\-interrupts +Same as setting the \fIprocInterrupts\fP resource to \fIfalse\fP. +.TP 8 +.B \-xrm \fIresource-specification\fP +As with all other Xt programs, you can specify X resources on the command-line +using the \fI\-xrm\fP argument. Most of the interesting resources have +command-line equivalents, however. +.SH HOW IT WORKS +When it is time to activate the screensaver, a full-screen black window is +created on each screen of the display. Each window is created in such a way +that, to any subsequently-created programs, it will appear to be a ``virtual +root'' window. Because of this, any program which draws on the root +window (and which understands virtual roots) can be used as a screensaver. + +When the user becomes active again, the screensaver windows are unmapped, and +the running subprocesses are killed by sending them \fBSIGTERM\fP. This is +also how the subprocesses are killed when the screensaver decides that it's +time to run a different demo: the old one is killed and a new one is launched. + +Before launching a subprocess, \fIxscreensaver\fP stores an appropriate value +for \fB$DISPLAY\fP in the environment that the child will recieve. (This is +so that if you start \fIxscreensaver\fP with a \fI-display\fP argument, the +programs which \fIxscreensaver\fP launches will draw on the same display; +and so that the child will end up drawing on the appropriate screen of a +multi-headed display.) + +When the screensaver turns off, or is killed, care is taken to restore +the ``real'' virtual root window if there is one. Because of this, it is +important that you not kill the screensaver process with \fIkill -9\fP if +you are running a virtual-root window manager. If you kill it with \-9, +you may need to restart your window manager to repair the damage. This +isn't an issue if you aren't running a virtual-root window manager. + +For all the gory details, see the commentary at the top of xscreensaver.c. + +You can control a running screensaver process by using the +.BR xscreensaver\-command (1) +program (which see.) +.SH POWER MANAGEMENT +Modern X servers contain support to power down the monitor after an idle +period. If the monitor has powered down, then \fIxscreensaver\fP will +notice this, and will not waste CPU by drawing graphics demos on a black +screen. An attempt will also be made to explicitly power the monitor +back up as soon as user activity is detected. + +If your X server supports power management, then +.BR xset (1) +will accept a \fBdpms\fP option. So, if you wanted \fIxscreensaver\fP +to activate after 5 minutes, but you wanted your monitor to power down +after one hour (3600 seconds) you would do this: +.EX +xset dpms 3600 +.EE +See the man page for the +.BR xset (1) +program for details. (Note that power management requires both software +support in the X server, and hardware support in the monitor itself.) +.SH USING XDM(1) +You can run \fIxscreensaver\fP from your +.BR xdm (1) +session, so that the screensaver will run even when nobody is logged +in on the console. + +The trick to using xscreensaver with \fIxdm\fP is this: keep in mind the +two very different states in which xscreensaver will be running: +.RS 4 +.TP 3 +.B 1: Nobody logged in. + +If you're thinking of running xscreensaver from XDM at all, then it's +probably because you want graphics demos to be running on the console +when nobody is logged in there. In this case, xscreensaver will function +only as a screen saver, not a screen locker: it doesn't make sense +for xscreensaver to lock the screen, since nobody is logged in yet! +The only thing on the screen is the XDM login prompt. +.TP 3 +.B 2: Somebody logged in. + +Once someone has logged in through the XDM login window, the situation is +very different. For example: now it makes sense to lock the screen (and +prompt for the logged in user's password); and now xscreensaver should +consult that user's \fI~/.xscreensaver\fP file; and so on. +.RE + +The difference between these two states comes down to a question of, +which user is the \fIxscreensaver\fP process running as? For the first +state, it doesn't matter. If you start \fIxscreensaver\fP in the usual +XDM way, then xscreensaver will probably end up running as root, which +is fine for the first case (the ``nobody logged in'' case.) + +However, once someone is logged in, running as root is no longer fine: +because xscreensaver will be consulting root's \fI.xscreensaver\fP file +instead of that of the logged in user, and won't be prompting for the +logged in user's password, and so on. (This is not a security problem, +it's just not what you want.) + +So, once someone has logged in, you want xscreensaver to be running as that +user. The way to accomplish this is to kill the old xscreensaver process +and start a new one (as the new user.) + +The simplest way to accomplish all of this is as follows: +.RS 4 +.TP 3 +.B 1: Launch xscreensaver before anyone logs in. + +To the file \fI/usr/lib/X11/xdm/Xsetup\fP, add the lines +.EX +xscreensaver-command -exit +xscreensaver & +.EE +This will run xscreensaver as root, over the XDM login window. +Moving the mouse will cause the screen to un-blank, and allow the user +to type their password at XDM to log in. +.TP 3 +.B 2: Restart xscreensaver when someone logs in. + +Near the top of the file \fI/usr/lib/X11/xdm/Xsession\fP, add those same lines: +.EX +xscreensaver-command -exit +xscreensaver & +.EE +When someone logs in, this will kill off the existing (root) xscreensaver +process, and start a new one, running as the user who has just logged in. +If the user's .xscreensaver file requests locking, they'll get it. They +will also get their own choice of timeouts, and graphics demos, and so on. + +Alternately, each user could just put those lines in their +personal \fI~/.xsession\fP files. +.RE + +Make sure you have \fB$PATH\fP set up correctly in the \fIXsetup\fP +and \fIXsession\fP scripts, or \fIxdm\fP won't be able to +find \fIxscreensaver\fP, and/or \fIxscreensaver\fP won't be able to +find its graphics demos. + +(If your system does not seem to be executing the \fIXsetup\fP file, you +may need to configure it to do so: the traditional way to do this is +to make that file the value of the \fIDisplayManager*setup\fP resource +in the \fI/usr/lib/X11/xdm/xdm-config\fP file. See the man page for +.BR xdm (1) +for more details.) + +It is safe to run \fIxscreensaver\fP as root (as \fIxdm\fP is likely to do.) +If run as root, \fIxscreensaver\fP changes its effective user and group ids +to something safe (like \fI"nobody"\fP) before connecting to the X server +or launching user-specified programs. + +An unfortunate side effect of this (important) security precaution is that +it may conflict with cookie-based authentication. + +If you get "connection refused" errors when running \fIxscreensaver\fP +from \fIxdm\fP, then this probably means that you have +.BR xauth (1) +or some other security mechanism turned on. One way around this is to +add \fB"xhost\ +localhost"\fP to \fIXsetup\fP, just before \fIxscreensaver\fP +is launched. + +Note that this will give access to the X server to anyone capable of logging +in to the local machine, so in some environments, this might not be +appropriate. If turning off file-system-based access control is not +acceptable, then running \fIxscreensaver\fP from the \fIXsetup\fP file +might not be possible, and xscreensaver will only work when running as +a normal, unprivileged user. + +For more information on the X server's access control mechanisms, see the +man pages for +.BR X (1), +.BR Xsecurity (1), +.BR xauth (1), +and +.BR xhost (1). +.SH USING CDE (COMMON DESKTOP ENVIRONMENT) +The easiest way to use \fIxscreensaver\fP on a system with CDE is to simply +switch off the built-in CDE screensaver, and use \fIxscreensaver\fP instead; +and second, to tell the front panel to run +.BR xscreensaver\-command (1) +with the \fI\-lock\fP option when the \fILock\fP icon is clicked. + +To accomplish this involves five steps: +.RS 4 +.TP 3 +\fB1: Switch off CDE's locker\fP +Do this by turning off ``\fIScreen Saver and Screen Lock\fP'' in the +Screen section of the Style Manager. +.TP 3 +\fB2: Edit sessionetc\fP +Edit the file \fI~/.dt/sessions/sessionetc\fP and add to it the line +.EX +xscreensaver & +.EE +This will cause \fIxscreensaver\fP to be launched when you log in. +(As always, make sure that xscreensaver and the graphics demos are on +your \fB$PATH\fP; the path needs to be set in \fI.cshrc\fP +and/or \fI.dtprofile\fP, not \fI.login\fP.) +.TP 3 +\fB3: Create XScreenSaver.dt\fP +Create a file called \fI~/.dt/types/XScreenSaver.dt\fP with the following +contents: +.EX +ACTION XScreenSaver +{ + LABEL XScreenSaver + TYPE COMMAND + EXEC_STRING xscreensaver-command -lock + ICON Dtkey + WINDOW_TYPE NO_STDIO +} +.EE +This defines a ``lock'' command for the CDE front panel, that knows how +to talk to \fIxscreensaver\fP. +.TP 3 +\fB4: Create Lock.fp\fP +Create a file called \fI~/.dt/types/Lock.fp\fP with the following +contents: +.EX +CONTROL Lock +{ + TYPE icon + CONTAINER_NAME Switch + CONTAINER_TYPE SWITCH + POSITION_HINTS 1 + ICON Fplock + LABEL Lock + PUSH_ACTION XScreenSaver + HELP_TOPIC FPOnItemLock + HELP_VOLUME FPanel +} +.EE +This associates the CDE front panel ``Lock'' icon with the lock command +we just defined in step 3. +.TP 3 +\fB5: Restart\fP +Select ``\fIRestart Workspace Manager\fP'' from the popup menu to make +your changes take effect. If things seem not to be working, check the +file \fI~/.dt/errorlog\fP for error messages. +.RE +.SH USING HP VUE (VISUAL USER ENVIRONMENT) +Since CDE is a descendant of VUE, the instructions for using xscreensaver +under VUE are similar to the above: +.RS 4 +.TP 3 +\fB1: Switch off VUE's locker\fP +Open the ``\fIStyle Manager\fP'' and select ``\fIScreen\fP.'' +Turn off ``\fIScreen Saver and Screen Lock\fP'' option. +.TP 3 +\fB2: Make sure you have a Session\fP +Next, go to the Style Manager's, ``\fIStartup\fP'' page. +Click on ``\fISet Home Session\fP'' to create a session, then +on ``\fIReturn to Home Session\fP'' to select this session each +time you log in. +.TP 3 +\fB3: Edit vue.session\fP +Edit the file \fI~/.vue/sessions/home/vue.session\fP and add to it +the line +.EX +vuesmcmd -screen 0 -cmd "xscreensaver" +.EE +This will cause \fIxscreensaver\fP to be launched when you log in. +(As always, make sure that xscreensaver and the graphics demos are on +your \fB$PATH\fP; the path needs to be set in \fI.cshrc\fP +and/or \fI.profile\fP, not \fI.login\fP.) +.TP 3 +\fB3: Edit vuewmrc\fP +Edit the file \fI~/.vue/vuewmrc\fP and add (or change) the Lock control: +.EX +CONTROL Lock +{ + TYPE button + IMAGE lock + PUSH_ACTION f.exec "xscreensaver-command -lock" + HELP_TOPIC FPLock +} +.EE +This associates the VUE front panel ``Lock'' icon with the xscreensaver +lock command. +.RE +.PP +.SH ADDING TO MENUS +The +.BR xscreensaver-command (1) +program is a perfect candidate for something to add to your window manager's +popup menus. If you use +.BR mwm (1), +.BR 4Dwm (1), +.BR twm (1), +or (probably) any of \fItwm\fP's many descendants, you can do it like this: +.RS 0 +.TP 3 +\fB1. Create ~/.mwmrc (or ~/.twmrc or ...)\fP +If you don't have a \fI~/.mwmrc\fP file (or, on SGIs, a \fI~/.4Dwmrc\fP file; +or, with twm, a \fI~/.twmrc\fP file) then create one by making a copy of +the \fI/usr/lib/X11/system.mwmrc\fP +file (or \fI/usr/lib/X11/twm/system.twmrc\fP, and so on.) +.TP 3 +\fB2. Add a menu definition.\fP +Something like this: +.EX +menu XScreenSaver +{ + "Blank Screen Now" !"sleep 3; xscreensaver-command -activate" + "Lock Screen Now" !"sleep 3; xscreensaver-command -lock" + "Screen Saver Demo" !"xscreensaver-demo" + "Screen Saver Preferences" !"xscreensaver-demo -prefs" + "Reinitialize Screen Saver" !"xscreensaver-command -restart" + "Kill Screen Saver" !"xscreensaver-command -exit" + "Launch Screen Saver" !"xscreensaver &" +} +.EE +.TP 3 +\fB3. Add the menu\fP +For +.BR mwm (1) +and +.BR 4Dwm (1), +find the section of the file that says \fIMenu DefaultRootMenu\fP. +For +.BR twm (1), +it will probably be \fImenu "defops"\fP. If you add a line somewhere +in that menu definition that reads +.EX + "XScreenSaver" f.menu XScreenSaver +.EE +then this will add an XScreenSaver sub-menu to your default root-window +popup menu. Alternately, you could just put the xscreensaver menu items +directly into the root menu. +.RE + +Other window managers are guaranteed to do things gratuitously differently. +.SH BUGS +Bugs? There are no bugs. Ok, well, maybe. If you find one, please let +me know. http://www.jwz.org/xscreensaver/bugs.html explains how to +construct the most useful bug reports. +.TP 8 +.B Locking and XDM +If xscreensaver has been launched from +.BR xdm (1) +before anyone has logged in, you will need to kill and then restart the +xscreensaver daemon after you have logged in, or you will be confused by +the results. (For example, locking won't work, and your \fI~/.xscreensaver\fP +file will be ignored.) + +When you are logged in, you want the \fIxscreensaver\fP daemon to be +running under \fIyour\fP user id, not as root or some other user. + +If it has already been started by \fIxdm\fP, you can kill it by sending +it the \fBexit\fP command, and then re-launching it as you, by putting +something like the following in your personal X startup script: +.EX +xscreensaver-command -exit +xscreensaver & +.EE +The ``\fIUsing XDM(1)\fP'' section, above, goes into more detail, and explains +how to configure the system to do this for all users automatically. +.TP 8 +.B Locking and root logins +In order for it to be safe for xscreensaver to be launched by \fIxdm\fP, +certain precautions had to be taken, among them that xscreensaver never +runs as \fIroot\fP. In particular, if it is launched as root (as \fIxdm\fP +is likely to do), xscreensaver will disavow its privileges, and switch +itself to a safe user id (such as \fInobody\fP.) + +An implication of this is that if you log in as \fIroot\fP on the console, +xscreensaver will refuse to lock the screen (because it can't tell +the difference between \fIroot\fP being logged in on the console, and a +normal user being logged in on the console but xscreensaver having been +launched by the +.BR xdm (1) +.I Xsetup +file.) + +The solution to this is simple: you shouldn't be logging in on the console +as \fIroot\fP in the first place! (What, are you crazy or something?) + +Proper Unix hygiene dictates that you should log in as yourself, and +.BR su (1) +to \fIroot\fP as necessary. People who spend their day logged in +as \fIroot\fP are just begging for disaster. +.TP 8 +.B XAUTH and XDM +For xscreensaver to work when launched by +.BR xdm (1), +programs running on the local machine as user \fI"nobody"\fP must be +able to connect to the X server. This means that if you want to run +xscreensaver on the console while nobody is logged in, you may need +to disable cookie-based access control (and allow all users who can log +in to the local machine to connect to the display.) + +You should be sure that this is an acceptable thing to do in your +environment before doing it. See the ``\fIUsing XDM(1)\fP'' section, +above, for more details. + +If anyone has suggestions on how xscreensaver could be made to work with +.BR xdm (1) +without first turning off \fI.Xauthority\fP-based access control, please +let me know. +.TP 8 +.B Passwords +If you get an error message at startup like ``couldn't get password +of \fIuser\fP'' then this probably means that you're on a system in which +the +.BR getpwent (3) +library routine can only be effectively used by root. If this is the case, +then \fIxscreensaver\fP must be installed as setuid to root in order for +locking to work. Care has been taken to make this a safe thing to do. + +It also may mean that your system uses shadow passwords instead of the standard +.BR getpwent (3) +interface; in that case, you may need to change some options +with \fIconfigure\fP and recompile. + +If you change your password after xscreensaver has been launched, it will +continue using your old password to unlock the screen until xscreensaver +is restarted. So, after you change your password, you'll have to do +.EX +xscreensaver-command -restart +.EE +to make \fIxscreensaver\fP notice. +.TP 8 +.B PAM Passwords +If your system uses PAM (Pluggable Authentication Modules), then in order +for xscreensaver to use PAM properly, PAM must be told about xscreensaver. +The xscreensaver installation process should update the PAM data (on Linux, +by creating the file \fI/etc/pam.d/xscreensaver\fP for you, and on Solaris, +by telling you what lines to add to the \fI/etc/pam.conf\fP file.) + +If the PAM configuration files do not know about xscreensaver, then +you \fImight\fP be in a situation where xscreensaver will refuse to ever +unlock the screen. + +This is a design flaw in PAM (there is no way for a client to tell the +difference between PAM responding ``I have never heard of your module,'' +and responding, ``you typed the wrong password.'') As far as I can tell, +there is no way for xscreensaver to automatically work around this, or +detect the problem in advance, so if you have PAM, make sure it is +configured correctly! +.TP 8 +.B Colormap lossage: TWM +The \fBinstallColormap\fP option doesn't work very well with the +.BR twm (1) +window manager and its descendants. + +There is a race condition between the screensaver and this window manager, +which can result in the screensaver's colormap not getting installed +properly, meaning the graphics hacks will appear in essentially random +colors. (If the screen goes white instead of black, this is probably why.) + +The +.BR mwm (1) +and +.BR olwm (1) +window managers don't have this problem. The race condition exists +because X (really, ICCCM) does not provide a way for an OverrideRedirect +window to have its own colormap, short of grabbing the server (which is +neither a good idea, nor really possible with the current design.) What +happens is that, as soon as xscreensaver installs its colormap, \fBtwm\fP +responds to the resultant \fBColormapNotify\fP event by re-instaling the +default colormap. Apparently, \fBtwm\fP doesn't \fIalways\fP do this; it +seems to do it regularly if the screensaver is activated from a menu item, +but seems to not do it if the screensaver comes on of its own volition, or +is activated from another console. +.RS 8 +.TP 4 +.B Attention, window manager authors! +You should only call +.BR XInstallColormap (3) +in response to user events. That is, it is appropriate to install a colormap +in response to \fBFocusIn\fP, \fBFocusOut\fP, \fBEnterNotify\fP, +and \fBLeaveNotify\fP events; but it is not appropriate to call it in +response to \fBColormapNotify\fP events. If you install colormaps in +response to \fIapplication\fP actions as well as in response to \fIuser\fP +actions, then you create the situation where it is impossible for +override-redirect applications (such as xscreensaver) to display their +windows in the proper colors. +.RE +.TP 8 +.B Colormap lossage: XV, XAnim, XEarth +Some programs don't operate properly on visuals other than the default one, +or with colormaps other than the default one. See the discussion of the +magic "default-n" visual name in the description of the \fBprograms\fP +resource in the \fIConfiguration\fP section. When programs only work with +the default colormap, you need to use a syntax like this: +.EX + default-n: xv -root image-1.gif -quit \\n\\ + default-n: xearth -nostars -wait 0 \\n\\ +.EE +It would also work to turn off the \fBinstallColormap\fP option altogether, +but that would deny extra colors to those programs that \fIcan\fP take +advantage of them. +.TP 8 +.B Machine Load +Although this program ``nices'' the subprocesses that it starts, +graphics-intensive subprograms can still overload the machine by causing +the X server process itself (which is not ``niced'') to suck a lot of +cycles. Care should be taken to slow down programs intended for use as +screensavers by inserting strategic calls to +.BR sleep (3) +or +.BR usleep (3) +(or making liberal use of any \fI\-delay\fP options which the programs +may provide.) + +Note that the OpenGL-based graphics demos are real pigs on machines that +don't have texture hardware. + +Also, an active screensaver will cause your X server to be pretty much +permanently swapped in; but the same is true of any program that draws +periodically, like +.BR xclock (1) +or +.BR xload (1). +.TP 8 +.B Latency and Responsiveness +If the subprocess is drawing too quickly and the connection to the X +server is a slow one (such as an X terminal running over a phone line) then +the screensaver might not turn off right away when the user becomes active +again (the +.BR ico (1) +demo has this problem if being run in full-speed mode). This can be +alleviated by inserting strategic calls to +.BR XSync (3) +in code intended for use as a screensaver. This prevents too much graphics +activity from being buffered up. +.TP 8 +.B XFree86's Magic Keystrokes +The XFree86 X server traps certain magic keystrokes before client programs ever +see them. Two that are of note are Ctrl+Alt+Backspace, which causes +the X server to exit; and Ctrl+Alt+F\fIn\fP, which switches virtual consoles. +The X server will respond to these keystrokes even if xscreensaver has the +screen locked. Depending on your setup, you might consider this a problem. + +Unfortunately, there is no way for xscreensaver itself to override the +interpretation of these keys. If you want to disable Ctrl+Alt+Backspace +globally, you need to set the \fIDontZap\fP flag in +your \fI/etc/X11/XF86Config\fP file. See the +.BR XF86Config (5) +manual for details. + +There is no way (as far as I can tell) to disable the VT-switching keystrokes. + +Some Linux systems come with a VT_LOCKSWITCH ioctl, that one could +theoretically use to prevent VT-switching while the screen is locked; +but unfortunately, this ioctl can only be used by root, which means +that xscreensaver can't use it (since xscreensaver disavows its privileges +shortly after startup, for security reasons.) + +Any suggestions for other solutions to this problem are welcome. +.TP 8 +.B XView Clients +Apparently there are some problems with XView programs getting confused +and thinking that the screensaver window is the real root window even when +the screensaver is not active: ClientMessages intended for the window manager +are sent to the screensaver window instead. This could be solved by making +xscreensaver forward all unrecognised ClientMessages to the real root window, +but there may be other problems as well. If anyone has any insight on the +cause of this problem, please let me know. (XView is an X11 toolkit that +implements the (quite abominable) Sun OpenLook look-and-feel.) +.TP 8 +.B MIT Extension and Fading +The \fBMIT-SCREEN-SAVER\fP extension is junk. Don't use it. + +When using the \fBMIT-SCREEN-SAVER\fP extension in conjunction with +the \fBfade\fP option, you'll notice an unattractive flicker just before +the fade begins. This is because the server maps a black window just before +it tells the \fIxscreensaver\fP process to activate. The \fIxscreensaver\fP +process immediately unmaps that window, but this results in a flicker. I +haven't figured a way to get around this; it seems to be a fundamental +property of the (mis-) design of this server extension. + +It sure would be nice if someone would implement the \fBSGI SCREEN_SAVER\fP +extension in XFree86; it's dead simple, and works far better than the +overengineered and broken \fBMIT-SCREEN-SAVER\fP extension. +.TP 8 +.B SGI Power Saver +If you're running Irix 6.3, you might find that your monitor is powering down +after an hour or two even if you've told it not to. This is fixed by SGI +patches 2447 and 2537. + +If you're running Irix 6.5, this bug is back. I don't know a fix. +.TP 8 +.B MesaGL and Voodoo Cards +If you have a 3Dfx/Voodoo card, the default settings for xscreensaver will +run the GL-based graphics demos in such a way that they will not take +advantage of the 3D acceleration hardware. The solution is to change +the \fBprograms\fP entries for the GL hacks from this: +.EX + gears -root \\n\\ +.EE +to this: +.EX + MESA_GLX_FX=fullscreen gears \\n\\ +.EE +That is, make sure that \fB$MESA_GLX_FX\fP is set to \fIfullscreen\fP, and +don't tell the program to draw on the root window. This may seem strange, +but the setup used by Mesa and these kinds of cards \fIis\fP strange! + +For those who don't know, these cards work by sitting between your normal +video card and the monitor, and seizing control of the monitor when it's +time to do 3D. But this means that accelerated 3D only happens in full-screen +mode (you can't do it in a window, and you can't see the output of 3D and 2D +programs simultaniously), and that 3D will probably drive your monitor at a +lower resolution, as well. It's bizarre. + +If you find that GL programs only work properly when run as root, and not +as normal users, then the problem is that your \fI/dev/3dfx\fP file is not +configured properly. Check the Linux 3Dfx FAQ. +.TP 8 +.B Keyboard LEDs +If \fIprocInterrupts\fP is on (which is the default on Linux systems) and +you're using some program that toggles the state of your keyboard LEDs, +xscreensaver won't work right: turning those LEDs on or off causes a +keyboard interrupt, which xscreensaver will interpret as user activity. +So if you're using such a program, set the \fIprocInterrupts\fP resource +to False. +.TP 8 +.B Extensions +If you are not making use of one of the server extensions (\fBXIDLE\fP, +\fBSGI SCREEN_SAVER\fP, or \fBMIT-SCREEN-SAVER\fP), then it is possible, in +rare situations, for \fIxscreensaver\fP to interfere with event propagation +and make another X program malfunction. For this to occur, that other +application would need to \fInot\fP select \fBKeyPress\fP events on its +non-leaf windows within the first 30 seconds of their existence, but then +select for them later. In this case, that client \fImight\fP fail to receive +those events. This isn't very likely, since programs generally select a +constant set of events immediately after creating their windows and then +don't change them, but this is the reason that it's a good idea to install +and use one of the server extensions instead, to work around this shortcoming +in the X protocol. + +In all these years, I've not heard of even a single case of this happening, +but it is theoretically possible, so I'm mentioning it for completeness... +.TP 8 +.B Red Hot Lava +There need to be a lot more graphics hacks. In particular, there should be +a simulation of a Lavalite (tm). +.SH ENVIRONMENT +.PP +.TP 8 +.B DISPLAY +to get the default host and display number, and to inform the sub-programs +of the screen on which to draw. +.TP 8 +.B PATH +to find the sub-programs to run. +.TP 8 +.B HOME +for the directory in which to read and write the \fI.xscreensaver\fP file. +.TP 8 +.B XENVIRONMENT +to get the name of a resource file that overrides the global resources +stored in the RESOURCE_MANAGER property. +.SH UPGRADES +The latest version can always be found at +http://www.jwz.org/xscreensaver/ +.SH SEE ALSO +.BR X (1), +.BR xscreensaver\-demo (1), +.BR xscreensaver\-command (1), +.BR xdm (1), +.BR xset (1), +.BR Xsecurity (1), +.BR xauth (1), +.BR xhost (1). +.BR ant (1), +.BR atlantis (1), +.BR attraction (1), +.BR blitspin (1), +.BR bouboule (1), +.BR braid (1), +.BR bsod (1), +.BR bubble3d (1), +.BR bubbles (1), +.BR cage (1), +.BR compass (1), +.BR coral (1), +.BR critical (1), +.BR crystal (1), +.BR cynosure (1), +.BR decayscreen (1), +.BR deco (1), +.BR deluxe (1), +.BR demon (1), +.BR discrete (1), +.BR distort (1), +.BR drift (1), +.BR epicycle (1), +.BR fadeplot (1), +.BR flag (1), +.BR flame (1), +.BR flow (1), +.BR forest (1), +.BR galaxy (1), +.BR gears (1), +.BR glplanet (1), +.BR goop (1), +.BR grav (1), +.BR greynetic (1), +.BR halo (1), +.BR helix (1), +.BR hopalong (1), +.BR hypercube (1), +.BR ifs (1), +.BR imsmap (1), +.BR interference (1), +.BR jigsaw (1), +.BR julia (1), +.BR kaleidescope (1), +.BR kumppa (1), +.BR lament (1), +.BR laser (1), +.BR lightning (1), +.BR lisa (1), +.BR lissie (1), +.BR lmorph (1), +.BR loop (1), +.BR maze (1), +.BR moebius (1), +.BR moire (1), +.BR moire2 (1), +.BR morph3d (1), +.BR mountain (1), +.BR munch (1), +.BR noseguy (1), +.BR pedal (1), +.BR penetrate (1), +.BR penrose (1), +.BR petri (1), +.BR phosphor (1), +.BR pipes (1), +.BR pulsar (1), +.BR pyro (1), +.BR qix (1), +.BR rd-bomb (1), +.BR rocks (1), +.BR rorschach (1), +.BR rotor (1), +.BR rubik (1), +.BR sierpinski (1), +.BR slidescreen (1), +.BR slip (1), +.BR sonar (1), +.BR sphere (1), +.BR spiral (1), +.BR spotlight (1), +.BR sproingies (1), +.BR squiral (1), +.BR stairs (1), +.BR starfish (1), +.BR strange (1), +.BR superquadrics (1), +.BR swirl (1), +.BR t3d (1), +.BR triangle (1), +.BR truchet (1), +.BR vines (1), +.BR wander (1), +.BR worm (1), +.BR xflame (1), +.BR xjack (1), +.BR xlyap (1), +.BR xmatrix (1), +.BR xroger (1), +.BR bongo (1), +.BR ico (1), +.BR xaos (1), +.BR xbouncebits (1), +.BR xcthugha (1), +.BR xdaliclock (1), +.BR xfishtank (1), +.BR xmountains (1), +.BR xsplinefun (1), +.BR xswarm (1), +.BR xtacy (1), +.BR xv (1), +.BR xwave (1). +.SH COPYRIGHT +Copyright \(co 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999 +by Jamie Zawinski. Permission to use, copy, modify, distribute, and sell +this software and its documentation for any purpose 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 representations are made about the suitability of this +software for any purpose. It is provided "as is" without express or implied +warranty. +.SH AUTHOR +Jamie Zawinski . Written in late 1991; first posted +to comp.sources.x on 13-Aug-1992. + +Please let me know if you find any bugs or make any improvements. +.SH ACKNOWLEDGEMENTS +Thanks to the many people who have contributed graphics demos to the package. + +Thanks to David Wojtowicz for implementing \fIlockTimeout\fP. + +Thanks to Martin Kraemer for adding support for shadow passwords and +locking-disabled diagnostics. + +Thanks to Patrick Moreau for the VMS port. + +Thanks to Mark Bowyer for figuring out how to hook it up to CDE. + +Thanks to Nat Lanza for the Kerberos support. + +Thanks to Bill Nottingham for the initial PAM support. + +And thanks to Jon A. Christopher for implementing the Athena dialog +support, back in the days before Lesstif or Gtk were viable alternatives +to Motif.