gflux

title: gflux(6)

summary: rippling surface graphics hack

text:
# gflux(6)

## NAME
gflux - rippling surface graphics hack

## SYNOPSIS
gflux [-display host:display.screen] [-window] [-root] [-install] [-visual visual] [-delay microseconds] [-squares num] [-resolution num] [-mode mode] [-flat num] [-speed num] [-rotationx num] [-rotationy num] [-rotationz num] [-waves num] [-waveChange num] [-waveHeight num] [-waveFreq num] [-zoom num] [-wireframe] [-fps]

## DESCRIPTION
The gflux program draws a colourfull animated rippling square rotating in 3D space.

## OPTIONS
gflux accepts the following options:

-window

Draw on a newly-created window. This is the default.

-root

Draw on the root window.

-install

Install a private colormap for the window.

-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.

-squares num

Specifies the size of the grid in squares. default 19

-resolution num

Specifies the wireframe detail of the squares. default 4

-mode mode

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 grabDesktopImages, grabVideoFrames, and chooseRandomImages options in the ~/.xscreensaver file; see xscreensaver-demo(1) for more details.

-wireframe

Same as "-mode wire".

-flat num

0 for smooth shading 1 for flat. default 0

-speed num

Specifies speed of ripples flowing over the surface. default 0.05

-rotationx num -rotationy num -rotationz num

Specifies the speed of rotation of the surface in these axis

-waves num

Specifies the number of ripple centres at any one time. Values should be greater than 1. default 3

-waveChange num

Specifies the duration of a ripple centre. after this they fade away to be reborn elsewhere with a different frequency. default 50

-waveHeight num

Specifies the height of ripples on the surface. default 1.0

-waveFreq num

Specifies the maximum frequency of ripples. default 3.0

-zoom num

Specifies the size of the viewport. Smaller values fill the screen with rippling surface. default 1.0

-delay microseconds

How long to pause between frames. Default is 20000, or 0.02 second.

-fps

Display the current frame rate, CPU load, and polygon count.

## ENVIRONMENT
DISPLAY

to get the default host and display number.

XENVIRONMENT

to get the name of a resource file that overrides the global resources stored in the RESOURCE_MANAGER property.

## SEE ALSO
X(1), xscreensaver(1) xscreensaver-demo(1), xscreensaver-getimage(1)

## COPYRIGHT
Copyright © 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.

## AUTHOR
Josiah Pease <gflux@jpease.force9.co.uk>, 10-Jun-2000.


gibson

package: xscreensaver-modules-gl

title: gibson(6)

summary: Hacking the Gibson screen saver.

text:
# gibson(6)

## NAME
gibson - Hacking the Gibson screen saver.

## SYNOPSIS
gibson [-display host:display.screen] [-visual visual] [-window] [-root] [-delay number] [-speed number] [-grid-width number] [-grid-depth number] [-grid-height number] [-grid-spacing number] [-columns number] [-no-texture] [-wireframe] [-fps]

## DESCRIPTION
Hacking the Gibson, as per the 1995 classic film, HACKERS.

"Hackers penetrate and ravage delicate public and privately owned computer systems, infecting them with viruses, and stealing materials for their own ends. These people, they are terrorists."

## OPTIONS
-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.

-window

Draw on a newly-created window. This is the default.

-root

Draw on the root window.

-delay number

Per-frame delay, in microseconds. Default: 20000 (0.02 seconds).

-speed number

Animation speed. 2.0 means twice as fast, 0.5 means half as fast.

-grid-width number

Number of towers across. 1 - 20. Default: 10.

-grid-depth number

Number of towers deep. 1 - 20. Default: 10.

-grid-height number

Height of the towers. 1 - 20. Default: 7.

-grid-spacing number

Space between towers. 1 - 5. Default: 2.0.

-columns number

Columns of text on the towers. 1 - 20. Default: 6.

-texture | -no-texture

Whether to draw text. Default true.

-wireframe | -no-wireframe

Render in wireframe instead of solid.

-fps | -no-fps

Whether to show a frames-per-second display at the bottom of the screen.

## ENVIRONMENT
DISPLAY

to get the default host and display number.

XENVIRONMENT

to get the name of a resource file that overrides the global resources stored in the RESOURCE_MANAGER property.

## SEE ALSO
X(1), xscreensaver(1)

## COPYRIGHT
Copyright © 2020 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.

## AUTHOR
Jamie Zawinski.


glblur

title: glblur(6)

summary: 3D radial blur texture fields

text:
# glblur(6)

## NAME
glblur - 3D radial blur texture fields

## SYNOPSIS
glblur [-display host:display.screen] [-visual visual] [-window] [-root] [-delay number] [-blursize number] [-no-wander] [-no-spin] [-spin [XYZ]] [-fps]

## 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.

## OPTIONS
-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.

-window

Draw on a newly-created window. This is the default.

-root

Draw on the root window.

-delay number

Per-frame delay, in microseconds. Default: 10000 (0.01 seconds.).

-blursize number

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.

-wander | -no-wander

Whether the object should wander around the screen.

-spin [XYZ]

Around which axes should the object spin?

-no-spin

None.

-fps

Display the current frame rate, CPU load, and polygon count.

## ENVIRONMENT
DISPLAY

to get the default host and display number.

XENVIRONMENT

to get the name of a resource file that overrides the global resources stored in the RESOURCE_MANAGER property.

## SEE ALSO
X(1), xscreensaver(1)

## COPYRIGHT
Copyright © 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.

## AUTHOR
Jamie Zawinski, with inspiration from a tutorial by Dario Corno.


glcells

title: glcells(6)

summary: growing cells graphics hack

text:
# glcells(6)

## NAME
glcells - growing cells graphics hack

## SYNOPSIS
glcells [-display host:display.screen] [-window] [-root] [-install] [-visual visual] [-delay num] [-pause num] [-maxcells num] [-radius num] [-seeds num] [-quality num] [-minfood num] [-maxfood num] [-divideage num] [-mindist num] [-keepold] [-wireframe] [-fps]

## DESCRIPTION
The glcells program draws cells that divide exponentially, eat and eventually die.

## OPTIONS
glcells accepts the following options:

-window

Draw on a newly-created window. This is the default.

-root

Draw on the root window.

-install

Install a private colormap for the window.

-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.

-pause num

Specifies the pause at the end of the animation (all cells dead or maximum amount of cells reached). Unit is in frames, default 20.

-maxcells num

Specifies the maximum number of cells on screen (dead cells also count, even if invisible). Default is 800.

-radius num

Specifies the radius of the cells. Default is 40.

-seeds num

Specifies the number of cells when animation starts. Default is 1.

-quality num

Specifies subdivision quality of the spheres used to draw the cells [0...5]. Default is 3.

-minfood num

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.

-maxfood num

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.

-divideage num

Specifies the minimum age in frames a cell needs to have before being able to divide. Default is 20

-mindist num

Specifies the minimum distance between cells. Default 1.4

-delay num

How long to pause between frames. Default is 20000, or 0.02 second.

-fps

Display the current frame rate, CPU load, and polygon count.

-wireframe

Draw wireframe only.

-keepold

Dead cells stay on screen.

## ENVIRONMENT
DISPLAY

to get the default host and display number.

XENVIRONMENT

to get the name of a resource file that overrides the global resources stored in the RESOURCE_MANAGER property.

## SEE ALSO
X(1), xscreensaver(1) xscreensaver-demo(1),

## COPYRIGHT
Copyright © 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.

## AUTHOR
Matthias Toussaint <glcells@mtoussaint.de>, 17-Jun-2007, http://www.mtoussaint.de/bits.html.


gleidescope

title: gleidescope(6)

summary: a tiled OpenGL kaleidescope

text:
# gleidescope(6)

## NAME
gleidescope - a tiled OpenGL kaleidescope

## SYNOPSIS
gleidescope [-display host:display.screen] [-visual visual] [-window] [-root] [-delay number] [-move] [-rotate] [-zoom] [-image file] [-fps] [-size number] [-duration number]

## DESCRIPTION
A tiled kaleidescope using OpenGL.

## OPTIONS
-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.

-window

Draw on a newly-created window. This is the default.

-root

Draw on the root window.

-delay number

Per-frame delay, in microseconds. Default: 20000 (0.02 seconds.).

-move

