From ffcd2e7e3da122dbba5c4188e05d3a63d0ede26e Mon Sep 17 00:00:00 2001 From: Zygo Blaxell Date: Fri, 30 May 2014 12:15:27 -0400 Subject: [PATCH] From http://www.jwz.org/xscreensaver/xscreensaver-5.25.tar.gz -rw-r--r-- 1 zblaxell zblaxell 8760532 Dec 9 03:46 xscreensaver-5.25.tar.gz b33ce25ca14be090bcf685a54b0f0e5fcd3acb17 xscreensaver-5.25.tar.gz --- OSX/Makefile | 9 +- OSX/SaverRunner.plist | 10 +- OSX/Updater.m | 26 +++ OSX/Updater.plist | 10 +- OSX/XScreenSaver.plist | 4 +- OSX/XScreenSaverView.m | 56 ++++- OSX/bindist.rtf | 4 +- OSX/iSaverRunner.plist | 10 +- OSX/installer.sh | 41 ++-- OSX/updates.xml | 22 +- README | 9 +- driver/XScreenSaver.ad.in | 4 +- driver/XScreenSaver_ad.h | 158 +++++++------- driver/xscreensaver-getimage.c | 2 +- hacks/config/README | 4 +- hacks/config/rd-bomb.xml | 9 +- hacks/glx/Makefile.in | 2 +- hacks/glx/antinspect.man | 56 +++++ hacks/glx/antmaze.man | 52 +++++ hacks/glx/antspotlight.man | 56 +++++ hacks/glx/atlantis.man | 78 +++++++ hacks/glx/atunnel.man | 83 ++++++++ hacks/glx/blinkbox.man | 73 +++++++ hacks/glx/blocktube.man | 73 +++++++ hacks/glx/boing.man | 105 ++++++++++ hacks/glx/bouncingcow.man | 73 +++++++ hacks/glx/boxed.man | 56 +++++ hacks/glx/bubble3d.man | 62 ++++++ hacks/glx/cage.man | 61 ++++++ hacks/glx/carousel.man | 109 ++++++++++ hacks/glx/circuit.man | 72 +++++++ hacks/glx/companioncube.man | 85 ++++++++ hacks/glx/crackberg.man | 123 +++++++++++ hacks/glx/cube21.man | 147 +++++++++++++ hacks/glx/cubenetic.man | 89 ++++++++ hacks/glx/cubestorm.man | 77 +++++++ hacks/glx/cubicgrid.man | 83 ++++++++ hacks/glx/dangerball.man | 72 +++++++ hacks/glx/endgame.man | 72 +++++++ hacks/glx/engine.man | 80 +++++++ hacks/glx/extrusion.man | 71 +++++++ hacks/glx/flipflop.man | 95 +++++++++ hacks/glx/flipscreen3d.man | 61 ++++++ hacks/glx/fliptext.man | 114 ++++++++++ hacks/glx/flurry.man | 73 +++++++ hacks/glx/flyingtoasters.man | 86 ++++++++ hacks/glx/gears.man | 79 +++++++ hacks/glx/geodesic.man | 79 +++++++ hacks/glx/gflux.man | 111 ++++++++++ hacks/glx/glblur.man | 76 +++++++ hacks/glx/glcells.man | 97 +++++++++ hacks/glx/gleidescope.man | 77 +++++++ hacks/glx/glhanoi.man | 83 ++++++++ hacks/glx/glknots.man | 81 ++++++++ hacks/glx/glmatrix.man | 116 +++++++++++ hacks/glx/glplanet.man | 70 +++++++ hacks/glx/glschool.man | 126 +++++++++++ hacks/glx/glslideshow.man | 131 ++++++++++++ hacks/glx/glsnake.man | 98 +++++++++ hacks/glx/gltext.man | 123 +++++++++++ hacks/glx/hilbert.man | 103 +++++++++ hacks/glx/hypertorus.man | 188 +++++++++++++++++ hacks/glx/hypnowheel.man | 80 +++++++ hacks/glx/jigglypuff.man | 121 +++++++++++ hacks/glx/jigsaw.man | 90 ++++++++ hacks/glx/juggler3d.man | 183 ++++++++++++++++ hacks/glx/kaleidocycle.man | 96 +++++++++ hacks/glx/klein.man | 299 +++++++++++++++++++++++++++ hacks/glx/lament.man | 68 ++++++ hacks/glx/lavalite.man | 160 ++++++++++++++ hacks/glx/lockward.man | 79 +++++++ hacks/glx/menger.man | 78 +++++++ hacks/glx/mirrorblob.man | 107 ++++++++++ hacks/glx/moebius.man | 65 ++++++ hacks/glx/moebiusgears.man | 86 ++++++++ hacks/glx/molecule.man | 160 ++++++++++++++ hacks/glx/morph3d.man | 57 +++++ hacks/glx/noof.man | 52 +++++ hacks/glx/photopile.man | 113 ++++++++++ hacks/glx/pinion.man | 82 ++++++++ hacks/glx/pipes.man | 85 ++++++++ hacks/glx/polyhedra.man | 124 +++++++++++ hacks/glx/polytopes.man | 207 +++++++++++++++++++ hacks/glx/providence.man | 66 ++++++ hacks/glx/pulsar.man | 102 +++++++++ hacks/glx/quasicrystal.man | 84 ++++++++ hacks/glx/queens.man | 66 ++++++ hacks/glx/rubik.man | 69 +++++++ hacks/glx/rubikblocks.man | 117 +++++++++++ hacks/glx/sballs.man | 125 +++++++++++ hacks/glx/sierpinski3d.man | 67 ++++++ hacks/glx/skytentacles.man | 102 +++++++++ hacks/glx/sonar.man | 169 +++++++++++++++ hacks/glx/spheremonics.man | 92 +++++++++ hacks/glx/sproingies.man | 68 ++++++ hacks/glx/stairs.man | 56 +++++ hacks/glx/starwars.man | 181 ++++++++++++++++ hacks/glx/stonerview.man | 53 +++++ hacks/glx/superquadrics.man | 70 +++++++ hacks/glx/surfaces.man | 127 ++++++++++++ hacks/glx/tangram.man | 67 ++++++ hacks/glx/timetunnel.man | 105 ++++++++++ hacks/glx/topblock.man | 170 +++++++++++++++ hacks/glx/tronbit.man | 79 +++++++ hacks/glx/unknownpleasures.man | 74 +++++++ hacks/glx/voronoi.man | 88 ++++++++ hacks/glx/xscreensaver-gl-helper.man | 33 +++ po/POTFILES.in | 2 +- utils/grabclient.c | 2 +- utils/version.h | 2 +- xscreensaver.spec | 2 +- 111 files changed, 8828 insertions(+), 157 deletions(-) create mode 100644 hacks/glx/antinspect.man create mode 100644 hacks/glx/antmaze.man create mode 100644 hacks/glx/antspotlight.man create mode 100644 hacks/glx/atlantis.man create mode 100644 hacks/glx/atunnel.man create mode 100644 hacks/glx/blinkbox.man create mode 100644 hacks/glx/blocktube.man create mode 100644 hacks/glx/boing.man create mode 100644 hacks/glx/bouncingcow.man create mode 100644 hacks/glx/boxed.man create mode 100644 hacks/glx/bubble3d.man create mode 100644 hacks/glx/cage.man create mode 100644 hacks/glx/carousel.man create mode 100644 hacks/glx/circuit.man create mode 100644 hacks/glx/companioncube.man create mode 100644 hacks/glx/crackberg.man create mode 100644 hacks/glx/cube21.man create mode 100644 hacks/glx/cubenetic.man create mode 100644 hacks/glx/cubestorm.man create mode 100644 hacks/glx/cubicgrid.man create mode 100644 hacks/glx/dangerball.man create mode 100644 hacks/glx/endgame.man create mode 100644 hacks/glx/engine.man create mode 100644 hacks/glx/extrusion.man create mode 100644 hacks/glx/flipflop.man create mode 100644 hacks/glx/flipscreen3d.man create mode 100644 hacks/glx/fliptext.man create mode 100644 hacks/glx/flurry.man create mode 100644 hacks/glx/flyingtoasters.man create mode 100644 hacks/glx/gears.man create mode 100644 hacks/glx/geodesic.man create mode 100644 hacks/glx/gflux.man create mode 100644 hacks/glx/glblur.man create mode 100644 hacks/glx/glcells.man create mode 100644 hacks/glx/gleidescope.man create mode 100644 hacks/glx/glhanoi.man create mode 100644 hacks/glx/glknots.man create mode 100644 hacks/glx/glmatrix.man create mode 100644 hacks/glx/glplanet.man create mode 100644 hacks/glx/glschool.man create mode 100644 hacks/glx/glslideshow.man create mode 100644 hacks/glx/glsnake.man create mode 100644 hacks/glx/gltext.man create mode 100644 hacks/glx/hilbert.man create mode 100644 hacks/glx/hypertorus.man create mode 100644 hacks/glx/hypnowheel.man create mode 100644 hacks/glx/jigglypuff.man create mode 100644 hacks/glx/jigsaw.man create mode 100644 hacks/glx/juggler3d.man create mode 100644 hacks/glx/kaleidocycle.man create mode 100644 hacks/glx/klein.man create mode 100644 hacks/glx/lament.man create mode 100644 hacks/glx/lavalite.man create mode 100644 hacks/glx/lockward.man create mode 100644 hacks/glx/menger.man create mode 100644 hacks/glx/mirrorblob.man create mode 100644 hacks/glx/moebius.man create mode 100644 hacks/glx/moebiusgears.man create mode 100644 hacks/glx/molecule.man create mode 100644 hacks/glx/morph3d.man create mode 100644 hacks/glx/noof.man create mode 100644 hacks/glx/photopile.man create mode 100644 hacks/glx/pinion.man create mode 100644 hacks/glx/pipes.man create mode 100644 hacks/glx/polyhedra.man create mode 100644 hacks/glx/polytopes.man create mode 100644 hacks/glx/providence.man create mode 100644 hacks/glx/pulsar.man create mode 100644 hacks/glx/quasicrystal.man create mode 100644 hacks/glx/queens.man create mode 100644 hacks/glx/rubik.man create mode 100644 hacks/glx/rubikblocks.man create mode 100644 hacks/glx/sballs.man create mode 100644 hacks/glx/sierpinski3d.man create mode 100644 hacks/glx/skytentacles.man create mode 100644 hacks/glx/sonar.man create mode 100644 hacks/glx/spheremonics.man create mode 100644 hacks/glx/sproingies.man create mode 100644 hacks/glx/stairs.man create mode 100644 hacks/glx/starwars.man create mode 100644 hacks/glx/stonerview.man create mode 100644 hacks/glx/superquadrics.man create mode 100644 hacks/glx/surfaces.man create mode 100644 hacks/glx/tangram.man create mode 100644 hacks/glx/timetunnel.man create mode 100644 hacks/glx/topblock.man create mode 100644 hacks/glx/tronbit.man create mode 100644 hacks/glx/unknownpleasures.man create mode 100644 hacks/glx/voronoi.man create mode 100644 hacks/glx/xscreensaver-gl-helper.man diff --git a/OSX/Makefile b/OSX/Makefile index a4dff53c..28588ee8 100644 --- a/OSX/Makefile +++ b/OSX/Makefile @@ -111,10 +111,11 @@ updates.xml:: test_sig:: @ \ - U=../version.h ; \ + U=../utils/version.h ; \ V=`sed -n 's/[^0-9]*\([0-9]\.[0-9][^. ;]*\).*/\1/p' < $$U` ; \ - V=`echo $$V | sed 's/\.//g'` ; \ - ZIP="../archive/DaliClock-$$V.dmg" ; \ + BASE="xscreensaver-$$V" ; \ + OUTDIR="../archive" ; \ + DMG="$$OUTDIR/$$BASE.dmg" ; \ SIG=`sed -n 's/^.*dsaSignature="\(.*\)".*/\1/p' updates.xml` ; \ PUB="sparkle_dsa_pub.pem" ; \ NN="t.$$$$" ; \ @@ -124,7 +125,7 @@ test_sig:: echo "$$SIG " | base64 -D > "$$SIGB" ; \ set -e ; \ for OPENSSL in /usr/bin/openssl /opt/local/bin/openssl ; do \ - $$OPENSSL dgst -sha1 -binary < "$$ZIP" > "$$HASH" ; \ + $$OPENSSL dgst -sha1 -binary < "$$DMG" > "$$HASH" ; \ /bin/echo -n "$$OPENSSL `$$OPENSSL version`: " ; \ $$OPENSSL dgst -dss1 -verify "$$PUB" -signature "$$SIGB" "$$HASH" ; \ done ; \ diff --git a/OSX/SaverRunner.plist b/OSX/SaverRunner.plist index 17374270..7ba00ce8 100644 --- a/OSX/SaverRunner.plist +++ b/OSX/SaverRunner.plist @@ -7,7 +7,7 @@ CFBundleExecutable ${EXECUTABLE_NAME} CFBundleGetInfoString - 5.24 + 5.25 CFBundleIconFile SaverRunner CFBundleIdentifier @@ -15,21 +15,21 @@ CFBundleInfoDictionaryVersion 6.0 CFBundleLongVersionString - 5.24 + 5.25 CFBundleName ${PRODUCT_NAME} CFBundlePackageType APPL CFBundleShortVersionString - 5.24 + 5.25 CFBundleSignature ???? CFBundleVersion - 5.24 + 5.25 LSMinimumSystemVersion ${MACOSX_DEPLOYMENT_TARGET} NSHumanReadableCopyright - 5.24 + 5.25 NSMainNibFile SaverRunner NSPrincipalClass diff --git a/OSX/Updater.m b/OSX/Updater.m index 94a3afae..f7cd8c68 100644 --- a/OSX/Updater.m +++ b/OSX/Updater.m @@ -29,6 +29,8 @@ NSUserDefaults *defs = [NSUserDefaults standardUserDefaults]; [defs registerDefaults:UPDATER_DEFAULTS]; + [updater setDelegate:self]; + // Launch the updater thread. [updater checkForUpdatesInBackground]; @@ -41,6 +43,30 @@ repeats:YES]; } +// Delegate method that lets us append extra info to the system-info URL. +// +- (NSArray *) feedParametersForUpdater:(SUUpdater *)updater + sendingSystemProfile:(BOOL)sending +{ + // Get the name of the saver that invoked us, and include that in the + // system info. + NSString *saver = [[[NSProcessInfo + processInfo]environment]objectForKey: + @"XSCREENSAVER_CLASSPATH"]; + if (! saver) return nil; + NSString *head = @"org.jwz.xscreensaver."; + if ([saver hasPrefix:head]) + saver = [saver substringFromIndex:[head length]]; + + return @[ @{ @"key": @"saver", + @"value": saver, + @"displayKey": @"Current Saver", + @"displayValue": saver + } + ]; +} + + - (void) exitWhenDone:(NSTimer *)timer { SUUpdater *updater = [timer userInfo]; diff --git a/OSX/Updater.plist b/OSX/Updater.plist index 9ac2e0e9..6ba6c89b 100644 --- a/OSX/Updater.plist +++ b/OSX/Updater.plist @@ -7,7 +7,7 @@ CFBundleExecutable ${EXECUTABLE_NAME} CFBundleGetInfoString - 5.24 + 5.25 CFBundleIconFile SaverRunner CFBundleIdentifier @@ -15,23 +15,23 @@ CFBundleInfoDictionaryVersion 6.0 CFBundleLongVersionString - 5.24 + 5.25 CFBundleName ${PRODUCT_NAME} CFBundlePackageType APPL CFBundleShortVersionString - 5.24 + 5.25 CFBundleSignature ???? CFBundleVersion - 5.24 + 5.25 LSMinimumSystemVersion ${MACOSX_DEPLOYMENT_TARGET} LSUIElement NSHumanReadableCopyright - 5.24 + 5.25 NSMainNibFile Updater NSPrincipalClass diff --git a/OSX/XScreenSaver.plist b/OSX/XScreenSaver.plist index 790a6ba2..f3638267 100644 --- a/OSX/XScreenSaver.plist +++ b/OSX/XScreenSaver.plist @@ -15,11 +15,11 @@ CFBundlePackageType BNDL CFBundleShortVersionString - 5.24 + 5.25 CFBundleSignature ???? CFBundleVersion - 5.24 + 5.25 LSMinimumSystemVersion 10.4 NSMainNibFile diff --git a/OSX/XScreenSaverView.m b/OSX/XScreenSaverView.m index a02a5067..beb17fd7 100644 --- a/OSX/XScreenSaverView.m +++ b/OSX/XScreenSaverView.m @@ -1930,18 +1930,60 @@ double current_device_rotation (void) static BOOL checked_p = NO; if (checked_p) return; checked_p = YES; + + // If it's off, don't bother running the updater. Otherwise, the + // updater will decide if it's time to hit the network. if (! get_boolean_resource (xdpy, SUSUEnableAutomaticChecksKey, SUSUEnableAutomaticChecksKey)) - return; // If it's off, don't bother running the updater. + return; + + NSString *updater = @"XScreenSaverUpdater.app"; - // Otherwise, the updater will decide if it's time to hit the network. - NSString *updater = @"XScreenSaverUpdater"; - if (! [[NSWorkspace sharedWorkspace] - launchApplication:updater showIcon:NO autolaunch:NO]) { - NSLog(@"Unable to launch %@", updater); + // There may be multiple copies of the updater: e.g., one in /Applications + // and one in the mounted installer DMG! It's important that we run the + // one from the disk and not the DMG, so search for the right one. + // + NSWorkspace *workspace = [NSWorkspace sharedWorkspace]; + NSBundle *bundle = [NSBundle bundleForClass:[self class]]; + NSArray *search = + @[[[bundle bundlePath] stringByDeletingLastPathComponent], + [@"~/Library/Screen Savers" stringByExpandingTildeInPath], + @"/Library/Screen Savers", + @"/System/Library/Screen Savers", + @"/Applications", + @"/Applications/Utilities"]; + NSString *app_path = nil; + for (NSString *dir in search) { + NSString *p = [dir stringByAppendingPathComponent:updater]; + if ([[NSFileManager defaultManager] fileExistsAtPath:p]) { + app_path = p; + break; + } } -# endif // USE_IPHONE + + if (! app_path) + app_path = [workspace fullPathForApplication:updater]; + + if (app_path && [app_path hasPrefix:@"/Volumes/XScreenSaver "]) + app_path = 0; // The DMG version will not do. + + if (!app_path) { + NSLog(@"Unable to find %@", updater); + return; + } + + NSError *err = nil; + if (! [workspace launchApplicationAtURL:[NSURL fileURLWithPath:app_path] + options:(NSWorkspaceLaunchWithoutAddingToRecents | + NSWorkspaceLaunchWithoutActivation | + NSWorkspaceLaunchAndHide) + configuration:nil + error:&err]) { + NSLog(@"Unable to launch %@: %@", updater, err); + } + +# endif // !USE_IPHONE } diff --git a/OSX/bindist.rtf b/OSX/bindist.rtf index 3a303392..43550ab2 100644 --- a/OSX/bindist.rtf +++ b/OSX/bindist.rtf @@ -16,8 +16,8 @@ \b0 by Jamie Zawinski\ and many others\ \ -version 5.24\ -07-Dec-2013\ +version 5.25\ +09-Dec-2013\ \ {\field{\*\fldinst{HYPERLINK "http://www.jwz.org/xscreensaver/"}}{\fldrslt \cf2 \ul \ulc2 http://www.jwz.org/xscreensaver/}}\ \pard\pardeftab720 diff --git a/OSX/iSaverRunner.plist b/OSX/iSaverRunner.plist index 21a0019d..e5456e0f 100644 --- a/OSX/iSaverRunner.plist +++ b/OSX/iSaverRunner.plist @@ -5,11 +5,11 @@ CFBundleName ${PRODUCT_NAME} NSHumanReadableCopyright - 5.24 + 5.25 CFBundleDevelopmentRegion English CFBundleVersion - 5.24 + 5.25 NSMainNibFile iSaverRunner CFBundlePackageType @@ -19,7 +19,7 @@ UIViewControllerBasedStatusBarAppearance CFBundleShortVersionString - 5.24 + 5.25 CFBundleInfoDictionaryVersion 6.0 UIRequiredDeviceCapabilities @@ -37,7 +37,7 @@ UIInterfaceOrientationLandscapeRight CFBundleLongVersionString - 5.24 + 5.25 CFBundleIdentifier ${BUNDLE_IDENTIFIER} CFBundleSignature @@ -62,6 +62,6 @@ CFBundleDisplayName ${PRODUCT_NAME} CFBundleGetInfoString - 5.24 + 5.25 diff --git a/OSX/installer.sh b/OSX/installer.sh index e2a155dd..06a1a135 100755 --- a/OSX/installer.sh +++ b/OSX/installer.sh @@ -19,6 +19,8 @@ #exec >/tmp/xscreensaver.log 2>&1 #set -x +export PATH="/bin:/sbin:/usr/bin:/usr/sbin:$PATH" + REQUIRED_SPACE=140 # MB. Highly approximate. DEBUG=0 @@ -66,17 +68,30 @@ fi mkdir -p "$DST1" || error "Unable to create directory $DST1/" mkdir -p "$DST2" || error "Unable to create directory $DST2/" -# Install the savers in /System/Library/Screen Savers/ -# Plus the updater. +# Install the savers and the updater in /System/Library/Screen Savers/ +# Install the other apps in /Applications/ # -for f in *.saver "$UPDATER" ; do - DD="$DST1/$f" +for f in *.{saver,app} ; do + EXT=`echo "$f" | sed 's/^.*\.//'` + if [ "$EXT" = "app" -a "$f" != "$UPDATER" ]; then + DST="$DST2" + else + DST="$DST1" + fi + DD="$DST/$f" echo "Installing $DD" >&2 rm -rf "$DD" || error "Unable to delete $DD" - cp -pR "$f" "$DST1/" || error "Unable to install $f in $DST1/" + cp -pR "$f" "$DST/" || error "Unable to install $f in $DST/" + + # Eliminate the "this was downloaded from the interweb" warning. xattr -r -d com.apple.quarantine "$DD" - # If this saver is also installed in the per-user directory, + if [ "$EXT" = "app" ]; then + # Eliminate the "this is from an unknown developer" warning. + spctl --add "$DD" + fi + + # If this saver or app is also installed in the per-user directory, # delete that copy so that we don't have conflicts. # if [ "$DEBUG" = 0 ]; then @@ -84,20 +99,6 @@ for f in *.saver "$UPDATER" ; do fi done - -# Install the apps in /Applications/ -# But not the updater. -# -for f in *.app ; do - if [ "$f" != "$UPDATER" ]; then - DD="$DST2/$f" - echo "Installing $DD" >&2 - rm -rf "$DD" || error "Unable to delete $DD" - cp -pR "$f" "$DST2/" || error "Unable to install $f in $DST2/" - xattr -r -d com.apple.quarantine "$DD" - fi -done - # Launch System Preferences with the Screen Saver pane selected. # open /System/Library/PreferencePanes/DesktopScreenEffectsPref.prefPane & diff --git a/OSX/updates.xml b/OSX/updates.xml index 5b773823..c1196643 100644 --- a/OSX/updates.xml +++ b/OSX/updates.xml @@ -7,6 +7,17 @@ http://www.jwz.org/xscreensaver/updates.xml Updates to xscreensaver. en + + Version 5.24 + http://www.jwz.org/xscreensaver/xscreensaver-5.24.dmg + • Updated feed-loading for recent Flickr changes.
• Updated `webcollage' for recent Google changes.
• Added Instagram and Bing as `webcollage' image sources.
• Updated to latest autoconf.
• Bug fixes.]]> + Sat, 07 Dec 2013 19:06:56 -0800 + + Version 5.23 http://www.jwz.org/xscreensaver/xscreensaver-5.23.dmg @@ -18,17 +29,6 @@ length="47275494" type="application/octet-stream" /> - - Version 5.22 - http://www.jwz.org/xscreensaver/xscreensaver-5.22.dmg - • Performance improvements for `interference'.
• Fixed possible crashes in `apple2', `maze', `pacman', `polyominoes', `fireworkx', `engine'.
• Fix for `bumps' in 64 bit.
• Fixed preferences crash on old iOS 5 devices.
• Fixed "Shake to Randomize"; display name of saver.
• Fixed weirdness with "Frame Rate" sliders on iOS.
• Fixed rotation problems with `pacman', `decayscreen'.
• Better dragging in `fluidballs'.
• Ignore rotation in hacks that don't benefit from it.
• Ignore DEACTIVATE messages when locked, instead of popping up the password dialog box.]]> - Tue, 16 Jul 2013 02:26:09 -0700 - - Version 5.14 http://www.jwz.org/xscreensaver/xscreensaver-5.14.dmg diff --git a/README b/README index 1a0718f7..454e4cbb 100644 --- a/README +++ b/README @@ -38,12 +38,15 @@ XScreenSaver has an extensive manual -- please read it! =============================================================================== +5.25 * Try harder to bypass Quarrantine and Gatekeeper in OSX installer. + * Some files were missing from the tarball. + 5.24 * Added "Automatically check for updates" option on OSX. * Updated feed-loading for recent Flickr changes. * Updated `webcollage' for recent Google changes. - * Added Instagram and Bing as `webcollage' image sources. - * Updated to latest autoconf. - * Bug fixes. + * Added Instagram and Bing as `webcollage' image sources. + * Updated to latest autoconf. + * Bug fixes. 5.23 * New hack, `geodesic'. * iOS and OSX: huge XCopyArea performance improvements. diff --git a/driver/XScreenSaver.ad.in b/driver/XScreenSaver.ad.in index 35bf033d..aa59c7c0 100644 --- a/driver/XScreenSaver.ad.in +++ b/driver/XScreenSaver.ad.in @@ -4,8 +4,8 @@ ! a screen saver and locker for the X window system ! by Jamie Zawinski ! -! version 5.24 -! 07-Dec-2013 +! version 5.25 +! 09-Dec-2013 ! ! See "man xscreensaver" for more info. The latest version is always ! available at http://www.jwz.org/xscreensaver/ diff --git a/driver/XScreenSaver_ad.h b/driver/XScreenSaver_ad.h index 678ae443..ae68ab9a 100644 --- a/driver/XScreenSaver_ad.h +++ b/driver/XScreenSaver_ad.h @@ -53,7 +53,7 @@ "*installColormap: True", "*programs: \ maze -root \\n\ -- GL: superquadrics -root \\n\ + GL: superquadrics -root \\n\ attraction -root \\n\ blitspin -root \\n\ greynetic -root \\n\ @@ -80,31 +80,31 @@ goop -root \\n\ grav -root \\n\ ifs -root \\n\ -- GL: jigsaw -root \\n\ + GL: jigsaw -root \\n\ julia -root \\n\ - kaleidescope -root \\n\ -- GL: moebius -root \\n\ + GL: moebius -root \\n\ moire -root \\n\ -- GL: morph3d -root \\n\ + GL: morph3d -root \\n\ mountain -root \\n\ munch -root \\n\ penrose -root \\n\ -- GL: pipes -root \\n\ + GL: pipes -root \\n\ rd-bomb -root \\n\ -- GL: rubik -root \\n\ + GL: rubik -root \\n\ - sierpinski -root \\n\ slip -root \\n\ -- GL: sproingies -root \\n\ + GL: sproingies -root \\n\ starfish -root \\n\ strange -root \\n\ swirl -root \\n\ triangle -root \\n\ xjack -root \\n\ xlyap -root \\n\ -- GL: atlantis -root \\n\ + GL: atlantis -root \\n\ bsod -root \\n\ -- GL: bubble3d -root \\n\ -- GL: cage -root \\n\ + GL: bubble3d -root \\n\ + GL: cage -root \\n\ - crystal -root \\n\ cynosure -root \\n\ discrete -root \\n\ @@ -114,10 +114,10 @@ - GL: glplanet -root \\n\ interference -root \\n\ kumppa -root \\n\ -- GL: lament -root \\n\ + GL: lament -root \\n\ moire2 -root \\n\ -- GL: sonar -root \\n\ -- GL: stairs -root \\n\ + GL: sonar -root \\n\ + GL: stairs -root \\n\ truchet -root \\n\ - vidwhacker -root \\n\ blaster -root \\n\ @@ -131,80 +131,80 @@ penetrate -root \\n\ petri -root \\n\ phosphor -root \\n\ -- GL: pulsar -root \\n\ + GL: pulsar -root \\n\ ripples -root \\n\ shadebobs -root \\n\ -- GL: sierpinski3d -root \\n\ + GL: sierpinski3d -root \\n\ spotlight -root \\n\ squiral -root \\n\ wander -root \\n\ - webcollage -root \\n\ xflame -root \\n\ xmatrix -root \\n\ -- GL: gflux -root \\n\ + GL: gflux -root \\n\ - nerverot -root \\n\ xrayswarm -root \\n\ xspirograph -root \\n\ -- GL: circuit -root \\n\ -- GL: dangerball -root \\n\ + GL: circuit -root \\n\ + GL: dangerball -root \\n\ - GL: dnalogo -root \\n\ -- GL: engine -root \\n\ -- GL: flipscreen3d -root \\n\ -- GL: gltext -root \\n\ -- GL: menger -root \\n\ -- GL: molecule -root \\n\ + GL: engine -root \\n\ + GL: flipscreen3d -root \\n\ + GL: gltext -root \\n\ + GL: menger -root \\n\ + GL: molecule -root \\n\ rotzoomer -root \\n\ speedmine -root \\n\ -- GL: starwars -root \\n\ -- GL: stonerview -root \\n\ + GL: starwars -root \\n\ + GL: stonerview -root \\n\ vermiculate -root \\n\ whirlwindwarp -root \\n\ zoom -root \\n\ anemone -root \\n\ apollonian -root \\n\ -- GL: boxed -root \\n\ -- GL: cubenetic -root \\n\ -- GL: endgame -root \\n\ + GL: boxed -root \\n\ + GL: cubenetic -root \\n\ + GL: endgame -root \\n\ euler2d -root \\n\ fluidballs -root \\n\ -- GL: flurry -root \\n\ + GL: flurry -root \\n\ - GL: glblur -root \\n\ -- GL: glsnake -root \\n\ + GL: glsnake -root \\n\ halftone -root \\n\ -- GL: juggler3d -root \\n\ -- GL: lavalite -root \\n\ + GL: juggler3d -root \\n\ + GL: lavalite -root \\n\ - polyominoes -root \\n\ -- GL: queens -root \\n\ + GL: queens -root \\n\ - GL: sballs -root \\n\ -- GL: spheremonics -root \\n\ + GL: spheremonics -root \\n\ - thornbird -root \\n\ twang -root \\n\ - GL: antspotlight -root \\n\ apple2 -root \\n\ -- GL: atunnel -root \\n\ + GL: atunnel -root \\n\ barcode -root \\n\ -- GL: blinkbox -root \\n\ -- GL: blocktube -root \\n\ -- GL: bouncingcow -root \\n\ + GL: blinkbox -root \\n\ + GL: blocktube -root \\n\ + GL: bouncingcow -root \\n\ cloudlife -root \\n\ -- GL: cubestorm -root \\n\ + GL: cubestorm -root \\n\ eruption -root \\n\ -- GL: flipflop -root \\n\ -- GL: flyingtoasters -root \\n\ + GL: flipflop -root \\n\ + GL: flyingtoasters -root \\n\ fontglide -root \\n\ -- GL: gleidescope -root \\n\ -- GL: glknots -root \\n\ -- GL: glmatrix -root \\n\ + GL: gleidescope -root \\n\ + GL: glknots -root \\n\ + GL: glmatrix -root \\n\ - GL: glslideshow -root \\n\ -- GL: hypertorus -root \\n\ + GL: hypertorus -root \\n\ - GL: jigglypuff -root \\n\ metaballs -root \\n\ -- GL: mirrorblob -root \\n\ + GL: mirrorblob -root \\n\ piecewise -root \\n\ -- GL: polytopes -root \\n\ + GL: polytopes -root \\n\ pong -root \\n\ popsquares -root \\n\ -- GL: surfaces -root \\n\ + GL: surfaces -root \\n\ xanalogtv -root \\n\ - abstractile -root \\n\ anemotaxis -root \\n\ @@ -214,49 +214,49 @@ interaggregate -root \\n\ intermomentary -root \\n\ memscroller -root \\n\ -- GL: noof -root \\n\ + GL: noof -root \\n\ pacman -root \\n\ -- GL: pinion -root \\n\ -- GL: polyhedra -root \\n\ + GL: pinion -root \\n\ + GL: polyhedra -root \\n\ - GL: providence -root \\n\ substrate -root \\n\ wormhole -root \\n\ - GL: antmaze -root \\n\ -- GL: boing -root \\n\ + GL: boing -root \\n\ boxfit -root \\n\ -- GL: carousel -root \\n\ + GL: carousel -root \\n\ celtic -root \\n\ -- GL: crackberg -root \\n\ -- GL: cube21 -root \\n\ + GL: crackberg -root \\n\ + GL: cube21 -root \\n\ fiberlamp -root \\n\ -- GL: fliptext -root \\n\ -- GL: glhanoi -root \\n\ -- GL: tangram -root \\n\ -- GL: timetunnel -root \\n\ -- GL: glschool -root \\n\ -- GL: topblock -root \\n\ -- GL: cubicgrid -root \\n\ + GL: fliptext -root \\n\ + GL: glhanoi -root \\n\ + GL: tangram -root \\n\ + GL: timetunnel -root \\n\ + GL: glschool -root \\n\ + GL: topblock -root \\n\ + GL: cubicgrid -root \\n\ cwaves -root \\n\ -- GL: gears -root \\n\ -- GL: glcells -root \\n\ -- GL: lockward -root \\n\ + GL: gears -root \\n\ + GL: glcells -root \\n\ + GL: lockward -root \\n\ m6502 -root \\n\ -- GL: moebiusgears -root \\n\ -- GL: voronoi -root \\n\ -- GL: hypnowheel -root \\n\ -- GL: klein -root \\n\ + GL: moebiusgears -root \\n\ + GL: voronoi -root \\n\ + GL: hypnowheel -root \\n\ + GL: klein -root \\n\ - lcdscrub -root \\n\ -- GL: photopile -root \\n\ -- GL: skytentacles -root \\n\ -- GL: rubikblocks -root \\n\ -- GL: companioncube -root \\n\ -- GL: hilbert -root \\n\ -- GL: tronbit -root \\n\ -- GL: geodesic -root \\n\ + GL: photopile -root \\n\ + GL: skytentacles -root \\n\ + GL: rubikblocks -root \\n\ + GL: companioncube -root \\n\ + GL: hilbert -root \\n\ + GL: tronbit -root \\n\ + GL: geodesic -root \\n\ hexadrop -root \\n\ -- GL: kaleidocycle -root \\n\ -- GL: quasicrystal -root \\n\ -- GL: unknownpleasures -root \\n", + GL: kaleidocycle -root \\n\ + GL: quasicrystal -root \\n\ + GL: unknownpleasures -root \\n", "XScreenSaver.pointerPollTime: 0:00:05", "XScreenSaver.pointerHysteresis: 10", "XScreenSaver.initialDelay: 0:00:00", diff --git a/driver/xscreensaver-getimage.c b/driver/xscreensaver-getimage.c index 7123265c..598a9135 100644 --- a/driver/xscreensaver-getimage.c +++ b/driver/xscreensaver-getimage.c @@ -1719,7 +1719,7 @@ get_image (Screen *screen, /* Replace slashes with newlines */ /* while ((dot = strchr(f2, '/'))) *dot = '\n'; */ /* Replace slashes with spaces */ - while ((dot = strchr(f2, '/'))) *dot = ' '; + /* while ((dot = strchr(f2, '/'))) *dot = ' '; */ XChangeProperty (dpy, window, a, XA_STRING, 8, PropModeReplace, (unsigned char *) f2, strlen(f2)); diff --git a/hacks/config/README b/hacks/config/README index afc45756..03242c12 100644 --- a/hacks/config/README +++ b/hacks/config/README @@ -4,8 +4,8 @@ a screen saver and locker for the X window system by Jamie Zawinski - version 5.24 - 07-Dec-2013 + version 5.25 + 09-Dec-2013 http://www.jwz.org/xscreensaver/ diff --git a/hacks/config/rd-bomb.xml b/hacks/config/rd-bomb.xml index c489776d..da187ee6 100644 --- a/hacks/config/rd-bomb.xml +++ b/hacks/config/rd-bomb.xml @@ -27,6 +27,11 @@ + + + + + @@ -49,12 +54,8 @@ - - - - <_description> Reaction-diffusion: draws a grid of growing square-like shapes that, once they overtake each other, react in unpredictable ways. diff --git a/hacks/glx/Makefile.in b/hacks/glx/Makefile.in index 4950ddce..762f8571 100644 --- a/hacks/glx/Makefile.in +++ b/hacks/glx/Makefile.in @@ -235,7 +235,7 @@ RETIRED_MEN = glforestfire.man EXTRAS = README Makefile.in dxf2gl.pl vrml2gl.pl wfront2gl.pl \ molecules.sh starwars.txt -TARFILES = $(SRCS) $(HDRS) $(MEN) $(RETIRED_MEN) $(EXTRAS) +TARFILES = $(SRCS) $(HDRS) $(GL_MEN) $(RETIRED_MEN) $(EXTRAS) default: all diff --git a/hacks/glx/antinspect.man b/hacks/glx/antinspect.man new file mode 100644 index 00000000..804d7a4e --- /dev/null +++ b/hacks/glx/antinspect.man @@ -0,0 +1,56 @@ +.TH XScreenSaver 1 "March 2004" +.SH NAME +antinspect \- ant model inspection screenhack +.SH SYNOPSIS +.B antinspect +[\-display \fIhost:display.screen\fP] [\-window] [\-root] [\-install] +[\-visual \fIvisual\fP] [\-delay \fImicroseconds\fP] [\-fps] +.SH DESCRIPTION +The \fIantinspect\fP code displays three ant-powered balls churning in a +circle. +.SH OPTIONS +.I antinspect +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 \-shadows +Draw shadows on ground +.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. +.B \-fps +Display the current frame rate, CPU load, and polygon count. +.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\-demo (1), +.BR xscreensaver\-getimage (1) +.SH COPYRIGHT +Copyright \(co 2004 by Blair Tennessy. 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 +Blair Tennessy , 15-March-2004. + diff --git a/hacks/glx/antmaze.man b/hacks/glx/antmaze.man new file mode 100644 index 00000000..4c4bec8c --- /dev/null +++ b/hacks/glx/antmaze.man @@ -0,0 +1,52 @@ +.TH XScreenSaver 1 "May 2005" +.SH NAME +antmaze \- ant maze walker +.SH SYNOPSIS +.B antmaze +[\-display \fIhost:display.screen\fP] [\-window] [\-root] [\-install] +[\-visual \fIvisual\fP] [\-delay \fImicroseconds\fP] [\-fps] +.SH DESCRIPTION +The \fIantmaze\fP code displays ants finding their way through a maze. +.SH OPTIONS +.I antmaze +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. +.B \-fps +Display the current frame rate, CPU load, and polygon count. +.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\-demo (1), +.BR xscreensaver\-getimage (1) +.SH COPYRIGHT +Copyright \(co 2005 by Blair Tennessy. 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 +Blair Tennessy , 8-May-2005. + diff --git a/hacks/glx/antspotlight.man b/hacks/glx/antspotlight.man new file mode 100644 index 00000000..c5f8ed7c --- /dev/null +++ b/hacks/glx/antspotlight.man @@ -0,0 +1,56 @@ +.TH XScreenSaver 1 "July 2003" +.SH NAME +antspotlight \- ant spotlight screenhack +.SH SYNOPSIS +.B antspotlight +[\-display \fIhost:display.screen\fP] [\-window] [\-root] [\-install] +[\-visual \fIvisual\fP] [\-delay \fImicroseconds\fP] [\-fps] +.SH DESCRIPTION +The \fIantspotlight\fP code displays a single ant spotting out a screenshot. +.SH OPTIONS +.I antspotlight +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 \-fps +Display the current frame rate, CPU load, and polygon count. +.TP 8 +.B \-delay \fImicroseconds\fP +Per-frame delay. +.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\-demo (1), +.BR xscreensaver\-getimage (1) +.SH COPYRIGHT +Copyright \(co 2003 by Blair Tennessy. 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 +Blair Tennessy , 20-July-2003. + diff --git a/hacks/glx/atlantis.man b/hacks/glx/atlantis.man new file mode 100644 index 00000000..0c2df5ab --- /dev/null +++ b/hacks/glx/atlantis.man @@ -0,0 +1,78 @@ +.TH XScreenSaver 1 "" "X Version 11" +.SH NAME +atlantis - draw swimming sharks, whales, and dolphins. +.SH SYNOPSIS +.B atlantis +[\-display \fIhost:display.screen\fP] +[\-visual \fIvisual\fP] +[\-window] +[\-root] +[\-whalespeed \fInumber\fP] +[\-delay \fInumber\fP] +[\-size \fInumber\fP] +[\-count \fInumber\fP] +[\-no-texture] +[\-gradient] +[\-wireframe] +[\-fps] +.SH DESCRIPTION +This is xfishtank writ large: a GL animation of a number of sharks, +dolphins, and whales. The swimming motions are great. +.SH OPTIONS +.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 \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-whalespeed \fInumber\fP +Whale Speed. 0 - 1000. Default: 250. +.TP 8 +.B \-cycles \fInumber\fP +Shark Speed. Default: 100. +.TP 8 +.B \-size \fInumber\fP +Shark Proximity. 100 - 10000. Default: 6000. +.TP 8 +.B \-count \fInumber\fP +Number of Sharks. 0 - 20. Default: 4. +.TP 8 +.B \-texture | \-no-texture +Whether to show shimmering water. +.TP 8 +.B \-gradient +Whether to draw a gradient on the background, making it darker at the bottom. +.TP 8 +.B \-wireframe +Render in wireframe instead of solid. +.TP 8 +.B \-fps +Display the current frame rate, CPU load, and polygon count. +.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 2002 by Mark Kilgard. 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 +Mark Kilgard. + diff --git a/hacks/glx/atunnel.man b/hacks/glx/atunnel.man new file mode 100644 index 00000000..dc195829 --- /dev/null +++ b/hacks/glx/atunnel.man @@ -0,0 +1,83 @@ +.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 "12-Feb-03" "X Version 11" +.SH NAME +atunnel - hypnotic GL tunnel journey +.SH SYNOPSIS +.B sballs +[\-display \fIhost:display.screen\fP] [\-window] [\-root] +[\-visual \fIvisual\fP] [\-delay \fImicroseconds\fP] +[\-light] [\-no-light] +[\-wire] [\-no-wire] +[\-texture] [\-no-texture] +[\-fps] +.SH DESCRIPTION +The \fIatunnel\fP program draws an animation of a journey in a GL tunnel. +.SH OPTIONS +.I sballs +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 \-fps +Display the current frame rate, CPU load, and polygon count. +.TP 8 +.B \-texture +Show a textured tunnel. This is the default. +.TP 8 +.B \-no\-texture +Disables texturing the animation. +.TP 8 +.B \-wire +Draw a wireframe rendition of the tunnel. +.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 2003 by Eric Lassauge. +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. + +The original code for this mode was written by +Roman Podobedov +and can be found at http://romka.demonews.com + +.SH AUTHOR +Roman Podobedov +Eric Lassauge diff --git a/hacks/glx/blinkbox.man b/hacks/glx/blinkbox.man new file mode 100644 index 00000000..0dc2a3f8 --- /dev/null +++ b/hacks/glx/blinkbox.man @@ -0,0 +1,73 @@ +.TH XScreenSaver 1 "" "X Version 11" +.SH NAME +blinkbox \- shows a ball inside a box. +.SH SYNOPSIS +.B blinkbox +[\-display \fIhost:display.screen\fP] +[\-visual \fIvisual\fP] +[\-window] +[\-root] +[\-delay \fInumber\fP] +[\-wireframe] +[\-boxsize \fInumber\fP] +[\-dissolve] +[\-fade] +[\-no\-blur] +[\-fps] +.SH DESCRIPTION +Shows a ball contained inside of a bounding box. Colored blocks blink in +when the ball hits the edges. +.SH OPTIONS +.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 \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-delay \fInumber\fP +Per-frame delay, in microseconds. Default: 30000 (0.03 seconds.). +.TP 8 +.B \-wireframe | \-no-wireframe +Render in wireframe instead of solid. +.TP 8 +.B \-boxsize +Sets the size of the colored boxes. Should be between 1 and 8. Default: 2 +.TP 8 +.B \-dissolve | \-no-dissolve +Boxes shrink instead of just vanishing. +.TP 8 +.B \-fade | \-no-fade +Boxes fade to transparency instead of just vanishing. +.TP 8 +.B \-blur | \-no-blur +Enable or disable motion blur on the ball. Default: blurry. +.TP 8 +.B \-fps +Display the current frame rate, CPU load, and polygon count. +.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 2003 by Jeremy English. 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 +Jeremy English. Motion blur by John Boero. diff --git a/hacks/glx/blocktube.man b/hacks/glx/blocktube.man new file mode 100644 index 00000000..5d016e09 --- /dev/null +++ b/hacks/glx/blocktube.man @@ -0,0 +1,73 @@ +.TH XScreenSaver 1 "" "X Version 11" +.SH NAME +blocktube - draws a swirling, falling tunnel of reflective slabs +.SH SYNOPSIS +.B blocktube +[\-display \fIhost:display.screen\fP] +[\-visual \fIvisual\fP] +[\-window] +[\-root] +[\-delay \fInumber\fP] +[\-holdtime \fInumber\fP] +[\-changetime \fInumber\fP] +[\-no-texture] +[\-no-fog] +[\-wireframe] +[\-fps] +.SH DESCRIPTION +Blocktube draws a swirling, falling tunnel of reflective slabs. They fade +from hue to hue. +.SH OPTIONS +.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 \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-delay \fInumber\fP +Per-frame delay, in microseconds. Default: 40000 (0.04 seconds.). +.TP 8 +.B \-holdtime \fInumber\fP +How long to stay on the same color. Default: 1000 frames. +.TP 8 +.B \-changetime \fInumber\fP +How long it takes to fade to a new color. Default: 200 frames. +.TP 8 +.B \-no-texture +Draw solid blocks intstead of reflective blocks. +.TP 8 +.B \-no-fog +Do not make blocks in the distance be darker. +.TP 8 +.B \-wireframe +Only draw outlines. +.TP 8 +.B \-fps +Display the current frame rate, CPU load, and polygon count. +.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 2003 by Lars Damerow. 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 +Lars Damerow diff --git a/hacks/glx/boing.man b/hacks/glx/boing.man new file mode 100644 index 00000000..1f00d723 --- /dev/null +++ b/hacks/glx/boing.man @@ -0,0 +1,105 @@ +.TH XScreenSaver 1 "30-Oct-99" "X Version 11" +.SH NAME +boing - draws a bouncing ball like the ancient Amiga demo +.SH SYNOPSIS +.B boing +[\-display \fIhost:display.screen\fP] [\-window] [\-root] [\-install] +[\-visual \fIvisual\fP] +[\-delay \fIusecs\fP] +[\-smooth] +[\-lighting] +[\-scanlines] +[\-speed] +[\-no\-spin] +[\-angle \fIdegrees\fP] +[\-size \fIratio\fP] +[\-parallels \fIn\fP] +[\-meridians \fIn\fP] +[\-wireframe] +[\-fps] +.SH DESCRIPTION +The \fIboing\fP program draws a bouncing checkered ball on a grid. + +This is a clone of the first graphics demo for the Amiga 1000, which +was written by Dale Luck and RJ Mical during a break at the 1984 +Consumer Electronics Show (or so the legend goes.) The boing ball was +briefly the official logo of Amiga Inc., until they were bought by +Commodore later that year. + +With no arguments, this program looks a lot like the original Amiga +demo. With "-smooth -lighting", it looks... less old. +.SH OPTIONS +.I boing +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 \-delay \fIusecs\fP +The delay between frames of the animation, in microseconds: default 15000. +.TP 8 +.B \-smooth +Draw a smooth sphere instead of a faceted polyhedron. +.TP 8 +.B \-lighting +Do shaded lighting instead of flat colors. +.TP 8 +.B \-scanlines +If the window is large enough, draw horizontal lines to simulate the +scanlines on a low resolution monitor. +.TP 8 +.B \-speed \fIratio\fP +Change the animation speed; 0.5 to go half as fast, 2.0 to go twice as fast. +.TP 8 +.B \-no\-spin +Don't rotate the ball. +.TP 8 +.B \-angle \fIdegrees\fP +The jaunty angle at which the ball sits. Default 15 degrees. +.TP 8 +.B \-size \fIratio\fP +How big the ball is; default 0.5 meaning about half the size of the window. +.TP 8 +.B \-parallels \fIn\fP +.B \-meridians \fIn\fP +The pattern of rectangles on the ball. Default 8x16. +.TP 8 +.B \-wireframe +Look crummy. +.TP 8 +.B \-fps +Display the current frame rate, CPU load, and polygon count. +.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 bsod (MANSUFFIX), +.BR pong (MANSUFFIX), +.BR xscreensaver (1), +.BR X (1) +.SH COPYRIGHT +Copyright \(co 2005 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 , 19-Feb-2005. diff --git a/hacks/glx/bouncingcow.man b/hacks/glx/bouncingcow.man new file mode 100644 index 00000000..516d1de3 --- /dev/null +++ b/hacks/glx/bouncingcow.man @@ -0,0 +1,73 @@ +.TH XScreenSaver 1 "" "X Version 11" +.SH NAME +bouncingcow - a happy cow on a trampoline in 3D. Moo. +.SH SYNOPSIS +.B bouncingcow +[\-display \fIhost:display.screen\fP] +[\-visual \fIvisual\fP] +[\-window] +[\-root] +[\-delay \fInumber\fP] +[\-speed \fInumber\fP] +[\-count \fInumber\fP] +[\-texture \fIfilename\fP] +[\-wireframe] +[\-fps] +.SH DESCRIPTION +It's very silly. +.SH OPTIONS +.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 \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-delay \fInumber\fP +Per-frame delay, in microseconds. Default: 30000 (0.03 seconds.). +.TP 8 +.B \-speed \fInumber\fP +How fast the cow bounces. Larger for faster. Default: 1.0. +.TP 8 +.B \-count \fInumber\fP +How many cows! Default 1. +.TP 8 +.B \-texture \fIfilename\fP +An image file to paint on the cow's hide. + +Note that on most systems, GL textures must have dimensions that are a +power of two. +.TP 8 +.B \-wireframe +Render in wireframe instead of solid. +.TP 8 +.B \-fps +Display the current frame rate, CPU load, and polygon count. +.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 2003 by Jamie Zawinski. Moo. 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. +Moo. No representations are made about the suitability of this +software for any purpose. It is provided "as is" without express or +implied warranty. Moo. +.SH AUTHOR +Jamie Zawinski + diff --git a/hacks/glx/boxed.man b/hacks/glx/boxed.man new file mode 100644 index 00000000..42334466 --- /dev/null +++ b/hacks/glx/boxed.man @@ -0,0 +1,56 @@ +.TH XScreenSaver 1 "" "X Version 11" +.SH NAME +boxed - draws a box full of 3D bouncing balls that explode. +.SH SYNOPSIS +.B boxed +[\-display \fIhost:display.screen\fP] +[\-visual \fIvisual\fP] +[\-window] +[\-root] +[\-delay \fInumber\fP] +[\-wireframe] +[\-fps] +.SH DESCRIPTION +Draws a box full of 3D bouncing balls that explode. +.SH OPTIONS +.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 \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-delay \fInumber\fP +Per-frame delay, in microseconds. Default: 20000 (0.02 seconds.). +.TP 8 +.B \-wireframe +Render in wireframe instead of solid. +.TP 8 +.B \-fps +Display the current frame rate, CPU load, and polygon count. +.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 2002 by Sander van Grieken. 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 +Sander van Grieken. diff --git a/hacks/glx/bubble3d.man b/hacks/glx/bubble3d.man new file mode 100644 index 00000000..f847e12d --- /dev/null +++ b/hacks/glx/bubble3d.man @@ -0,0 +1,62 @@ +.TH XScreenSaver 1 "" "X Version 11" +.SH NAME +bubble3d - 3d rising bubbles. +.SH SYNOPSIS +.B bubble3d +[\-display \fIhost:display.screen\fP] +[\-visual \fIvisual\fP] +[\-window] +[\-root] +[\-delay \fInumber\fP] +[\-transparent] +[\-color \fIcolor\fP] +[\-fps] +.SH DESCRIPTION +Draws a stream of rising, undulating 3D bubbles, rising toward the top of +the screen, with nice specular reflections. +.SH OPTIONS +.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 \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-transparent +Draw transparent bubbles instead of solid ones. +.TP 8 +.B \-color \fIcolor\fP +Draw bubbles of the specified color. "Random" means a different color +for each bubble. +.TP 8 +.B \-delay \fInumber\fP +Per-frame delay, in microseconds. Default: 15000 (0.015 seconds.). +.TP 8 +.B \-fps +Display the current frame rate, CPU load, and polygon count. +.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 2002 by Richard Jones. 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 +Richard Jones. diff --git a/hacks/glx/cage.man b/hacks/glx/cage.man new file mode 100644 index 00000000..dc5595b9 --- /dev/null +++ b/hacks/glx/cage.man @@ -0,0 +1,61 @@ +.TH XScreenSaver 1 "" "X Version 11" +.SH NAME +cage - Escher's impossible cage, for xscreensaver. +.SH SYNOPSIS +.B cage +[\-display \fIhost:display.screen\fP] +[\-visual \fIvisual\fP] +[\-window] +[\-root] +[\-delay \fInumber\fP] +[\-mono] +[\-wireframe] +[\-fps] +.SH DESCRIPTION +This draws Escher's "Impossible Cage", a 3d analog of a moebius strip, +and rotates it in three dimensions. +.SH OPTIONS +.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 \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-delay \fInumber\fP +Per-frame delay, in microseconds. Default: 25000 (0.03 seconds.). +.TP 8 +.B \-mono +Render solid instead of textured. +.TP 8 +.B \-wireframe +Render in wireframe instead of textured. +.TP 8 +.B \-fps +Display the current frame rate, CPU load, and polygon count. +.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 2002 by Marcelo Vianna. 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 +Marcelo Vianna. diff --git a/hacks/glx/carousel.man b/hacks/glx/carousel.man new file mode 100644 index 00000000..d5c9e430 --- /dev/null +++ b/hacks/glx/carousel.man @@ -0,0 +1,109 @@ +.TH XScreenSaver 1 "" "X Version 11" +.SH NAME +carousel - displays multiple images rotating in a circular formation +.SH SYNOPSIS +.B carousel +[\-display \fIhost:display.screen\fP] +[\-visual \fIvisual\fP] +[\-window] +[\-root] +[\-count \fIint\fP] +[\-zoom | \-no\-zoom] +[\-tilt \fIXY\fP] +[\-titles | \-no\-titles] +[\-font \fIfont\fP] +[\-speed \fIratio\fP] +[\-duration \fIseconds\fP] +[\-fps] +[\-debug] +[\-wireframe] +.SH DESCRIPTION +Loads several random images, and displays them flying in a circular +formation. The circle changes speed and direction randomly, tilts on +its axis, and the images move in and out. + +This program requires a good video card capable of supporting large +textures. + +To specify the directory that images are loaded from, run +.BR xscreensaver-demo (1) +and click on the "Advanced" tab. +.SH OPTIONS +.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 \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-count \fIint\fP +How many images to display. Default 7. +.TP 8 +.B \-zoom \fB| \-no\-zoom\fP +Whether the images should move in and out (toward and away from the +axis of rotation). Default true. +.TP 8 +.B \-tilt \fIXY\fP \fB| \-no\-tilt\fP +Whether the axis of rotation should tilt, and how. \fB-tilt X\fP +means that it will tilt toward and away from the viewer. +\fB-tilt Y\fP means that it will tilt to the left and right of the +screen. \fB-tilt XY\fP (the default) means it will do both. +.TP 8 +.B \-titles \fB| \-no\-titles\fP +Whether to display the file names of the images beneath them. Default: yes. +.TP 8 +.B \-font \fIfont-name\fP +The font to use for titles. Note that the size of the font affects +the clarity of the characters, not their size (it is auto-scaled.) +.TP 8 +.B \-duration \fIseconds\fP +Every \fIduration\fP seconds, one of the images will be replaced +with a new one. Default 20 seconds. +.TP 8 +.B \-speed \fIratio\fP +Speed up or slow down the animation. 0.5 means half as fast as the +default; 2.0 means twice as fast. +.TP 8 +.B \-delay \fInumber\fP +Per-frame delay, in microseconds. Default: 20000 (0.02 seconds.). +.TP 8 +.B \-fps +Display the current frame rate, CPU load, and polygon count. +.TP 8 +.B \-debug +Prints debugging info to stderr. +.TP 8 +.B \-wireframe +Another debug mode. +.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-demo (1) +.BR xscreensaver-getimage (1) +.BR xscreensaver (1) +.BR glslideshow (MANSUFFIX) +.BR photopile (MANSUFFIX) +.SH COPYRIGHT +Copyright \(co 2005 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. diff --git a/hacks/glx/circuit.man b/hacks/glx/circuit.man new file mode 100644 index 00000000..794f97bc --- /dev/null +++ b/hacks/glx/circuit.man @@ -0,0 +1,72 @@ +.TH XScreenSaver 1 "5-May-2004" "X Version 11" +.SH NAME +circuit - animates a number of 3D electronic components. +.SH SYNOPSIS +.B circuit +[\-display \fIhost:display.screen\fP] +[\-visual \fIvisual\fP] +[\-window] +[\-root] +[\-delay \fInumber\fP] +[\-parts \fInumber\fP] +[\-no-spin] +[\-rotate] +[\-speed \fInumber\fP] +[\-no-light] +[\-fps] +.SH DESCRIPTION +Animates a number of 3D electronic components. +.SH OPTIONS +.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 \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-delay \fInumber\fP +Per-frame delay, in microseconds. Default: 20000 (0.02 seconds.). +.TP 8 +.B \-parts \fInumber\fP +Number of parts. Default: 10. +.TP 8 +.B \-spin | \-no-spin +Whether the objects should spin. +.TP 8 +.B \-rotate | \-no-rotate +Whether the scene should spin. +.TP 8 +.B \-speed \fInumber\fP +Rotation speed, 0 - 100. Default: 1. +.TP 8 +.B \-light | \-no-light +Whether to us lighting, or flat coloring. +.TP 8 +.B \-fps +Display the current frame rate, CPU load, and polygon count. +.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 2002 by Ben Buxton. 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 +Ben Buxton. diff --git a/hacks/glx/companioncube.man b/hacks/glx/companioncube.man new file mode 100644 index 00000000..e15b15eb --- /dev/null +++ b/hacks/glx/companioncube.man @@ -0,0 +1,85 @@ +.TH XScreenSaver 1 "" "X Version 11" +.SH NAME +companioncube - a vital aparatus. +.SH SYNOPSIS +.B companioncube +[\-display \fIhost:display.screen\fP] +[\-visual \fIvisual\fP] +[\-window] +[\-root] +[\-delay \fInumber\fP] +[\-speed \fIratio\fP] +[\-spin] +[\-wander] +[\-count \fInumber\fP] +[\-wireframe] +[\-fps] +.SH DESCRIPTION +The symptoms most commonly produced by Enrichment Center testing are +superstition, perceiving inanimate objects as alive, and hallucinations. +The Enrichment Center reminds you that the weighted companion cube will +never threaten to stab you and, in fact, cannot speak. In the event that +the Weighted Companion Cube does speak, the Enrichment Center urges you to +disregard its advice. +.SH OPTIONS +.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 \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-delay \fInumber\fP +Per-frame delay, in microseconds. Default: 30000 (0.03 seconds.). +.TP 8 +.B \-speed \fInumber\fP +How fast the animation should run. +Less than 1 for slower, greater than 1 for faster. +.TP 8 +.B \-count \fInumber\fP +How many cubes. Default 3. +.TP 8 +.B \-spin +.B \-no\-spin +Instead of bouncing, float and spin. +.TP 8 +.B \-wander +.B \-no\-wander +Instead of bouncing, float and drift. +.TP 8 +.B \-wireframe +Render in wireframe instead of solid. +.TP 8 +.B \-fps +Display the current frame rate, CPU load, and polygon count. +.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 tronbit (1), +.BR lament (1), +.BR dangerball (1), +.BR xscreensaver (1) +.SH COPYRIGHT +Copyright \(co 2011 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, with apologies to the fine folks at Valve Software +and Aperture Science. diff --git a/hacks/glx/crackberg.man b/hacks/glx/crackberg.man new file mode 100644 index 00000000..5183baa3 --- /dev/null +++ b/hacks/glx/crackberg.man @@ -0,0 +1,123 @@ +.TH XScreenSaver 1 "" "X Version 11" +.SH NAME +crackberg - Lose your way wandering some height fields, and enjoy candy. +.SH SYNOPSIS +.B crackberg +[\-root] +[\-window] +[\-install] +[\-display \fIhost:display.screen\fP] +[\-visual \fIvisual\fP] +[\-window-id \fIid\fP] +[\-delay \fIusecs\fP] +[\-fps] +[\-crack] +[\-lit] +[\-boring] +[\-letterbox] +[\-flat] +[\-wire] +[\-nowater] +[\-visibility \fIfloat\fP] +[\-color \fIstring\fP] +[\-nsubdivs \fIinteger\fP] +.SH DESCRIPTION +Flies through height maps, optionally animating the instantiation and +destruction of generated tiles; by default, tiles 'grow' into place (height +gradually increased up to correct value). In windowed mode the following key +controls are available: +.TP 8 +.B left, right +Turn left and right. +.TP 8 +.B a,w,s,d +Move left, forwards, backwards, and to the right, respectively. +.TP 8 +.B 1,2 +Decrease and increase manual speed, respectively. +.TP 8 +.B Spacebar +Return to automatic control. +.SH OPTIONS +.I crackberg +accepts the following options: +.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 \-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 +Delay between frames; default 20000 (1/50th of a second). +.TP 8 +.B \-fps +Display the current frame rate, CPU load, and polygon count. +.TP 8 +.B \-crack +Use all possible methods to animate tile instantiation. +.TP 8 +.B \-boring +Do not animate instatiation at all; use this to get standard landscape +generator behavior. +.TP 8 +.B \-letterbox +Drawable window region has a 16:9 aspect ratio, regardless of actual +window size. +.TP 8 +.B \-lit +Enable lighting. +.TP 8 +.B \-flat +Flat shading (OpenGL will use one color per primitive, rather than +interpolating betwixt vertices). +.TP 8 +.B \-wire +Wireframe. +.TP 8 +.B \-nowater +Do not display 'water' (forces negative values to zero, and selects a +different coloring method). +.TP 8 +.B \-visibility \fIfloat\fP +Value in range [0.2,1.0] (default 0.6) specifying proportion of viewable +XY plane which is to be drawn upon. +.TP 8 +.B \-color \fIstring\fP +Selects color scheme. Use with no or bogus argument for current list. +.TP 8 +.B \-nsubdivs \fIinteger\fP +Number of times to recursively subdivide each triangular tile. Each +increment increases total triangles by a factor of 4; for instance the default +setting 4 results in 256 triangles per tile. + +.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 2005 by Matus Telgarsky. 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 +Matus Telgarsky , 2005. diff --git a/hacks/glx/cube21.man b/hacks/glx/cube21.man new file mode 100644 index 00000000..d90c0fba --- /dev/null +++ b/hacks/glx/cube21.man @@ -0,0 +1,147 @@ +.TH XScreenSaver 1 "30-Aug-05" "X Version 11" +.SH NAME +cube21 - animates the Cube 21 puzzle +.SH SYNOPSIS +.B cube21 +[\-display \fIhost:display.screen\fP] +[\-visual \fIvisual\fP] +[\-window] +[\-root] +[\-install] +[\-delay \fImicroseconds\fP] +[\-texture] [\-no\-texture] +[\-mono] +[\-wireframe] +[\-spin] [\-no\-spin] +[\-wander] [\-no\-wander] +[\-randomize] [\-no\-randomize] +[\-spinspeed \fInumber\fP] +[\-rotspeed \fInumber\fP] +[\-wanderspeed \fInumber\fP] +[\-wait \fInumber\fP] +[\-cubesize \fInumber\fP] +[\-colormode \fIarg\fP] +[\-fps] +.SH DESCRIPTION +This program animates a puzzle known as Cube 21 or Square-1. +Its moves are chosen randomly. +.P +Cube 21 is a Rubik-like puzzle invented in 1992. Its specialities are that +it can change its shape and even the number of possible moves. It can have +more than 200 different shapes and the total number of configurations +(assuming colors) is several tens of billions. +.SH OPTIONS +.I cube21 +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 \-delay \fImicroseconds\fP +How long to pause between frames. Default is 20000, or 0.02 second. +.TP 8 +.B \-texture +Use texture maps. This is the default. +.TP 8 +.B \-no\-texture +Use solid colors. +.TP 8 +.B \-mono +Disable both texture maps and colors. +.TP 8 +.B \-wireframe +Only draw outlines. Outlines of all pieces, not only the whole object, are drawn. +.TP 8 +.B \-spin +Spin the whole object around X, Y and Z axes. This is the default. +.TP 8 +.B \-no\-spin +Do not spin, showing the same three faces all the time. +.TP 8 +.B \-wander +Move the object around the screen. This is the default. +.TP 8 +.B \-no\-wander +Keep the object centered on the screen. +.TP 8 +.B \-randomize +Shuffle the puzzle randomly at startup. This is the default. +.TP 8 +.B \-no\-randomize +Do not shuffle at startup, begin at the shape of cube. +.TP 8 +.B \-spinspeed \fInumber\fP +The relative speed of spinning. Default is 1.0. +.TP 8 +.B \-rotspeed \fInumber\fP +The relative speed of the moves. Default is 3.0. Setting to \(<= 0.0 +makes the object stay at one configuration. +.TP 8 +.B \-wanderspeed \fInumber\fP +The relative speed of wandering around the screen. Default is 1.0. +.TP 8 +.B \-wait \fInumber\fP +How long to stay at ending position after each move. The meaning of +the argument is again relative. Default is 40.0. +.TP 8 +.B \-cubesize \fInumber\fP +Size of the object. Value of 3.0 fills roughly all the screen (its height). Default is 0.7. +.TP 8 +.B \-colormode \fIargument\fP +How many and which colors should the object have. The colors are put on the piece +faces so that the puzzle is solvable. The inner faces are not influenced. +.RS +.TP 8 +.BR se " or " silver +Simulate the "Silver Edition" \- white and one random color. +.TP 8 +.BR 2 " or " two +Two random colors. +.TP 8 +.BR ce " or " classic +Simulate the "Classic Edition" \- white, yellow, orange, red, green and blue. +.TP 8 +.BR 6 " or " six +Six random colors. +.TP 8 +.BR 1 " or " random " or " rnd +One random color. +.TP 8 +Anything else +All faces white. +.RE +.TP 8 +.B \-fps +Display the current frame rate, CPU load, and polygon count. +.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 2005 by Vaclav Potocek. 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 +Vaclav (Vasek) Potocek , 30-Aug-05. diff --git a/hacks/glx/cubenetic.man b/hacks/glx/cubenetic.man new file mode 100644 index 00000000..e11d479e --- /dev/null +++ b/hacks/glx/cubenetic.man @@ -0,0 +1,89 @@ +.TH XScreenSaver 1 "" "X Version 11" +.SH NAME +cubenetic - cubist 3D undulating blob. +.SH SYNOPSIS +.B cubenetic +[\-display \fIhost:display.screen\fP] +[\-visual \fIvisual\fP] +[\-window] +[\-root] +[\-delay \fInumber\fP] +[\-count \fInumber\fP] +[\-no-wander] +[\-no-spin] +[\-spin \fI[XYZ]\fP] +[\-wireframe] +[\-no-texture] +[\-wave-speed \fInumber\fP] +[\-wave-radius \fInumber\fP] +[\-waves \fInumber\fP] +[\-fps] +.SH DESCRIPTION +Draws a pulsating set of overlapping boxes with ever-chaning blobby +patterns undulating across their surfaces. +.SH OPTIONS +.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 \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-delay \fInumber\fP +Per-frame delay, in microseconds. Default: 20000 (0.02 seconds.). +.TP 8 +.B \-count \fInumber\fP +How many boxes make up the object. Default: 5. +.TP 8 +.B \-wander | \-no-wander +Whether the object should wander around the screen. +.TP 8 +.B \-spin \fI[XYZ]\fP +Around which axes should the object spin? +.TP 8 +.B \-no-spin +Don't spin. +.TP 8 +.B \-wireframe +Render in wireframe instead of solid. +.TP 8 +.B \-texture | \-no-texture +Display Solid Colors. +.TP 8 +.B \-wave-speed \fInumber\fP +Surface Pattern Speed. 5 - 150. Default: 80. +.TP 8 +.B \-wave-radius \fInumber\fP +Surface Pattern Overlap. 5 - 600. Default: 512. +.TP 8 +.B \-waves \fInumber\fP +Surface Pattern Complexity. 1 - 20. Default: 3. +.TP 8 +.B \-fps +Display the current frame rate, CPU load, and polygon count. +.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 2002 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. diff --git a/hacks/glx/cubestorm.man b/hacks/glx/cubestorm.man new file mode 100644 index 00000000..9d912fd8 --- /dev/null +++ b/hacks/glx/cubestorm.man @@ -0,0 +1,77 @@ +.TH XScreenSaver 1 "" "X Version 11" +.SH NAME +cubestorm - a series of 3D boxes that fill space +.SH SYNOPSIS +.B cubestorm +[\-display \fIhost:display.screen\fP] +[\-visual \fIvisual\fP] +[\-window] +[\-root] +[\-delay \fInumber\fP] +[\-speed \fIfloat\fP] +[\-count \fIint\fP] +[\-thickness \fIfloat\fP] +[\-no-wander] +[\-no-spin] +[\-wireframe] +[\-fps] +.SH DESCRIPTION +Draws a series of rotating 3D boxes that intersect each other and +eventually fill space. +.SH OPTIONS +.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 \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-delay \fInumber\fP +Per-frame delay, in microseconds. Default: 30000 (0.03 seconds.). +.TP 8 +.B \-speed \fInumber\fP +Larger numbers mean run faster. Default: 1.0. +.TP 8 +.B \-count \fInumber\fP +Number of cubes. Default 4. +.TP 8 +.B \-thickness \fIfloat\fP +How thick the struts making up the cubes should be (0.0-1.0). Default 0.06. +.TP 8 +.B \-wander | \-no-wander +Whether the cubes should wander around the screen. +.TP 8 +.B \-spin | \-no-spin +Whether the cubes should spin. +.TP 8 +.B \-wireframe | \-no-wireframe +Render in wireframe instead of solid. +.TP 8 +.B \-fps +Display the current frame rate, CPU load, and polygon count. +.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 2003 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. diff --git a/hacks/glx/cubicgrid.man b/hacks/glx/cubicgrid.man new file mode 100644 index 00000000..d267bc3c --- /dev/null +++ b/hacks/glx/cubicgrid.man @@ -0,0 +1,83 @@ +.TH XScreenSaver 1 "Dec-28-07" "X Version 11" +.SH NAME +cubicgrid - rotating 3D lattice seen from inside +.SH SYNOPSIS +.B cubicgrid +[\-display \fIhost:display.screen\fP] +[\-visual \fIvisual\fP] +[\-window] +[\-root] +[\-install] +[\-delay \fImicroseconds\fP] +[\-mono] +[\-speed \fInumber\fP] +[\-zoom \fInumber\fP] +[\-ticks \fInumber\fP] +[\-bigdots] +[\-fps] +.SH DESCRIPTION +This program shows the view of an observer located inside a set of points +arranged to a 3D lattice. As the lattice rotates, various view-throughs appear +and evolve. A simple idea with interesting results. +.SH OPTIONS +.I cubicgrid +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 \-delay \fImicroseconds\fP +How long to pause between frames. Default is 20000, or 0.02 second. +.TP 8 +.B \-mono +Draw in black and white. If not used, a fixed all-color scheme is chosen. +.TP 8 +.B \-speed \fInumber\fP +The maximum speed of the rotation. The actual speed and axis change smoothly +for better effect. 0.5 - 10. The default is 1.0. +.TP 8 +.B \-zoom \fInumber\fP +Size of the lattice. Ideally it should fill all the screen, but one may find +other values also interesting. 5 - 50. The default of 20 should do for common +screen aspect ratios. +.TP 8 +.B \-ticks \fInumber\fP +The count of points drawn along every axis. 10 - 100. The default is 30. +.TP 8 +.B \-bigdots +Draw the points twice as big. +.TP 8 +.B \-fps +Display the current frame rate, CPU load, and polygon count. +.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 2007 by Vasek Potocek. 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 +Vasek Potocek , Dec-28-07. diff --git a/hacks/glx/dangerball.man b/hacks/glx/dangerball.man new file mode 100644 index 00000000..3e33f827 --- /dev/null +++ b/hacks/glx/dangerball.man @@ -0,0 +1,72 @@ +.TH XScreenSaver 1 "" "X Version 11" +.SH NAME +dangerball - a 3D ball that periodically extrudes spikes. Ouch! +.SH SYNOPSIS +.B dangerball +[\-display \fIhost:display.screen\fP] +[\-visual \fIvisual\fP] +[\-window] +[\-root] +[\-delay \fInumber\fP] +[\-speed \fInumber\fP] +[\-count \fInumber\fP] +[\-no-wander] +[\-no-spin] +[\-wireframe] +[\-fps] +.SH DESCRIPTION +Draws a ball that periodically extrudes many random spikes. Ouch! +.SH OPTIONS +.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 \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-delay \fInumber\fP +Per-frame delay, in microseconds. Default: 30000 (0.03 seconds.). +.TP 8 +.B \-speed \fInumber\fP +Spike growth frequency. 0.0 - 0.25. Default: 0.05. +.TP 8 +.B \-count \fInumber\fP +Number o spikes. Default: 30. +.TP 8 +.B \-wander | \-no-wander +Whether the object should wander around the screen. +.TP 8 +.B \-spin | \-no-spin +Whether the object should spin. +.TP 8 +.B \-wireframe | \-no-wireframe +Render in wireframe instead of solid. +.TP 8 +.B \-fps +Display the current frame rate, CPU load, and polygon count. +.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 2002 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. diff --git a/hacks/glx/endgame.man b/hacks/glx/endgame.man new file mode 100644 index 00000000..93ca5c39 --- /dev/null +++ b/hacks/glx/endgame.man @@ -0,0 +1,72 @@ +.TH XScreenSaver 1 "5-May-2004" +.SH NAME +endgame \- endgame chess screensaver +.SH SYNOPSIS +.B endgame +[\-display \fIhost:display.screen\fP] +[\-window] +[\-root] +[\-install] +[\-visual \fIvisual\fP] +[\-delay \fImicroseconds\fP] +[\-wireframe] +[\-fps] +.SH DESCRIPTION +endgame replays a brilliant chess ending +.SH OPTIONS +.I endgame +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 \-shadows +Project pieces against the board with dark blend. +.TP 8 +.B \-reflections +Reflect pieces in light board squares. +.TP 8 +.B \-classic +Use the original low-polygon piece models. +.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 \-wireframe +Render in wireframe instead of solid. +.B \-fps +Display the current frame rate, CPU load, and polygon count. +.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's not unknown for this and other OpenGL hacks to fail under hardware accelaration (UtahGLX) and take the X server with them. Texture images must be 16x16 or 32x32 or 64x64 etc. +.SH SEE ALSO +.BR X (1), +.BR xscreensaver (1) +.BR xscreensaver\-demo (1), +.BR xscreensaver\-getimage (1) +.SH COPYRIGHT +Copyright \(co 2002 by Blair Tennessy. 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 +Blair Tennessy , 20-April-2002. + diff --git a/hacks/glx/engine.man b/hacks/glx/engine.man new file mode 100644 index 00000000..af794e5e --- /dev/null +++ b/hacks/glx/engine.man @@ -0,0 +1,80 @@ +.TH XScreenSaver 1 "" "X Version 11" +.SH NAME +engine - draws a 3D four-stroke engine. +.SH SYNOPSIS +.B engine +[\-display \fIhost:display.screen\fP] +[\-visual \fIvisual\fP] +[\-window] +[\-root] +[\-engine \fIname\fP] +[\-delay \fInumber\fP] +[\-no-move] +[\-no-spin] +[\-no-title] +[\-fps] +.SH DESCRIPTION +Draws a simple four-stroke engine that floats around the screen. +.SH OPTIONS +.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 \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-engine \fIname\fP +What kind of engine to draw. Default: random. +Known models are: +"Honda Insight" (3), +"BMW M3" (4), +"VW Beetle" (flat 4), +"Audi Quattro" (5), +"BMW M5" (6), +"Subaru XT" (V6), +"Porsche 911" (flat 6), +"Corvette Z06" (V8), +"Dodge Viper" (V10), +and +"Jaguar XKE" (V12). +.TP 8 +.B \-delay \fInumber\fP +Per-frame delay, in microseconds. Default: 10000 (0.01 seconds.). +.TP 8 +.B \-move | \-no-move +Whether the object should wander around the screen. +.TP 8 +.B \-spin | \-no-spin +Whether the object should spin. +.TP 8 +.B \-fps +Display the current frame rate, CPU load, and polygon count. +.TP 8 +.B \-title | \-no-title +Whether to display the name of the engine being rendered. +.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 2002 by Ben Buxton. 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 +Ben Buxton. diff --git a/hacks/glx/extrusion.man b/hacks/glx/extrusion.man new file mode 100644 index 00000000..e01d5736 --- /dev/null +++ b/hacks/glx/extrusion.man @@ -0,0 +1,71 @@ +.TH XScreenSaver 1 "" "X Version 11" +.SH NAME +extrusion - various rotating extruded shapes. +.SH SYNOPSIS +.B extrusion +[\-display \fIhost:display.screen\fP] +[\-visual \fIvisual\fP] +[\-window] +[\-root] +[\-delay \fInumber\fP] +[\-name \fIwhich\fP] +[\-no-light] +[\-wireframe] +[\-fps] +.SH DESCRIPTION +Draws various rotating extruded shapes that twist around, lengthen, and +turn inside out. +.SH OPTIONS +.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 \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-delay \fInumber\fP +Per-frame delay, in microseconds. Default: 10000 (0.01 seconds.). +.TP 8 +.B \-name \fIwhich\fP +Which object to draw. Choices are: helix2, helix3, helix4, joinoffset, +screw, taper, and twistoid. +.TP 8 +.B \-light | \-no-light +Whether to light the scene, or use flat coloring. +.TP 8 +.B \-bitmap \fIfile\fP +The texture map to use. +.TP 8 +.B \-wireframe +Render in wireframe instead of solid. +.TP 8 +.B \-fps +Display the current frame rate, CPU load, and polygon count. +.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 2002 by Linas Vepstas and David Konerding. 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 +This screensaver was created by David Konerding from the samples that +come with the GL Extrusion library by Linas Vepstas. diff --git a/hacks/glx/flipflop.man b/hacks/glx/flipflop.man new file mode 100644 index 00000000..17691bce --- /dev/null +++ b/hacks/glx/flipflop.man @@ -0,0 +1,95 @@ +.TH XScreenSaver 1 "" "X Version 11" +.SH NAME +flipflop - draws a grid of 3D squares that change positions +.SH SYNOPSIS +.B flipflop +[\-display \fIhost:display.screen\fP] +[\-visual \fIvisual\fP] +[\-window] +[\-count \fInumber\fP | \-free \fInumber\fP] +[\-size \fInumber\fP] +[\-size-x \fInumber\fP] +[\-size-y \fInumber\fP] +[\-spin \fInumber\fP] +[\-mode sticks | tiles] +[\-delay \fInumber\fP] +[\-wireframe] +[\-fps] +[\-texture] +.SH DESCRIPTION +Flipflop draws a grid of 3D colored tiles that change positions with +each other. +.SH OPTIONS +.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 \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-count \fInumber\fP +Number of tiles on the board. A value of "0" means "default". The +default number of tiles depends on the size of the board and the mode: +95% of total tiles for "tiles" mode and 80% of total sticks for +"sticks" mode (e.g. 76 tiles or 64 sticks for a 9x9 board). +.TP 8 +.B \-free \fInumber\fP +Number of tiles missing from the board. See -count. +.TP 8 +.B \-size \fInumber\fP +Number of tiles on each side of the board. Takes precedence over +-size-x and -size-y. Default: 9. +.TP 8 +.B \-size-x \fInumber\fP +Width (in tiles) of the board. Default: 9. +.TP 8 +.B \-size-y \fInumber\fP +Length (in tiles) of the board. Default: 9. +.TP 8 +.B \-spin \fInumber\fP +Angular velocity for the rotation of the board. +.TP 8 +.B \-mode sticks +Draw hopping sticks instead of flipping tiles. +.TP 8 +.B \-mode tiles +Draw flipping tiles. This is the default. +.TP 8 +.B \-delay \fInumber\fP +Per-frame delay, in microseconds. Default: 20000 (0.02 seconds.). +.TP 8 +.B \-fps | \-no\-fps +Display the current frame rate, CPU load, and polygon count. +.TP 8 +.B \-wireframe +Only draw outlines. +.TP 8 +.B \-texture | \-no\-texture +Whether to texture the tiles with a screen grab or an 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 SEE ALSO +.BR X (1), +.BR xscreensaver (1) +.SH COPYRIGHT +Copyright \(co 2003 by Kevin Ogden. 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 +Kevin Ogden . Some additional code by Sergio +Gutierrez . diff --git a/hacks/glx/flipscreen3d.man b/hacks/glx/flipscreen3d.man new file mode 100644 index 00000000..fecd005b --- /dev/null +++ b/hacks/glx/flipscreen3d.man @@ -0,0 +1,61 @@ +.TH XScreenSaver 1 "" "X Version 11" +.SH NAME +flipscreen3d - rotates an image of the screen through 3 dimensions. +.SH SYNOPSIS +.B flipscreen3d +[\-display \fIhost:display.screen\fP] +[\-visual \fIvisual\fP] +[\-window] +[\-root] +[\-delay \fInumber\fP] +[\-no-rotate] +[\-wireframe] +[\-fps] +.SH DESCRIPTION +Grabs an image of the desktop, turns it into a GL texture map, and spins it +around and deforms it in various ways. +.SH OPTIONS +.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 \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-delay \fInumber\fP +Per-frame delay, in microseconds. Default: 20000 (0.02 seconds.). +.TP 8 +.B \-rotate | \-no-rotate +Whether to rotate. +.TP 8 +.B \-wireframe +Just render boxes instead of textures (for debugging). +.TP 8 +.B \-fps +Display the current frame rate, CPU load, and polygon count. +.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 2002 by Ben Buxton. 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 +Ben Buxton. diff --git a/hacks/glx/fliptext.man b/hacks/glx/fliptext.man new file mode 100644 index 00000000..8d2915ef --- /dev/null +++ b/hacks/glx/fliptext.man @@ -0,0 +1,114 @@ +.TH XScreenSaver 1 "20-Mar-2005" "X Version 11" +.SH NAME +fliptext - draws pages of text whose lines transparently flip around +.SH SYNOPSIS +.B fliptext +[\-display \fIhost:display.screen\fP] [\-window] [\-root] +[\-visual \fIvisual\fP] +[\-delay \fImicroseconds\fP] +[\-program \fIcommand\fP] +[\-size \fIinteger\fP ] +[\-columns \fIinteger\fP] +[\-left | \-center | \-right] +[\-lines \fIinteger\fP] +[\-speed \fIfloat\fP] +[\-delay \fIusecs\fP] +[\-font \fIxlfd\fP] +[\-wireframe] +[\-fps] +.SH DESCRIPTION +The \fIfliptext\fP program runs another program to generate a stream of +text, then animates the lines of that text transparently flipping in +and out in 3D. +.SH OPTIONS +.I fliptext +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 \-program \fIsh-command\fP +This program will be run periodically, and its output will be the text +that is displayed. Default \fIxscreensaver\-text\fP. + +You can configure the text printed through the "Advanced" tab of +.BR xscreensaver\-demo (1), +or by editing your ~/.xscreensaver file. +.TP 8 +.B \-size \fIinteger\fP +How large a font to use, in points. (Well, in some arbitrary unit +we're calling "points" for the sake of argument.) Default: 20. +.TP 8 +.B \-columns \fIinteger\fP +At (approximately) what column to wrap lines. Default 80. Wrapping is +done by pixels, not characters, and lines will always wrap at the +edge of the screen regardless. +.TP 8 +.B \-left | \-center | \-right +Whether to align the text flush left, centered, or flush right. +The default is to choose randomly each time a new screen of text +is displayed. +.TP 8 +.B \-lines \fIinteger\fP +How many lines of text should be shown at once. Default 8. +.TP 8 +.B \-speed \fIratio\fP +Change the animation speed; 0.5 to go half as fast, 2.0 to go twice as fast. +.TP 8 +.B \-delay \fIusecs\fP +The delay between frames of the animation; default is 10000 (1/10th second.) +.TP 8 +.B \-font \fIfont-name\fP +The name of the font to use. For best effect, this should be a large +font (at least 36 points.) The bigger the font, the better looking the +characters will be. Note that the size of this font affects only the +clarity of the characters, not their size on the screen: for that, use +the \fI\-size\fP or \fI\-columns\fP options. + +Default: -*-utopia-bold-r-normal-*-*-720-*-*-*-*-iso8859-1 +.TP 8 +.B \-fps +Display the current frame rate, CPU load, and polygon count. +.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 xscreensaver (1), +.BR xscreensaver-text (1), +.BR fortune (1), +.BR phosphor (MANSUFFIX), +.BR apple2 (MANSUFFIX), +.BR fontglide (MANSUFFIX), +.BR ljlatest (MANSUFFIX), +.BR dadadodo (1), +.BR webcollage (MANSUFFIX), +.BR driftnet (1) +.BR EtherPEG , +.BR EtherPeek +.SH COPYRIGHT +Copyright \(co 2005 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 diff --git a/hacks/glx/flurry.man b/hacks/glx/flurry.man new file mode 100644 index 00000000..bec54d9d --- /dev/null +++ b/hacks/glx/flurry.man @@ -0,0 +1,73 @@ +.TH XScreenSaver 1 "" "X Version 11" +.SH NAME +flurry - a colorful particle system +.SH SYNOPSIS +.B flurry +[\-display \fIhost:display.screen\fP] +[\-visual \fIvisual\fP] +[\-window] +[\-root] +[\-preset ] +[\-fps] +.SH DESCRIPTION +This is a port of the OSX screensaver flurry. +.SH OPTIONS +.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 \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-preset +Select a preset (classic, fire, water, psychedelic, rgb, binary, random, insane) + +(Insane will never be selected at random, because it requires lots of CPU/GPU +power) + +.TP 8 +.B \-fps +Display the current frame rate, CPU load, and polygon count. +.TP 8 +.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 AUTHORS +OSX screensaver by Calum Robinson + +http://homepage.mac.com/calumr + +xscreensaver port by Tobias Sargeant + +.SH POSTCARDS + +If you really like it, send me a postcard (after all, you're getting this for +free!). Please check this address by downloading the latest version of Flurry +just before you send me a postcard - I may have moved. + +.PD 0 +Calum Robinson +.P +133 Sydenham Avenue +.P +Belfast +.P +Northern Ireland +.P +BT4 2DQ +.PD 0 + +.SH SEE ALSO +.BR X (1), +.BR xscreensaver (1) +.SH COPYRIGHT diff --git a/hacks/glx/flyingtoasters.man b/hacks/glx/flyingtoasters.man new file mode 100644 index 00000000..dbe5d5a9 --- /dev/null +++ b/hacks/glx/flyingtoasters.man @@ -0,0 +1,86 @@ +.TH XScreenSaver 1 "" "X Version 11" +.SH NAME +flyingtoasters - 3d space-age jet-powered flying toasters (and toast) +.SH SYNOPSIS +.B flyingtoasters +[\-display \fIhost:display.screen\fP] +[\-visual \fIvisual\fP] +[\-window] +[\-root] +[\-delay \fInumber\fP] +[\-speed \fInumber\fP] +[\-ntoasters \fInumber\fP] +[\-nslices \fInumber\fP] +[\-no-texture] +[\-wireframe] +[\-fps] +.SH DESCRIPTION +Draws a squadron of shiny 3D space-age jet-powered flying toasters, and +associated toast, flying across your screen. +.SH OPTIONS +.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 \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-delay \fInumber\fP +Per-frame delay, in microseconds. Default: 30000 (0.03 seconds.). +.TP 8 +.B \-speed \fInumber\fP +How fast the toasters fly. Larger for faster. Default: 1.0. +.TP 8 +.B \-ntoasters \fInumber\fP +How many toasters to draw. Default 20. +.TP 8 +.B \-nslices \fInumber\fP +How many slices of toast to draw. Default 25. +.TP 8 +.B \-no-texture +Turn off texture mapping (for slow machines.) +.TP 8 +.B \-wireframe +Render in wireframe instead of solid. +.TP 8 +.B \-fps +Display the current frame rate, CPU load, and polygon count. +.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 After Dark +.SH COPYRIGHT +Copyright \(co 2003 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. + +The original After Dark flying toasters, with the fluffy white wings, +were a trademark of Berkeley Systems. Berkeley Systems ceased to exist +some time in 1998, having been gobbled up by Sierra Online, who were +subsequently gobbled up by Flipside and/or Vivendi (it's hard to tell +exactly what happened when.) + +I doubt anyone even cares any more, but if they do, hopefully this +homage, with the space-age 3D jet-plane toasters, will be considered +different enough that whoever still owns the trademark to the +fluffy-winged 2D bitmapped toasters won't get all huffy at us. +.SH AUTHOR +Code by Jamie Zawinski. Object models by Baconmonkey. diff --git a/hacks/glx/gears.man b/hacks/glx/gears.man new file mode 100644 index 00000000..a54a6afc --- /dev/null +++ b/hacks/glx/gears.man @@ -0,0 +1,79 @@ +.TH XScreenSaver 1 "" "X Version 11" +.SH NAME +gears - draw interlocking gears, for xscreensaver. +.SH SYNOPSIS +.B gears +[\-display \fIhost:display.screen\fP] [\-window] [\-root] [\-install] +[\-visual \fIvisual\fP] +[\-delay \fIusecs\fP] +[\-speed \fIfloat\fP] +[\-no\-spin] +[\-no\-wander] +[-count \fIinteger\fP] +[-wireframe] +[-fps] +.SH DESCRIPTION +This draws a set of rotating gears. +.SH OPTIONS +.I gears +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 \fIusecs\fP +The delay between frames of the animation, in microseconds. +Default: 30000 (0.03 seconds.) +.TP 8 +.B \-speed \fIfloat\fP +Larger numbers mean run faster. Default: 1.0. +.TP 8 +.B \-no\-spin +Don't rotate the object. +.TP 8 +.B \-no\-wander +Don't wander the object around the screen. +.TP 8 +.B \-count \fIinteger\fP +How many gears to draw. Default: 0 for random. +.TP 8 +.B \-wireframe +Render in wireframe instead of solid. +.TP 8 +.B \-fps +Display the current frame rate, CPU load, and polygon count. +.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 2007 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. + +An earlier version of this program by Brian Paul was written in 1997; +this version was rewritten from scratch by jwz in 2007. diff --git a/hacks/glx/geodesic.man b/hacks/glx/geodesic.man new file mode 100644 index 00000000..4a408cae --- /dev/null +++ b/hacks/glx/geodesic.man @@ -0,0 +1,79 @@ +.TH XScreenSaver 1 "" "X Version 11" +.SH NAME +geodesic - animates a mesh geodesic sphere. +.SH SYNOPSIS +.B geodesic +[\-display \fIhost:display.screen\fP] +[\-visual \fIvisual\fP] +[\-window] +[\-root] +[\-mode \fImode\fP] +[\-no-wander] +[\-no-spin] +[\-fps] +[\-delay \fInumber\fP] +[\-speed \fInumber\fP] +[\-count \fInumber\fP] +.SH DESCRIPTION +Animates a mesh geodesic sphere of increasing and decreasing complexity. A +geodesic sphere is an icosohedron whose equilateral faces are sub-divided +into non-equilateral triangles to more closely approximate a sphere. + +The animation shows the equilateral triangles subdivided into four +coplanar equilateral triangles; and then inflated outward, causing the +sub-triangles to no longer be equilateral, but to more closely +approximate the surface of a sphere. +.SH OPTIONS +.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 \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-mode mesh | solid | stellated | stellated2 | wire +Face/edge display style. Default mesh. +.TP 8 +.B \-wander | \-no-wander +Whether the object should wander around the screen. +.TP 8 +.B \-spin | \-no-spin +Whether the object should spin. +.TP 8 +.B \-fps | \-no-fps +Whether to show a frames-per-second display at the bottom of the screen. +.TP 8 +.B \-delay \fInumber\fP +Per-frame delay, in microseconds. Default: 30000 (0.03 seconds). +.TP 8 +.B \-speed \fInumber\fP +Animation speed. 2.0 means twice as fast, 0.5 means half as fast. +.TP 8 +.B \-count \fInumber\fP +Depth (frequency) of the geodesic sphere. Default: 4. +.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 2013 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. diff --git a/hacks/glx/gflux.man b/hacks/glx/gflux.man new file mode 100644 index 00000000..654aeb46 --- /dev/null +++ b/hacks/glx/gflux.man @@ -0,0 +1,111 @@ +.TH XScreenSaver 1 "May 2004" +.SH NAME +gflux \- rippling surface graphics hack +.SH SYNOPSIS +.B gflux +[\-display \fIhost:display.screen\fP] [\-window] [\-root] [\-install] +[\-visual \fIvisual\fP] [\-delay \fImicroseconds\fP] +[\-squares \fInum\fP] [\-resolution \fInum\fP] [\-mode \fImode\fP] +[\-flat \fInum\fP] [\-speed \fInum\fP] +[\-rotationx \fInum\fP] [\-rotationy \fInum\fP] [\-rotationz \fInum\fP] +[\-waves \fInum\fP] [\-waveChange \fInum\fP] [\-waveHeight \fInum\fP] +[\-waveFreq \fInum\fP] [\-zoom \fInum\fP] +[\-wireframe] +[\-fps] +.SH DESCRIPTION +The \fIgflux\fP program draws a colourfull animated rippling square rotating in 3D space. +.SH OPTIONS +.I gflux +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 \-squares \fInum\fP\fP +Specifies the size of the grid in squares. default 19 +.TP 8 +.B \-resolution \fInum\fP\fP +Specifies the wireframe detail of the squares. default 4 +.TP 8 +.B \-mode \fImode\fP\fP +Specifies the draw method: wireframe; solid (meaning a solid colored +surface); light (same as solid, but with lighting effects); +checker (a texture-mapped checkerboard pattern); or grab (meaning +grab an image to manipulate.) + +When grabbing images, the image will be grabbed from the portion of +the screen underlying the window, or from the system's video input, +or from a random file on disk, as indicated by +the \fIgrabDesktopImages\fP, \fIgrabVideoFrames\fP, +and \fIchooseRandomImages\fP options in the \fI~/.xscreensaver\fP +file; see +.BR xscreensaver-demo (1) +for more details. +.TP 8 +.B \-wireframe +Same as "-mode wire". +.TP 8 +.B \-flat \fInum\fP\fP +0 for smooth shading 1 for flat. default 0 +.TP 8 +.B \-speed \fInum\fP\fP +Specifies speed of ripples flowing over the surface. default 0.05 +.TP 8 +.B \-rotationx \fInum\fP \-rotationy \fInum\fP \-rotationz \fInum\fP\fP +Specifies the speed of rotation of the surface in these axis +.TP 8 +.B \-waves \fInum\fP\fP +Specifies the number of ripple centres at any one time. Values should be greater than 1. default 3 +.TP 8 +.B \-waveChange \fInum\fP\fP +Specifies the duration of a ripple centre. after this they fade away to be reborn elsewhere with a different frequency. default 50 +.TP 8 +.B \-waveHeight \fInum\fP\fP +Specifies the height of ripples on the surface. default 1.0 +.TP 8 +.B \-waveFreq \fInum\fP\fP +Specifies the maximum frequency of ripples. default 3.0 +.TP 8 +.B \-zoom \fInum\fP\fP +Specifies the size of the viewport. Smaller values fill the screen with rippling surface. default 1.0 +.TP 8 +.B \-delay \fImicroseconds\fP +How long to pause between frames. Default is 20000, or 0.02 second. +.TP 8 +.B \-fps +Display the current frame rate, CPU load, and polygon count. +.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\-demo (1), +.BR xscreensaver\-getimage (1) +.SH COPYRIGHT +Copyright \(co 2000 by Josiah Pease. 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 +Josiah Pease , 10-Jun-2000. + diff --git a/hacks/glx/glblur.man b/hacks/glx/glblur.man new file mode 100644 index 00000000..968f42f2 --- /dev/null +++ b/hacks/glx/glblur.man @@ -0,0 +1,76 @@ +.TH XScreenSaver 1 "" "X Version 11" +.SH NAME +glblur - 3D radial blur texture fields +.SH SYNOPSIS +.B glblur +[\-display \fIhost:display.screen\fP] +[\-visual \fIvisual\fP] +[\-window] +[\-root] +[\-delay \fInumber\fP] +[\-blursize \fInumber\fP] +[\-no-wander] +[\-no-spin] +[\-spin \fI[XYZ]\fP] +[\-fps] +.SH DESCRIPTION +This program draws a box and a few line segments, and generates a +radial blur outward from it. This creates flowing field effects. + +This is done by rendering the scene into a small texture, then +repeatedly rendering increasingly-enlarged and increasingly-transparent +versions of that texture onto the frame buffer. As such, it's quite +graphics intensive: don't bother trying to run this if you don't have +hardware-accelerated texture support. It will hurt your machine bad. +.SH OPTIONS +.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 \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-delay \fInumber\fP +Per-frame delay, in microseconds. Default: 10000 (0.01 seconds.). +.TP 8 +.B \-blursize \fInumber\fP +How many copies of the scene should be laid down to make the vapor trail. +Default: 15. Larger numbers create smoother fields, but are slower. +.TP 8 +.B \-wander | \-no-wander +Whether the object should wander around the screen. +.TP 8 +.B \-spin [XYZ] +Around which axes should the object spin? +.TP 8 +.B \-no-spin +None. +.TP 8 +.B \-fps +Display the current frame rate, CPU load, and polygon count. +.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 2002 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, with inspiration from a tutorial by Dario Corno. diff --git a/hacks/glx/glcells.man b/hacks/glx/glcells.man new file mode 100644 index 00000000..6c1e7e9b --- /dev/null +++ b/hacks/glx/glcells.man @@ -0,0 +1,97 @@ +.TH XScreenSaver 1 "June 2007" +.SH NAME +glcells \- growing cells graphics hack +.SH SYNOPSIS +.B glcells +[\-display \fIhost:display.screen\fP] [\-window] [\-root] [\-install] +[\-visual \fIvisual\fP] +[\-delay \fInum\fP] [\-pause \fInum\fP] [\-maxcells \fInum\fP] +[\-radius \fInum\fP] [\-seeds \fInum\fP] [\-quality \fInum\fP] +[\-minfood \fInum\fP] [\-maxfood \fInum\fP] [\-divideage \fInum\fP] +[\-mindist \fInum\fP] +[\-keepold] +[\-wireframe] +[\-fps] +.SH DESCRIPTION +The \fIglcells\fP program draws cells that divide exponentially, eat and eventually die. +.SH OPTIONS +.I glcells +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 \-pause \fInum\fP\fP +Specifies the pause at the end of the animation (all cells dead or maximum amount of cells reached). Unit is in frames, default 20. +.TP 8 +.B \-maxcells \fInum\fP\fP +Specifies the maximum number of cells on screen (dead cells also count, even if invisible). Default is 800. +.TP 8 +.B \-radius \fInum\fP\fP +Specifies the radius of the cells. Default is 40. +.TP 8 +.B \-seeds \fInum\fP\fP +Specifies the number of cells when animation starts. Default is 1. +.TP 8 +.B \-quality \fInum\fP\fP +Specifies subdivision quality of the spheres used to draw the cells [0...5]. Default is 3. +.TP 8 +.B \-minfood \fInum\fP\fP +Food is ditributed randomly on the screen (Yes, the cells need to eat). This parameter specifies the +minimum amount of food per pixel. Default is 5. +.TP 8 +.B \-maxfood \fInum\fP\fP +Food is ditributed randomly on the screen (Yes, the cells need to eat). This parameter specifies the +maximum amount of food per pixel. Default is 20. +.TP 8 +.B \-divideage \fInum\fP\fP +Specifies the minimum age in frames a cell needs to have before beeing able to divide. Default is 20 +.TP 8 +.B \-mindist \fInum\fP\fP +Specifies the minimum distance between cells. Default 1.4 +.TP 8 +.B \-delay \fInum\fP +How long to pause between frames. Default is 20000, or 0.02 second. +.TP 8 +.B \-fps +Display the current frame rate, CPU load, and polygon count. +.TP 8 +.B \-wireframe +Draw wireframe only. +.TP 8 +.B \-keepold +Dead cells stay on 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 SEE ALSO +.BR X (1), +.BR xscreensaver (1) +.BR xscreensaver\-demo (1), +.SH COPYRIGHT +Copyright \(co 2007 by Matthias Toussaint. 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 +Matthias Toussaint , 17-Jun-2007, http://www.mtoussaint.de/bits.html. + diff --git a/hacks/glx/gleidescope.man b/hacks/glx/gleidescope.man new file mode 100644 index 00000000..c0b9b158 --- /dev/null +++ b/hacks/glx/gleidescope.man @@ -0,0 +1,77 @@ +.TH XScreenSaver 1 "" "X Version 11" +.SH NAME +gleidescope - a tiled OpenGL kaleidescope +.SH SYNOPSIS +.B gleidescope +[\-display \fIhost:display.screen\fP] +[\-visual \fIvisual\fP] +[\-window] +[\-root] +[-delay \fInumber\fP] +[-move] +[-rotate] +[-zoom] +[-image \fIfile\fP] +[-fps] +[-size \fInumber\fP] +[-duration \fInumber\fP] +.SH DESCRIPTION +A tiled kaleidescope using OpenGL. +.SH OPTIONS +.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 \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-delay \fInumber\fP +Per-frame delay, in microseconds. Default: 20000 (0.02 seconds.). +.TP 8 +.B \-move +Move the camera. +.TP 8 +.B \-rotate +Rotate the camera. +.TP 8 +.B \-zoom +Zoom the camera in and out. +.TP 8 +.B \-image \fIfile\fP +The texture map to use at the end of the kaleidescope. +.TP 8 +.B \-fps +Display the current frame rate, CPU load, and polygon count. +.TP 8 +.B \-size \fInumber\fP +The size of the hexagons being displayed [1(small)-10(large)] +.TP 8 +.B \-duration \fInumber\fP +The time in seconds before another image is chosen. +.TP 8 +.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 2003 by Andrew Dean 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 +Andrew Dean. diff --git a/hacks/glx/glhanoi.man b/hacks/glx/glhanoi.man new file mode 100644 index 00000000..2060cde9 --- /dev/null +++ b/hacks/glx/glhanoi.man @@ -0,0 +1,83 @@ +.TH XScreenSaver 1 "" "X Version 11" +.SH NAME +glhanoi - OpenGL Towers of Hanoi +.SH SYNOPSIS +.B glhanoi +[\-display \fIhost:display.screen\fP] +[\-visual \fIvisual\fP] +[\-window] +[\-root] +[\-delay \fInumber\fP] +[\-count \fInumber\fP] +[\-poles \fInumber\fP] +[\-speed \fInumber\fP] +[\-wireframe] +[\-light] +[\-texture] +[\-fog] +[\-fps] +.SH DESCRIPTION +Implementation of Towers of Hanoi in OpenGL +.SH OPTIONS +.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 \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-delay \fInumber\fP +Per-frame delay, in microseconds. Default: 30000 (0.03 seconds.). +.TP 8 +.B \-count \fInumber\fP +Number of disks. Default: 7. +.TP 8 +.B \-poles \fInumber\fP +Number of poles. Default: random from 3 to disks+1. +.TP 8 +.B \-speed \fInumber\fP +Speed multiplier (for smallest disks). Default: 1. +.TP 8 +.B \-trails \fInumber\fP +Length of disk trails, in seconds. Default: 2. +.TP 8 +.B \-wireframe | \-no-wireframe +Render in wireframe instead of solid. +.TP 8 +.B \-fog | \-no-fog +Render in fog. +.TP 8 +.B \-fps +Display the current frame rate, CPU load, and polygon count. +.TP 8 +.B \-light | -no-light +Whether the scene is lit. +.TP 8 +.B \-texture | \-no-texture +Render with textures instead of solid. +.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 2004 by Dave Atkinson. 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 +Dave Atkinson. diff --git a/hacks/glx/glknots.man b/hacks/glx/glknots.man new file mode 100644 index 00000000..c4f1d1ae --- /dev/null +++ b/hacks/glx/glknots.man @@ -0,0 +1,81 @@ +.TH XScreenSaver 1 "" "X Version 11" +.SH NAME +glknots - generates some twisting 3d knot patterns +.SH SYNOPSIS +.B glknots +[\-display \fIhost:display.screen\fP] +[\-visual \fIvisual\fP] +[\-window] +[\-root] +[\-delay \fInumber\fP] +[\-speed \fIfloat\fP] +[\-segments \fIint\fP] +[\-thickness \fIfloat\fP] +[\-duration \fIseconds\fP] +[\-no-wander] +[\-spin \fIXYZ\fP] +[\-wireframe] +[\-fps] +.SH DESCRIPTION +Generates some twisting 3d knot patterns. Spins 'em around. +.SH OPTIONS +.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 \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-delay \fInumber\fP +Per-frame delay, in microseconds. Default: 30000 (0.03 seconds.). +.TP 8 +.B \-speed \fInumber\fP +Larger numbers mean run faster. Default: 1.0. +.TP 8 +.B \-segments \fInumber\fP +Number of segments in each path. Default 800. Larger numbers make the +curves smoother, at the expense of a higher polygon count. +.TP 8 +.B \-thickness \fIfloat\fP +How thick the tubes should be. Default 0.3. +.TP 8 +.B \-duration \fIseconds\fP +How long to leave each knot up. Default 8 seconds. +.TP 8 +.B \-wander | \-no-wander +Whether the cubes should wander around the screen. +.TP 8 +.B \-spin [XYZ] | \-no-spin +Which axes, if any, to spin around on. +.TP 8 +.B \-wireframe | \-no-wireframe +Render in wireframe instead of solid. +.TP 8 +.B \-fps +Display the current frame rate, CPU load, and polygon count. +.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 2003 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. diff --git a/hacks/glx/glmatrix.man b/hacks/glx/glmatrix.man new file mode 100644 index 00000000..92902907 --- /dev/null +++ b/hacks/glx/glmatrix.man @@ -0,0 +1,116 @@ +.TH XScreenSaver 1 "30-Oct-99" "X Version 11" +.SH NAME +glmatrix - simulates the title sequence effect of the movie +.SH SYNOPSIS +.B glmatrix +[\-display \fIhost:display.screen\fP] [\-window] [\-root] [\-install] +[\-visual \fIvisual\fP] +[\-delay \fIusecs\fP] +[\-speed \fIratio\fP] +[\-density \fIpct\fP] +[\-no\-fog] +[\-no\-waves] +[\-no\-rotate] +[\-binary] +[\-hexadecimal] +[\-dna] +[\-clock] +[\-timefmt \fIfmt\fP] +[\-wireframe] +[\-fps] +.SH DESCRIPTION +The \fIglmatrix\fP program draws the 3D "digital rain" effect, as seen +in the title sequence of the Wachowski brothers' film, "The Matrix". + +Also see +.BR xmatrix (MANSUFFIX) +for a 2D rendering of the similar effect that appeared on the +computer monitors actually \fIin\fP the movie. +.SH OPTIONS +.I glmatrix +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 \-delay \fIusecs\fP +The delay between frames of the animation, in microseconds: default 30000. +.TP 8 +.B \-speed \fIratio\fP +How fast the glyphs should move; default 1.0. 2.0 means twice as fast, +0.5 means half as fast. +.TP 8 +.B \-density \fIpercentage\fP +The approximate percentage of the screen that should be filled with +characters at any given time. Default 20%. +.TP 8 +.B \-no\-fog +By default, glyphs are dimmer the farther away they are. This +argument disables that. +.TP 8 +.B \-no\-waves +By default, waves of color roll down the columns of glyphs. This +argument disables that. +.TP 8 +.B \-no-rotate\fP +By default, the scene slowly tilts and rotates. This +argument disables that. +.TP 8 +.B \-binary\fP +Instead of displaying Matrix glyphs, only display ones and zeros. +.TP 8 +.B \-hexadecimal\fP +Instead of displaying Matrix glyphs, display hexadecimal digits. +.TP 8 +.B \-dna\fP +Instead of displaying Matrix glyphs, display genetic code +(guanine, adenine, thymine, and cytosine.) +.TP 8 +.B \-clock\fP +Hide a clock displaying the current time somewhere in the glyphs. +.TP 8 +.B \-timefmt\fP \fIstrftime-string\fP +How to format the clock when \fI\-clock\fP is specified. +Default "\ %l%M%p\ ". +.TP 8 +.B \-speed \fIratio\fP +Less than 1 for slower, greater than 1 for faster. Default 1. +.TP 8 +.B \-wireframe +Just draw boxes instead of textured characters. +.TP 8 +.B \-fps +Display the current frame rate, CPU load, and polygon count. +.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 xmatrix (MANSUFFIX), +.BR X (1), +.BR xscreensaver (1) +.SH COPYRIGHT +Copyright \(co 1999-2003 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 , 8-Jun-2003. diff --git a/hacks/glx/glplanet.man b/hacks/glx/glplanet.man new file mode 100644 index 00000000..a01358ee --- /dev/null +++ b/hacks/glx/glplanet.man @@ -0,0 +1,70 @@ +.TH XScreenSaver 1 "" "X Version 11" +.SH NAME +glplanet - rotating 3d texture-mapped planet. +.SH SYNOPSIS +.B glplanet +[\-display \fIhost:display.screen\fP] +[\-visual \fIvisual\fP] +[\-window] +[\-root] +[\-no-light] +[\-delay \fInumber\fP] +[\-image \fIfile\fP] +[\-resolution \fInumber\fP] +[\-wireframe] +[\-fps] +.SH DESCRIPTION +Draws a planet bouncing around in space. The built-in image is a map +of the earth, but you can wrap any texture around the sphere, e.g., the +planetary textures that come with `ssystem'. +.SH OPTIONS +.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 \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-light | \-no-light +Use Flat Coloring. +.TP 8 +.B \-delay \fInumber\fP +Per-frame delay, in microseconds. Default: 20000 (0.02 seconds.). +.TP 8 +.B \-images \fIfile\fP +The texture map to wrap around the planet's surface. +.TP 8 +.B \-resolution +The resolution of the planet. Default: 128. +.TP 8 +.B \-wireframe +Render in wireframe instead of solid. +.TP 8 +.B \-fps +Display the current frame rate, CPU load, and polygon count. +.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 2002 by David Konerding. 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 +David Konerding. diff --git a/hacks/glx/glschool.man b/hacks/glx/glschool.man new file mode 100644 index 00000000..8de00c41 --- /dev/null +++ b/hacks/glx/glschool.man @@ -0,0 +1,126 @@ +.TH XScreenSaver 1 "" "X Version 11" +.SH NAME +glschool - a 3D schooling simulation +.SH SYNOPSIS +.B glschool +[\-display \fIhost:display.screen\fP] +[\-visual \fIvisual\fP] +[\-window] +[\-root] +[\-wireframe] +[\-fps] +[\-delay \fInumber\fP] +[\-nfish \fInumber\fP] +[\-maxvel \fInumber\fP] +[\-minvel \fInumber\fP] +[\-acclimit \fInumber\fP] +[\-avoidfact \fInumber\fP] +[\-matchfact \fInumber\fP] +[\-centerfact \fInumber\fP] +[\-targetfact \fInumber\fP] +[\-minradius \fInumber\fP] +[\-momentum \fInumber\fP] +[\-distexp \fInumber\fP] +[\-goalchgf \fInumber\fP] +[\-fog] +[\-drawgoal] +[\-drawbbox] +.SH DESCRIPTION +Uses Craig Reynolds Boids algorithm to simulate a 3d school of +fish. See for a description +of the algorithm and the original paper. This is a lightly modified +version of the algorithm that supports goal attraction. + +Many different behaviors are possible by tweaking the parameters. No sanity checking is performed +on the command line params, so if you want to use negative accelerations or minimum velocity that is +larger than maximum velocity or that sort of thing, the simulation will try to digest it. + +It looks best with the highest number of fish that will give you an FPS of > 25 or so. + +.SH OPTIONS +.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 \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-delay \fInumber\fP +Per-frame delay, in microseconds. Default: 20000 (0.020 seconds.). +.TP 8 +.B \-wireframe | \-no-wireframe +Render in wireframe instead of solid. +.TP 8 +.B \-fps +Display the current frame rate, CPU load, and polygon count. +.TP 8 +.B \-fog | \-no-fog + Whether to show foggy (cloudy) water. +.TP 8 +.B \-drawgoal | \-no-drawgoal + Whether to show the school's attraction goal. +.TP 8 +.B \-drawbbox | \-no-drawbbox + Whether to show the bounding box. +.TP 8 +.B \-fog | \-no-fog + Whether to show foggy (cloudy) water. +.TP 8 +.B \-nfish \fInumber\fP +Number of fish. Defaults to 100 +.TP 8 +.B \-acclimit \fInumber\fP +Acceleration limit. Defaults to 8.0 +.TP 8 +.B \-minvel \fInumber\fP +Minimum velocity. Defaults to 1.0 +.TP 8 +.B \-maxvel \fInumber\fP +Minimum velocity. Defaults to 7.0 +.TP 8 +.B \-goalchgf \fInumber\fP +Goal change frequency. Defaults to 50 (frames) +.TP 8 +.B \-avoidfact \fInumber\fP +Avoidance acceleration factor. Defaults to 1.5 +.TP 8 +.B \-matchfact \fInumber\fP +Match avg velocity acceleration factor. Defaults to 0.15 +.TP 8 +.B \-centerfact \fInumber\fP +School centering acceleration factor. Defaults to 0.1 +.TP 8 +.B \-targetfact \fInumber\fP +Target attraction acceleration factor. Defaults to 80 +.TP 8 +.B \-distexp \fInumber\fP +Distance weighting exponent. Defaults to 2.2 +.TP 8 +.B \-momentum \fInumber\fP +Momentum. Defaults to 0.9 +.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 2005-2006 by David C. Lambert. 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 +David C. Lambert diff --git a/hacks/glx/glslideshow.man b/hacks/glx/glslideshow.man new file mode 100644 index 00000000..4ce46724 --- /dev/null +++ b/hacks/glx/glslideshow.man @@ -0,0 +1,131 @@ +.TH XScreenSaver 1 "" "X Version 11" +.SH NAME +glslideshow - slideshow of images using smooth zooming and fades +.SH SYNOPSIS +.B glslideshow +[\-display \fIhost:display.screen\fP] +[\-visual \fIvisual\fP] +[\-window] +[\-root] +[\-duration \fIseconds\fP] +[\-zoom \fIpercent\fP] +[\-pan \fIseconds\fP] +[\-fade \fIseconds\fP] +[\-titles] +[\-letterbox | \-clip] +[\-delay \fIusecs\fP] +[\-fps] +[\-debug] +[\-wireframe] +[\-cutoff \fIint\fP] +.SH DESCRIPTION +Loads a random sequence of images and smoothly scans and zooms around +in each, fading from pan to pan. + +This program requires a good video card capable of supporting large +textures. + +To specify the directory that images are loaded from, run +.BR xscreensaver-demo (1) +and click on the "Advanced" tab. +.SH OPTIONS +.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 \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-duration \fIseconds\fP +How long each image will be displayed before loading a new one. +Default 30 seconds. +.TP 8 +.B \-pan \fIseconds\fP +How long each pan-and-zoom should last. Default 6 seconds. + +With the default settings of \fI\-pan 6 \-duration 30\fP, each image +will be displayed five times (30/6), and then a new image will be loaded. +If you want a new image to be loaded at each fade, then set \fI\-pan\fP +and \fI\-duration\fP to the same value. +.TP 8 +.B \-fade \fIseconds\fP +How long each cross-fade between images should last. Default 2 seconds. +If set to 0, then no cross-fading will be done (all transitions +will be jump-cuts.) + +Note that fades are included in the pan time, so \fI\-fade\fP cannot +be larger than \fI\-pan\fP. +.TP 8 +.B \-zoom \fInumber\fP +Amount to zoom and pan as a percentage. Default: 75, meaning that +75% or more of each image will always be visible. If set to 100%, +then the images will always fill the screen, and no panning or +zooming will occur. (Images will still smoothly fade from one +to another if \fI\-fade\fP is non-zero.) +.TP 8 +.B \-titles +Whether to print the file name of the current image in the upper left corner. +.TP 8 +.B \-letterbox +In "letterbox" mode, when an image is not the same aspect ratio as the screen, +black bars will appear at the top/bottom or left/right so that the whole +image can be displayed. This is the default. +.TP 8 +.B \-clip +In "clip" mode, when an image is not the same aspect ratio as the screen, +we will zoom in further until the image takes up the whole screen. +This is the opposite of \fI\-letterbox\fP. +.TP 8 +.B \-delay \fInumber\fP +Per-frame delay, in microseconds. Default: 20000 (0.02 seconds.). +.TP 8 +.B \-fps +Display the current frame rate, CPU load, and polygon count. +.TP 8 +.B \-cutoff \fInumber\fP +If the frame rate we are achieving is lower than this, then panning, +fading, and zooming will be disabled. Default 5 FPS. + +The idea here is that if your machine can't maintain a decent frame +rate, then it must not have fast 3D hardware, so we might as well +behave in a simpler manner. Set this to 0 to disable this check. +.TP 8 +.B \-debug +Prints debugging info to stderr. +.TP 8 +.B \-wireframe +Another debug mode. +.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-demo (1), +.BR xscreensaver-getimage (1), +.BR xscreensaver (1), +.BR carousel (MANSUFFIX) +.BR photopile (MANSUFFIX) +.SH COPYRIGHT +Copyright \(co 2003-2005 by Jamie Zawinski, based on an earlier version +that was +Copyright \(co 2002 by Mike Oliphant. + +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 and Mike Oliphant. diff --git a/hacks/glx/glsnake.man b/hacks/glx/glsnake.man new file mode 100644 index 00000000..217be2f8 --- /dev/null +++ b/hacks/glx/glsnake.man @@ -0,0 +1,98 @@ +.\" Hey, EMACS: -*- nroff -*- +.TH XScreenSaver 1 "January 15, 2001" "X Version 11" +.SH NAME +glsnake \- OpenGL enhanced Rubik's Snake cyclewaster. +.SH SYNOPSIS +.B glsnake +[\-display \fIhost:display.screen\fP] [\-window] [\-root] +[\-visual \fIvisual\fP] [\-delay \fImicroseconds\fP] [\-fps] +[\-wireframe] [\-altcolour] +[\-angvel \fIangular\fP] +[\-explode \fIdistance\fP] +[\-statictime \fImilliseconds\fP] +[\-yangvel \fIangle\fP] +[\-zangvel \fIangle\fP] +.SH DESCRIPTION +.PP +.B glsnake +is an imitation of Rubiks\' Snake, using OpenGL. +.SH OPTIONS +.I glsnake +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 \-fps +Display the current frame rate, CPU load, and polygon count. +.TP 8 +.B \-wireframe +Display the snake in wireframe mode, rather than the default solid mode. +.TP 8 +.B \-altcolour +Use the alternate colour scheme for the snake. Shape identification using +colour will be disabled. +.TP 8 +.B -angvel \fIangular\fP +Change the speed at which the snake morphs to a new shape. +.TP 8 +.B -explode \fIdistance\fP +Change the distance between the nodes of a snake. +.TP 8 +.B \-statictime \fImilliseconds\fP +Change the time between morphs. +.TP 8 +.B \-yangvel \fIangle\fP +Change the angle of rotation around the Y axis per frame. +.TP 8 +.B \-zangvel \fIangle\fP +Change the angle of rotation around the Z axis per frame. +.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 +.TP +\fB/usr/share/glsnake/*.glsnake\fP +This XScreenSaver will attempt to read model files installed with the interactive \fBglsnake\fP. +.SH SEE ALSO +.BR X (1), +.BR xscreensaver (1), +.BR glsnake (MANSUFFIX) +.PP +.EX +http://spacepants.org/src/glsnake/ +.EE +.SH BUGS +The snake will happily intersect itself while morphing (this is not a bug). +.PP +The rotation/camera position sucks. +.SH COPYRIGHT +Copyright \(co 2001,2002 by Jamie Wilkinson, Andrew Bennetts, and Peter Aylett. +.PP +This program is free software; you can redistribute it and/or modify it under +the terms of the GNU General Public License as published by the Free Software +Foundation; either version 2 of the License, or (at your option) any later +version. +.PP +This program is distributed in the hope that it will be useful, but WITHOUT +ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS +FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. +.SH AUTHOR +Jamie Wilkinson , Andrew Bennetts , +and Peter Aylett . Ported to XScreenSaver by Jamie Wilkinson. diff --git a/hacks/glx/gltext.man b/hacks/glx/gltext.man new file mode 100644 index 00000000..0af1d0a3 --- /dev/null +++ b/hacks/glx/gltext.man @@ -0,0 +1,123 @@ +.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 "25-Jul-98" "X Version 11" +.SH NAME +gltext - draws text spinning around in 3D +.SH SYNOPSIS +.B gltext +[\-display \fIhost:display.screen\fP] [\-window] [\-root] +[\-visual \fIvisual\fP] [\-delay \fImicroseconds\fP] +[\-text \fIstring\fP] +[\-program \fIcommand\fP] +[\-wander] [\-no-wander] +[\-spin \fIaxes\fP] +[\-no-spin] +[\-front] [\-no\-front] +[\-wireframe] +[\-fps] +.SH DESCRIPTION +The \fIgltext\fP program draws some text spinning around in 3D, using +a font that appears to be made of solid tubes. +.SH OPTIONS +.I gltext +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 \-text \fIstring\fP +The text to display. This may contain newlines, but it shouldn't be +very long. The default is to display the machine name and OS version. + +This may also be a format string acceptable to +.BR date (1) +and +.BR strftime (3) , +in which case, it will be updated once a second. So to make this +program display a spinning digital clock, you could do this: +.EX +gltext -text "%A%n%d %b %Y%n%l:%M:%S %p" +.EE +To include a literal `%', you must double it: `%%'. + +See the man page for +.BR strftime (3) +for more details. +.TP 8 +.B \-program \fIcommand\fP +The given program is run, and its output is displayed. +If specified, this overrides \fI\-text\fP. +The program will be re-run every 5 seconds to re-generate the text. +It should run quickly, and shouldn't generate too much text. +.TP 8 +.B \-wander +Move the text around the screen. This is the default. +.TP 8 +.B \-no\-wander +Keep the text centered on the screen. +.TP 8 +.B \-spin +Which axes around which the text should spin. The default is "XYZ", +meaning rotate it freely in space. "\fB\-spin Z\fP" would rotate the +text in the plane of the screen while not rotating it into or out +of the screen; etc. +.TP 8 +.B \-no\-spin +Don't spin the text at all: the same as \fB\-spin ""\fP. +.TP 8 +.B \-front +When spinning, never spin all the way around or upside down: +always face mostly forward so that the text is easily readable. +.TP 8 +.B \-no\-front +Allow spins to go all the way around or upside down. This is the default. +.TP 8 +.B \-wireframe +Render in wireframe instead of solid. +.TP 8 +.B \-fps +Display the current frame rate, CPU load, and polygon count. +.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 2001-2005 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 diff --git a/hacks/glx/hilbert.man b/hacks/glx/hilbert.man new file mode 100644 index 00000000..8693dce6 --- /dev/null +++ b/hacks/glx/hilbert.man @@ -0,0 +1,103 @@ +.TH XScreenSaver 1 "" "X Version 11" +.SH NAME +hilbert - 3D Hilbert fractal. +.SH SYNOPSIS +.B hilbert +[\-display \fIhost:display.screen\fP] +[\-visual \fIvisual\fP] +[\-window] +[\-root] +[\-delay \fInumber\fP] +[\-speed \fIratio\fP] +[\-depth \fInumber\fP] +[\-spin] +[\-wander] +[\-2d] +[\-3d] +[\-closed] +[\-open] +[\-max\-depth \fInumber\fP] +[\-thickness \fIratio\fP] +[\-wireframe] +[\-fps] +.SH DESCRIPTION +This draws the recursive Hilbert space-filling curve, in both 2D and +3D variants. It incrementally animates the growth and recursion to +the maximum depth, then unwinds it back. + +The Hilbert path is a single contiguous line that can fill a volume +without crossing itself. As a data structure, Hilbert paths are +useful because ordering along the curve preserves locality: points +that close together along the curve are also close together in space. +The converse is often, but not always, true. The coloration +reflects this. +.SH OPTIONS +.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 \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-delay \fInumber\fP +Per-frame delay, in microseconds. Default: 30000 (0.03 seconds.). +.TP 8 +.B \-speed \fInumber\fP +How fast the animation should run. +Less than 1 for slower, greater than 1 for faster. +.TP 8 +.B \-max\-depth \fInumber\fP +Max depth to descend. Default: 5, which peaks at around half a +million polygons. +.TP 8 +.B \-spin +.B \-no\-spin +Whether to rotate the object. Default: true. +.TP 8 +.B \-wander +.B \-no\-wander +Whether to wander the object around on the screen. Default: false; +.TP 8 +.B \-2d +.B \-3d +Whether to draw the 2D or 3D variant. Default: random. +.TP 8 +.B \-closed +.B \-open +Whether to draw the open or closed-path variant. Default: random. +.TP 8 +.B \-thickness \fIratio\fP +How thick the lines should be. Default: 0.25. +.TP 8 +.B \-wireframe +Render in wireframe instead of solid. +.TP 8 +.B \-fps +Display the current frame rate, CPU load, and polygon count. +.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 2011 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. diff --git a/hacks/glx/hypertorus.man b/hacks/glx/hypertorus.man new file mode 100644 index 00000000..8c7075f7 --- /dev/null +++ b/hacks/glx/hypertorus.man @@ -0,0 +1,188 @@ +.TH XScreenSaver 1 "" "X Version 11" +.SH NAME +hypertorus - Draws a hypertorus that rotates in 4d +.SH SYNOPSIS +.B hypertorus +[\-display \fIhost:display.screen\fP] +[\-install] +[\-visual \fIvisual\fP] +[\-window] +[\-root] +[\-delay \fIusecs\fP] +[\-fps] +[\-wireframe] +[\-surface] +[\-transparent] +[\-solid] +[\-bands] +[\-spirals-{1,2,4,8,16}] +[\-twosided] +[\-colorwheel] +[\-perspective-3d] +[\-orthographic-3d] +[\-perspective-4d] +[\-orthographic-4d] +[\-speed-wx \fIfloat\fP] +[\-speed-wy \fIfloat\fP] +[\-speed-wz \fIfloat\fP] +[\-speed-xy \fIfloat\fP] +[\-speed-xz \fIfloat\fP] +[\-speed-yz \fIfloat\fP] +.SH DESCRIPTION +The \fIhypertorus\fP program shows the Clifford torus as it rotates in +4d. The Clifford torus is a torus lies on the "surface" of the +hypersphere in 4d. The program projects the 4d torus to 3d using +either a perspective or an orthographic projection. Of the two +alternatives, the perspective projection looks much more appealing. +In orthographic projections the torus degenerates into a doubly +covered cylinder for some angles. The projected 3d torus can then be +projected to the screen either perspectively or orthographically. +There are three display modes for the torus: mesh (wireframe), solid, +or transparent. Furthermore, the appearance of the torus can be as a +solid object or as a set of see-through bands or see-through spirals. +Finally, the colors with with the torus is drawn can be set to either +two-sided or to a color wheel. In the first case, the torus is drawn +with red on the outside and green on the inside. This mode enables +you to see that the torus turns inside-out as it rotates in 4d. The +second mode draws the torus with a fully saturated color wheel. This +gives a very nice effect when combined with the see-through bands or +see-through spirals mode. The rotation speed for each of the six +planes around which the torus rotates can be chosen. This program is +very much inspired by Thomas Banchoff's book "Beyond the Third +Dimension: Geometry, Computer Graphics, and Higher Dimensions", +Scientific American Library, 1990. +.SH OPTIONS +.I hypertorus +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 much of a delay should be introduced between steps of the +animation. Default 25000, or 1/40th second. +.PP +The following three options are mutually exclusive. They determine +how the torus is displayed. +.TP 8 +.B \-wireframe +Display the torus as a wireframe mesh. +.TP 8 +.B \-surface +Display the torus as a solid surface (default). +.TP 8 +.B \-transparent +Display the torus as a transparent surface. +.PP +The following seven options are mutually exclusive. They determine the +appearance of the torus. +.TP 8 +.B \-solid +Display the torus as a solid object. +.TP 8 +.B \-bands +Display the torus as see-through bands (default). +.TP 8 +.B \-spirals-1, \-spirals-2, \-spirals-4, \-spirals-8, \-spirals-16 +Display the torus as see-through spirals with the indicated number of +spirals. +.PP +The following two options are mutually exclusive. They determine how +to color the torus. +.TP 8 +.B \-twosided +Display the torus with two colors: red on the outside and green on +the inside. +.TP 8 +.B \-colorwheel +Display the torus with a fully saturated color wheel (default). If +the torus is displayed as see-through bands each band will be +displayed with a different color. Likewise, if the torus is displayed +as see-through spirals each spiral will receive a different color. +.PP +The following two options are mutually exclusive. They determine how +the torus is projected from 3d to 2d (i.e., to the screen). +.TP 8 +.B \-perspective-3d +Project the torus from 3d to 2d using a perspective projection +(default). +.TP 8 +.B \-orthographic-3d +Project the torus from 3d to 2d using an orthographic projection. +.PP +The following two options are mutually exclusive. They determine how +the torus is projected from 4d to 3d. +.TP 8 +.B \-perspective-4d +Project the torus from 4d to 3d using a perspective projection +(default). +.TP 8 +.B \-orthographic-4d +Project the torus from 4d to 3d using an orthographic projection. +.PP +The following six options determine the rotation speed of the torus +around the six possible hyperplanes. The rotation speed is measured +in degrees per frame. The speeds should be set to relatively small +values, e.g., less than 4 in magnitude. +.TP 8 +.B \-speed-wx \fIfloat\fP +Rotation speed around the wx plane (default: 1.1). +.TP 8 +.B \-speed-wy \fIfloat\fP +Rotation speed around the wy plane (default: 1.3). +.TP 8 +.B \-speed-wz \fIfloat\fP +Rotation speed around the wz plane (default: 1.5). +.TP 8 +.B \-speed-xy \fIfloat\fP +Rotation speed around the xy plane (default: 1.7). +.TP 8 +.B \-speed-xz \fIfloat\fP +Rotation speed around the xz plane (default: 1.9). +.TP 8 +.B \-speed-yz \fIfloat\fP +Rotation speed around the yz plane (default: 2.1). +.TP 8 +.B \-fps +Display the current frame rate, CPU load, and polygon count. +.SH INTERACTION +If you run this program in standalone mode you can rotate the +hypertorus by dragging the mouse while pressing the left mouse button. +This rotates the hypertorus in 3D, i.e., around the wx, wy, and wz +planes. If you press the shift key while dragging the mouse with the +left button pressed the hypertorus is rotated in 4D, i.e., around the +xy, xz, and yz planes. To examine the hypertorus at your leisure, it +is best to set all speeds to 0. Otherwise, the hypertorus will rotate +while the left mouse button is not pressed. +.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 2003-2005 by Carsten Steger. 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 +Carsten Steger , 28-sep-2005. diff --git a/hacks/glx/hypnowheel.man b/hacks/glx/hypnowheel.man new file mode 100644 index 00000000..233c9453 --- /dev/null +++ b/hacks/glx/hypnowheel.man @@ -0,0 +1,80 @@ +.TH XScreenSaver 1 "" "X Version 11" +.SH NAME +hypnowheel - draws overlapping, translucent spiral patterns +.SH SYNOPSIS +.B hypnowheel +[\-display \fIhost:display.screen\fP] +[\-visual \fIvisual\fP] +[\-window] +[\-root] +[\-delay \fIint\fP] +[\-layers \fIint\fP] +[\-count \fIint\fP] +[\-twistiness \fIfloat\fP] +[\-speed \fIfloat\fP] +[\-wander\fP] +[\-symmetric\fP] +[\-fps] +.SH DESCRIPTION +Draws a series of overlapping, translucent spiral patterns. +The tightness of their spirals fluctuates in and out. +.SH OPTIONS +.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 \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-delay \fIint\fP +Delay between frames, in microseconds. Default 20000. +.TP 8 +.B \-layers \fIint\fP +How many different spirals to draw at once. Default 4. +.TP 8 +.B \-count \fIint\fP +How many arms each spiral should have. Default 11. +.TP 8 +.B \-twistiness \fIfloat\fP +How tightly wound the spirals can become, measured in rotations. +Default 4.0 (four times around). +.TP 8 +.B \-speed \fIratio\fP +Less than 1 for slower, greater than 1 for faster. Default 1. +.TP 8 +.B \-wander +If specified, then the centers of the spirals will wander around, +rather than them all having the same origin. +.TP 8 +.B \-symmetric +If specified, then each pair of left-wrapping and right-wrapping +spirals will be mirror images of each other. +.TP 8 +.B \-fps +Display the current frame rate, CPU load, and polygon count. +.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 2008 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. diff --git a/hacks/glx/jigglypuff.man b/hacks/glx/jigglypuff.man new file mode 100644 index 00000000..4a5f8bf5 --- /dev/null +++ b/hacks/glx/jigglypuff.man @@ -0,0 +1,121 @@ +.TH XScreenSaver 1 "" "X Version 11" +.SH NAME +jigglypuff - save your screen by tormenting your eyes. +.SH SYNOPSIS +.B jigglypuff +[\-display \fIhost:display.screen\fP] +[\-visual \fIvisual\fP] +[\-window] +[\-root] +[-delay \fInumber\fP] +[-cycles \fInumber\fP] +[-wireframe] +[-fps] +[-color \fIcolorspec\fP] +[-spooky] +[-complexity \fIn\fP] +[-speed \fIn\fP] +[-spherism \fIn\fP] +[-hold \fIn\fP] +[-distance \fIn\fP] +[-damping \fIn\fP] +.SH DESCRIPTION +This draws all manners of obscene, spastic, puffy, vaguely ball-shaped +objects orbiting lazily about the screen, with a dizzying array of +mostly pointless options. +.SH OPTIONS +.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 \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-delay \fInumber\fP +Per-frame delay, in microseconds. Default: 20000 (0.02 seconds.). +.TP 8 +.B \-wireframe +Render in wireframe instead of solid. Default: render solid. +.TP 8 +.B \-fps +Display the current frame rate, CPU load, and polygon count. +.TP 8 +.B -tetra | -no-tetra +Whether to start the shape in the form of a tetrahedron. The default +is to start as a sphere. +.TP 8 +.B -color \fIcolorspec\fP +Available options for colorspec are: cycle, flowerbox, clownpuke, chrome +and #xxxxxx (i.e an (old-style) X color specification.) Default: cycle +.TP 8 +.B -spooky \fIn\fP +This option controls a kind of interesting effect obtained by +using unnormalized normal vectors (how's that for an oxymoron?) in OpenGL. +A value of zero disables the effect. Other values vary the lengths of +the normals proportionally. +Okay, so it's not very spooky. Sue me. +Default: 0 +.TP 8 +.B -complexity \fIn\fP +Valid options are 1, 2, and 3. Everything else is treated as though it +were 2, which is the default. This controls the number of polygons in +the 'thing'. A value of 1 yields 1024, and the values go up in powers +of 4. (i.e. 4096, 16384.) + note: There is an inherent lack of stability +at lower complexity, which can cause the shape to devolve into a 'flying +snotrag'. +.TP 8 +.B -speed \fIn\fP +Controls how fast the blob moves around the screen. Default: 500. +.TP 8 +.B -spherism, -hold, -distance, -damping +These options control the 'jigglyness'. The best way to explain these is +to explain how jigglypuff works. Basically, the shape is a tetrahedron +whose faces are subdivided into a number of triangles, forming a mesh. +Each of the vertices of the mesh has two different forces applied to it: +one proportional to its distance from the surface of a sphere, and one +proportional to the difference of the distance to each of its neighbors +in the mesh to a given ideal distance. In short, one tries to move the +points into the configuration of a sphere, and the other tries to push +them back into a tetrahedron. The catch is that the points have inertia, +so they always overshoot their target, and hence they oscillate. The +magnitudes of the two forces is controlled by the options 'spherism' and +\'hold'; 'distance' specifies the distance the vertices seek to keep from +their neighbors, with 500 corresponding to the size of the start tetrahedron. +e.g. if you were to give the options '-tetra -spherism 0 -distance 500', you +would end up with a stable tetrahedron. The 'damping' option can help to +keep the blob from collapsing or flying apart. The option specifies the +speed at which damping starts, hence lower values mean more damping. +Defaults: spherism: 75; hold: 800; distance: 100; damping: 500. +.TP 8 +.B -random +Probably the only parameter you'l ever need. Overrides almost all of the +parameters with random values. The values affected are: speed, spherism, +hold, distance, damping, spooky, color, wireframe and tetra. +Default: off +.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 2003 by Keith Macleod. 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 +By Keith Macleod diff --git a/hacks/glx/jigsaw.man b/hacks/glx/jigsaw.man new file mode 100644 index 00000000..c7d34933 --- /dev/null +++ b/hacks/glx/jigsaw.man @@ -0,0 +1,90 @@ +.TH XScreenSaver 1 "25-Aug-2008" "X Version 11" +.SH NAME +jigsaw - permute an image like a jigsaw puzzle +.SH SYNOPSIS +.B jigsaw +[\-display \fIhost:display.screen\fP] +[\-delay \fIusecs\fP] +[\-speed \fIratio\fP] +[\-complexity \fIratio\fP] +[\-resolution \fIint\fP] +[\-thickness \fIfloat\fP] +[\-no\-wobble] +[\-fps] +.SH DESCRIPTION +The \fIjigsaw\fP program loads an image, carves it up into +a jigsaw puzzle, shuffles it, and then solves it. + +The image that it manipulates will be grabbed from the portion of +the screen underlying the window, or from the system's video input, +or from a random file on disk, as indicated by +the \fIgrabDesktopImages\fP, \fIgrabVideoFrames\fP, +and \fIchooseRandomImages\fP options in the \fI~/.xscreensaver\fP +file; see +.BR xscreensaver-demo (1) +for more details. +.SH OPTIONS +.I jigsaw +accepts the following options: +.TP 8 +.B \-delay \fImicroseconds\fP +How long to wait between animation frames; default 20000. +.TP 8 +.B \-speed \fIratio\fP +Less than 1 for slower, greater than 1 for faster. Default 1. +.TP 8 +.B \-complexity \fIratio\fP +Less than 1 for simpler puzzles (fewer pieces), greater than 1 for +more complex puzzles (more pieces). Default 1. +.TP 8 +.B \-resolution \fIratio\fP +Smoothness of the edges of the pieces. Less than 1 for rougher pieces +(fewer polygons), greater than 1 for more smoother pieces (more polygons). +Default 1. +.TP 8 +.B \-thickness \fIfloat\fP +Thickness of the puzzle pieces (relative to their width). +Default 0.06. +.TP 8 +.B \-no\-wobble +Keep the display stationary instead of very slowly wobbling back and forth. +.TP 8 +.B \-fps +Display the current frame rate, polygon count, and CPU load. +.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. +.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\-demo (1), +.BR xscreensaver\-getimage (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/hacks/glx/juggler3d.man b/hacks/glx/juggler3d.man new file mode 100644 index 00000000..48d47160 --- /dev/null +++ b/hacks/glx/juggler3d.man @@ -0,0 +1,183 @@ +'\" t +.\" ** The above line should force tbl to be used as a preprocessor ** +.TH XScreenSaver 1 "" "X Version 11" +.SH NAME +juggler3d - juggling man screen saver. +.SH SYNOPSIS +.B juggler3d +[\-display host:display.screen ] +[\-root ] +[\-window ] +[\-mono ] +[\-install | \-noinstall ] +[\-visual visual ] +[\-window\-id id ] +[\-pattern pattern ] +[\-tail number ] +[\-real | \-no\-real ] +[\-describe | \-no\-describe ] +[\-balls | \-no\-balls ] +[\-clubs | \-no\-clubs ] +[\-torches | \-no\-torches ] +[\-knives | \-no\-knives ] +[\-rings | \-no\-rings ] +[\-bballs | \-no\-bballs ] +[\-count count ] +[\-cycles cycles ] +[\-delay delay ] +[\-ncolors ncolors ] +[\-fps] +.SH DESCRIPTION +Draws a stick-man juggling various collections of objects. +.SH OPTIONS +.I juggler3d +accepts the following options: +.TP 8 +.B \-display host:display.screen +X11 display to use. Overrides +.B DISPLAY +environment variable. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-window +Draw on a newly-created X window. This is the default. +.TP 8 +.B \-mono +Draw in monochrome. +.TP 8 +.B \-install | \-noinstall +Turn on/off installing colormap. +.TP 8 +.B \-visual visual +Specify which visual to use. Legal values are the name of a visual class, +or the id number (decimal or hex) of a specific visual. +.TP 8 +.B \-window\-id id +Draw on an already existing X window. +.TP 8 +.B \-pattern\ \(dq pattern \(dq +Specify juggling pattern in annotated +.B site-swap +notation. In +.B site-swap +notation, the "height" of each throw is given. E.g., "3" is the height +needed to juggle a 3\-Cascade. Note that these sequences need to be +chosen carefully, to avoid collisions. + +Annotations indicate relative hand movements or tricks: +.TS +cb l. +\&\- Inside throw (default) ++ Outside throw +\&= Cross Throw +& Cross Catch +x Cross Throw and Catch +\&_ Bounce +.TE +.TP 8 +.B \-pattern\ \(dq[ pattern ]\(dq +Specify juggling pattern in annotated +.B Adam +notation. Adam notation is a little harder to visualize. Each +integer +.B n +represents a cyclic permutation of (0...n). The equivalent +.B site-swap +value is determined by calculating how many of the permutations it +takes to get back to the identity. The largest number used is the +same as the number of objects in the pattern. The advantage of Adam +notation is that these sequences do not need to be chosen carefully, +since all possible sequences are juggle-able. Annotations are the same +as in +.B site-swap +notation. + +For example, both of these describe a 3\-Shower: +.IP +.B \-pattern\ "+5 1" +.IP +.B \-pattern\ "[+3 1]" + +For further examples, see the +.B portfolio +list in the source code. +.TP 8 +.B \-tail number +Minimum Trail Length. 0 \- 100. Default: 1. Objects may override +this, for example flaming torches always leave a trail. +.TP 8 +.BR \-real | \-no\-real +Turn on/off real-time juggling. +.B Deprecated. +There should be no need to turn off real-time juggling, even on slow +systems. Adjust speed using +.B \-count +above. +.TP 8 +.BR \-describe | \-no\-describe +Turn on/off pattern descriptions. +.TP 8 +.BR \-balls | \-no\-balls +Turn on/off Balls. +.TP 8 +.BR \-clubs | \-no\-clubs +Turn on/off Clubs. +.TP 8 +.BR \-torches | \-no\-torches +Turn on/off Flaming Torches. +.TP 8 +.BR \-knives | \-no\-knives +Turn on/off Knives. +.TP 8 +.BR \-rings | \-no\-rings +Turn on/off Rings. +.TP 8 +.BR \-bballs | \-no\-bballs +Turn on/off Bowling Balls. +.TP 8 +.B \-count number +Speed. 50 \- 1000. Default: 200. This determines the expected time +interval between a throw and the next catch, in milliseconds. +.TP 8 +.B \-cycles number +Performance Length. 50 \- 1000. Default: 1000. Setting this smaller +will force the juggler to switch patterns (and objects) more often. +.TP 8 +.B \-delay delay +Additional delay between frames, in microseconds. Default: 10000. +.B Deprecated. +Adjust speed using +.BR \-count . +.TP 8 +.B \-ncolors ncolors +Maximum number of colors to use. Default: 32. +.TP 8 +.B \-fps +Display the current frame rate and CPU load. +.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 1996,2000,2002,2004 by Tim Auckland. 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 Auckland. + +Converted to OpenGL by Jamie Zawinski, 2009. diff --git a/hacks/glx/kaleidocycle.man b/hacks/glx/kaleidocycle.man new file mode 100644 index 00000000..874d82d4 --- /dev/null +++ b/hacks/glx/kaleidocycle.man @@ -0,0 +1,96 @@ +.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 "25-Jul-98" "X Version 11" +.SH NAME +kaleidocycle - draws twistable rings of tetrahedra +.SH SYNOPSIS +.B kaleidocycle +[\-display \fIhost:display.screen\fP] [\-window] [\-root] +[\-visual \fIvisual\fP] [\-delay \fImicroseconds\fP] +[\-count \fInumber\fP] +[\-speed \fInumber\fP] +[\-wander] [\-no-wander] +[\-spin \fIaxes\fP] +[\-no-spin] +[\-wireframe] +[\-fps] +.SH DESCRIPTION +The \fIkaleidocycle\fP program draws a ring composed of tetrahedra +connected at the edges that twists and rotates toroidally. Segments +are occasionally inserted or removed. +.SH OPTIONS +.I kaleidocycle +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 \-count \fInumber\fP +The initial number of segments. Default 16. Must be 8 or greater, and +an even number. +.TP 8 +.B \-speed \fInumber\fP +Adjust the animation speed. 0.5 for half as fast, 2.0 for twice as fast. +.TP 8 +.B \-wander +Move the text around the screen. This is the default. +.TP 8 +.B \-no\-wander +Keep the text centered on the screen. +.TP 8 +.B \-spin +Which axes around which the text should spin. The default is "Z", +meaning rotate the object the plane of the screen only. +.TP 8 +.B \-no\-spin +Don't spin the text at all: the same as \fB\-spin ""\fP. +.TP 8 +.B \-wireframe +Render in wireframe instead of solid. +.TP 8 +.B \-fps +Display the current frame rate, CPU load, and polygon count. +.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 2001-2013 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 diff --git a/hacks/glx/klein.man b/hacks/glx/klein.man new file mode 100644 index 00000000..de4fd480 --- /dev/null +++ b/hacks/glx/klein.man @@ -0,0 +1,299 @@ +.TH XScreenSaver 1 "" "X Version 11" +.SH NAME +kleinbottle - Draws a 4d Klein bottle. +.SH SYNOPSIS +.B kleinbottle +[\-display \fIhost:display.screen\fP] +[\-install] +[\-visual \fIvisual\fP] +[\-window] +[\-root] +[\-delay \fIusecs\fP] +[\-fps] +[\-klein-bottle \fIbottle-name\fP] +[-figure-8] +[-lawson] +[\-mode \fIdisplay-mode\fP] +[\-wireframe] +[\-surface] +[\-transparent] +[\-appearance \fIappearance\fP] +[\-solid] +[\-bands] +[\-colors \fIcolor-scheme\fP] +[\-twosided] +[\-rainbow] +[\-depth] +[\-view-mode \fIview-mode\fP] +[\-walk] +[\-turn] +[\-walk-turn] +[\-orientation-marks] +[\-projection-3d \fImode\fP] +[\-perspective-3d] +[\-orthographic-3d] +[\-projection-4d \fImode\fP] +[\-perspective-4d] +[\-orthographic-4d] +[\-speed-wx \fIfloat\fP] +[\-speed-wy \fIfloat\fP] +[\-speed-wz \fIfloat\fP] +[\-speed-xy \fIfloat\fP] +[\-speed-xz \fIfloat\fP] +[\-speed-yz \fIfloat\fP] +[\-walk-direction \fIfloat\fP] +[\-walk-speed \fIfloat\fP] +.SH DESCRIPTION +The \fIkleinbottle\fP program shows two different Klein bottles in 4d: +the figure-8 Klein bottle or the Lawson Klein bottle. You can walk on +the Klein bottle, see it turn in 4d, or walk on it while it turns in +4d. The figure-8 Klein bottle is well known in its 3d form. The 4d +form used in this program is an extension of the 3d form to 4d that +does not intersect itself in 4d (which can be seen in the depth colors +mode). The Lawson Klein bottle, on the other hand, does intersect +itself in 4d. Its primary use is that it has a nice appearance for +walking and for turning in 3d. The Klein bottle is a non-orientable +surface. To make this apparent, the two-sided color mode can be used. +Alternatively, orientation markers (curling arrows) can be drawn as a +texture map on the surface of the Klein bottle. While walking on the +Klein bottle, you will notice that the orientation of the curling +arrows changes (which it must because the Klein bottle is +non-orientable). The program projects the 4d Klein bottle to 3d using +either a perspective or an orthographic projection. Which of the two +alternatives looks more appealing depends on the viewing mode and the +Klein bottle. For example, the Lawson Klein bottle looks nicest when +projected perspectively. The figure-8 Klein bottle, on the other +hand, looks nicer while walking when projected orthographically from +4d. The projected Klein bottle can then be projected to the screen +either perspectively or orthographically. When using the walking +modes, perspective projection to the screen should be used. There are +three display modes for the Klein bottle: mesh (wireframe), solid, or +transparent. Furthermore, the appearance of the Klein bottle can be +as a solid object or as a set of see-through bands. Finally, the +colors with with the Klein bottle is drawn can be set to two-sided, +rainbow, or depth. In the first case, the Klein bottle is drawn with +red on one "side" and green on the "other side". Of course, the Klein +bottle only has one side, so the color jumps from red to green along a +curve on the surface of the Klein bottle. This mode enables you to +see that the Klein bottle is non-orientable. The second mode draws +the Klein bottle with fully saturated rainbow colors. This gives a +very nice effect when combined with the see-through bands mode or with +the orientation markers drawn. The third mode draws the Klein bottle +with colors that are chosen according to the 4d "depth" of the points. +This mode enables you to see that the figure-8 Klein bottle does not +intersect itself in 4d, while the Lawson Klein bottle does intersect +itself. The rotation speed for each of the six planes around which +the Klein bottle rotates can be chosen. For the walk-and-turn more, +only the rotation speeds around the true 4d planes are used (the xy, +xz, and yz planes). Furthermore, in the walking modes the walking +direction in the 2d base square of the Klein bottle and the walking +speed can be chosen. This program is somewhat inspired by Thomas +Banchoff's book "Beyond the Third Dimension: Geometry, Computer +Graphics, and Higher Dimensions", Scientific American Library, 1990. +.SH OPTIONS +.I kleinbottle +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 much of a delay should be introduced between steps of the +animation. Default 10000, or 1/100th second. +.TP 8 +.B \-fps +Display the current frame rate, CPU load, and polygon count. +.PP +The following three options are mutually exclusive. They determine +which Klein bottle is displayed. +.TP 8 +.B \-klein-bottle random +Display a random Klein bottle (default). +.TP 8 +.B \-klein-bottle figure-8 \fP(Shortcut: \fB\-figure-8\fP) +Display the figure-8 Klein bottle. +.TP 8 +.B \-klein-bottle lawson \fP(Shortcut: \fB\-lawson\fP) +Display the Lawson Klein bottle. +.PP +The following four options are mutually exclusive. They determine +how the Klein bottle is displayed. +.TP 8 +.B \-mode random +Display the Klein bottle in a random display mode (default). +.TP 8 +.B \-mode wireframe \fP(Shortcut: \fB\-wireframe\fP) +Display the Klein bottle as a wireframe mesh. +.TP 8 +.B \-mode surface \fP(Shortcut: \fB\-surface\fP) +Display the Klein bottle as a solid surface. +.TP 8 +.B \-mode transparent \fP(Shortcut: \fB\-transparent\fP) +Display the Klein bottle as a transparent surface. +.PP +The following three options are mutually exclusive. They determine the +appearance of the Klein bottle. +.TP 8 +.B \-appearance random +Display the Klein bottle with a random appearance (default). +.TP 8 +.B \-appearance solid \fP(Shortcut: \fB\-solid\fP) +Display the Klein bottle as a solid object. +.TP 8 +.B \-appearance bands \fP(Shortcut: \fB\-bands\fP) +Display the Klein bottle as see-through bands. +.PP +The following four options are mutually exclusive. They determine +how to color the Klein bottle. +.TP 8 +.B \-colors random +Display the Klein bottle with a random color scheme (default). +.TP 8 +.B \-colors twosided \fP(Shortcut: \fB\-twosided\fP) +Display the Klein bottle with two colors: red on one "side" and green +on the "other side". +.TP 8 +.B \-colors rainbow \fP(Shortcut: \fB\-rainbow\fP) +Display the Klein bottle with fully saturated rainbow colors. If the +Klein bottle is displayed as see-through bands, each band will be +displayed with a different color. +.TP 8 +.B \-colors depth \fP(Shortcut: \fB\-depth\fP) +Display the Klein bottle with colors chosen depending on the 4d +"depth" of the points. +.PP +The following four options are mutually exclusive. They determine +how to view the Klein bottle. +.TP 8 +.B \-view-mode random +View the Klein bottle in a random view mode (default). +.TP 8 +.B \-view-mode walk \fP(Shortcut: \fB\-walk\fP) +View the Klein bottle as if walking on its surface. +.TP 8 +.B \-view-mode turn \fP(Shortcut: \fB\-turn\fP) +View the Klein bottle while it turns in 4d. +.TP 8 +.B \-view-mode walk-turn \fP(Shortcut: \fB\-walk-turn\fP) +View the Klein bottle as if walking on its surface. Additionally, the +Klein bottle turns around the true 4d planes (the xy, xz, and yz +planes). +.PP +The following options determine whether orientation marks are shown on +the Klein bottle. +.TP 8 +.B \-orientation-marks +Display orientation marks on the Klein bottle. +.TP 8 +.B \-no-orientation-marks +Don't display orientation marks on the Klein bottle (default). +.PP +The following three options are mutually exclusive. They determine +how the Klein bottle is projected from 3d to 2d (i.e., to the screen). +.TP 8 +.B \-projection-3d random +Project the Klein bottle from 3d to 2d using a random projection mode +(default). +.TP 8 +.B \-projection-3d perspective \fP(Shortcut: \fB\-perspective-3d\fP) +Project the Klein bottle from 3d to 2d using a perspective projection. +.TP 8 +.B \-projection-3d orthographic \fP(Shortcut: \fB\-orthographic-3d\fP) +Project the Klein bottle from 3d to 2d using an orthographic +projection. +.PP +The following three options are mutually exclusive. They determine +how the Klein bottle is projected from 4d to 3d. +.TP 8 +.B \-projection-4d random +Project the Klein bottle from 4d to 3d using a random projection mode +(default). +.TP 8 +.B \-projection-4d perspective \fP(Shortcut: \fB\-perspective-4d\fP) +Project the Klein bottle from 4d to 3d using a perspective projection. +.TP 8 +.B \-projection-4d orthographic \fP(Shortcut: \fB\-orthographic-4d\fP) +Project the Klein bottle from 4d to 3d using an orthographic +projection. +.PP +The following six options determine the rotation speed of the Klein +bottle around the six possible hyperplanes. The rotation speed is +measured in degrees per frame. The speeds should be set to relatively +small values, e.g., less than 4 in magnitude. In walk mode, all +speeds are ignored. In walk-and-turn mode, the 3d rotation speeds are +ignored (i.e., the wx, wy, and wz speeds). In walk-and-turn mode, +smaller speeds must be used than in the turn mode to achieve a nice +visualization. Therefore, in walk-and-turn mode the speeds you have +selected are divided by 5 internally. +.TP 8 +.B \-speed-wx \fIfloat\fP +Rotation speed around the wx plane (default: 1.1). +.TP 8 +.B \-speed-wy \fIfloat\fP +Rotation speed around the wy plane (default: 1.3). +.TP 8 +.B \-speed-wz \fIfloat\fP +Rotation speed around the wz plane (default: 1.5). +.TP 8 +.B \-speed-xy \fIfloat\fP +Rotation speed around the xy plane (default: 1.7). +.TP 8 +.B \-speed-xz \fIfloat\fP +Rotation speed around the xz plane (default: 1.9). +.TP 8 +.B \-speed-yz \fIfloat\fP +Rotation speed around the yz plane (default: 2.1). +.PP +The following two options determine the walking speed and direction. +.TP 8 +.B \-walk-direction \fIfloat\fP +The walking direction is measured as an angle in degrees in the 2d +square that forms the coordinate system of the surface of the Klein +bottle (default: 7.0). +.TP 8 +.B \-walk-speed \fIfloat\fP +The walking speed is measured in percent of some sensible maximum +speed (default: 20.0). +.SH INTERACTION +If you run this program in standalone mode in its turn mode, you can +rotate the Klein bottle by dragging the mouse while pressing the left +mouse button. This rotates the Klein bottle in 3D, i.e., around the +wx, wy, and wz planes. If you press the shift key while dragging the +mouse with the left button pressed the Klein bottle is rotated in 4D, +i.e., around the xy, xz, and yz planes. To examine the Klein bottle +at your leisure, it is best to set all speeds to 0. Otherwise, the +Klein bottle will rotate while the left mouse button is not pressed. +This kind of interaction is not available in the two walk modes. +.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 2005-2009 by Carsten Steger. 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 +Carsten Steger , 03-aug-2009. diff --git a/hacks/glx/lament.man b/hacks/glx/lament.man new file mode 100644 index 00000000..2077dd67 --- /dev/null +++ b/hacks/glx/lament.man @@ -0,0 +1,68 @@ +.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] [\-delay \fImicroseconds\fP] [\-fps] +[\-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. +.TP 8 +.B \-delay \fImicroseconds\fP +How long to pause between frames. Default is 20000, or 0.02 second. +.TP 8 +.B \-fps +Display the current frame rate, CPU load, and polygon count. +.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/hacks/glx/lavalite.man b/hacks/glx/lavalite.man new file mode 100644 index 00000000..3d7aad5b --- /dev/null +++ b/hacks/glx/lavalite.man @@ -0,0 +1,160 @@ +.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 "18-May-2002" "X Version 11" +.SH NAME +lavalite - 3D OpenGL simulation of a Lavalite. +.SH SYNOPSIS +.B lavalite +[\-display \fIhost:display.screen\fP] [\-window] [\-root] +[\-visual \fIvisual\fP] [\-delay \fImicroseconds\fP] [\-fps] +[\-style \fIstyle\fP ] +[\-spin \fIxyz\fP ] [\-no-spin ] +[\-speed \fIfloat\fP ] +[\-resolution \fIinteger\fP ] +[\-count \fIinteger\fP ] +[\-no-smooth ] +[\-wireframe ] +[\-impatient ] +[\-lava-color \fIcolor\fP ] +[\-fluid-color \fIcolor\fP ] +[\-base-color \fIcolor\fP ] +[\-table-color \fIcolor\fP ] +[\-fluid-texture \fIfilename\fP ] +[\-base-texture \fIfilename\fP ] +[\-table-texture \fIfilename\fP ] +.SH DESCRIPTION +The \fIlavalite\fP program displays a 3D simulation of the famous lamp +of the same name. It requires a fast computer with fast OpenGL support. +.SH OPTIONS +.I lavalite +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 \-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 \-style \fIstyle\fP\fP +Specify which model of lamp to draw. Available models +are: \fBClassic\fP, \fBGiant\fP, \fBCone\fP, and \fBRocket\fP. +Default: random. +.TP 8 +.B \-spin \fIxyz\fP +Around which axes the model should auto-spin. Defaults to "Z", meaning +it rotates horizontally, but otherwise pitch or roll. +.TP 8 +.B \-no-spin +Same as \fB\-spin ''\fP. +.TP 8 +.B \-speed \fIfloat\fP +A number controlling the frequency at which new blobs launch: you can +think of this as being related to the the heat of the lightbulb in +the base. Default: 0.003. +.TP 8 +.B \-delay \fIusecs\fP +The delay between steps of the animation; default is 30000 (0.03 second.) +.TP 8 +.B \-resolution \fIinteger\fP +The size of the grid from which the mesh is created that is used +to polygonize the blobs. higher values will give very smooth looking +blobs, at the expense of speed. Default: 40. + +The options "-resolution 10 -no-smooth" look kind of interesting. +.TP 8 +.B \-fps +Display the current frame rate, CPU load, and polygon count. +.TP 8 +.B \-count \fIinteger\fP +The maximum number of blobs that can be in motion at once. +Default: 3. +.TP 8 +.B \-no-smooth +Turn off smoothing: the objects in the scene will be facetted. +.TP 8 +.B \-wireframe +Render all objects in wireframe instead of as solids. +.TP 8 +.B \-impatient +Provide this option if you are. This will pre-warm the lamp, so when it +starts up, the first frame will show a blob already halfway up the lamp. +.TP 8 +.B \-lava-color \fIcolor\fP +Specifies the color of the blobbies. Default: red. +.TP 8 +.B \-fluid-color \fIcolor\fP +Specifies the color of the fluid that the blobbies float in. +Default: light blue. +.TP 8 +.B \-base-color \fIcolor\fP +Specifies the color of the lamp base, and the cap on top of the bottle. +Default: very dark gray. +.TP 8 +.B \-table-color \fIcolor\fP +Specifies the color of the table that the lamp is sitting on. +Default: black (meaning it is invisible.) +.TP 8 +.B \-fluid-texture \fIfilename\fP +An image file to wrap around the glass. + +Note that on most systems, GL textures must have dimensions that are a +power of two. + +Note also that colors and textures are both applied: so, if you apply a +texture and it isn't showing up, try specifying the corresponding color +as "white". Otherwise, the combination of the two might be too dark to +see. +.TP 8 +.B \-base-texture \fIfilename\fP +An image file to wrap around the base of the lamp, and the cap on top +of the bottle. +.TP 8 +.B \-table-texture \fItexture\fP +An image file to spread across the table that the lamp is sitting on. +.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), + http://www.lavaworld.com/ + http://www.lavarnd.org/ +.SH COPYRIGHT +Copyright \(co 2002 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. + +LAVA LITE\(rg and the configuration of the LAVA\(rg brand motion lamp +are registered trademarks of Haggerty Enterprises, Inc. The +configuration of the globe and base of the motion lamp are registered +trademarks of Haggerty Enterprises, Inc. in the U.S.A. and in other +countries around the world. + +.SH AUTHOR +Jamie Zawinski diff --git a/hacks/glx/lockward.man b/hacks/glx/lockward.man new file mode 100644 index 00000000..f55e5be0 --- /dev/null +++ b/hacks/glx/lockward.man @@ -0,0 +1,79 @@ +.TH XScreenSaver 1 "" "X Version 11" +.SH NAME +lockward - Rotating spinning color-cycling things +.SH SYNOPSIS +.B lockward +[\-display \fIdisplayspec\fP] +[\-root] +[\-window] +[\-visual \fIarg\fP] +[\-window-id \fIarg\fP] +[\-delay \fIusec\fP] +[\-pair] +[\-fps] +[\-blink | \-no-blink] +[\-rotateidle-min \fImsec\fP] +[\-rotateidle-max \fImsec\fP] +[\-blinkidle-min \fImsec\fP] +[\-blinkidle-max \fImsec\fP] +[\-blinkdwell-min \fImsec\fP] +[\-blinkdwell-max \fImsec\fP] +.SH DESCRIPTION +.B lockward +draws a spinning, rotating set of notched wheels overlaid with some flashing +effects, using OpenGL. It's a sort of cross between the wards in a +combination lock and those old information displays that animated via +polarized light. +.SH OPTIONS +.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 \-window +Draw on a newly-created window (default). +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-delay \fImicroseconds\fP +Per-frame delay, in microseconds. Default: 20000 (50 frames/sec). +.TP 8 +.B \-blink | \-no-blink +Enables/disables the blinking effects. Default: Enabled. +.TP 8 +.B \-fps +Display the current frame rate, CPU load, and polygon count. +.TP 8 +.B \-rotateidle-min \fImilliseconds +.TP 8 +.B \-rotateidle-max \fImilliseconds +The minimum and maximum time each spinner will sit idle, in milliseconds. +Defaults: Min 1000, max 6000. +.TP 8 +.B \-blinkidle-min \fImilliseconds +.TP 8 +.B \-blinkidle-max \fImilliseconds +The minimum and maximum time between blinking effects, in milliseconds. +Defaults: Min 1000, max 9000. +.TP 8 +.B \-blinkdwell-min \fImilliseconds +.TP 8 +.B \-blinkdwell-max \fImilliseconds +The minimum and maximum dwell time for the blinking effects, in +milliseconds. This affects how quickly the blinks actually happen. +Defaults: Min 100, max 600. +.SH ENVIRONMENT +.PP +.TP 8 +.B DISPLAY +Default host and display number. +.TP 8 +.B XENVIRONMENT +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 AUTHORS +Leo L. Schwab diff --git a/hacks/glx/menger.man b/hacks/glx/menger.man new file mode 100644 index 00000000..c2c21412 --- /dev/null +++ b/hacks/glx/menger.man @@ -0,0 +1,78 @@ +.TH XScreenSaver 1 "" "X Version 11" +.SH NAME +menger - 3D menger gasket fractal. +.SH SYNOPSIS +.B menger +[\-display \fIhost:display.screen\fP] +[\-visual \fIvisual\fP] +[\-window] +[\-root] +[\-delay \fInumber\fP] +[\-speed \fInumber\fP] +[\-depth \fInumber\fP] +[\-no-wander] +[\-no-spin] +[\-spin \fI[XYZ]\fP] +[\-wireframe] +[\-fps] +.SH DESCRIPTION +This draws the three-dimensional variant of the recursive Menger Gasket, a +cube-based fractal object analagous to the Sierpinski Tetrahedron. +.SH OPTIONS +.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 \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-delay \fInumber\fP +Per-frame delay, in microseconds. Default: 30000 (0.03 seconds.). +.TP 8 +.B \-speed \fInumber\fP +Number of frames before changing shape. Default: 150. +.TP 8 +.B \-depth \fInumber\fP +Max depth to descend. Default: 3. You probably don't have enough +memory for 6. +.TP 8 +.B \-wander | \-no-wander +Whether the object should wander around the screen. +.TP 8 +.B \-spin [XYZ] +Around which axes should the object spin? +.TP 8 +.B \-no-spin +None. +.TP 8 +.B \-wireframe +Render in wireframe instead of solid. +.TP 8 +.B \-fps +Display the current frame rate, CPU load, and polygon count. +.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 2002 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. diff --git a/hacks/glx/mirrorblob.man b/hacks/glx/mirrorblob.man new file mode 100644 index 00000000..c61f7a60 --- /dev/null +++ b/hacks/glx/mirrorblob.man @@ -0,0 +1,107 @@ +.TH XScreenSaver 1 "" "X Version 11" +.SH NAME +mirrorblob - Draws a wobbly blob that distorts the image behind it. +.SH SYNOPSIS +.B mirrorblob +[\-display \fIhost:display.screen\fP] +[\-visual \fIvisual\fP] +[\-window] +[\-root] +[\-wire] +[\-delay \fInumber\fP] +[\-fog] +[\-walls] +[\-colour] +[\-texture] +[\-offset-texture] +[\-blend] +[\-antialias] +[\-resolution \fInumber\fP] +[\-bumps \fInumber\fP] +[\-fade-time \fInumber\fP] +[\-hold-time \fInumber\fP] +[\-zoom \fInumber\fP] +[\-fps] +.SH DESCRIPTION +Draws a wobbling blob, making use of alpha blending, fog, +textures, and lighting, plus a ``frames per second'' meter so that you can +tell how fast your graphics card is... Requires OpenGL. +.SH OPTIONS +.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 \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.B \-wire +Render in wireframe instead of solid. +.TP 8 +.B \-delay \fInumber\fP +Per-frame delay, in microseconds. Default: 10000 (0.01 seconds.). +.TP 8 +.B \-fog | \-no-fog +Whether to enable fog. +.TP 8 +.B \-walls | \-no-walls +Add walls for blob to hit. +.TP 8 +.B \-colour | \-no-colour +Draw coloured blob. If also textured, the texture will have color mixed in. +.TP 8 +.B \-texture | \-no-texture +Whether to wrap a texture image on the blob. +.TP 8 +.B \-offset_texture | \-no-offset_texture +Whether to ofset the texture calculations to only use a region of the image + under the blob. This works well with a semi-transparent blob. +.TP 8 +.B \-blend | \-no-blend +Whether to draw a transparent blob. (see also offset_texture above) +.TP 8 +.B \-antialias | \-no-antialias +Whether to antialias lines. +.TP 8 +.B \-resolution \fInumber\fP +Resolution of the tessellation used to calculate and draw the blob. Larger + numbers give a smoother blob but increase calculation times exponentially. +.TP 8 +.B \-bumps \fInumber\fP +Number of bumps used to distort the blob. +.TP 8 +.B \-hold-time \fInumber\fP +Time until loading a new image. +.TP 8 +.B \-fade-time \fInumber\fP +Time taken to transition between images. +.TP 8 +.B \-zoom \fInumber\fP +Size multiplier for blob. +.TP 8 +.B \-fps +Display the current frame rate, CPU load, and polygon count. +.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 2003 by Jon Dowdall. 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 +Jon Dowdall. diff --git a/hacks/glx/moebius.man b/hacks/glx/moebius.man new file mode 100644 index 00000000..696e0d69 --- /dev/null +++ b/hacks/glx/moebius.man @@ -0,0 +1,65 @@ +.TH XScreenSaver 1 "" "X Version 11" +.SH NAME +moebius - Escher's Moebuis Strip II, with ants. +.SH SYNOPSIS +.B moebius +[\-display \fIhost:display.screen\fP] +[\-visual \fIvisual\fP] +[\-window] +[\-root] +[-delay \fInumber\fP] +[-solidmoebius] +[-wireframe] +[-noants] +[-fps] +.SH DESCRIPTION +Another M. C. Escher hack by Marcelo Vianna, this one draws ``Moebius Strip +II,'' a GL image of ants walking along the surface of a moebius strip. +.SH OPTIONS +.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 \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-delay \fInumber\fP +Per-frame delay, in microseconds. Default: 20000 (0.02 seconds.). +.TP 8 +.B \-solidmoebius +Solid Floor. +.TP 8 +.B \-wireframe +Render in wireframe instead of solid. +.TP 8 +.B \-noants | \-no-noants +Draw Ants. Boolean. +.TP 8 +.B \-fps +Display the current frame rate, CPU load, and polygon count. +.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 2002 by Marcelo Vianna. 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 +Marcelo Vianna. diff --git a/hacks/glx/moebiusgears.man b/hacks/glx/moebiusgears.man new file mode 100644 index 00000000..a45519a6 --- /dev/null +++ b/hacks/glx/moebiusgears.man @@ -0,0 +1,86 @@ +.TH XScreenSaver 1 "30-Oct-99" "X Version 11" +.SH NAME +moebiusgears - draw a moebius strip of interlocking gears. +.SH SYNOPSIS +.B moebiusgears +[\-display \fIhost:display.screen\fP] [\-window] [\-root] [\-install] +[\-visual \fIvisual\fP] +[\-delay \fIusecs\fP] +[\-speed \fIfloat\fP] +[\-no\-spin] +[\-no\-wander] +[\-no\-roll] +[-count \fIinteger\fP] +[-teeth \fIinteger\fP] +[-wireframe] +[-fps] +.SH DESCRIPTION +The \fImoebiusgears\fP program draws a closed, interlinked chain of +rotating gears. The layout of the gears follows the path of a +moebius strip. +.SH OPTIONS +.I moebiusgears +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 \fIusecs\fP +The delay between frames of the animation, in microseconds. +Default: 30000 (0.03 seconds.) +.TP 8 +.B \-speed \fIfloat\fP +Larger numbers mean run faster. Default: 1.0. +.TP 8 +.B \-no\-spin +Don't rotate the object. +.TP 8 +.B \-no\-wander +Don't wander the object around the screen. +.TP 8 +.B \-no\-roll +Don't slowly roll the moebius strip inside out. +.TP 8 +.B \-count \fIinteger\fP +How many gears to draw. Default: 17. Minimum 11, must be odd. +.TP 8 +.B \-teeth \fIinteger\fP +How many teeth to draw on each draw. Default: 15. Minimum 7, must be odd. +.TP 8 +.B \-wireframe +Render in wireframe instead of solid. +.TP 8 +.B \-fps +Display the current frame rate, CPU load, and polygon count. +.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 2007 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. diff --git a/hacks/glx/molecule.man b/hacks/glx/molecule.man new file mode 100644 index 00000000..6ec8328d --- /dev/null +++ b/hacks/glx/molecule.man @@ -0,0 +1,160 @@ +.TH XScreenSaver 1 "13-Mar-01" "X Version 11" +.SH NAME +molecule - draws 3D molecular structures +.SH SYNOPSIS +.B molecule +[\-display \fIhost:display.screen\fP] [\-window] [\-root] +[\-visual \fIvisual\fP] [\-delay \fImicroseconds\fP] +[\-wander] [\-no-wander] +[\-spin \fIaxes\fP] +[\-no-spin] +[\-timeout \fIseconds\fP] +[\-labels] [\-no-labels] +[\-titles] [\-no-titles] +[\-atoms] [\-no-atoms] +[\-bonds] [\-no-bonds] +[\-shells] [\-no-shells] +[\-molecule \fIfile-or-directory\fP] +[\-verbose] +[\-wireframe] +[\-fps] +.SH DESCRIPTION +The \fImolecule\fP program draws several different representations of +molecules. Some common molecules are built in, and it can read PDB +(Protein Data Base) files as input. +.SH OPTIONS +.I molecule +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 \-fps +Display the current frame rate, CPU load, and polygon count. +.TP 8 +.B \-verbose +Print debugging info on stderr about files being loaded, etc. +.TP 8 +.B \-wander +Move the molecules around the screen. +.TP 8 +.B \-no\-wander +Keep the molecule centered on the screen. This is the default. +.TP 8 +.B \-spin +Which axes around which the molecule should spin. The default is "XYZ", +meaning rotate it freely in space. "\fB\-spin Z\fP" would rotate the +molecule in the plane of the screen while not rotating it into or out +of the screen; etc. +.TP 8 +.B \-no\-spin +Don't spin it at all: the same as \fB\-spin ""\fP. +.TP 8 +.B \-labels +Draw labels on the atoms (or the spot where the atoms would be.) +This is the default. +.TP 8 +.B \-no\-labels +Do not draw labels on the atoms. +.TP 8 +.B \-titles +Print the name of the molecule and its chemical formula at the top of +the screen. +.TP 8 +.B \-no\-titles +Do not print the molecule name. +.TP 8 +.B \-atoms +Represent the atoms as shaded spheres of appropriate sizes. +This is the default. +.TP 8 +.B \-no\-atoms +Do not draw spheres for the atoms: only draw bond lines. +.TP 8 +.B \-bonds +Represent the atomic bonds as solid tubes of appropriate thicknesses. +This is the default. +.TP 8 +.B \-no\-bonds +Do not draw the bonds: instead, make the spheres for the atoms be +larger, for a "space-filling" representation of the molecule. +.TP 8 +.B \-shells +Draw transparent electron shells around the atoms. This only works +if bonds are also being drawn. +.TP 8 +.B \-no\-shells +Do not draw electron shells. This is the default. +.TP 8 +.B \-shell\-alpha +When drawing shells, how transparent to make them. Default 0.4. +.TP 8 +.B \-wireframe +Draw a wireframe rendition of the molecule: this will consist only of +single-pixel lines for the bonds, and text labels where the atoms go. +This will be very fast. +.TP 8 +.B \-timeout \fIseconds\fP +When using the built-in data set, change to a new molecule every +this-many seconds. Default is 20 seconds. +.TP 8 +.B \-molecule \fIfile-or-directory\fP +Instead of using the built-in molecules, read one from the given file. +This file must be in PDB (Protein Data Base) format. (Note that it's +not uncommon for PDB files to contain only the atoms, with no (or +little) information about the atomic bonds.) + +This can also be a directory, in which case, all of the .pdb files in +that directory will be loaded. A new one will be displayed at random +every few seconds (as per the \fI\-timeout\fP option.) +.PP +When the molecule is too large (bigger than about 30 angstroms from +side to side), the \fI\-label\fP option will be automatically turned +off, because otherwise, the labels would overlap and completely obscure +the display. + +When the molecule is around 150 angstroms from side to side, wireframe +mode will be turned on (because otherwise it would be too slow.) +.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) +.PP +Documentation on the PDB file format: + + http://www.wwpdb.org/docs.html + http://www.rcsb.org/pdb/docs/format/pdbguide2.2/guide2.2_frame.html + +A good source of PDB files: + + http://www.umass.edu/microbio/rasmol/whereget.htm + http://www.wwpdb.org/docs.html +.SH COPYRIGHT +Copyright \(co 2001-2005 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 diff --git a/hacks/glx/morph3d.man b/hacks/glx/morph3d.man new file mode 100644 index 00000000..21af78c6 --- /dev/null +++ b/hacks/glx/morph3d.man @@ -0,0 +1,57 @@ +.TH XScreenSaver 1 "" "X Version 11" +.SH NAME +morph3d - 3d morphing objects. +.SH SYNOPSIS +.B morph3d +[\-display \fIhost:display.screen\fP] +[\-visual \fIvisual\fP] +[\-window] +[\-root] +[\-count \fInumber\fP] +[\-delay \fInumber\fP] +[\-fps] +.SH DESCRIPTION +Another 3d shape-changing GL hack. It has the same shiny-plastic feel +as Superquadrics, as many computer-generated objects do... +.SH OPTIONS +.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 \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-count \fInumber\fP +0 - 20. Default: 0. +.TP 8 +.B \-delay \fInumber\fP +Per-frame delay, in microseconds. Default: 40000 (0.04 seconds.). +.TP 8 +.B \-fps +Display the current frame rate, CPU load, and polygon count. +.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 2002 by Marcelo Vianna. 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 +Marcelo Vianna. diff --git a/hacks/glx/noof.man b/hacks/glx/noof.man new file mode 100644 index 00000000..f4145712 --- /dev/null +++ b/hacks/glx/noof.man @@ -0,0 +1,52 @@ +.TH XScreenSaver 1 "" "X Version 11" +.SH NAME +noof - draw rotatey patterns +.SH SYNOPSIS +.B dangerball +[\-display \fIhost:display.screen\fP] +[\-visual \fIvisual\fP] +[\-window] +[\-root] +[\-delay \fInumber\fP] +[\-fps] +.SH DESCRIPTION +Draws some rotatey patterns, using OpenGL. +.SH OPTIONS +.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 \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-delay \fInumber\fP +Per-frame delay, in microseconds. Default: 10000 (0.01 seconds.). +.TP 8 +.B \-fps +Display the current frame rate, CPU load, and polygon count. +.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 2004 by Mark Kilgard. 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 +Mark Kilgard diff --git a/hacks/glx/photopile.man b/hacks/glx/photopile.man new file mode 100644 index 00000000..277f9ddc --- /dev/null +++ b/hacks/glx/photopile.man @@ -0,0 +1,113 @@ +.TH XScreenSaver 1 "" "X Version 11" +.SH NAME +photopile - displays multiple images in a periodically shuffled pile +.SH SYNOPSIS +.B photopile +[\-display \fIhost:display.screen\fP] +[\-visual \fIvisual\fP] +[\-window] +[\-root] +[\-count \fIint\fP] +[\-scale \fIfactor\fP] +[\-maxTilt \fIdegrees\fP] +[\-titles | \-no\-titles] +[\-polaroid | \-no\-polaroid] +[\-shadows | \-no\-shadows] +[\-font \fIfont\fP] +[\-speed \fIratio\fP] +[\-duration \fIseconds\fP] +[\-fps] +[\-debug] +[\-wireframe] +.SH DESCRIPTION +Loads several random images, and displays them as if lying in a random pile. +The pile is periodically reshuffled, with new images coming in and old ones +being thrown out. + +This program requires a good video card capable of supporting large +textures. + +To specify the directory that images are loaded from, run +.BR xscreensaver-demo (1) +and click on the "Advanced" tab. +.SH OPTIONS +.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 \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-count \fIint\fP +How many images to display. Default 7. +.TP 8 +.B \-scale \fIfactor\fP +Size of images in relation to the size of the window. Default 0.4. +.TP 8 +.B \-maxTilt \fIdegrees\fP +Maximum deviation from vertical. Default 50 degrees. +.TP 8 +.B \-duration \fIseconds\fP +Every \fIduration\fP seconds, one of the images will be replaced +with a new one. Default 5 seconds. +.TP 8 +.B \-speed \fIratio\fP +Speed up or slow down the animation. 0.5 means half as fast as the +default; 2.0 means twice as fast. +.TP 8 +.B \-delay \fInumber\fP +Per-frame delay, in microseconds. Default: 10000 (0.01 seconds.). +.TP 8 +.B \-titles \fB| \-no\-titles\fP +Whether to display the file names of the images beneath them. Default: no. +.TP 8 +.B \-polaroid \fB| \-no\-polaroid\fP +Whether to simulate images taken by an instant camera. Default: yes. +.TP 8 +.B \-shadows \fB| \-no\-shadows\fP +Whether to draw images with drop shadows. Default: no. +.TP 8 +.B \-font \fIfont-name\fP +The font to use for the initial loading screen. +.TP 8 +.B \-fps +Display the current frame rate, CPU load, and polygon count. +.TP 8 +.B \-debug +Prints debugging info to stderr. +.TP 8 +.B \-wireframe +Another debug mode. +.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-demo (1) +.BR xscreensaver-getimage (1) +.BR xscreensaver (1) +.BR carousel (MANSUFFIX) +.BR glslideshow (MANSUFFIX) +.SH COPYRIGHT +Copyright \(co 2005 by Jamie Zawinski. +Copyright \(co 2008 by Jens Kilian. + +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 +Jens Kilian. diff --git a/hacks/glx/pinion.man b/hacks/glx/pinion.man new file mode 100644 index 00000000..3ae6eff5 --- /dev/null +++ b/hacks/glx/pinion.man @@ -0,0 +1,82 @@ +.TH XScreenSaver 1 "30-Oct-99" "X Version 11" +.SH NAME +pinion - draws a scrolling sequence of interconnected gears +.SH SYNOPSIS +.B pinion +[\-display \fIhost:display.screen\fP] [\-window] [\-root] [\-install] +[\-visual \fIvisual\fP] +[\-delay \fIusecs\fP] +[\-scroll \fIratio\fP] +[\-spin \fIratio\fP] +[\-size \fIratio\fP] +[\-max-rpm \fIint\fP] +[\-wireframe] +[\-fps] +.SH DESCRIPTION +The \fIpinion\fP program draws an interconnected set of gears moving +across the screen. +.SH OPTIONS +.I pinion +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 \-delay \fIusecs\fP +The delay between frames of the animation, in microseconds: default 15000. +.TP 8 +.B \-spin \fIratio\fP +How fast the gears should spin; default 1.0. 2.0 means twice as fast, +0.5 means half as fast. +.TP 8 +.B \-scroll \fIratio\fP +How fast the gears should scroll past the screen; default 1.0. +2.0 means twice as fast, 0.5 means half as fast. +.TP 8 +.B \-size \fIratio\fP +How big the gears should be, on average; default 1.0. +2.0 means twice as large, 0.5 means half as large. +.TP 8 +.B \-max\-rpm \fIinteger\fP +If any gear exceeds the maximum RPM, the current gear train is broken there, +and we start a new train. Default: 900 RPM. (At 30 FPS, that's about half +a rotation per frame.) +.TP 8 +.B \-wireframe +Render in wireframe instead of solid. +.TP 8 +.B \-fps +Display the current frame rate, CPU load, and polygon count. +.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 gears (MANSUFFIX), +.BR xscreensaver (1), +.BR X (1) +.SH COPYRIGHT +Copyright \(co 2004 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 , 12-Dec-2004. diff --git a/hacks/glx/pipes.man b/hacks/glx/pipes.man new file mode 100644 index 00000000..b58a511b --- /dev/null +++ b/hacks/glx/pipes.man @@ -0,0 +1,85 @@ +.TH XScreenSaver 1 "" "X Version 11" +.SH NAME +pipes - fill the screen with a plumbing system. +.SH SYNOPSIS +.B pipes +[\-display \fIhost:display.screen\fP] +[\-visual \fIvisual\fP] +[\-window] +[\-root] +[-count 0] +[-count 1] +[-cycles \fInumber\fP] +[-size \fInumber\fP] +[-factory \fInumber\fP] +[-delay \fInumber\fP] +[-no-fisheye] +[-tightturns] +[-db] +[-fps] +.SH DESCRIPTION +If you've ever been in the same room as a Windows NT machine, you've +probably seen this GL hack. It fills the screen with a plumbing system. +.SH OPTIONS +.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 \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-count 0 +Curved Pipes. +.TP 8 +.B \-count 1 +Ball Joints. +.TP 8 +.B \-cycles \fInumber\fP +Number of pipe systems to draw at once. Default: 5. +.TP 8 +.B \-size \fInumber\fP +Length of each pipe system. Default: 500. +.TP 8 +.B \-factory \fInumber\fP +How much gadgetry to create; Useful range is 0-10. Default: 2. +.TP 8 +.B \-delay \fInumber\fP +How long (in microseconds) to sleep between frames. Default: 10000. +.TP 8 +.B \-fisheye | \-no-fisheye +Whether to use a fisheye lens. +.TP 8 +.B \-tightturns | \-no-tightturns +Whether to allow tight turns. +.TP 8 +.B \-db | \-no-db +Whether to double-buffer. +.TP 8 +.B \-fps +Display the current frame rate, CPU load, and polygon count. +.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 2002 by Marcelo Vianna. 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 +Marcelo Vianna. diff --git a/hacks/glx/polyhedra.man b/hacks/glx/polyhedra.man new file mode 100644 index 00000000..b4e1cca3 --- /dev/null +++ b/hacks/glx/polyhedra.man @@ -0,0 +1,124 @@ +.TH XScreenSaver 1 "" "X Version 11" +.SH NAME +polyhedra - draws the 80 uniform polyhedra and their duals +.SH SYNOPSIS +.SH SYNOPSIS +.B polyhedra +[\-display \fIhost:display.screen\fP] +[\-visual \fIvisual\fP] +[\-window] +[\-root] +[\-delay \fInumber\fP] +[\-speed \fIfloat\fP] +[\-duration \fIseconds\fP] +[\-no-wander] +[\-spin \fIXYZ\fP] +[\-wireframe] +[\-no-titles] +[\-which \fIname\fP] +[\-wireframe] +[\-fps] +.SH DESCRIPTION +This program renders 160 different 3D solids, and displays some +information about each. A new solid is chosen every few seconds. + +There are 75 uniform polyhedra, plus an inifinite number of +prisms and antiprisms: + + * Convex Uniform Polyhedra: + * Platonic solids (5) + * Archimedean solids (13) + * Convex prisms and antiprisms (2 infinite families) + * Nonconvex Uniform Polyhedra: + * Kepler-Poinsot polyhedra (4) + * Nonconvex uniform polyhedra (53) + * Nonconvex prisms, antiprisms, and crossed antiprisms + (3 infinite families) + +Representative samples of the prism sets brings the total to 80 solids. +Including the \fIdual\fP of each brings the total up to 160. (To +create the "dual" of a polyhedron, faces are replaced with vertices, +and vertices with faces.) +.SH OPTIONS +.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 \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-delay \fInumber\fP +Per-frame delay, in microseconds. Default: 30000 (0.03 seconds.). +.TP 8 +.B \-speed \fInumber\fP +Larger numbers mean run faster. Default: 1.0. +.TP 8 +.B \-duration \fIseconds\fP +How long before switching to a new polyhedron. Default 12 seconds. +.TP 8 +.B \-wander | \-no-wander +Whether the objects should wander around the screen. +.TP 8 +.B \-spin [XYZ] | \-no-spin +Which axes, if any, to spin around on. +.TP 8 +.B \-titles | \-no-titles +Whether to display text describing each object. +.TP 8 +.B \-which \fIobject-name\fP +Display only one particular object, identified by number, name, or +Whthoff symbol. +.TP 8 +.B \-wireframe | \-no-wireframe +Render in wireframe instead of solid. +.TP 8 +.B \-fps +Display the current frame rate, CPU load, and polygon count. +.SH KEY BINDINGS +When running in a window, you can rotate the object with the mouse. +Also, the following keystrokes are defined: +.TP 12 +.B SPC \fIor\fP TAB +Select a new polyhedron at random. +.TP 12 +.B + \fIor\fP > +Select the next-higher-numbered polyhedron. +.TP 12 +.B - \fIor\fP < +Select the next-lower-numbered polyhedron. +.TP 12 +.B ESC \fIor\fP ^C +Quit. +.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 1991-2002 Dr. Zvi Har'El. + +Copyright \(co 2004 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 the program \fIkaleido\fP ("Kaleidoscopic construction of +uniform polyhedra"), by Dr. Zvi Har'El + http://www.math.technion.ac.il/~rl/ + ftp://ftp.math.technion.ac.il/kaleido/ + +Adapted for OpenGL and XScreenSaver by Jamie Zawinski, 2004. diff --git a/hacks/glx/polytopes.man b/hacks/glx/polytopes.man new file mode 100644 index 00000000..45fcb4a8 --- /dev/null +++ b/hacks/glx/polytopes.man @@ -0,0 +1,207 @@ +.TH XScreenSaver 1 "" "X Version 11" +.SH NAME +polytopes - Draws one of the six regular 4d polytopes rotating in 4d. +.SH SYNOPSIS +.B polytopes +[\-display \fIhost:display.screen\fP] +[\-install] +[\-visual \fIvisual\fP] +[\-window] +[\-root] +[\-delay \fIusecs\fP] +[\-fps] +[\-5-cell] +[\-8-cell] +[\-16-cell] +[\-24-cell] +[\-120-cell] +[\-600-cell] +[\-wireframe] +[\-surface] +[\-transparent] +[\-single-color] +[\-depth-colors] +[\-perspective-3d] +[\-orthographic-3d] +[\-perspective-4d] +[\-orthographic-4d] +[\-speed-wx \fIfloat\fP] +[\-speed-wy \fIfloat\fP] +[\-speed-wz \fIfloat\fP] +[\-speed-xy \fIfloat\fP] +[\-speed-xz \fIfloat\fP] +[\-speed-yz \fIfloat\fP] +.SH DESCRIPTION +The \fIpolytopes\fP program shows one of the six regular 4d polytopes +(5-cell, 8-cell, 16-cell, 24-cell, 120-cell, or 600-cell) rotating in +4d. The program projects the 4d polytope to 3d using either a +perspective or an orthographic projection. The projected 3d polytope +can then be projected to the screen either perspectively or +orthographically. There are three display modes for the polytope: +mesh (wireframe), solid, or transparent. Furthermore, the colors with +which the polytope is drawn can be set to either single color or to a +coloring according to the 4d "depth" (the w coordinate) of the +polytope in its unrotated position. In the first case, the polytope +is drawn in red. This coloring combined with transparency gives a +nice visual effect of the structure of the polytope. The second mode +draws the polytope with a fully saturated color wheel in which the +edges or faces are colored accoring to their average 4d "depth". This +mode is best combined with the wireframe mode, where it allows you to +see how different parts of the polytope are moved to the "inside" of +the projected polytope in 3d. Of course, in 4d the cells, faces, and +edges of the polytope all have the same distance from the center of +the polytope. Only the projection creates the appearance that some of +the cells lie "inside" the figure in 3d. +.SH OPTIONS +.I polytopes +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 much of a delay should be introduced between steps of the +animation. Default 25000, or 1/40th second. +.PP +The following six options are mutually exclusive. They determine +which polytope is displayed. +.TP 8 +.B \-5-cell +Display the 5-cell. The 5-cell is the 4d analogon of a regular +tetrahedron in 3d. It has 5 regular tetrahedra as its cells, 10 +equilateral triangles as faces, 10 edges, and 5 vertices. +.TP 8 +.B \-8-cell +Display the 8-cell (a.k.a. hypercube or tessaract). The 8-cell is the +4d analogon of a cube in 3d. It has 8 cubes as its cells, 24 squares +as faces, 32 edges, and 16 vertices. +.TP 8 +.B \-16-cell +Display the 16-cell. The 16-cell is the 4d analogon of an octahedron +in 3d. It has 16 regular tetrahedra as its cells, 32 equilateral +triangles as faces, 24 edges, and 8 vertices. +.TP 8 +.B \-24-cell +Display the 24-cell. The 24-cell has no 3d analogon. It has 24 +regular octahedra as its cells, 96 equilateral triangles as faces, 96 +edges, and 24 vertices. +.TP 8 +.B \-120-cell +Display the 120-cell. The 120-cell has no 3d analogon. It has 120 +regular dodecahedra as its cells, 720 regular pentagons as faces, 1200 +edges, and 600 vertices. +.TP 8 +.B \-600-cell +Display the 600-cell. The 600-cell has no 3d analogon. It has 600 +regular tetrahedra as its cells, 1200 equilateral triangles as faces, +720 edges, and 120 vertices. +.PP +The following three options are mutually exclusive. They determine +how the polytope is displayed. +.TP 8 +.B \-wireframe +Display the polytope as a wireframe mesh. +.TP 8 +.B \-surface +Display the polytope as a solid object. +.TP 8 +.B \-transparent +Display the polytope as a transparent object (default). +.PP +The following two options are mutually exclusive. They determine how +to color the polytope. +.TP 8 +.B \-single-color +Display the polytope in red. +.TP 8 +.B \-depth-colors +Display the polytope with a fully saturated color wheel in which the +edges or faces are colored accoring to their average 4d "depth", i.e., +the w coordinate of the polytope in its unrotated position (default). +.PP +The following two options are mutually exclusive. They determine how +the polytope is projected from 3d to 2d (i.e., to the screen). +.TP 8 +.B \-perspective-3d +Project the polytope from 3d to 2d using a perspective projection +(default). +.TP 8 +.B \-orthographic-3d +Project the polytope from 3d to 2d using an orthographic projection. +.PP +The following two options are mutually exclusive. They determine how +the polytope is projected from 4d to 3d. +.TP 8 +.B \-perspective-4d +Project the polytope from 4d to 3d using a perspective projection +(default). +.TP 8 +.B \-orthographic-4d +Project the polytope from 4d to 3d using an orthographic projection. +.PP +The following six options determine the rotation speed of the polytope +around the six possible hyperplanes. The rotation speed is measured +in degrees per frame. The speeds should be set to relatively small +values, e.g., less than 4 in magnitude. +.TP 8 +.B \-speed-wx \fIfloat\fP +Rotation speed around the wx plane (default: 1.1). +.TP 8 +.B \-speed-wy \fIfloat\fP +Rotation speed around the wy plane (default: 1.3). +.TP 8 +.B \-speed-wz \fIfloat\fP +Rotation speed around the wz plane (default: 1.5). +.TP 8 +.B \-speed-xy \fIfloat\fP +Rotation speed around the xy plane (default: 1.7). +.TP 8 +.B \-speed-xz \fIfloat\fP +Rotation speed around the xz plane (default: 1.9). +.TP 8 +.B \-speed-yz \fIfloat\fP +Rotation speed around the yz plane (default: 2.1). +.SH INTERACTION +If you run this program in standalone mode you can rotate the polytope +by dragging the mouse while pressing the left mouse button. This +rotates the polytope in 3D, i.e., around the wx, wy, and wz planes. +If you press the shift key while dragging the mouse with the left +button pressed the polytope is rotated in 4D, i.e., around the xy, xz, +and yz planes. To examine the polytope at your leisure, it is best to +set all speeds to 0. Otherwise, the polytope will rotate while the +left mouse button is not pressed. +.B \-fps +Display the current frame rate, CPU load, and polygon count. +.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 2003-2005 by Carsten Steger. 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 +Carsten Steger , 28-sep-2005. diff --git a/hacks/glx/providence.man b/hacks/glx/providence.man new file mode 100644 index 00000000..ea7286d5 --- /dev/null +++ b/hacks/glx/providence.man @@ -0,0 +1,66 @@ +.TH XScreenSaver 1 "May 2004" +.SH NAME +providence - eye in glory screenhack +.SH SYNOPSIS +.B providence +[\-display \fIhost:display.screen\fP] +[\-window] +[\-root] + [\-install] +[\-visual \fIvisual\fP] +[\-delay \fImicroseconds\fP] +[\-wireframe] +[\-fps] +.SH DESCRIPTION +The \fIprovidence\fP code displays an eye, shrouded in glory, set upon the +base of a pyramid. +.SH OPTIONS +.I providence +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 \-eye +Draw an eye/$. +.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 \-wireframe +Render in wireframe (with hidden line removal) instead of as textured solids. +.TP 8 +.B \-fps +Display the current frame rate, CPU load, and polygon count. +.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\-demo (1), +.BR xscreensaver\-getimage (1) +.SH COPYRIGHT +Copyright \(co 2004 by Blair Tennessy. 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 +Blair Tennessy , 11-May-2004. + diff --git a/hacks/glx/pulsar.man b/hacks/glx/pulsar.man new file mode 100644 index 00000000..f3b10090 --- /dev/null +++ b/hacks/glx/pulsar.man @@ -0,0 +1,102 @@ +.TH XScreenSaver 1 "" "X Version 11" +.SH NAME +pulsar - intersecting planes, alpha blending, fog, and textures. +.SH SYNOPSIS +.B pulsar +[\-display \fIhost:display.screen\fP] +[\-visual \fIvisual\fP] +[\-window] +[\-root] +[\-no-light] +[\-wire] +[\-delay \fInumber\fP] +[\-quads \fInumber\fP] +[\-image \fIfile\fP] +[\-light] +[\-fog] +[\-texture] +[\-mipmap] +[\-no-blend] +[\-antialias] +[\-texture_quality] +[\-do_depth] +[\-fps] +.SH DESCRIPTION +Draws some intersecting planes, making use of alpha blending, fog, +textures, and mipmaps, plus a ``frames per second'' meter so that you can +tell how fast your graphics card is... Requires OpenGL. +.SH OPTIONS +.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 \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-light | \-no-light +Use Flat Coloring. +.TP 8 +.B \-wire +Render in wireframe instead of solid. +.TP 8 +.B \-delay \fInumber\fP +Per-frame delay, in microseconds. Default: 10000 (0.01 seconds.). +.TP 8 +.B \-image \fIfile\fP +The texture map to use. +.TP 8 +.B \-quads \fInumber\fP +Quad Count. 1 - 50. Default: 5. +.TP 8 +.B \-light | \-no-light +Whether to enable lighting. +.TP 8 +.B \-fog | \-no-fog +Whether to enable fog. +.TP 8 +.B \-texture | \-no-texture +Whether to enable texturing. +.TP 8 +.B \-mipmap | \-no-mipmap +Whether to enable texture mipmaps. +.TP 8 +.B \-blend | \-no-blend +Whether to enable blending. +.TP 8 +.B \-antialias | \-no-antialias +Whether to anti-alias lines. +.TP 8 +.B \-texture_quality | \-no-texture_quality +Whether to enable texture filtering. +.TP 8 +.B \-do_depth | \-no-do_depth +Whether to enable depth buffer. +.TP 8 +.B \-fps +Display the current frame rate, CPU load, and polygon count. +.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 2002 by David Konerding. 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 +David Konerding. diff --git a/hacks/glx/quasicrystal.man b/hacks/glx/quasicrystal.man new file mode 100644 index 00000000..cbf90400 --- /dev/null +++ b/hacks/glx/quasicrystal.man @@ -0,0 +1,84 @@ +.TH XScreenSaver 1 "" "X Version 11" +.SH NAME +quasicrystal - aperiodic plane tilings. +.SH SYNOPSIS +.B quasicrystal +[\-display \fIhost:display.screen\fP] +[\-visual \fIvisual\fP] +[\-window] +[\-root] +[\-delay \fInumber\fP] +[\-speed \fInumber\fP] +[\-count \fInumber\fP] +[\-contrast \fIpercent\fP] +[\-no-wander] +[\-no-spin] +[\-asymmetric] +[\-fps] +.SH DESCRIPTION +A quasicrystal is a structure that is ordered but aperiodic. +Two-dimensional quasicrystals can be generated by adding a set of planes +where x is the sine of y. Different complex aperiodic plane tilings are +produced depending on the period, position, and rotation of the component +planes, and whether the rotation of the planes is evenly distributed around +the circle (the "symmetric" option, above) or random. See also the +"RD-Bomb", "CWaves" and "Penrose" screen savers. +http://en.wikipedia.org/wiki/Quasicrystal +.SH OPTIONS +.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 \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-delay \fInumber\fP +Per-frame delay, in microseconds. Default: 30000 (0.03 seconds.). +.TP 8 +.B \-speed \fInumber\fP +Animation speed. 2 for twice as fast, 0.5 for half as fast. +.TP 8 +.B \-contrast \fIcontrast\fP +Contrast. Sort of. Default 30%. +.TP 8 +.B \-count \fInumber\fP +How many planes to use. Default 17. +.TP 8 +.B \-wander | \-no-wander +Whether the planes should displace horizontally and vertically. +.TP 8 +.B \-spin | \-no-spin +Whether the planes should rotate. +.TP 8 +.B \-asymmetric +Allow each plane to rotate freely instead of being constrained to an +even distribution around the circle. +.TP 8 +.B \-fps | \-no-fps +Whether to show a frames-per-second display at the bottom of 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 SEE ALSO +.BR X (1), +.BR xscreensaver (1) +.SH COPYRIGHT +Copyright \(co 2013 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. diff --git a/hacks/glx/queens.man b/hacks/glx/queens.man new file mode 100644 index 00000000..47fc3f4c --- /dev/null +++ b/hacks/glx/queens.man @@ -0,0 +1,66 @@ +.TH XScreenSaver 1 "May 2002" +.SH NAME +queens \- n queens screensaver +.SH SYNOPSIS +.B queens +[\-display \fIhost:display.screen\fP] +[\-window] +[\-root] +[\-install] +[\-visual \fIvisual\fP] +[\-delay \fImicroseconds\fP] +[\-wireframe] +[\-fps] +.SH DESCRIPTION +The \fIqueens\fP program solves the n-queens problem (where, in this +program, N is between 5 and 10 queens) using a straightforward +backtracking algorithm. The problem is: how may one place N queens +on an NxN chessboard such that no queen can attack a sister? +.SH OPTIONS +.I queens +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 \-wireframe +Render in wireframe instead of solid. +.B \-fps +Display the current frame rate, CPU load, and polygon count. +.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's not unknown for this and other OpenGL hacks to fail under hardware accelaration (UtahGLX) and take the X server with them. Texture images must be 16x16 or 32x32 or 64x64 etc. +.SH SEE ALSO +.BR X (1), +.BR xscreensaver (1) +.BR xscreensaver\-demo (1), +.BR xscreensaver\-getimage (1) +.SH COPYRIGHT +Copyright \(co 2002 by Blair Tennessy. 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 +Blair Tennessy , 20-April-2002. + diff --git a/hacks/glx/rubik.man b/hacks/glx/rubik.man new file mode 100644 index 00000000..08e5b94e --- /dev/null +++ b/hacks/glx/rubik.man @@ -0,0 +1,69 @@ +.TH XScreenSaver 1 "" "X Version 11" +.SH NAME +rubik - screen saver that solves Rubik's Cube. +.SH SYNOPSIS +.B rubik +[\-display \fIhost:display.screen\fP] +[\-visual \fIvisual\fP] +[\-window] +[\-root] +[\-count \fInumber\fP] +[\-cycles \fInumber\fP] +[\-delay \fInumber\fP] +[\-size \fInumber\fP] +[\-hideshuffling] +[\-fps] +.SH DESCRIPTION +Draws a Rubik's Cube that rotates in three dimensions and repeatedly +shuffles and solves itself. +.SH OPTIONS +.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 \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-count \fInumber\fP +Count. -100 - 100. Default: -30. +.TP 8 +.B \-cycles \fInumber\fP +Timeout. 0 - 60. Default: 5. +.TP 8 +.B \-delay \fInumber\fP +Per-frame delay, in microseconds. Default: 40000 (0.04 seconds.). +.TP 8 +.B \-size \fInumber\fP +Size. -20 - 20. Default: -6. +.TP 8 +.B \-hideshuffling | \-no-hideshuffling +Show Shuffling. Boolean. +.TP 8 +.B \-fps +Display the current frame rate, CPU load, and polygon count. +.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 2002 by Marcelo Vianna. 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 +Marcelo Vianna. diff --git a/hacks/glx/rubikblocks.man b/hacks/glx/rubikblocks.man new file mode 100644 index 00000000..c18d18f9 --- /dev/null +++ b/hacks/glx/rubikblocks.man @@ -0,0 +1,117 @@ +.TH XScreenSaver 1 "04-Feb-09" "X Version 11" +.SH NAME +rubikblocks - animates the Rubik's Mirror Blocks puzzle +.SH SYNOPSIS +.B rubikblocks +[\-display \fIhost:display.screen\fP] +[\-visual \fIvisual\fP] +[\-window] +[\-root] +[\-install] +[\-delay \fImicroseconds\fP] +[\-texture] [\-no\-texture] +[\-mono] +[\-wireframe] +[\-spin] [\-no\-spin] +[\-wander] [\-no\-wander] +[\-randomize] [\-no\-randomize] +[\-spinspeed \fInumber\fP] +[\-rotspeed \fInumber\fP] +[\-wanderspeed \fInumber\fP] +[\-wait \fInumber\fP] +[\-cubesize \fInumber\fP] +[\-fps] +.SH DESCRIPTION +This program animates a puzzle called Rubik's Mirror Blocks. +The moves are chosen randomly. +.SH OPTIONS +.I rubikblocks +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 \-delay \fImicroseconds\fP +How long to pause between frames. Default is 20000, or 0.02 second. +.TP 8 +.B \-texture +Use texture maps. This is the default. +.TP 8 +.B \-no\-texture +Use solid colors. Looks a bit weird. +.TP 8 +.B \-mono +Disable both texture maps and colors. Ditto. +.TP 8 +.B \-wireframe +Only draw outlines. Outlines of each piece, not only the whole object, are drawn. +.TP 8 +.B \-spin +Spin the whole object around X, Y and Z axes. This is the default. +.TP 8 +.B \-no\-spin +Do not spin, stay in the same tilt all the time. +.TP 8 +.B \-wander +Move the object around the screen. This is the default. +.TP 8 +.B \-no\-wander +Keep the object centered on the screen. +.TP 8 +.B \-randomize +Shuffle the puzzle randomly at startup. This is the default. +.TP 8 +.B \-no\-randomize +Do not shuffle at startup, begin at the shape of cube. +.TP 8 +.B \-spinspeed \fInumber\fP +The relative speed of spinning. Default is 1.0. +.TP 8 +.B \-rotspeed \fInumber\fP +The relative speed of the moves. Default is 3.0. Setting to \(<= 0.0 +makes the object stay at one configuration. +.TP 8 +.B \-wanderspeed \fInumber\fP +The relative speed of wandering around the screen. Default is 0.02. +.TP 8 +.B \-wait \fInumber\fP +How long to stay at final position after each move. The meaning of +the argument is again relative. Default is 40.0. +.TP 8 +.B \-cubesize \fInumber\fP +Size of the object. Value of 3.0 fills roughly all the screen. +.TP 8 +.B \-fps +Display the current frame rate, CPU load, and polygon count. +.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 2009 by Vasek Potocek. 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 +Vasek Potocek , 04-Feb-09. diff --git a/hacks/glx/sballs.man b/hacks/glx/sballs.man new file mode 100644 index 00000000..33cb9421 --- /dev/null +++ b/hacks/glx/sballs.man @@ -0,0 +1,125 @@ +.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 "03-Oct-01" "X Version 11" +.SH NAME +sballs - draws balls spinning like crazy in GL +.SH SYNOPSIS +.B sballs +[\-display \fIhost:display.screen\fP] [\-window] [\-root] +[\-visual \fIvisual\fP] [\-delay \fImicroseconds\fP] +[\-object \fIobject_number\fP] +[\-cycles \fIsphere_speed\fP] +[\-size \fIviewport_size\fP] +[\-texture] [\-no-texture] +[\-wireframe] [\-no-wireframe] +[\-trackmouse] [\-no-trackmouse] +[\-fps] +.SH DESCRIPTION +The \fIsballs\fP program draws an animation of balls spinning like crazy in GL. +.SH OPTIONS +.I sballs +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 \-fps +Display the current frame rate, CPU load, and polygon count. +.TP 8 +.B \-object \fIobject_number\fP\fP +Specify how the spheres are grouped (forming an object). +Objects are: +.TP 10 +.B 1 +tetrahedron +.TP 10 +.B 2 +cube. This is the default. +.TP 10 +.B 3 +octahedron +.TP 10 +.B 4 +dodecahedron +.TP 10 +.B 5 +icosahedron +.TP 10 +.B 6 +plane +.TP 10 +.B 7 +pyramid +.TP 10 +.B 8 +star +.TP 8 +.B \-size \fIviewport_size\fP\fP +Viewport of GL scene is specified size if greater than 32 and less than screensize. Default value is 0, meaning full screensize. +.TP 8 +.B \-texture +Show a textured background and spheres. This is the default. +.TP 8 +.B \-no\-texture +Disables texturing the animation. +.TP 8 +.B \-trackmouse +Let the mouse be a joystick to change the view of the animation. +This implies +.I \-no\-wander. +.TP 8 +.B \-no\-trackmouse +Disables mouse tracking. This is the default. +.TP 8 +.B \-wire +Draw a wireframe rendition of the spheres. +.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 2001 by Eric Lassauge. +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. + +The original code for this mode was written by +Mustata Bogdan (LoneRunner) +and can be found at http://www.cfxweb.net/lonerunner/ + +.SH AUTHOR +Mustata Bogdan (LoneRunner) +Eric Lassauge diff --git a/hacks/glx/sierpinski3d.man b/hacks/glx/sierpinski3d.man new file mode 100644 index 00000000..ed3b69a9 --- /dev/null +++ b/hacks/glx/sierpinski3d.man @@ -0,0 +1,67 @@ +.TH XScreenSaver 1 "" "X Version 11" +.SH NAME +sierpinski3d - 3D Sierpinski triangle fractal. +.SH SYNOPSIS +.B sierpinski3d +[\-display \fIhost:display.screen\fP] +[\-visual \fIvisual\fP] +[\-window] +[\-root] +[\-delay \fInumber\fP] +[\-speed \fInumber\fP] +[\-depth \fInumber\fP] +[\-wireframe] +[\-fps] +.SH DESCRIPTION +This draws the three-dimensional variant of the recursive Sierpinski +triangle fractal, using GL. +.SH OPTIONS +.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 \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-delay \fInumber\fP +Per-frame delay, in microseconds. Default: 20000 (0.02 seconds.). +.TP 8 +.B \-speed \fInumber\fP +Number of frames before changing shape. Default: 150. +.TP 8 +.B \-depth \fInumber\fP +Max depth to descend. Default: 5. You probably don't have enough +memory for 6. +.TP 8 +.B \-wireframe +Render in wireframe instead of solid. +.TP 8 +.B \-fps +Display the current frame rate, CPU load, and polygon count. +.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 2002 by Tim Robinson and 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 +Tim Robinson and Jamie Zawinski. diff --git a/hacks/glx/skytentacles.man b/hacks/glx/skytentacles.man new file mode 100644 index 00000000..2e5cd16e --- /dev/null +++ b/hacks/glx/skytentacles.man @@ -0,0 +1,102 @@ +.TH XScreenSaver 1 "" "X Version 11" +.SH NAME +skytentacles - 3D tentacles from the sky! +.SH SYNOPSIS +.B skytentacles +[\-display \fIhost:display.screen\fP] +[\-visual \fIvisual\fP] +[\-window] +[\-root] +[\-delay \fIint\fP] +[\-speed \fIratio\fP] +[\-count \fIint\fP] +[\-slices \fIint\fP] +[\-length \fIfloat\fP] +[\-wiggliness \fIratio\fP] +[\-flexibility \fIratio\fP] +[\-color \fIcolor\fP] +[\-stripe\-color \fIcolor\fP] +[\-sucker\-color \fIcolor\fP] +[\-segments \fIint\fP] +[\-thickness \fIratio\fP] +[\-no\-smooth] +[\-fps] +.SH DESCRIPTION +There is a tentacled abomination in the sky. From above you it devours. +.SH OPTIONS +.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 \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-delay \fIint\fP +Delay between frames, in microseconds. Default 30000. +.TP 8 +.B \-speed \fIratio\fP +Less than 1 for slower, greater than 1 for faster. Default 1. +.TP 8 +.B \-count \fIint\fP +How many tentacles. Default 8. +.TP 8 +.B \-thickness \fIratio\fP +Less than 1 for thinner tentacles, greater than 1 for thicker. Default 1. +.TP 8 +.B \-length \fIratio\fP +Length of the tentacles. Default 9. +.TP 8 +.B \-wiggliness \fIratio\fP +A measure of how bendy the tentacles are. Smaller numbers result in +smoother flexing; larger numbers make it "crinkly". Default 0.35. +.TP 8 +.B \-flexibility \fIratio\fP +Another measure of how bendy the tentacles are. Smaller numbers +result in straighter tentacles; larger numbers result in more extreme +curves. Default 0.35. +.TP 8 +.B \-color \fIcolor\fP +.TP 8 +.B \-stripe\-color \fIcolor\fP +.TP 8 +.B \-sucker\-color \fIcolor\fP +The colors of the various parts of the tentacle. Default green +with a redish stripe. +.TP 8 +.B \-slices \fIint\fP +.TP 8 +.B \-segments \fIint\fP +Larger numbers increase number of polygons in the object mesh. +Default 32. +.TP 8 +.B \-no\-smooth +Make the tentacles appear faceted instead of smooth. +.TP 8 +.B \-fps +Display the current frame rate, CPU load, and polygon count. +.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 2008 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. diff --git a/hacks/glx/sonar.man b/hacks/glx/sonar.man new file mode 100644 index 00000000..9927b3bb --- /dev/null +++ b/hacks/glx/sonar.man @@ -0,0 +1,169 @@ +.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 "12-Aug-08" "X Version 11" +.SH NAME +sonar - display a sonar scope +.SH SYNOPSIS +.B sonar +[\-ping \fIhosts-or-subnets\fP] +[\-ping\-timeout \fIint\fP] +[\-delay \fIusecs\fP] +[\-speed \fIratio\fP] +[\-sweep-size \fIratio\fP] +[\-font-size \fIpoints\fP] +[\-team-a-name \fIstring\fP] +[\-team-b-name \fIstring\fP] +[\-team-a-count \fIint\fP] +[\-team-b-count \fIint\fP] +[\-no\-dns] +[\-no\-times] +[\-no\-wobble] +[\-debug] +[\-fps] +.SH DESCRIPTION +This draws a sonar screen that pings (get it?) the hosts on +your local network, and plots their distance (response time) from you. +The three rings represent ping times of approximately 2.5, 70 and 2,000 +milliseconds respectively. + +Alternately, it can run a simulation that doesn't involve hosts. +.SH OPTIONS +.I sonar +understands the following options: +.TP 8 +.B \-ping \fIhosts-or-subnets\fP +The list of things to ping, separated by commas or spaces. +Elements of this list may be: +.RS 8 +.TP 12 +.B simulation +Run in simulation mode instead of pinging real hosts. +.TP 12 +.I hostname +Ping the given host. +.TP 12 +.I A.B.C.D +Ping the given IPv4 address. +.TP 12 +.B subnet +Ping the local subnet. On systems where we can determine the local +network mask, we use that; otherwise, we assume Class C (254 hosts). +.TP 12 +.B subnet/\fINN\fP +Ping a different-sized local subnet: e.g., \fBsubnet/28\fP would ping +a 4-bit subnet (the nearest 14 addresses). On systems where we can +determine the local network mask, we always use that. +.TP 12 +.I A.B.C.D/NN +Ping an arbitrary other IPv4 subnet. The address specifies +the base address, and the part after the slash is how wide the +subnet is. Typical values are /24 (for 254 addresses) and /28 (for +14 addresses). +.TP 12 +.I filename +Ping the hosts listed in the given file. 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 or second element on each line. If you use ssh, +try this: + + sonar -ping $HOME/.ssh/known_hosts +.RE +.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 \-delay \fIint\fP +Delay between frames, in microseconds. Default 20000. +.TP 8 +.B \-speed \fIratio\fP +Less than 1 for slower, greater than 1 for faster. Default 1. +.TP 8 +.B \-sweep-size \fIratio\fP +How big the glowing sweep area should be. Default 0.3. +.TP 8 +.B \-font-size \fIpoints\fP +How large the text should be. Default 10 points. +.TP 8 +.B \-no\-wobble +Keep the display stationary instead of very slowly wobbling back and forth. +.TP 8 +.B \-no\-dns +Do not attempt to resolve IP addresses to hostnames. +.TP 8 +.B \-no\-times +Do not display ping times beneath the host names. +.TP 8 +.B \-team-a-name \fIstring\fP +In simulation mode, the name of team A. +.TP 8 +.B \-team-b-name \fIstring\fP +In simulation mode, the name of team B. +.TP 8 +.B \-team-a-count \fIint\fP +In simulation mode, the number of bogies on team A. +.TP 8 +.B \-team-b-count \fIint\fP +In simulation mode, the number of bogies on team B. +.TP 8 +.B \-fps +Display the current frame rate, polygon count, and CPU load. +.SH NOTES +On most Unix systems, this program must be installed as setuid root +in order to ping hosts. This is because root privileges are needed +to create an ICMP RAW socket. Privileges are disavowed shortly after +startup (just after connecting to the X server) so this is believed +to be safe: +.EX +chown root:root sonar +chmod u+s sonar +.EE +It is not necessary to make it setuid on MacOS systems, because on +MacOS, unprivileged programs can ping by using ICMP DGRAM sockets +instead of ICMP RAW. + +In ping-mode, the display is a logarithmic scale, calibrated so that the +three rings represent ping times of approximately 2.5, 70 and 2,000 +milliseconds respectively. + +This means that if any the hosts you are pinging take longer than 2 +seconds to respond, they won't show up; and if you are pinging several +hosts with very fast response times, they will all appear close to the +center of the screen (making their names hard to read.) +.SH BUGS +Does not support IPv6. +.SH SEE ALSO +.BR X (1), +.BR xscreensaver (1), +.BR ping (8), +.BR ping6 (8) +.SH COPYRIGHT +Copyright \(co 2000-2012 by Jamie Zawinski +.RE +Copyright \(co 1998 by Stephen Martin. + +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-1998. + +Subnet support, etc. added by Jamie Zawinski, 17-Jul-2000. + +Rewritten using OpenGL instead of X11 by Jamie Zawinski, 12-Aug-2008. diff --git a/hacks/glx/spheremonics.man b/hacks/glx/spheremonics.man new file mode 100644 index 00000000..5e6f437e --- /dev/null +++ b/hacks/glx/spheremonics.man @@ -0,0 +1,92 @@ +.TH XScreenSaver 1 "" "X Version 11" +.SH NAME +spheremonics - 3d spherical harmonic shapes. +.SH SYNOPSIS +.B spheremonics +[\-display \fIhost:display.screen\fP] +[\-visual \fIvisual\fP] +[\-window] +[\-root] +[\-delay \fInumber\fP] +[\-duration \fInumber\fP] +[\-resolution \fInumber\fP] +[\-wander] +[\-no-spin] +[\-spin \fI[XYZ]\fP] +[\-wireframe] +[\-no-smooth] +[\-no-grid] +[\-bbox] +[\-fps] +.SH DESCRIPTION +These closed objects are commonly called spherical harmonics, although they +are only remotely related to the mathematical definition found in the +solution to certain wave functions, most notable the eigenfunctions of +angular momentum operators. +.SH OPTIONS +.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 \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-delay \fInumber\fP +Per-frame delay, in microseconds. Default: 30000 (0.03 seconds.). +.TP 8 +.B \-duration \fInumber\fP +Duration. 5 - 1000. Default: 100. +.TP 8 +.B \-resolution \fInumber\fP +Resolution. 5 - 100. Default: 64. +.TP 8 +.B \-wander | \-no-wander +Whether the object should wander around the screen. +.TP 8 +.B \-spin \fI[XYZ]\fP +Around which axes should the object spin? +.TP 8 +.B \-no-spin +Don't spin. +.TP 8 +.B \-wireframe +Render in wireframe instead of solid. +.TP 8 +.B \-smooth | \-no-smooth +Smoothed Lines. Boolean. +.TP 8 +.B \-grid | \-no-grid +Draw Grid. Boolean. +.TP 8 +.B \-bbox | \-no-bbox +Draw Bounding Box. Boolean. +.TP 8 +.B \-fps +Display the current frame rate, CPU load, and polygon count. +.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 2002 by Paul Bourke and 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 +Paul Bourke and Jamie Zawinski. diff --git a/hacks/glx/sproingies.man b/hacks/glx/sproingies.man new file mode 100644 index 00000000..5150fca5 --- /dev/null +++ b/hacks/glx/sproingies.man @@ -0,0 +1,68 @@ +.TH XScreenSaver 1 "" "X Version 11" +.SH NAME +sproingies - Q-Bert meets Marble Madness! +.SH SYNOPSIS +.B sproingies +[\-display \fIhost:display.screen\fP] +[\-visual \fIvisual\fP] +[\-window] +[\-root] +[\-count \fInumber\fP] +[\-delay \fInumber\fP] +[\-size \fInumber\fP] +[\-no\-fall] +[\-wireframe] +[\-fps] +.SH DESCRIPTION +Q-Bert meets Marble Madness! +.SH OPTIONS +.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 \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-count \fInumber\fP +How many sproingies to draw at once. Default: 5. +.TP 8 +.B \-delay \fInumber\fP +Per-frame delay, in microseconds. Default: 25000 (0.03 seconds.). +.TP 8 +.B \-size \fInumber\fP +How much to scale the image down. Default 0 (full screen.) +.TP 8 +.B \-no\-fall +Make sproingies "smart", so they do not fall down the edge. +.TP 8 +.B \-wireframe +Render in wireframe instead of solid. +.TP 8 +.B \-fps +Display the current frame rate, CPU load, and polygon count. +.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 2002 by Ed Mackey. 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 +Ed Mackey. Some additional code by Sergio Gutiérrez "Sergut". diff --git a/hacks/glx/stairs.man b/hacks/glx/stairs.man new file mode 100644 index 00000000..898f7ffa --- /dev/null +++ b/hacks/glx/stairs.man @@ -0,0 +1,56 @@ +.TH XScreenSaver 1 "" "X Version 11" +.SH NAME +stairs - Escher's infinite staircase. +.SH SYNOPSIS +.B stairs +[\-display \fIhost:display.screen\fP] +[\-visual \fIvisual\fP] +[\-window] +[\-root] +[\-delay \fInumber\fP] +[\-wireframe] +[\-fps] +.SH DESCRIPTION +This draws an "infinite" staircase. +.SH OPTIONS +.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 \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-delay \fInumber\fP +Per-frame delay, in microseconds. Default: 20000 (0.02 seconds.). +.TP 8 +.B \-wireframe +Render in wireframe instead of solid. +.TP 8 +.B \-fps +Display the current frame rate, CPU load, and polygon count. +.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 2002 by Marcelo Vianna. 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 +Marcelo Vianna. diff --git a/hacks/glx/starwars.man b/hacks/glx/starwars.man new file mode 100644 index 00000000..d7dc7f22 --- /dev/null +++ b/hacks/glx/starwars.man @@ -0,0 +1,181 @@ +.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 "25-Jul-98" "X Version 11" +.SH NAME +starwars - draws a perspective text crawl, like at the beginning of the movie +.SH SYNOPSIS +.B starwars +[\-display \fIhost:display.screen\fP] [\-window] [\-root] +[\-visual \fIvisual\fP] +[\-delay \fImicroseconds\fP] +[\-program \fIcommand\fP] +[\-size \fIinteger\fP ] +[\-columns \fIinteger\fP] +[\-wrap | \-no\-wrap] +[\-left | \-center | \-right] +[\-lines \fIinteger\fP] +[\-spin \fIfloat\fP] +[\-steps \fIinteger\fP] +[\-delay \fIusecs\fP] +[\-font \fIxlfd\fP] +[\-no\-textures] +[\-no\-smooth] +[\-no\-thick] +[\-fps] +.SH DESCRIPTION +The \fIstarwars\fP program runs another program to generate a stream of +text, then animates that text receeding into the background at an angle, +in front of a star field. +.SH OPTIONS +.I starwars +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 \-program \fIsh-command\fP +The command to run to generate the text to display. This option may be +any string acceptable to /bin/sh. The program will be run at the end of +a pipe, and any characters that it prints to \fIstdout\fP will be printed +on the starwars window. If the program exits, it will be launched again +after we have processed all the text it produced. + +Note that starwars is \fInot\fP a terminal emulator: programs that try to +directly address the screen will not do what you might expect. This +program merely draws the characters on the screen left to right, top +to bottom, in perspective. Lines (may) wrap when they reach the right +edge. + +In other words, programs like +.BR fortune (1) +will work, but programs like +.BR top (1) +won't. + +Some examples: +.EX +starwars -program 'cat /usr/src/linux*/README' +starwars -columns 30 -program 'ping www.starwars.com' +starwars -left -no-wrap -program 'ps -auxwwf' +starwars -left -no-wrap -columns 45 -program 'top -bn1' +starwars -left -columns 40 -program 'od -txC /dev/urandom' +starwars -font fixed -program 'od -txC /dev/urandom' +.EE +.TP 8 +.B \-size \fIinteger\fP +How large a font to use, in points. (Well, in some arbitrary unit +we're calling "points" for the sake of argument.) Default: 24. +.TP 8 +.B \-columns \fIinteger\fP +How many columns of text should be visible on the bottom line of the +screen. Default: 60. + +Only one of \fI\-columns\fP and \fI\-size\fP may be specified; +if both are specified, \fI\-columns\fP takes priority. +.TP 8 +.B \-wrap +Word-wrap lines when they reach the rightmost column. This is the default. +.TP 8 +.B \-no\-wrap +Do not word-wrap: just let the lines go off the right side of the screen. +.TP 8 +.B \-left | \-center | \-right +Whether to align the text flush left, centered, or flush right. +The default is centered. +.TP 8 +.B \-lines \fIinteger\fP +How many lines should be allowed to be on the screen before they fall off +the end. The default is 125. +.TP 8 +.B \-spin \fIfloat\fP +The star field on the background slowly rotates. This is how fast. +The default is 0.03. +.TP 8 +.B \-steps \fIinteger\fP +How many steps should be used to scroll a single line. The default is 35. +If the animation looks jerky to you, increase this number. +.TP 8 +.B \-delay \fIusecs\fP +The delay between steps of the animation; default is 40000 (1/25th second.) +.TP 8 +.B \-font \fIfont-name\fP +The name of the font to use. For best effect, this should be a large +font (at least 36 points.) The bigger the font, the better looking the +characters will be. Note that the size of this font affects only the +clarity of the characters, not their size on the screen: for that, use +the \fI\-size\fP or \fI\-columns\fP options. + +Default: -*-utopia-bold-r-normal-*-*-720-*-*-*-*-iso8859-1 +.TP 8 +.B \-no\-textures +Instead of texture-mapping a real font to render the text, use a +built-in font composed of line segments. On graphics cards without +texture support, the line-segment font will have much better +performance. +.TP 8 +.B \-no\-smooth +When using the line-segment font, turn off anti-aliasing of the lines +used to draw the font. This will make the text blockier, but may +improve performance. +.TP 8 +.B \-no\-thick +When using the line-segment font, turn off use of thick lines for the +characters that are close to the foreground. This will make the text +appear unnaturally skinny, but may improve performance. +.TP 8 +.B \-fps +Display the current frame rate, CPU load, and polygon count. +.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 xscreensaver (1), +.BR xscreensaver-text (1), +.BR fortune (1), +.BR phosphor (MANSUFFIX), +.BR apple2 (MANSUFFIX), +.BR fontglide (MANSUFFIX), +.BR ljlatest (MANSUFFIX), +.BR dadadodo (1), +.BR webcollage (MANSUFFIX), +.BR driftnet (1) +.BR EtherPEG , +.BR EtherPeek +.SH COPYRIGHT +Copyright \(co 1998-2005 by Jamie Zawinski and Claudio Matsuoka. +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 and Claudio Matauoka diff --git a/hacks/glx/stonerview.man b/hacks/glx/stonerview.man new file mode 100644 index 00000000..820e9af1 --- /dev/null +++ b/hacks/glx/stonerview.man @@ -0,0 +1,53 @@ +.TH XScreenSaver 1 "" "X Version 11" +.SH NAME +stonerview - 3D undulating ribbons of squares. +.SH SYNOPSIS +.B stonerview +[\-display \fIhost:display.screen\fP] +[\-visual \fIvisual\fP] +[\-window] +[\-root] +[\-wireframe] +[\-fps] +.SH DESCRIPTION +Chains of colorful squares dance around each other in complex spiral +patterns. This is a clone of the SGI "electropaint" screen saver. +.SH OPTIONS +.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 \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-wireframe +Render in wireframe instead of solid. +.TP 8 +.B \-fps +Display the current frame rate, CPU load, and polygon count. +.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 2002 by Andrew Plotkin. 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 +Andrew Plotkin. diff --git a/hacks/glx/superquadrics.man b/hacks/glx/superquadrics.man new file mode 100644 index 00000000..8a127f0b --- /dev/null +++ b/hacks/glx/superquadrics.man @@ -0,0 +1,70 @@ +.TH XScreenSaver 1 "" "X Version 11" +.SH NAME +superquadrics - morphing 3d shapes. +.SH SYNOPSIS +.B superquadrics +[\-display \fIhost:display.screen\fP] +[\-visual \fIvisual\fP] +[\-window] +[\-root] +[\-delay \fInumber\fP] +[\-spinspeed \fInumber\fP] +[\-count \fInumber\fP] +[\-cycles \fInumber\fP] +[\-wireframe] +[\-fps] +.SH DESCRIPTION +Ed Mackey reports that he wrote the first version of this program in BASIC +on a Commodore 64 in 1987, as a 320x200 black and white wireframe. Now it +is GL and has specular reflections. +.SH OPTIONS +.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 \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-delay \fInumber\fP +Per-frame delay, in microseconds. Default: 40000 (0.04 seconds.). +.TP 8 +.B \-spinspeed \fInumber\fP +0.1 - 15.0. Default: 5.0. +.TP 8 +.B \-count \fInumber\fP +0 - 100. Default: 25. +.TP 8 +.B \-cycles \fInumber\fP +0 - 100. Default: 40. +.TP 8 +.B \-wireframe +Render in wireframe instead of solid. +.TP 8 +.B \-fps +Display the current frame rate, CPU load, and polygon count. +.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 2002 by Ed Mackey. 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 +Ed Mackey. diff --git a/hacks/glx/surfaces.man b/hacks/glx/surfaces.man new file mode 100644 index 00000000..4c62a0e7 --- /dev/null +++ b/hacks/glx/surfaces.man @@ -0,0 +1,127 @@ +.TH XScreenSaver 1 "" "X Version 11" +.SH NAME +surfaces - Draws some interesting 3d parametric surfaces. +.SH SYNOPSIS +.B surfaces +[\-display \fIhost:display.screen\fP] +[\-visual \fIvisual\fP] +[\-window] +[\-root] +[\-speed \fInumber\fP] +[\-rand] +[\-spin] +[\-wander] +[\-fps] +[\-surface \fIsurface-name\fP] +[\-random-surface] +[\-dini] +[\-enneper] +[\-kuen] +[\-moebius] +[\-seashell] +[\-swallowtail] +[\-bohemian] +[\-whitney] +[\-pluecker] +[\-henneberg] +[\-catalan] +[\-corkscrew] +[\-mode \fIdisplay-mode\fP] +[\-random-mode] +[\-points] +[\-lines] +[\-line-loops] +.SH DESCRIPTION +This draws one of several three dimensional parametric surfaces. +.SH OPTIONS +.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 \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-delay \fInumber\fP +Per-frame delay, in microseconds. Default: 20000 (0.02 seconds.). +.TP 8 +.B \-speed \fInumber\fP +Number of frames before changing shape. Default: 1000. +.TP 8 +.B \-surface random \fP(Shortcut: \fB\-random-surface\fP) +Display a random surface. This is the default. +.TP 8 +.B \-surface dini \fP(Shortcut: \fB\-dini\fP) +Display Dini's surface. +.TP 8 +.B \-surface enneper \fP(Shortcut: \fB\-enneper\fP) +Display Enneper's minimal surface. +.TP 8 +.B \-surface kuen \fP(Shortcut: \fB\-kuen\fP) +Display the Kuen surface. +.TP 8 +.B \-surface moebius \fP(Shortcut: \fB\-moebius\fP) +Display the Moebius strip. +.TP 8 +.B \-surface seashell \fP(Shortcut: \fB\-seashell\fP) +Display the seashell surface. +.TP 8 +.B \-surface swallowtail \fP(Shortcut: \fB\-swallowtail\fP) +Display the swallowtail catastrophe. +.TP 8 +.B \-surface bohemian \fP(Shortcut: \fB\-bohemian\fP) +Display the Bohemian dome. +.TP 8 +.B \-surface whitney \fP(Shortcut: \fB\-whitney\fP) +Display the Whitney umbrella. +.TP 8 +.B \-surface pluecker \fP(Shortcut: \fB\-pluecker\fP) +Display Pluecker's conoid. +.TP 8 +.B \-surface henneberg \fP(Shortcut: \fB\-henneberg\fP) +Display Henneberg's minimal surface. +.TP 8 +.B \-surface catalan \fP(Shortcut: \fB\-catalan\fP) +Display Catalan's minimal surface. +.TP 8 +.B \-surface corkscrew \fP(Shortcut: \fB\-corkscrew\fP) +Display the corkscrew surface. +.TP 8 +.B \-mode random \fP(Shortcut: \fB\-random-mode\fP) +Use random OpenGL primitives to display the surface. This is the +default. +.TP 8 +.B \-mode points \fP(Shortcut: \fB\-points\fP) +Use OpenGL points to display the surface. +.TP 8 +.B \-mode lines \fP(Shortcut: \fB\-lines\fP) +Use OpenGL lines to display the surface. +.TP 8 +.B \-mode line-loops \fP(Shortcut: \fB\-line-loops\fP) +Use OpenGL line loops to display the surface. +.TP 8 +.B \-wander | \-no-wander +Whether to wander around the screen. +.TP 8 +.B \-spin | \-no-spin +Whether to rotate around the center of the figure. +.TP 8 +.B \-fps +Display the current frame rate, CPU load, and polygon count. +.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 AUTHORS +Andrey Mirtchovski, Carsten Steger diff --git a/hacks/glx/tangram.man b/hacks/glx/tangram.man new file mode 100644 index 00000000..c5d39809 --- /dev/null +++ b/hacks/glx/tangram.man @@ -0,0 +1,67 @@ +.TH XScreenSaver 1 "" "X Version 11" +.SH NAME +tangram - watch the computer solve tangram puzzles. +.SH SYNOPSIS +.B tangram +[\-display \fIhost:display.screen\fP] +[\-visual \fIvisual\fP] +[\-window] +[\-root] +[\-delay \fInumber\fP] +[\-wireframe] +[\-viewing_time \fInumber\fP] +[\-rotate] +[\-fps] +.SH DESCRIPTION +The \fItangram\fP program uses a few basic shapes to build silhouettes of recognizable objects. +.SH OPTIONS +.I tangram +accepts the following options: +.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 \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-delay \fInumber\fP +Per-frame delay, in microseconds. Default: 10000 (0.01 seconds.). +.TP 8 +.B \-wireframe | \-no-wireframe +Render in wireframe instead of solid. +.TP 8 +.B \-viewing_time \fInumber\fP +Specify the length of time, in seconds, that the finished puzzle +should be displayed. Default: 5 +.TP 8 +.B \-rotate | \-no-rotate +Rotate the camera around the puzzle. +.TP 8 +.B \-fps +Display the current frame rate, CPU load, and polygon count. +.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 2005 by Jeremy English. 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 +Jeremy English diff --git a/hacks/glx/timetunnel.man b/hacks/glx/timetunnel.man new file mode 100644 index 00000000..cdd6af5b --- /dev/null +++ b/hacks/glx/timetunnel.man @@ -0,0 +1,105 @@ +.TH XScreenSaver 1 "" "X Version 11" +.SH NAME +timetunnel - Plasma tunnels fade in and out +.SH SYNOPSIS +.B timetunnel +[\-display \fIhost:display.screen\fP] +[\-visual \fIvisual\fP] +[\-window] +[\-root] +[\-start \fInumber\fP] +[\-end \fInumber\fP] +[\-dilate \fInumber\fP] +[\-no-logo] +[\-reverse] +[\-no-fog] +[\-no-texture] +[\-wireframe] +[\-fps] +[\-tardis \fItexture\fP] +[\-head \fItexture\fP] +[\-marquee \fItexture\fP] +[\-tun1 \fItexture\fP] +[\-tun2 \fItexture\fP] +[\-tun3 \fItexture\fP] +.SH DESCRIPTION +Draws an animation similar to the opening and closing effects on the +Dr. Who television show. +.SH OPTIONS +.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 \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-start \fInumber\fP +Start time of loop, 0.0 - 30.00. Default 0.0. May be identical to end time. +.TP 8 +.B \-end \fInumber\fP +End time of loop, 0.0 - 30.00. Default 27.79. May be identical to start time. +.TP 8 +.B \-dilate \fInumber\fP +Scale time to speed or slow simulation. Numbers less than one slow it down. +.TP 8 +.B \-no-logo +Show only tunnels, no logos, etc. +.TP 8 +.B \-reverse +Play in reverse, including tunnels. +.TP 8 +.B \-no-fog +Turn off fog. +.TP 8 +.B \-no-texture +Turn off textures. +.TP 8 +.B \-wireframe +Show as wire frame. +.TP 8 +.B \-fps | \-no-fps +Whether to show a frames-per-second display at the bottom of the screen. +.TP 8 +.B \-tardis \fItexture\fP +Specify an xpm file to override default tardis texture. +.TP 8 +.B \-head \fItexture\fP +Specify an xpm file to override default Dr. Who head texture. +.TP 8 +.B \-marquee \fItexture\fP +Specify an xpm file to override default show marquee texture. +.TP 8 +.B \-tun1 \fItexture\fP +Specify an xpm file to override default tardis tunnel texture. +.TP 8 +.B \-tun2 \fItexture\fP +Specify an xpm file to override default middle tunnel texture. +.TP 8 +.B \-tun3 \fItexture\fP +Specify an xpm file to override default final tunnel texture. +.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 2005 by Sean Brennan. 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 +Sean Brennan diff --git a/hacks/glx/topblock.man b/hacks/glx/topblock.man new file mode 100644 index 00000000..bbe4965e --- /dev/null +++ b/hacks/glx/topblock.man @@ -0,0 +1,170 @@ +.TH XScreenSaver 1 "" "X Version 11" +.SH NAME +topblock - a 3D world of falling blocks that build up and up. +.SH SYNOPSIS +.B topblock +[\-display \fIhost:display.screen\fP] +[\-visual \fIvisual\fP] +[\-window] +[\-root] +[\-delay \fInumber\fP] +[\-wireframe] +[\-fps] +[\-size \fInumber\fP] +[\-spawn \fInumber\fP] +[\-camX \fInumber\fP] +[\-camY \fInumber\fP] +[\-camZ \fInumber\fP] +[\-rotate] +[\-no-carpet] +[\-no-nipples] +[\-blob] +[\-rotateSpeed \fInumber\fP] +[\-follow] +[\-maxFalling \fInumber\fP] +[\-resolution \fInumber\fP] +[\-maxColors \fInumber\fP] +[\-dropSpeed \fInumber\fP] +[\-override] +.SH DESCRIPTION +Creates a world of falling blocks that build up and up. +.SH OPTIONS +.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 \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-delay \fInumber\fP +Per-frame delay, in microseconds. Default: 10000 (0.01 seconds.). +.TP 8 +.B \-wireframe | \-no-wireframe +Render in wireframe instead of solid. +.TP 8 +.B \-fps +Display the current frame rate, CPU load, and polygon count. +.TP 8 +.B \-size \fInumber\fP +Size of the base/carpet. +.TP 8 +.B \-spawn \fInumber\fP +Likeyhood of a new block being created per frame : 1 high, 1000 very low. +.TP 8 +.B \-camX \fInumber\fP +Initial camera X location in the world. +.TP 8 +.B \-camY \fInumber\fP +Initial camera Y location in the world. +.TP 8 +.B \-camZ \fInumber\fP +Initial camera Z location in the world. +.TP 8 +.B \-rotate | -no-rotate +Add/Remove rotation to/from the animation. +.TP 8 +.B \-no-carpet +Remove the base/carpet. +.TP 8 +.B \-no-nipples +Remove nipples on the blocks (also applies to udders) (has no effect in blob mode). +.TP 8 +.B \-blob +Run in blob mode, blocks become over sized spheres. +.TP 8 +.B \-rotateSpeed \fInumber\fP +Varries speed of world rotation. +.TP 8 +.B \-follow +Camera follows blocks as they fall instead of camera being semi static (stays with top block). +.TP 8 +.B \-maxFalling \fInumber\fP +Maximum number of objects created before recycling occurs. +.TP 8 +.B \-resolution \fInumber\fP +Resolution of tubes, disks and spheres. +.TP 8 +.B \-maxColors \fInumber\fP +Number of different colors available to falling objects. +.TP 8 +.B \-dropSpeed \fInumber\fP +Varries speed of falling objects. +.TP 8 +.B \-override +Overrides camera settings and provides a tunnel view. + +.SH KEYS +.PP +.TP 8 +.B a +Increases viewing X coordinate. +.TP 8 +.B z +Decreases viewing X coordinate. +.TP 8 +.B s +Increases viewing Y coordinate. +.TP 8 +.B x +Decreases viewing Y coordinate. +.TP 8 +.B d +Increases viewing Z coordinate. +.TP 8 +.B c +Decreases viewing Z coordinate. +.TP 8 +.B f +Increases camera location X coordinate. +.TP 8 +.B v +Decreases camera location X coordinate. +.TP 8 +.B g +Increases camera location Y coordinate. +.TP 8 +.B b +Decreases camera location Y coordinate. +.TP 8 +.B h +Increases camera location Z coordinate. +.TP 8 +.B n +Decreases camera location Z coordinate. +.TP 8 +.B r +Increases world rotation. +.TP 8 +.B q +quit. +.SH EXAMPLES +To see which block follow-mode is tracking, set the number of block colors to 1. +.TP 8 +.B topblock -follow -maxColors 1 +.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 2006 by rednuht. 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 +rednuht + diff --git a/hacks/glx/tronbit.man b/hacks/glx/tronbit.man new file mode 100644 index 00000000..9001f0e3 --- /dev/null +++ b/hacks/glx/tronbit.man @@ -0,0 +1,79 @@ +.TH XScreenSaver 1 "" "X Version 11" +.SH NAME +tronbit - Yes. Yes. No. Yes. Yes. No. Yes. Yes yes yes yes yes. +.SH SYNOPSIS +.B tronbit +[\-display \fIhost:display.screen\fP] +[\-visual \fIvisual\fP] +[\-window] +[\-root] +[\-delay \fInumber\fP] +[\-speed \fIratio\fP] +[\-spin] +[\-wander] +[\-wireframe] +[\-fps] +.SH DESCRIPTION +Draws an animation of the character "Bit" from the film, \fITron\fP. + +The "yes" state is a tetrahedron; the "no" state is the second +stellation of an icosahedron; and the idle state oscillates between +a small triambic icosahedron and the compound of an icosahedron and +a dodecahedron. +.SH OPTIONS +.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 \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-delay \fInumber\fP +Per-frame delay, in microseconds. Default: 30000 (0.03 seconds.). +.TP 8 +.B \-speed \fInumber\fP +How fast the animation should run. +Less than 1 for slower, greater than 1 for faster. +.TP 8 +.B \-no\-spin +Don't rotate. +.TP 8 +.B \-no\-wander +Don't wander around. +.TP 8 +.B \-wireframe +Render in wireframe instead of solid. +.TP 8 +.B \-fps +Display the current frame rate, CPU load, and polygon count. +.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 polyhedra (1), +.BR dangerball (1), +.BR companioncube (1), +.BR xscreensaver (1), +.BR TRON. +.SH COPYRIGHT +Copyright \(co 2011 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, who fights for the users. diff --git a/hacks/glx/unknownpleasures.man b/hacks/glx/unknownpleasures.man new file mode 100644 index 00000000..422c81fd --- /dev/null +++ b/hacks/glx/unknownpleasures.man @@ -0,0 +1,74 @@ +.TH XScreenSaver 1 "" "X Version 11" +.SH NAME +unknownpleasures - an animation of the signal from the pulsar PSR B1919+21. +.SH SYNOPSIS +.B unknownpleasures +[\-display \fIhost:display.screen\fP] +[\-visual \fIvisual\fP] +[\-window] +[\-root] +[\-delay \fInumber\fP] +[\-speed \fIpercent\fP] +[\-count \fIinteger\fP] +[\-resolution \fIpercent\fP] +[\-no-ortho] +[\-fps] +.SH DESCRIPTION +PSR B1919+21 (AKA CP 1919) was the first pulsar ever discovered: a spinning +neutron star emitting a periodic lighthouse-like beacon. An illustration of +the signal received from it was published in Scientific American in 1971, +and later in The Cambridge Encyclopedia of Astronomy in 1977, where it was +seen by Stephen Morris, the drummer of Joy Division, and was consequently +appropriated by Peter Saville for the cover of the band's album "Unknown +Pleasures". +.SH OPTIONS +.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 \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-delay \fInumber\fP +Per-frame delay, in microseconds. Default: 30000 (0.03 seconds.). +.TP 8 +.B \-speed \fInumber\fP +Animation speed. 2 for twice as fast, 0.5 for half as fast. +.TP 8 +.B \-count \fInumber\fP +Scanlines (vertical resolution). Default: 80. +.TP 8 +.B \-count \fInumber\fP +Horizontal Resolution, Default: 100%. +.TP 8 +.B \-ortho | \-no-ortho +Whether to use an orthographic projection. +.TP 8 +.B \-fps | \-no-fps +Whether to show a frames-per-second display at the bottom of 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 SEE ALSO +.BR X (1), +.BR xscreensaver (1) +.SH COPYRIGHT +Copyright \(co 2013 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. diff --git a/hacks/glx/voronoi.man b/hacks/glx/voronoi.man new file mode 100644 index 00000000..713f08cf --- /dev/null +++ b/hacks/glx/voronoi.man @@ -0,0 +1,88 @@ +.TH XScreenSaver 1 "" "X Version 11" +.SH NAME +voronoi - draws a randomly-colored Voronoi tessellation +.SH SYNOPSIS +.B voronoi +[\-display \fIhost:display.screen\fP] +[\-visual \fIvisual\fP] +[\-window] +[\-root] +[\-points \fIint\fP] +[\-point\-size \fIint\fP] +[\-point\-speed \fIratio\fP] +[\-point\-delay \fIseconds\fP] +[\-zoom\-speed \fIratio\fP] +[\-zoom\-delay \fIseconds\fP] +[\-fps] +.SH DESCRIPTION +Draws a randomly-colored Voronoi tessellation, and periodically zooms +in and adds new points. The existing points also wander around. + +There are a set of control points on the plane, each at the center of +a colored cell. Every pixel within that cell is closer to that cell's +control point than to any other control point. That is what +determines the cell's shapes. + +When running in a window, you can click to insert a new point at +the mouse position. Clicking on an existing point lets you drag +it around. + +This implementation takes advantage of the OpenGL depth buffer to +compute the cells for us, by rendering the intersection of overlapping +cones in an orthographic plane. +.SH OPTIONS +.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 \-window +Draw on a newly-created window. This is the default. +.TP 8 +.B \-root +Draw on the root window. +.TP 8 +.B \-points \fIint\fP +How many points to add each time we zoom in. +.TP 8 +.B \-point\-size \fIint\fP +How big to draw the stars, in pixels. 0 for no stars. +.TP 8 +.B \-point\-speed \fIratio\fP +How fast the points should wander. +Less than 1 for slower, greater than 1 for faster. +.TP 8 +.B \-point\-delay \fIseconds\fP +How quickly to insert new points, when adding. +.TP 8 +.B \-zoom\-speed \fIratio\fP +How fast to zoom in. +Less than 1 for slower, greater than 1 for faster. +.TP 8 +.B \-zoom\-delay \fIseconds\fP +Zoom in every this-many seconds. +.TP 8 +.B \-fps +Display the current frame rate, CPU load, and polygon count. +.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 2007 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. diff --git a/hacks/glx/xscreensaver-gl-helper.man b/hacks/glx/xscreensaver-gl-helper.man new file mode 100644 index 00000000..7c40eb37 --- /dev/null +++ b/hacks/glx/xscreensaver-gl-helper.man @@ -0,0 +1,33 @@ +.TH XScreenSaver 1 "5-Nov-00" "X Version 11" +.SH NAME +xscreensaver-gl-helper - figure out which X visual to use for GL programs +.SH SYNOPSIS +.B xscreensaver-gl-helper +[\-display \fIhost:display.screen\fP] +.SH DESCRIPTION +This program prints the ID of the visual that should be used for proper +operation of OpenGL programs. This program only exists so that the +.BR xscreensaver (1) +daemon does not need to link against the OpenGL library. +.SH ENVIRONMENT +.PP +.TP 8 +.B DISPLAY +to get the default host, display, and screen number. +.SH SEE ALSO +.BR X (1), +.BR xdpyinfo (1), +.BR xglinfo (1), +.BR glxinfo (1), +.BR glxdpyinfo (1), +.BR xscreensaver (1), +.BR xscreensaver\-demo (1), +.BR xscreensaver\-command (1) +.SH COPYRIGHT +Copyright \(co 2000 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. diff --git a/po/POTFILES.in b/po/POTFILES.in index 4cfb550c..97606c7f 100644 --- a/po/POTFILES.in +++ b/po/POTFILES.in @@ -1,4 +1,4 @@ -# Auto-generated: Sat Dec 7 19:10:53 PST 2013 +# Auto-generated: Mon Dec 9 00:26:15 PST 2013 driver/demo-Gtk-conf.c driver/demo-Gtk-support.c driver/demo-Gtk-widgets.c diff --git a/utils/grabclient.c b/utils/grabclient.c index 082f1f16..fc4b1197 100644 --- a/utils/grabclient.c +++ b/utils/grabclient.c @@ -629,7 +629,7 @@ pipe_cb (XtPointer closure, int *source, XtInputId *id) /* Replace slashes with newlines */ /* while (dot = strchr(buf, '/')) *dot = '\n'; */ /* Replace slashes with spaces */ - while ((dot = strchr(buf, '/'))) *dot = ' '; + /* while ((dot = strchr(buf, '/'))) *dot = ' '; */ } if (absfile) free (absfile); diff --git a/utils/version.h b/utils/version.h index ddcd9c2e..bfd97799 100644 --- a/utils/version.h +++ b/utils/version.h @@ -1,2 +1,2 @@ static const char screensaver_id[] = - "@(#)xscreensaver 5.24 (07-Dec-2013), by Jamie Zawinski (jwz@jwz.org)"; + "@(#)xscreensaver 5.25 (09-Dec-2013), by Jamie Zawinski (jwz@jwz.org)"; diff --git a/xscreensaver.spec b/xscreensaver.spec index 771b0812..a0f8ceae 100644 --- a/xscreensaver.spec +++ b/xscreensaver.spec @@ -1,5 +1,5 @@ %define name xscreensaver -%define version 5.24 +%define version 5.25 Summary: X screen saver and locker Name: %{name} -- 2.30.2