Move the camera.

-rotate

Rotate the camera.

-zoom

Zoom the camera in and out.

-image file

The texture map to use at the end of the kaleidescope.

-fps

Display the current frame rate, CPU load, and polygon count.

-size number

The size of the hexagons being displayed [1(small)-10(large)]

-duration number

The time in seconds before another image is chosen.

## ENVIRONMENT
DISPLAY

to get the default host and display number.

XENVIRONMENT

to get the name of a resource file that overrides the global resources stored in the RESOURCE_MANAGER property.

## SEE ALSO
X(1), xscreensaver(1)

## COPYRIGHT
Copyright © 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.

## AUTHOR
Andrew Dean.


glhanoi

title: glhanoi(6)

summary: OpenGL Towers of Hanoi

text:
# glhanoi(6)

## NAME
glhanoi - OpenGL Towers of Hanoi

## SYNOPSIS
glhanoi [-display host:display.screen] [-visual visual] [-window] [-root] [-delay number] [-count number] [-poles number] [-speed number] [-wireframe] [-light] [-texture] [-fog] [-fps]

## DESCRIPTION
Implementation of Towers of Hanoi in OpenGL

## OPTIONS
-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.

-window

Draw on a newly-created window. This is the default.

-root

Draw on the root window.

-delay number

Per-frame delay, in microseconds. Default: 30000 (0.03 seconds.).

-count number

Number of disks. Default: 7.

-poles number

Number of poles. Default: random from 3 to disks+1.

-speed number

Speed multiplier (for smallest disks). Default: 1.

-trails number

Length of disk trails, in seconds. Default: 2.

-wireframe | -no-wireframe

Render in wireframe instead of solid.

-fog | -no-fog

Render in fog.

-fps

Display the current frame rate, CPU load, and polygon count.

-light | -no-light

Whether the scene is lit.

-texture | -no-texture

Render with textures instead of solid.

## ENVIRONMENT
DISPLAY

to get the default host and display number.

XENVIRONMENT

to get the name of a resource file that overrides the global resources stored in the RESOURCE_MANAGER property.

## SEE ALSO
X(1), xscreensaver(1)

## COPYRIGHT
Copyright © 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.

## AUTHOR
Dave Atkinson.


glknots

title: glknots(6)

text:
# glknots(6)

## NAME
glknots - generates some twisting 3d knot patterns

## SYNOPSIS
glknots [-display host:display.screen] [-visual visual] [-window] [-root] [-delay number] [-speed float] [-segments int] [-thickness float] [-duration seconds] [-no-wander] [-spin XYZ] [-wireframe] [-fps]

## DESCRIPTION
Generates some twisting 3d knot patterns. Spins 'em around.

## OPTIONS
-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.

-window

Draw on a newly-created window. This is the default.

-root

Draw on the root window.

-delay number

Per-frame delay, in microseconds. Default: 30000 (0.03 seconds.).

-speed number

Larger numbers mean run faster. Default: 1.0.

-segments number

Number of segments in each path. Default 800. Larger numbers make the curves smoother, at the expense of a higher polygon count.

-thickness float

How thick the tubes should be. Default 0.3.

-duration seconds

How long to leave each knot up. Default 8 seconds.

-wander | -no-wander

Whether the cubes should wander around the screen.

-spin [XYZ] | -no-spin

Which axes, if any, to spin around on.

-wireframe | -no-wireframe

Render in wireframe instead of solid.

-fps

Display the current frame rate, CPU load, and polygon count.

## ENVIRONMENT
DISPLAY

to get the default host and display number.

XENVIRONMENT

to get the name of a resource file that overrides the global resources stored in the RESOURCE_MANAGER property.

## SEE ALSO
X(1), xscreensaver(1)

## COPYRIGHT
Copyright © 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.

## AUTHOR
Jamie Zawinski.


glmatrix

title: glmatrix(6)

text:
# glmatrix(6)

## NAME
glmatrix - simulates the title sequence effect of the movie

## SYNOPSIS
glmatrix [-display host:display.screen] [-window] [-root] [-install] [-visual visual] [-delay usecs] [-speed ratio] [-density pct] [-no-fog] [-no-waves] [-no-rotate] [-binary] [-hexadecimal] [-dna] [-clock] [-timefmt fmt] [-wireframe] [-fps]

## DESCRIPTION
The glmatrix program draws the 3D "digital rain" effect, as seen in the title sequence of the Wachowski brothers' film, "The Matrix".

Also see xmatrix(6) for a 2D rendering of the similar effect that appeared on the computer monitors actually in the movie.

## OPTIONS
glmatrix accepts the following options:

-window

Draw on a newly-created window. This is the default.

-root

Draw on the root window.

-install

Install a private colormap for the window.

-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.

-delay usecs

The delay between frames of the animation, in microseconds: default 30000.

-speed ratio

How fast the glyphs should move; default 1.0. 2.0 means twice as fast, 0.5 means half as fast.

-density percentage

The approximate percentage of the screen that should be filled with characters at any given time. Default 20%.

-no-fog

By default, glyphs are dimmer the farther away they are. This argument disables that.

-no-waves

By default, waves of color roll down the columns of glyphs. This argument disables that.

-no-rotate

By default, the scene slowly tilts and rotates. This argument disables that.

-binary

Instead of displaying Matrix glyphs, only display ones and zeros.

-hexadecimal

Instead of displaying Matrix glyphs, display hexadecimal digits.

-dna

Instead of displaying Matrix glyphs, display genetic code (guanine, adenine, thymine, and cytosine.)

-clock

Hide a clock displaying the current time somewhere in the glyphs.

-timefmt strftime-string

How to format the clock when -clock is specified. Default " %l%M%p ".

-speed ratio

Less than 1 for slower, greater than 1 for faster. Default 1.

-wireframe

Just draw boxes instead of textured characters.

-fps

Display the current frame rate, CPU load, and polygon count.

## ENVIRONMENT
DISPLAY

to get the default host and display number.

XENVIRONMENT

to get the name of a resource file that overrides the global resources stored in the RESOURCE_MANAGER property.

## SEE ALSO
xmatrix(6), X(1), xscreensaver(1)

## COPYRIGHT
Copyright © 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.

## AUTHOR
Jamie Zawinski <jwz@jwz.org>, 8-Jun-2003.


glplanet

title: glplanet(6)

summary: rotating 3d texture-mapped planet.

text:
# glplanet(6)

## NAME
glplanet - rotating 3d texture-mapped planet.

## SYNOPSIS
glplanet [-display host:display.screen] [-visual visual] [-window] [-root] [-delay number] [-image file] [-image2 file] [-mode string] [-resolution number] [-wireframe] [-fps]

## DESCRIPTION
Draws a planet bouncing around in space. The built-in images are day and night maps of the Earth, but you can wrap any Equirectangular-projected map onto the sphere, e.g., the planetary textures included with ssystem.

## OPTIONS
-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.

-window

Draw on a newly-created window. This is the default.

-root

Draw on the root window.

-delay number

Per-frame delay, in microseconds. Default: 20000 (0.02 seconds.).

-image file

The day texture map to wrap around the planet's surface.

-image2 file

The night texture map to wrap around the planet's surface. The two will be blended together at the dusk terminator.

-mode globe

All is right with the world.

-mode equirectangular

Wat.

-mode mercator

Good day, Sir. I said GOOD DAY.

-resolution

The resolution of the planetary mesh. Default: 128.

-wireframe

Render in wireframe instead of solid.

-fps

Display the current frame rate, CPU load, and polygon count.

## ENVIRONMENT
DISPLAY

to get the default host and display number.

XENVIRONMENT

to get the name of a resource file that overrides the global resources stored in the RESOURCE_MANAGER property.

## SEE ALSO
X(1), xscreensaver(1) dymaxionmap(1) ssystem(1)

## COPYRIGHT
Copyright © 2002-2018 by David Konerding 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.

## AUTHOR
David Konerding and Jamie Zawinski.


glschool

title: glschool(6)

summary: a 3D schooling simulation

text:
# glschool(6)

## NAME
glschool - a 3D schooling simulation

## SYNOPSIS
glschool [-display host:display.screen] [-visual visual] [-window] [-root] [-wireframe] [-fps] [-delay number] [-nfish number] [-maxvel number] [-minvel number] [-acclimit number] [-avoidfact number] [-matchfact number] [-centerfact number] [-targetfact number] [-minradius number] [-momentum number] [-distexp number] [-goalchgf number] [-fog] [-drawgoal] [-drawbbox]

## DESCRIPTION
Uses Craig Reynolds Boids algorithm to simulate a 3d school of fish. See <http://www.red3d.com/cwr/boids> 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.

## OPTIONS
-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.

-window

Draw on a newly-created window. This is the default.

-root

Draw on the root window.

-delay number

Per-frame delay, in microseconds. Default: 20000 (0.020 seconds.).

-wireframe | -no-wireframe

Render in wireframe instead of solid.

-fps

Display the current frame rate, CPU load, and polygon count.

-fog | -no-fog

Whether to show foggy (cloudy) water.

-drawgoal | -no-drawgoal

Whether to show the school's attraction goal.

-drawbbox | -no-drawbbox

Whether to show the bounding box.

-fog | -no-fog

Whether to show foggy (cloudy) water.

-nfish number

Number of fish. Defaults to 100

-acclimit number

Acceleration limit. Defaults to 8.0

-minvel number

Minimum velocity. Defaults to 1.0

-maxvel number

Minimum velocity. Defaults to 7.0

-goalchgf number

Goal change frequency. Defaults to 50 (frames)

-avoidfact number

Avoidance acceleration factor. Defaults to 1.5

-matchfact number

Match avg velocity acceleration factor. Defaults to 0.15

-centerfact number

School centering acceleration factor. Defaults to 0.1

-targetfact number

Target attraction acceleration factor. Defaults to 80

-distexp number

Distance weighting exponent. Defaults to 2.2

-momentum number

Momentum. Defaults to 0.9

## ENVIRONMENT
DISPLAY

to get the default host and display number.

XENVIRONMENT

to get the name of a resource file that overrides the global resources stored in the RESOURCE_MANAGER property.

## SEE ALSO
X(1), xscreensaver(1)

## COPYRIGHT
Copyright © 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.

## AUTHOR
David C. Lambert


glslideshow

title: glslideshow(6)

text:
# glslideshow(6)

## NAME
glslideshow - slideshow of images using smooth zooming and fades

## SYNOPSIS
glslideshow [-display host:display.screen] [-visual visual] [-window] [-root] [-duration seconds] [-zoom percent] [-pan seconds] [-fade seconds] [-titles] [-letterbox | -clip] [-delay usecs] [-fps] [-debug] [-wireframe] [-cutoff int]

## 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 xscreensaver-demo(1) and click on the "Advanced" tab.

## OPTIONS
-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.

-window

Draw on a newly-created window. This is the default.

-root

Draw on the root window.

-duration seconds

How long each image will be displayed before loading a new one. Default 30 seconds.

-pan seconds

How long each pan-and-zoom should last. Default 6 seconds. With the default settings of -pan 6 -duration 30, 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 -pan and -duration to the same value.

-fade seconds

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 -fade cannot be larger than -pan.

-zoom number

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 -fade is non-zero.)

-titles

Whether to print the file name of the current image in the upper left corner.

-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.

-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 -letterbox.

-delay number

Per-frame delay, in microseconds. Default: 20000 (0.02 seconds.).

-fps

Display the current frame rate, CPU load, and polygon count.

-cutoff number

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.

-debug

Prints debugging info to stderr.

-wireframe

Another debug mode.

## ENVIRONMENT
DISPLAY

to get the default host and display number.

XENVIRONMENT

to get the name of a resource file that overrides the global resources stored in the RESOURCE_MANAGER property.

## SEE ALSO
X(1), xscreensaver-demo(1), xscreensaver-getimage(1), xscreensaver(1), carousel(6) photopile(6)

## COPYRIGHT
Copyright © 2003-2005 by Jamie Zawinski, based on an earlier version that was Copyright © 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.

## AUTHOR
Jamie Zawinski and Mike Oliphant.


glsnake

title: glsnake(6)

text:
# glsnake(6)

## NAME
glsnake - OpenGL enhanced Rubik's Snake cyclewaster.

## SYNOPSIS
glsnake [-display host:display.screen] [-window] [-root] [-visual visual] [-delay microseconds] [-fps] [-wireframe] [-altcolour] [-angvel angular] [-explode distance] [-statictime milliseconds] [-yangvel angle] [-zangvel angle]

## DESCRIPTION
glsnake is an imitation of Rubiks´ Snake, using OpenGL.

## OPTIONS
glsnake accepts the following options:

-window

Draw on a newly-created window. This is the default.

-root

Draw on the root window.

-install

Install a private colormap for the window.

-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.

-fps

Display the current frame rate, CPU load, and polygon count.

-wireframe

Display the snake in wireframe mode, rather than the default solid mode.

-altcolour

Use the alternate colour scheme for the snake. Shape identification using colour will be disabled.

-angvel angular

Change the speed at which the snake morphs to a new shape.

-explode distance

Change the distance between the nodes of a snake.

-statictime milliseconds

Change the time between morphs.

-yangvel angle

Change the angle of rotation around the Y axis per frame.

-zangvel angle

Change the angle of rotation around the Z axis per frame.

## ENVIRONMENT
DISPLAY

to get the default host and display number.

XENVIRONMENT

to get the name of a resource file that overrides the global resources stored in the RESOURCE_MANAGER property.

## FILES
/usr/share/glsnake/*.glsnake

This XScreenSaver will attempt to read model files installed with the interactive glsnake.

## SEE ALSO
X(1), xscreensaver(1), glsnake(6)

```
http://spacepants.org/src/glsnake/
```

## BUGS
The snake will happily intersect itself while morphing (this is not a bug).

The rotation/camera position sucks.

## COPYRIGHT
Copyright © 2001,2002 by Jamie Wilkinson, Andrew Bennetts, and Peter Aylett.

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.

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.

## AUTHOR
Jamie Wilkinson <jaq@spacepants.org>, Andrew Bennetts <andrew@puzzling.org>, and Peter Aylett <peter@ylett.com>. Ported to XScreenSaver by Jamie Wilkinson.


gltext

title: gltext(6)

summary: draws text spinning around in 3D

text:
# gltext(6)

## NAME
gltext - draws text spinning around in 3D

## SYNOPSIS
gltext [-display host:display.screen] [-window] [-root] [-visual visual] [-delay microseconds] [-text string] [-program command] [-wander] [-no-wander] [-spin axes] [-no-spin] [-front] [-no-front] [-wireframe] [-fps]

## DESCRIPTION
The gltext program draws some text spinning around in 3D, using a font that appears to be made of solid tubes.

## OPTIONS
gltext accepts the following options:

-window

Draw on a newly-created window. This is the default.

-root

Draw on the root window.

-install

Install a private colormap for the window.

-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.

-text string

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 date(1) and 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:

```
gltext -text "%A%n%d %b %Y%n%l:%M:%S %p"

```

To include a literal `%', you must double it: `%%'. See the man page for strftime(3) for more details.

-program command

The given program is run, and its output is displayed. If specified, this overrides -text. The output of this program will be repeatedely displayed, with new pages of text shifting in every few seconds. Lines should be relatively short. You might try:

```
-program 'xscreensaver-text --cols 20'

```

-maxlines

Set the number of lines of text to display. By default, gltext will print 8 lines of text at a time. Use this option to increase or decrease that number. Be aware that gltext is designed to work with a fairly small amount of text, so setting this value too high might result in slow performance or strange behaviour stemming from buffer overflows. Increase at your own risk.

-mono

Display the text in a monospace font. Default is a variable-width font.

-no-mono

Display the text in a variable-width font. This is the default.

-wander

Move the text around the screen. This is the default.

-no-wander

Keep the text centered on the screen.

-wander-speed

Sets the speed at which the text wanders around. Default is 0.02.

-spin

Which axes around which the text should spin. The default is "XYZ", meaning rotate it freely in space. "-spin Z" would rotate the text in the plane of the screen while not rotating it into or out of the screen; etc.

-no-spin

Don't spin the text at all: the same as -spin "".

-front

When spinning, never spin all the way around or upside down: always face mostly forward so that the text is easily readable.

-no-front

Allow spins to go all the way around or upside down. This is the default.

-wireframe

Render in wireframe instead of solid.

-fps

Display the current frame rate, CPU load, and polygon count.

-scale

Sets the scale at which the text is rendered. Bigger values will result in bigger text; smaller values will result in smaller text. The default value is 0.01.

## ENVIRONMENT
DISPLAY

to get the default host and display number.

XENVIRONMENT

to get the name of a resource file that overrides the global resources stored in the RESOURCE_MANAGER property.

## SEE ALSO
X(1), xscreensaver(1) xscreensaver-text(1)

## COPYRIGHT
Copyright © 2001-2014 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.

## AUTHOR
Jamie Zawinski <jwz@jwz.org>


gravitywell

title: gravitywell(6)

summary: spaaaaace.

text:
# gravitywell(6)

## NAME
gravitywell - spaaaaace.

## SYNOPSIS
gravitywell [-display host:display.screen] [-visual visual] [-window] [-root] [-delay number] [-speed number] [-resolution number] [-grid-size number] [-count number]

## DESCRIPTION
Massive objects distort space in a two dimensional universe.

## OPTIONS
-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.

-window

Draw on a newly-created window. This is the default.

-root

Draw on the root window.

-delay number

Per-frame delay, in microseconds. Default: 30000 (0.03 seconds).

-speed number

Animation speed. 2.0 means twice as fast, 0.5 means half as fast.

-resolution number

Density of the underlying universe. Default: 1.0.

-grid-size number

Grid Size. Smaller values are more dense. Default: 1.0.

-count number

Number of stars. Default: 15.

## ENVIRONMENT
DISPLAY

to get the default host and display number.

XENVIRONMENT

to get the name of a resource file that overrides the global resources stored in the RESOURCE_MANAGER property.

## SEE ALSO
X(1), xscreensaver(1)

## COPYRIGHT
Copyright © 2019 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.

## AUTHOR
Jamie Zawinski.


headroom

title: headroom(6)

summary: a twitchy head.

text:
# headroom(6)

## NAME
headroom - a twitchy head.

## SYNOPSIS
headroom [-display host:display.screen] [-visual visual] [-window] [-root] [-delay number] [-speed number] [-spin [XYZ]] [-no-wander] [-wireframe] [-fps]

## DESCRIPTION
"Back in my day, we used to say 'No future'. Well. This is it." -- Blank Reg

## OPTIONS
-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.

-window

Draw on a newly-created window. This is the default.

-root

Draw on the root window.

-delay number

Per-frame delay, in microseconds. Default: 20000 (0.02 seconds).

-speed number

Animation speed. 2.0 means twice as fast, 0.5 means half as fast.

-spin 0

Don't rotate.

-spin [XYZ]

Around which axes should the object spin?

-wander | -no-wander

Whether the object should wander around the screen.

-wireframe | -no-wireframe

Render in wireframe instead of solid.

-fps | -no-fps

Whether to show a frames-per-second display at the bottom of the screen.

## ENVIRONMENT
DISPLAY

to get the default host and display number.

XENVIRONMENT

to get the name of a resource file that overrides the global resources stored in the RESOURCE_MANAGER property.

## SEE ALSO
X(1), xscreensaver(1)

## COPYRIGHT
Copyright © 2020 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.

## AUTHOR
Jamie Zawinski.


hexstrut

title: hexstrut(6)

text:
# hexstrut(6)

## NAME
hexstrut - a grid of hexagons composed of rotating Y-shaped struts.

## SYNOPSIS
hexstrut [-display host:display.screen] [-visual visual] [-window] [-root] [-delay number] [-speed number] [-count number] [-thickness number] [-no-wander] [-no-spin] [-wireframe] [-fps]

## DESCRIPTION
A grid of hexagons composed of rotating Y-shaped struts. Waves of rotation and color changes randomly propagate across the plane.

## OPTIONS
-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.

-window

Draw on a newly-created window. This is the default.

-root

Draw on the root window.

-delay number

Per-frame delay, in microseconds. Default: 30000 (0.03 seconds).

-speed number

Animation speed. 2.0 means twice as fast, 0.5 means half as fast.

-count number

Approximate number of hexagons on the screen, horizontally. Default: 20.

-thickness number

Relative thickness of the struts. 0.01 - 1.7. Default: 0.2.

-wander | -no-wander

Whether the grid should wander around the screen.

-spin | -no-spin

Whether the grid should spin.

-wireframe | -no-wireframe

Render in wireframe instead of solid.

-fps | -no-fps

Whether to show a frames-per-second display at the bottom of the screen.

## ENVIRONMENT
DISPLAY

to get the default host and display number.

XENVIRONMENT

to get the name of a resource file that overrides the global resources stored in the RESOURCE_MANAGER property.

## SEE ALSO
X(1), xscreensaver(1)

## COPYRIGHT
Copyright © 2016 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.

## AUTHOR
Jamie Zawinski.


hilbert

title: hilbert(6)

summary: 3D Hilbert fractal.

text:
# hilbert(6)

## NAME
hilbert - 3D Hilbert fractal.

## SYNOPSIS
hilbert [-display host:display.screen] [-visual visual] [-window] [-root] [-delay number] [-speed ratio] [-depth number] [-spin] [-wander] [-2d] [-3d] [-closed] [-open] [-max-depth number] [-thickness ratio] [-wireframe] [-fps]

## 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.

## OPTIONS
-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.

-window

Draw on a newly-created window. This is the default.

-root

Draw on the root window.

-delay number

Per-frame delay, in microseconds. Default: 30000 (0.03 seconds.).

-speed number

How fast the animation should run. Less than 1 for slower, greater than 1 for faster.

-max-depth number

Max depth to descend. Default: 5, which peaks at around half a million polygons.

-spin

-no-spin Whether to rotate the object. Default: true.

-wander

-no-wander Whether to wander the object around on the screen. Default: false;

-2d

-3d Whether to draw the 2D or 3D variant. Default: random.

-closed

-open Whether to draw the open or closed-path variant. Default: random.

-thickness ratio

How thick the lines should be. Default: 0.25.

-wireframe

Render in wireframe instead of solid.

-fps

Display the current frame rate, CPU load, and polygon count.

## ENVIRONMENT
DISPLAY

to get the default host and display number.

XENVIRONMENT

to get the name of a resource file that overrides the global resources stored in the RESOURCE_MANAGER property.

## SEE ALSO
X(1), xscreensaver(1)

## COPYRIGHT
Copyright © 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.

## AUTHOR
Jamie Zawinski.


hypertorus

title: hypertorus(6)

summary: Draws a hypertorus that rotates in 4d

text:
# hypertorus(6)

## NAME
hypertorus - Draws a hypertorus that rotates in 4d

## SYNOPSIS
hypertorus [-display host:display.screen] [-install] [-visual visual] [-window] [-root] [-delay usecs] [-fps] [-wireframe] [-surface] [-transparent] [-solid] [-bands] [-spirals-{1,2,4,8,16}] [-onesided] [-twosided] [-colorwheel] [-change-colors] [-perspective-3d] [-orthographic-3d] [-perspective-4d] [-orthographic-4d] [-speed-wx float] [-speed-wy float] [-speed-wz float] [-speed-xy float] [-speed-xz float] [-speed-yz float]

## DESCRIPTION
The hypertorus 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 one-sided, two-sided, or to a color wheel. The colors can be static or changing dynamically. In one-sided color mode, the torus is drawn with the same color on the inside and the outside. In two-sided color mode, the torus is drawn with red on the outside and green on the inside if static colors are used. If changing colors are used, dynamically varying complementary colors are used for the two sides. This mode enables you to see that the 3d projection of the torus turns inside-out as it rotates in 4d. The color wheel mode draws the torus with a fully saturated color wheel. If changing colors are used, the colors of the color wheel are varying dynamically. The color wheel mode gives a very nice effect when combined with the see-through bands or see-through spirals mode.

Finally, the rotation speed for each of the six planes around which the torus rotates can be chosen.

This program is inspired by Thomas Banchoff's book "Beyond the Third Dimension: Geometry, Computer Graphics, and Higher Dimensions", Scientific American Library, 1990.

## OPTIONS
hypertorus accepts the following options:

-window

Draw on a newly-created window. This is the default.

-root

Draw on the root window.

-install

Install a private colormap for the window.

-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.

-delay microseconds

How much of a delay should be introduced between steps of the animation. Default 25000, or 1/40th second.

The following three options are mutually exclusive. They determine how the torus is displayed.

-wireframe

Display the torus as a wireframe mesh.

-surface

Display the torus as a solid surface (default).

-transparent

Display the torus as a transparent surface.

The following seven options are mutually exclusive. They determine the appearance of the torus.

-solid

Display the torus as a solid object.

-bands

Display the torus as see-through bands (default).

-spirals-1, -spirals-2, -spirals-4, -spirals-8, -spirals-16

Display the torus as see-through spirals with the indicated number of spirals.

The following three options are mutually exclusive. They determine how to color the torus.

-onesided

Display the torus with a single color.

-twosided

Display the torus with two colors: one color on the outside and the complementary on the inside. For static colors, the colors are red and green.

-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.

The following options determine whether the colors with which the torus is displayed are static or are changing dynamically.

-change-colors

Change the colors with which the torus is displayed dynamically.

-no-change-colors

Use static colors to display the torus (default).

The following two options are mutually exclusive. They determine how the torus is projected from 3d to 2d (i.e., to the screen).

-perspective-3d

Project the torus from 3d to 2d using a perspective projection (default).

-orthographic-3d

Project the torus from 3d to 2d using an orthographic projection.

The following two options are mutually exclusive. They determine how the torus is projected from 4d to 3d.

-perspective-4d

Project the torus from 4d to 3d using a perspective projection (default).

-orthographic-4d

Project the torus from 4d to 3d using an orthographic projection.

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.

-speed-wx float

Rotation speed around the wx plane (default: 1.1).

-speed-wy float

Rotation speed around the wy plane (default: 1.3).

-speed-wz float

Rotation speed around the wz plane (default: 1.5).

-speed-xy float

Rotation speed around the xy plane (default: 1.7).

-speed-xz float

Rotation speed around the xz plane (default: 1.9).

-speed-yz float

Rotation speed around the yz plane (default: 2.1).

-fps

Display the current frame rate, CPU load, and polygon count.

## 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.

## ENVIRONMENT
DISPLAY

to get the default host and display number.

XENVIRONMENT

to get the name of a resource file that overrides the global resources stored in the RESOURCE_MANAGER property.

## SEE ALSO
X(1), xscreensaver(1)

## COPYRIGHT
Copyright © 2003-2020 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.

## AUTHOR
Carsten Steger <carsten@mirsanmir.org>, 11-jan-2020.


hypnowheel

title: hypnowheel(6)

text:
# hypnowheel(6)

## NAME
hypnowheel - draws overlapping, translucent spiral patterns

## SYNOPSIS
hypnowheel [-display host:display.screen] [-visual visual] [-window] [-root] [-delay int] [-layers int] [-count int] [-twistiness float] [-speed float] [-wander] [-symmetric] [-fps]

## DESCRIPTION
Draws a series of overlapping, translucent spiral patterns. The tightness of their spirals fluctuates in and out.

## OPTIONS
-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.

-window

Draw on a newly-created window. This is the default.

-root

Draw on the root window.

-delay int

Delay between frames, in microseconds. Default 20000.

-layers int

How many different spirals to draw at once. Default 4.

-count int

How many arms each spiral should have. Default 11.

-twistiness float

How tightly wound the spirals can become, measured in rotations. Default 4.0 (four times around).

-speed ratio

Less than 1 for slower, greater than 1 for faster. Default 1.

-wander

If specified, then the centers of the spirals will wander around, rather than them all having the same origin.

-symmetric

If specified, then each pair of left-wrapping and right-wrapping spirals will be mirror images of each other.

-fps

Display the current frame rate, CPU load, and polygon count.

## ENVIRONMENT
DISPLAY

to get the default host and display number.

XENVIRONMENT

to get the name of a resource file that overrides the global resources stored in the RESOURCE_MANAGER property.

## SEE ALSO
X(1), xscreensaver(1)

## COPYRIGHT
Copyright © 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.

## AUTHOR
Jamie Zawinski.


jigglypuff

title: jigglypuff(6)

text:
# jigglypuff(6)

## NAME
jigglypuff - save your screen by tormenting your eyes.

## SYNOPSIS
jigglypuff [-display host:display.screen] [-visual visual] [-window] [-root] [-delay number] [-cycles number] [-wireframe] [-fps] [-color colorspec] [-spooky] [-complexity n] [-speed n] [-spherism n] [-hold n] [-distance n] [-damping n]

## 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.

## OPTIONS
-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.

-window

Draw on a newly-created window. This is the default.

-root

Draw on the root window.

-delay number

Per-frame delay, in microseconds. Default: 20000 (0.02 seconds.).

-wireframe

Render in wireframe instead of solid. Default: render solid.

-fps

Display the current frame rate, CPU load, and polygon count.

-tetra | -no-tetra

Whether to start the shape in the form of a tetrahedron. The default is to start as a sphere.

-color colorspec

Available options for colorspec are: cycle, flowerbox, clownpuke, chrome and #xxxxxx (i.e an (old-style) X color specification.) Default: cycle

-spooky n

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

-complexity n

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'.

-speed n

Controls how fast the blob moves around the screen. Default: 500.

-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.

-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

## ENVIRONMENT
DISPLAY

to get the default host and display number.

XENVIRONMENT

to get the name of a resource file that overrides the global resources stored in the RESOURCE_MANAGER property.

## SEE ALSO
X(1), xscreensaver(1)

## COPYRIGHT
Copyright © 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.

## AUTHOR
By Keith Macleod


jigsaw

title: jigsaw(6)

summary: permute an image like a jigsaw puzzle

text:
# jigsaw(6)

## NAME
jigsaw - permute an image like a jigsaw puzzle

## SYNOPSIS
jigsaw [-display host:display.screen] [-delay usecs] [-speed ratio] [-complexity ratio] [-resolution int] [-thickness float] [-no-wobble] [-fps]

## DESCRIPTION
The jigsaw 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 grabDesktopImages, grabVideoFrames, and chooseRandomImages options in the ~/.xscreensaver file; see xscreensaver-demo(1) for more details.

## OPTIONS
jigsaw accepts the following options:

-delay microseconds

How long to wait between animation frames; default 20000.

-speed ratio

Less than 1 for slower, greater than 1 for faster. Default 1.

-complexity ratio

Less than 1 for simpler puzzles (fewer pieces), greater than 1 for more complex puzzles (more pieces). Default 1.

-resolution ratio

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.

-thickness float

Thickness of the puzzle pieces (relative to their width). Default 0.06.

-no-wobble

Keep the display stationary instead of very slowly wobbling back and forth.

-fps

Display the current frame rate, polygon count, and CPU load.

-window

Draw on a newly-created window. This is the default.

-root

Draw on the root window.

-install

Install a private colormap for the window.

-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.

## ENVIRONMENT
DISPLAY

to get the default host and display number.

XENVIRONMENT

to get the name of a resource file that overrides the global resources stored in the RESOURCE_MANAGER property.

## SEE ALSO
X(1), xscreensaver(1), xscreensaver-demo(1), xscreensaver-getimage(1)

## COPYRIGHT
Copyright © 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.

## AUTHOR
Jamie Zawinski <jwz@jwz.org>, 25-Nov-97.


title: juggler3d(6)

summary: juggling man screen saver.

text:
# juggler3d(6)

## NAME
juggler3d - juggling man screen saver.

## SYNOPSIS
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]

## DESCRIPTION
Draws a stick-man juggling various collections of objects.

## OPTIONS
juggler3d accepts the following options:

-display host:display.screen

X11 display to use. Overrides DISPLAY environment variable.

-root

Draw on the root window.

-window

Draw on a newly-created X window. This is the default.

-mono

Draw in monochrome.

-install | -noinstall

Turn on/off installing colormap.

-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.

-window-id id

Draw on an already existing X window.

-pattern " pattern "

Specify juggling pattern in annotated site-swap notation. In 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:

-

Inside throw (default)

+

Outside throw

=

Cross Throw

&

Cross Catch

x

Cross Throw and Catch

_

Bounce

-pattern "[ pattern ]"

Specify juggling pattern in annotated Adam notation. Adam notation is a little harder to visualize. Each integer n represents a cyclic permutation of (0...n). The equivalent 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 site-swap notation. For example, both of these describe a 3-Shower:

-pattern "+5 1"

-pattern "[+3 1]" For further examples, see the portfolio list in the source code.

-tail number

Minimum Trail Length. 0 - 100. Default: 1. Objects may override this, for example flaming torches always leave a trail.

-real|-no-real

Turn on/off real-time juggling. Deprecated. There should be no need to turn off real-time juggling, even on slow systems. Adjust speed using -count above.

-describe|-no-describe

Turn on/off pattern descriptions.

-balls|-no-balls

Turn on/off Balls.

-clubs|-no-clubs

Turn on/off Clubs.

-torches|-no-torches

Turn on/off Flaming Torches.

-knives|-no-knives

Turn on/off Knives.

-rings|-no-rings

Turn on/off Rings.

-bballs|-no-bballs

Turn on/off Bowling Balls.

-count number

Speed. 50 - 1000. Default: 200. This determines the expected time interval between a throw and the next catch, in milliseconds.

-cycles number

Performance Length. 50 - 1000. Default: 1000. Setting this smaller will force the juggler to switch patterns (and objects) more often.

-delay delay

Additional delay between frames, in microseconds. Default: 10000. Deprecated. Adjust speed using -count.

-ncolors ncolors

Maximum number of colors to use. Default: 32.

-fps

Display the current frame rate and CPU load.

## ENVIRONMENT
DISPLAY

to get the default host and display number.

XENVIRONMENT

to get the name of a resource file that overrides the global resources stored in the RESOURCE_MANAGER property.

## SEE ALSO
X(1), xscreensaver(1)

## COPYRIGHT
Copyright © 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.

## AUTHOR
Tim Auckland.

Converted to OpenGL by Jamie Zawinski, 2009.


kaleidocycle

title: kaleidocycle(6)

summary: draws twistable rings of tetrahedra

text:
# kaleidocycle(6)

## NAME
kaleidocycle - draws twistable rings of tetrahedra

## SYNOPSIS
kaleidocycle [-display host:display.screen] [-window] [-root] [-visual visual] [-delay microseconds] [-count number] [-speed number] [-wander] [-no-wander] [-spin axes] [-no-spin] [-wireframe] [-fps]

## DESCRIPTION
The kaleidocycle program draws a ring composed of tetrahedra connected at the edges that twists and rotates toroidally. Segments are occasionally inserted or removed.

## OPTIONS
kaleidocycle accepts the following options:

-window

Draw on a newly-created window. This is the default.

-root

Draw on the root window.

-install

Install a private colormap for the window.

-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.

-count number

The initial number of segments. Default 16. Must be 8 or greater, and an even number.

-speed number

Adjust the animation speed. 0.5 for half as fast, 2.0 for twice as fast.

-wander

Move the text around the screen. This is the default.

-no-wander

Keep the text centered on the screen.

-spin

Which axes around which the text should spin. The default is "Z", meaning rotate the object the plane of the screen only.

-no-spin

Don't spin the text at all: the same as -spin "".

-wireframe

Render in wireframe instead of solid.

-fps

Display the current frame rate, CPU load, and polygon count.

## ENVIRONMENT
DISPLAY

to get the default host and display number.

XENVIRONMENT

to get the name of a resource file that overrides the global resources stored in the RESOURCE_MANAGER property.

## SEE ALSO
X(1), xscreensaver(1)

## COPYRIGHT
Copyright © 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.

## AUTHOR
Jamie Zawinski <jwz@jwz.org>


klein

title: klein(6)

summary: Draws a 4d Klein bottle.

text:
# klein(6)

## NAME
klein - Draws a 4d Klein bottle.

## SYNOPSIS
klein [-display host:display.screen] [-install] [-visual visual] [-window] [-root] [-delay usecs] [-fps] [-klein-bottle bottle-name] [-figure-8] [-pinched-torus] [-lawson] [-mode display-mode] [-wireframe] [-surface] [-transparent] [-appearance appearance] [-solid] [-bands] [-colors color-scheme] [-onesided] [-twosided] [-rainbow] [-depth] [-change-colors] [-view-mode view-mode] [-walk] [-turn] [-walk-turn] [-orientation-marks] [-projection-3d mode] [-perspective-3d] [-orthographic-3d] [-projection-4d mode] [-perspective-4d] [-orthographic-4d] [-speed-wx float] [-speed-wy float] [-speed-wz float] [-speed-xy float] [-speed-xz float] [-speed-yz float] [-walk-direction float] [-walk-speed float]

## DESCRIPTION
The klein program shows three different Klein bottles in 4d: the figure-8 Klein bottle, the pinched torus 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 when using static colors). The pinched torus Klein bottle also does not intersect itself in 4d (which can be seen in the depth colors mode when using static colors). 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. For the pinched torus Klein bottle, both projection modes give equally acceptable projections.

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 one-sided, two-sided, rainbow, or depth. In one-sided mode, the Klein bottle is drawn with the same color on both "sides." In two-sided mode (using static colors), 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. If changing colors are used in two-sided mode, changing complementary colors are used on the respective "sides." The rainbow color mode (using static colors) draws the Klein bottle with a color wheel of fully saturated rainbow colors. If changing colors are used, the color wheel's colors change dynamically. The rainbow color mode gives a very nice effect when combined with the see-through bands mode or with the orientation markers drawn. The depth color mode draws the Klein bottle with colors that are chosen according to the 4d "depth" of the points. If static colors are used, this mode enables you to see that the figure-8 and pinched torus Klein bottles do not intersect themselves 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 mode, 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.

## OPTIONS
klein accepts the following options:

-window

Draw on a newly-created window. This is the default.

-root

Draw on the root window.

-install

Install a private colormap for the window.

-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.

-delay microseconds

How much of a delay should be introduced between steps of the animation. Default 10000, or 1/100th second.

-fps

Display the current frame rate, CPU load, and polygon count.

The following three options are mutually exclusive. They determine which Klein bottle is displayed.

-klein-bottle random

Display a random Klein bottle (default).

-klein-bottle figure-8 (Shortcut: -figure-8)

Display the figure-8 Klein bottle.

-klein-bottle pinched-torus (Shortcut: -pinched-torus)

Display the pinched torus Klein bottle.

-klein-bottle lawson (Shortcut: -lawson)

Display the Lawson Klein bottle.

The following four options are mutually exclusive. They determine how the Klein bottle is displayed.

-mode random

Display the Klein bottle in a random display mode (default).

-mode wireframe (Shortcut: -wireframe)

Display the Klein bottle as a wireframe mesh.

-mode surface (Shortcut: -surface)

Display the Klein bottle as a solid surface.

-mode transparent (Shortcut: -transparent)

Display the Klein bottle as a transparent surface.

The following three options are mutually exclusive. They determine the appearance of the Klein bottle.

-appearance random

Display the Klein bottle with a random appearance (default).

-appearance solid (Shortcut: -solid)

Display the Klein bottle as a solid object.

-appearance bands (Shortcut: -bands)

Display the Klein bottle as see-through bands.

The following five options are mutually exclusive. They determine how to color the Klein bottle.

-colors random

Display the Klein bottle with a random color scheme (default).

-colors one-sided (Shortcut: -onesided)

Display the Klein bottle with a single color.

-colors two-sided (Shortcut: -twosided)

Display the Klein bottle with two colors: one color one "side" and the complementary color on the "other side." For static colors, the colors are red and green.

-colors rainbow (Shortcut: -rainbow)

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.

-colors depth (Shortcut: -depth)

Display the Klein bottle with colors chosen depending on the 4d "depth" of the points.

The following options determine whether the colors with which the Klein bottle is displayed are static or are changing dynamically.

-change-colors

Change the colors with which the Klein bottle is displayed dynamically.

-no-change-colors

Use static colors to display the Klein bottle (default).

The following four options are mutually exclusive. They determine how to view the Klein bottle.

-view-mode random

View the Klein bottle in a random view mode (default).

-view-mode walk (Shortcut: -walk)

View the Klein bottle as if walking on its surface.

-view-mode turn (Shortcut: -turn)

View the Klein bottle while it turns in 4d.

-view-mode walk-turn (Shortcut: -walk-turn)

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).

The following options determine whether orientation marks are shown on the Klein bottle.

-orientation-marks

Display orientation marks on the Klein bottle.

-no-orientation-marks

Don't display orientation marks on the Klein bottle (default).

The following three options are mutually exclusive. They determine how the Klein bottle is projected from 3d to 2d (i.e., to the screen).

-projection-3d random

Project the Klein bottle from 3d to 2d using a random projection mode (default).

-projection-3d perspective (Shortcut: -perspective-3d)

Project the Klein bottle from 3d to 2d using a perspective projection.

-projection-3d orthographic (Shortcut: -orthographic-3d)

Project the Klein bottle from 3d to 2d using an orthographic projection.

The following three options are mutually exclusive. They determine how the Klein bottle is projected from 4d to 3d.

-projection-4d random

Project the Klein bottle from 4d to 3d using a random projection mode (default).

-projection-4d perspective (Shortcut: -perspective-4d)

Project the Klein bottle from 4d to 3d using a perspective projection.

-projection-4d orthographic (Shortcut: -orthographic-4d)

Project the Klein bottle from 4d to 3d using an orthographic projection.

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.

-speed-wx float

Rotation speed around the wx plane (default: 1.1).

-speed-wy float

Rotation speed around the wy plane (default: 1.3).

-speed-wz float

Rotation speed around the wz plane (default: 1.5).

-speed-xy float

Rotation speed around the xy plane (default: 1.7).

-speed-xz float

Rotation speed around the xz plane (default: 1.9).

-speed-yz float

Rotation speed around the yz plane (default: 2.1).

The following two options determine the walking speed and direction.

-walk-direction float

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).

-walk-speed float

The walking speed is measured in percent of some sensible maximum speed (default: 20.0).

## 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.

## ENVIRONMENT
DISPLAY

to get the default host and display number.

XENVIRONMENT

to get the name of a resource file that overrides the global resources stored in the RESOURCE_MANAGER property.

## SEE ALSO
X(1), xscreensaver(1)

## COPYRIGHT
Copyright © 2005-2020 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.

## AUTHOR
Carsten Steger <carsten@mirsanmir.org>, 11-jan-2020.


lament

title: lament(6)

summary: animates the Lament Configuration

text:
# lament(6)

## NAME
lament - animates the Lament Configuration

## SYNOPSIS
lament [-display host:display.screen] [-window] [-root] [-install] [-visual visual] [-delay microseconds] [-fps] [-texture] [-no-texture] [-wireframe]

## DESCRIPTION
The lament program draws an animation of a particular puzzle box repeatedly solving itself.

## OPTIONS
lament accepts the following options:

-window

Draw on a newly-created window. This is the default.

-root

Draw on the root window.

-install

Install a private colormap for the window.

-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.

-texture

Use texture maps. This is the default.

-no-texture

Do not use texture maps. This is boring and wrong.

-wireframe

Only draw outlines.

-delay microseconds

How long to pause between frames. Default is 20000, or 0.02 second.

-fps

Display the current frame rate, CPU load, and polygon count.

## ENVIRONMENT
DISPLAY

to get the default host and display number.

XENVIRONMENT

to get the name of a resource file that overrides the global resources stored in the RESOURCE_MANAGER property.

## BUGS
This hack is glacially slow on machines lacking hardware texture support.

Occasionally opens doors, admitting theologians of the Order of the Gash.

## SEE ALSO
X(1), xscreensaver(1)

## COPYRIGHT
Copyright © 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.

## AUTHOR
Jamie Zawinski <jwz@jwz.org>, 25-Jul-98.


lavalite

title: lavalite(6)

summary: 3D OpenGL simulation of a Lavalite.

text:
# lavalite(6)

## NAME
lavalite - 3D OpenGL simulation of a Lavalite.

## SYNOPSIS
lavalite [-display host:display.screen] [-window] [-root] [-visual visual] [-delay microseconds] [-fps] [-style style ] [-spin xyz ] [-no-spin ] [-speed float ] [-resolution integer ] [-count integer ] [-no-smooth ] [-wireframe ] [-impatient ] [-lava-color color ] [-fluid-color color ] [-base-color color ] [-table-color color ] [-fluid-texture filename ] [-base-texture filename ] [-table-texture filename ]

## DESCRIPTION
The lavalite program displays a 3D simulation of the famous lamp of the same name. It requires a fast computer with fast OpenGL support.

## OPTIONS
lavalite accepts the following options:

-window

Draw on a newly-created window. This is the default.

-root

Draw on the root window.

-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.

-style style

Specify which model of lamp to draw. Available models are: Classic, Giant, Cone, and Rocket. Default: random.

-spin xyz

Around which axes the model should auto-spin. Defaults to "Z", meaning it rotates horizontally, but otherwise pitch or roll.

-no-spin

Same as -spin ''.

-speed float

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.

-delay usecs

The delay between steps of the animation; default is 30000 (0.03 second.)

-resolution integer

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.

-fps

Display the current frame rate, CPU load, and polygon count.

-count integer

The maximum number of blobs that can be in motion at once. Default: 3.

-no-smooth

Turn off smoothing: the objects in the scene will be facetted.

-wireframe

Render all objects in wireframe instead of as solids.

-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.

-lava-color color

Specifies the color of the blobbies. Default: red.

-fluid-color color

Specifies the color of the fluid that the blobbies float in. Default: light blue.

-base-color color

Specifies the color of the lamp base, and the cap on top of the bottle. Default: very dark gray.

-table-color color

Specifies the color of the table that the lamp is sitting on. Default: black (meaning it is invisible.)

-fluid-texture filename

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.

-base-texture filename

An image file to wrap around the base of the lamp, and the cap on top of the bottle.

-table-texture texture

An image file to spread across the table that the lamp is sitting on.

## ENVIRONMENT
DISPLAY

to get the default host and display number.

XENVIRONMENT

to get the name of a resource file that overrides the global resources stored in the RESOURCE_MANAGER property.

## SEE ALSO
X(1), xscreensaver(1),

http://www.lavaworld.com/

http://www.lavarnd.org/

## COPYRIGHT
Copyright © 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® and the configuration of the LAVA® 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.

## AUTHOR
Jamie Zawinski <jwz@jwz.org>


lockward

title: lockward(6)

summary: Rotating spinning color-cycling things

text:
# lockward(6)

## NAME
lockward - Rotating spinning color-cycling things

## SYNOPSIS
lockward [-display displayspec] [-root] [-window] [-visual arg] [-window-id arg] [-delay usec] [-pair] [-fps] [-blink | -no-blink] [-rotateidle-min msec] [-rotateidle-max msec] [-blinkidle-min msec] [-blinkidle-max msec] [-blinkdwell-min msec] [-blinkdwell-max msec]

## DESCRIPTION
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.

## OPTIONS
-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.

-window

Draw on a newly-created window (default).

-root

Draw on the root window.

-delay microseconds

Per-frame delay, in microseconds. Default: 20000 (50 frames/sec).

-blink | -no-blink

Enables/disables the blinking effects. Default: Enabled.

-fps

Display the current frame rate, CPU load, and polygon count.

-rotateidle-min milliseconds

-rotateidle-max milliseconds

The minimum and maximum time each spinner will sit idle, in milliseconds. Defaults: Min 1000, max 6000.

-blinkidle-min milliseconds

-blinkidle-max milliseconds

The minimum and maximum time between blinking effects, in milliseconds. Defaults: Min 1000, max 9000.

-blinkdwell-min milliseconds

-blinkdwell-max milliseconds

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.

## ENVIRONMENT
DISPLAY

Default host and display number.

XENVIRONMENT

Name of a resource file that overrides the global resources stored in the RESOURCE_MANAGER property.

## SEE ALSO
X(1), xscreensaver(1)

## AUTHORS
Leo L. Schwab <ewhac@best.com>


title: maze3d(6)

summary: A 3D maze.

text:
# maze3d(6)

## NAME
maze3d - A 3D maze.

## SYNOPSIS
maze3d [-display host:display.screen] [-visual visual] [-window] [-root] [-speed float] [-delay number] [-fps] [-rows number] [-columns number] [-overlay] [-wall-texture texture] [-floor-texture texture] [-ceiling-texture texture] [-drop-acid] [-drop-acid-walls] [-drop-acid-floor] [-drop-acid-ceiling] [-inverters number] [-rats number]

## DESCRIPTION
A recreation of the 3D Maze screensaver from Windows 95.

## OPTIONS
-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.

-window

Draw on a newly-created window. This is the default.

-root

Draw on the root window.

-speed number

Speed of the dungeon crawl. 2 is twice as fast, 0.5 is half as fast.

-delay number

Per-frame delay, in microseconds. Default: 20000 (0.02 seconds).

-fps | -no-fps

Display the current frame rate and CPU load.

-rows number

The number of rows in the maze. Default: 12.

-columns number

The number of columns in the maze. Default: 12.

-overlay

Overlays a minimap of the maze on the screen.

-wall-texture texture

Sets the wall texture. texture can be a path to an image file, or it can be one of the built-in textures (see TEXTURES below).

-floor-texture texture

Sets the floor texture. texture can be a path to an image file, or it can be one of the built-in textures (see TEXTURES below).

-ceiling-texture texture

Sets the ceiling texture. texture can be a path to an image file, or it can be one of the built-in textures (see TEXTURES below).

-drop-acid-walls

Continuously shifts the hue of the wall texture. (This looks like an LSD trip, hence the name.)

-drop-acid-floor

Continuously shifts the hue of the floor texture.

-drop-acid-ceiling

Continuously shifts the hue of the ceiling texture.

-drop-acid

Turns on all three.

-inverters number

Sets the number of inverters (the spinny grey things that flip the camera upside-down) in the maze. Default: 10.

-rats number

Sets the number of rats, or rather "Bobs", in the maze. Default: 1.

## TEXTURES
The wall, ceiling, and floor textures can be set to one of the following:

brick-wall

A brick wall. This is the default wall texture.

wood-floor

A wooden floor. This is the default floor texture.

ceiling-tiles

Ceiling tiles. This is the default ceiling texture.

You can also specify a path to an image file, instead of using one of the built-in textures.

## ENVIRONMENT
DISPLAY

to get the default host and display number.

XENVIRONMENT

to get the name of a resource file that overrides the global resources stored in the RESOURCE_MANAGER property.

## SEE ALSO
X(1), xscreensaver(1)

## COPYRIGHT
Copyright © 2018 by sudoer@riseup.net. 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.


menger

title: menger(6)

summary: 3D menger gasket fractal.

text:
# menger(6)

## NAME
menger - 3D menger gasket fractal.

## SYNOPSIS
menger [-display host:display.screen] [-visual visual] [-window] [-root] [-delay number] [-speed number] [-depth number] [-no-wander] [-no-spin] [-spin [XYZ]] [-wireframe] [-fps]

## DESCRIPTION
This draws the three-dimensional variant of the recursive Menger Gasket, a cube-based fractal object analogous to the Sierpinski Tetrahedron.

## OPTIONS
-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.

-window

Draw on a newly-created window. This is the default.

-root

Draw on the root window.

-delay number

Per-frame delay, in microseconds. Default: 30000 (0.03 seconds.).

-speed number

Number of frames before changing shape. Default: 150.

-depth number

Max depth to descend. Default: 3. You probably don't have enough memory for 6.

-wander | -no-wander

Whether the object should wander around the screen.

-spin [XYZ]

Around which axes should the object spin?

-no-spin

None.

-wireframe

Render in wireframe instead of solid.

-fps

Display the current frame rate, CPU load, and polygon count.

## ENVIRONMENT
DISPLAY

to get the default host and display number.

XENVIRONMENT

to get the name of a resource file that overrides the global resources stored in the RESOURCE_MANAGER property.

## SEE ALSO
X(1), xscreensaver(1)

## COPYRIGHT
Copyright © 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.

## AUTHOR
Jamie Zawinski.


mirrorblob

title: mirrorblob(6)

text:
# mirrorblob(6)

## NAME
mirrorblob - Draws a wobbly blob that distorts the image behind it.

## SYNOPSIS
mirrorblob [-display host:display.screen] [-visual visual] [-window] [-root] [-wire] [-delay number] [-fog] [-walls] [-colour] [-texture] [-offset-texture] [-blend] [-antialias] [-resolution number] [-bumps number] [-fade-time number] [-hold-time number] [-zoom number] [-fps]

## 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.

## OPTIONS
-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.

-window

Draw on a newly-created window. This is the default.

-root

Draw on the root window. -wire Render in wireframe instead of solid.

-delay number

Per-frame delay, in microseconds. Default: 10000 (0.01 seconds.).

-fog | -no-fog

Whether to enable fog.

-walls | -no-walls

Add walls for blob to hit.

-colour | -no-colour

Draw coloured blob. If also textured, the texture will have color mixed in.

-texture | -no-texture

Whether to wrap a texture image on the blob.

-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.

-blend | -no-blend

Whether to draw a transparent blob. (see also offset_texture above)

-antialias | -no-antialias

Whether to antialias lines.

-resolution number

Resolution of the tessellation used to calculate and draw the blob. Larger

numbers give a smoother blob but increase calculation times exponentially.

-bumps number

Number of bumps used to distort the blob.

-hold-time number

Time until loading a new image.

-fade-time number

Time taken to transition between images.

-zoom number

Size multiplier for blob.

-fps

Display the current frame rate, CPU load, and polygon count.

## ENVIRONMENT
DISPLAY

to get the default host and display number.

XENVIRONMENT

to get the name of a resource file that overrides the global resources stored in the RESOURCE_MANAGER property.

## SEE ALSO
X(1), xscreensaver(1)

## COPYRIGHT
Copyright © 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.

## AUTHOR
Jon Dowdall.


moebius

title: moebius(6)

summary: Escher's Moebuis Strip II, with ants.

text:
# moebius(6)

## NAME
moebius - Escher's Moebuis Strip II, with ants.

## SYNOPSIS
moebius [-display host:display.screen] [-visual visual] [-window] [-root] [-delay number] [-solidmoebius] [-wireframe] [-noants] [-fps]

## 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.

## OPTIONS
-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.

-window

Draw on a newly-created window. This is the default.

-root

Draw on the root window.

-delay number

Per-frame delay, in microseconds. Default: 20000 (0.02 seconds.).

-solidmoebius

Solid Floor.

-wireframe

Render in wireframe instead of solid.

-noants | -no-noants

Draw Ants. Boolean.

-fps

Display the current frame rate, CPU load, and polygon count.

## ENVIRONMENT
DISPLAY

to get the default host and display number.

XENVIRONMENT

to get the name of a resource file that overrides the global resources stored in the RESOURCE_MANAGER property.

## SEE ALSO
X(1), xscreensaver(1)

## COPYRIGHT
Copyright © 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.

## AUTHOR
Marcelo Vianna.


moebiusgears

title: moebiusgears(6)

text:
# moebiusgears(6)

## NAME
moebiusgears - draw a moebius strip of interlocking gears.

## SYNOPSIS
moebiusgears [-display host:display.screen] [-window] [-root] [-install] [-visual visual] [-delay usecs] [-speed float] [-no-spin] [-no-wander] [-no-roll] [-count integer] [-teeth integer] [-wireframe] [-fps]

## DESCRIPTION
The moebiusgears program draws a closed, interlinked chain of rotating gears. The layout of the gears follows the path of a moebius strip.

## OPTIONS
moebiusgears accepts the following options:

-window

Draw on a newly-created window. This is the default.

-root

Draw on the root window.

-install

Install a private colormap for the window.

-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.

-delay usecs

The delay between frames of the animation, in microseconds. Default: 30000 (0.03 seconds.)

-speed float

Larger numbers mean run faster. Default: 1.0.

-no-spin

Don't rotate the object.

-no-wander

Don't wander the object around the screen.

-no-roll

Don't slowly roll the moebius strip inside out.

-count integer

How many gears to draw. Default: 17. Minimum 11, must be odd.

-teeth integer

How many teeth to draw on each draw. Default: 15. Minimum 7, must be odd.

-wireframe

Render in wireframe instead of solid.

-fps

Display the current frame rate, CPU load, and polygon count.

## ENVIRONMENT
DISPLAY

to get the default host and display number.

XENVIRONMENT

to get the name of a resource file that overrides the global resources stored in the RESOURCE_MANAGER property.

## SEE ALSO
X(1), xscreensaver(1)

## COPYRIGHT
Copyright © 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.

## AUTHOR
Jamie Zawinski.