etruscanvenus

title: etruscanvenus(6)

text:
# etruscanvenus(6)

## NAME
etruscanvenus - Draws a 3d immersion of a Klein bottle that smoothly deforms between the Etruscan Venus surface, the Roman surface, the Boy surface surface, and the Ida surface.

## SYNOPSIS
etruscanvenus [--display host:display.screen] [--install] [--visual visual] [--window] [--root] [--window-id number] [--delay usecs] [--fps] [--mode display-mode] [--wireframe] [--surface] [--transparent] [--appearance appearance] [--solid] [--distance-bands] [--direction-bands] [--colors color-scheme] [--onesided-colors] [--twosided-colors] [--distance-colors] [--direction-colors] [--no-change-colors] [--view-mode view-mode] [--walk] [--turn] [--no-deform] [--deformation-speed float] [--initial-deformation float] [--etruscan-venus] [--roman] [--boy] [--ida] [--orientation-marks] [--projection mode] [--perspective] [--orthographic] [--speed-x float] [--speed-y float] [--speed-z float] [--walk-direction float] [--walk-speed float]

## DESCRIPTION
The etruscanvenus program shows a 3d immersion of a Klein bottle that smoothly deforms between the Etruscan Venus surface, the Roman surface, the Boy surface, and the Ida surface. You can walk on the Klein bottle or turn it in 3d. Topologically, all surfaces are Klein bottles, even the Roman and Boy surfaces, which are doubly covered and therefore appear to be an immersed real projective plane. The smooth deformation between these surfaces was constructed by George K. Francis.

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). Since all the surfaces except the Ida surface have points where the surface normal is not well defined for some points, walking is only performed on the Ida surface.

As mentioned above, the Roman and Boy surfaces are doubly covered and therefore appear to be an immersed real projective plane. Since some of the parameter names are based on this interpretation of the surface, the geometry of the real projective plane will be briefly disussed. The real projective plane is a model for the projective geometry in 2d space. One point can be singled out as the origin. A line can be singled out as the line at infinity, i.e., a line that lies at an infinite distance to the origin. The line at infinity is topologically a circle. Points on the line at infinity are also used to model directions in projective geometry. Direction and distance bands refer to this interpretation of the surface. If direction bands are used, the bands extend from the origin of the projective plane in different directions to the line at infinity and back to the origin. If distance bands are used, the bands lie at constant distances to the origin. The same interpretation is used for distance and direction colors. Although there is no conceptually equivalent geometric interpretation for the two Klein bottle surfaces (the Etruscan Venus and Ida surfaces), the smooth deformation between the surfaces results in a natural extension of these concepts to the Klein bottle surfaces.

The immersed surfaces can be projected to the screen either perspectively or orthographically. When using the walking mode, perspective projection to the screen will be used.

There are three display modes for the Klein bottle: mesh (wireframe), solid, or transparent. Furthermore, the appearance of the surface can be as a solid object or as a set of see-through bands. The bands can be distance bands or direction bands, as explained above.

The colors with with the surface is drawn can be set to one-sided, two-sided, distance, or direction. In one-sided mode, the surface is drawn with the same color on both sides of the underlying triangles. In two-sided mode, the surface is drawn with one color on one side of the underlying triangles and the complementary color on the other side. Since the surface actually only has one side, the color jumps from red to green along a line on the surface. This mode enables you to see that the surface is non-orientable. In distance mode, the surface is displayed with fully saturated colors that depend on the distance of the points on the projective plane to the origin, as described above. If the surface is displayed as distance bands, each band will be displayed with a different color. In direction mode, the surface is displayed with fully saturated colors that depend on the angle of the points on the projective plane with respect to the origin (see above for an explanation). If the surface is displayed as direction bands, each band will be displayed with a different color. The colors used to color the surface can either be static or can be changed dynamically.

The rotation speed for each of the three coordinate axes around which the Klein bottle rotates can be chosen.

Furthermore, in the walking mode the walking direction in the 2d base square of the surface and the walking speed can be chosen. The walking direction is measured as an angle in degrees in the 2d square that forms the coordinate system of the surface. A value of 0 or 180 means that the walk is along a circle at a randomly chosen distance from the origin (parallel to a distance band). A value of 90 or 270 means that the walk is directly along a direction band. Any other value results in a curved path along the surface. As noted above, walking is performed only on the Ida surface.

By default, the immersion of the Klein bottle smoothly deforms between the Etruscan Venus surface, the Roman surface, the Boy surface, and the Ida surface. It is possible to choose the speed of the deformation. Furthermore, it is possible to switch the deformation off. It is also possible to determine the initial deformation of the immersion. This is mostly useful if the deformation is switched off, in which case it will determine the appearance of the surface. A value of 0 corresponds to the Etruscan Venus surface, a value of 1000 to the Roman surface, a value of 2000 to the Boy surface, and a value of 3000 to the Ida surface.

This program is inspired by George K. Francis's book "A Topological Picturebook", Springer, 1987, by George K. Francis's paper "The Etruscan Venus" in P. Concus, R. Finn, and D. A. Hoffman: "Geometric Analysis and Computer Graphics", Springer, 1991, and by a video entitled "The Etruscan Venus" by Donna J. Cox, George K. Francis, and Raymond L. Idaszak, presented at SIGGRAPH 1989.

## OPTIONS
etruscanvenus accepts the following options:

--window

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

--root

Draw on the root window.

--window-id number

Draw on the specified 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 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 four 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 distance-bands (Shortcut: --distance-bands)

Display the Klein bottle as see-through bands that lie at increasing distances from the origin (see above for an explanation).

--appearance direction-bands (Shortcut: --direction-bands)

Display the Klein bottle as see-through bands that lie at increasing angles with respect to the origin (see above for an explanation).

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 onesided (Shortcut: --onesided-colors)

Display the Klein bottle with a single color.

--colors twosided (Shortcut: --twosided-colors)

Display the Klein bottle with two colors: one color on one "side" and the complementary color on the "other side."

--colors distance (Shortcut: --distance-colors)

Display the Klein bottle with fully saturated colors that depend on the distance of the points on the projective plane to the origin (see above for an explanation). If the Klein bottle is displayed as distance bands, each band will be displayed with a different color.

--colors direction (Shortcut: --direction-colors)

Display the Klein bottle with fully saturated colors that depend on the angle of the points on the projective plane with respect to the origin (see above for an explanation). If the Klein bottle is displayed as direction bands, each band will be displayed with a different color.

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

--change-colors

Change the colors with which the Klein bottle is displayed dynamically (default).

--no-change-colors

Use static colors to display the Klein bottle.

The following three 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). The walking mode will be randomly selected in approximately 10% of the cases.

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

View the Klein bottle while it turns in 3d.

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

View the Klein bottle as if walking on its surface.

The following options determine whether the surface is being deformed.

--deform

Deform the surface smoothly between the Etruscan Venus surface, the Roman surface, the Boy surface surface, and the Ida surface (default).

--no-deform

Don't deform the surface.

The following option determines the deformation speed.

--deformation-speed float

The deformation speed is measured in percent of some sensible maximum speed (default: 10.0).

The following options determine the initial deformation of the surface. As described above, this is mostly useful if --no-deform is specified.

--initial-deformation float

The initial deformation is specified as a number between 0 and 4000. A value of 0 corresponds to the Etruscan Venus surface, a value of 1000 to the Roman surface, a value of 2000 to the Boy surface, and a value of 3000 to the Ida surface. The default value is 0.

--etruscan-venus

This is a shortcut for --initial-deformation 0.

--roman

This is a shortcut for --initial-deformation 1000.

--boy

This is a shortcut for --initial-deformation 2000.

--ida

This is a shortcut for --initial-deformation 3000.

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 Klain bottle is projected from 3d to 2d (i.e., to the screen).

--projection random

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

--projection perspective (Shortcut: --perspective)

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

--projection orthographic (Shortcut: --orthographic)

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

The following three options determine the rotation speed of the Klein bottle around the three possible axes. 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.

--speed-x float

Rotation speed around the x axis (default: 1.1).

--speed-y float

Rotation speed around the y axis (default: 1.3).

--speed-z float

Rotation speed around the z axis (default: 1.5).

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: 83.0). A value of 0 or 180 means that the walk is along a circle at a randomly chosen distance from the origin (parallel to a distance band). A value of 90 or 270 means that the walk is directly along a direction band. Any other value results in a curved path along the surface. As noted above, walking is performed only on the Ida surface.

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

XSCREENSAVER_WINDOW

The window ID to use with --root.

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

## COPYRIGHT
Copyright © 2019-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>, 05-jan-2020.


extrusion

package: xscreensaver-modules-gl

title: extrusion(6)

summary: various rotating extruded shapes.

text:
# extrusion(6)

## NAME
extrusion - various rotating extruded shapes.

## SYNOPSIS
extrusion [--display host:display.screen] [--visual visual] [--window] [--root] [--window-id number] [--delay number] [--name which] [--no-light] [--wireframe] [--fps]

## DESCRIPTION
Draws various rotating extruded shapes that twist around, lengthen, and turn inside 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.

--window-id number

Draw on the specified window.

--delay number

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

--name which

Which object to draw. Choices are: helix2, helix3, helix4, joinoffset, screw, taper, and twistoid.

--light | --no-light

Whether to light the scene, or use flat coloring.

--bitmap file

The texture map to use.

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

XSCREENSAVER_WINDOW

The window ID to use with --root.

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

## COPYRIGHT
Copyright © 2002 by Linas Vepstas and David Konerding. Permission to use, copy, modify, distribute, and sell this software and its documentation for any purpose is hereby granted without fee, provided that the above copyright notice appear in all copies and that both that copyright notice and this permission notice appear in supporting documentation. No representations are made about the suitability of this software for any purpose. It is provided "as is" without express or implied warranty.

## AUTHOR
This screensaver was created by David Konerding from the samples that come with the GL Extrusion library by Linas Vepstas.

branch: sisyphus


flipflop

title: flipflop(6)

text:
# flipflop(6)

## NAME
flipflop - draws a grid of 3D squares that change positions

## SYNOPSIS
flipflop [--display host:display.screen] [--visual visual] [--window] [--root] [--window-id number] [--count number | --free number] [--size number] [--size-x number] [--size-y number] [--spin number] [--mode sticks | tiles] [--delay number] [--wireframe] [--fps] [--texture]

## DESCRIPTION
Flipflop draws a grid of 3D colored tiles that change positions with each other.

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

--window-id number

Draw on the specified window.

--count number

Number of tiles on the board. A value of "0" means "default". The default number of tiles depends on the size of the board and the mode: 95% of total tiles for "tiles" mode and 80% of total sticks for "sticks" mode (e.g. 76 tiles or 64 sticks for a 9x9 board).

--free number

Number of tiles missing from the board. See -count.

--size number

Number of tiles on each side of the board. Takes precedence over -size-x and -size-y. Default: 9.

--size-x number

Width (in tiles) of the board. Default: 9.

--size-y number

Length (in tiles) of the board. Default: 9.

--spin number

Angular velocity for the rotation of the board.

--mode sticks

Draw hopping sticks instead of flipping tiles.

--mode tiles

Draw flipping tiles. This is the default.

--delay number

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

--fps | --no-fps

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

--wireframe

Only draw outlines.

--texture | --no-texture

Whether to texture the tiles with a screen grab or an image.

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

XSCREENSAVER_WINDOW

The window ID to use with --root.

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

## COPYRIGHT
Copyright © 2003 by Kevin Ogden. Permission to use, copy, modify, distribute, and sell this software and its documentation for any purpose is hereby granted without fee, provided that the above copyright notice appear in all copies and that both that copyright notice and this permission notice appear in supporting documentation. No representations are made about the suitability of this software for any purpose. It is provided "as is" without express or implied warranty.

## AUTHOR
Kevin Ogden <kogden1@hotmail.com>. Some additional code by Sergio Gutierrez <sergut@gmail.com>.


title: flipscreen3d(6)

text:
# flipscreen3d(6)

## NAME
flipscreen3d - rotates an image of the screen through 3 dimensions.

## SYNOPSIS
flipscreen3d [--display host:display.screen] [--visual visual] [--window] [--root] [--window-id number] [--delay number] [--no-rotate] [--wireframe] [--fps]

## DESCRIPTION
Grabs an image of the desktop, turns it into a GL texture map, and spins it around and deforms it in various ways.

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

--window-id number

Draw on the specified window.

--delay number

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

--rotate | --no-rotate

Whether to rotate.

--wireframe

Just render boxes instead of textures (for debugging).

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

XSCREENSAVER_WINDOW

The window ID to use with --root.

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

## COPYRIGHT
Copyright © 2002 by Ben Buxton. Permission to use, copy, modify, distribute, and sell this software and its documentation for any purpose is hereby granted without fee, provided that the above copyright notice appear in all copies and that both that copyright notice and this permission notice appear in supporting documentation. No representations are made about the suitability of this software for any purpose. It is provided "as is" without express or implied warranty.

## AUTHOR
Ben Buxton.


fliptext

title: fliptext(6)

text:
# fliptext(6)

## NAME
fliptext - draws pages of text whose lines transparently flip around

## SYNOPSIS
fliptext [--display host:display.screen] [--window] [--root] [--window-id number] [--visual visual] [--delay microseconds] [--program command] [--size integer ] [--columns integer] [--left | --center | --right] [--lines integer] [--speed float] [--delay usecs] [--font xlfd] [--wireframe] [--fps]

## DESCRIPTION
The fliptext program runs another program to generate a stream of text, then animates the lines of that text transparently flipping in and out in 3D.

## OPTIONS
fliptext accepts the following options:

--window

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

--root

Draw on the root window.

--window-id number

Draw on the specified 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.

--program sh-command

This program will be run periodically, and its output will be the text that is displayed. Default xscreensaver-text. You can configure the text printed through the "Advanced" tab of xscreensaver-settings(1), or by editing your ~/.xscreensaver file.

--size integer

How large a font to use, in points. (Well, in some arbitrary unit we're calling "points" for the sake of argument.) Default: 20.

--columns integer

At (approximately) what column to wrap lines. Default 80. Wrapping is done by pixels, not characters, and lines will always wrap at the edge of the screen regardless.

--left | --center | --right

Whether to align the text flush left, centered, or flush right. The default is to choose randomly each time a new screen of text is displayed.

--lines integer

How many lines of text should be shown at once. Default 8.

--speed ratio

Change the animation speed; 0.5 to go half as fast, 2.0 to go twice as fast.

--delay usecs

The delay between frames of the animation; default is 10000 (1/10th second.)

--font font-name

The name of the font to use. For best effect, this should be a large font (at least 36 points.) The bigger the font, the better looking the characters will be. Note that the size of this font affects only the clarity of the characters, not their size on the screen: for that, use the --size or --columns options. Default: -*-utopia-bold-r-normal-*-*-720-*-*-*-*-iso8859-1

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

XSCREENSAVER_WINDOW

The window ID to use with --root.

## SEE ALSO
xscreensaver(1), xscreensaver-text(6), fortune(1), phosphor(6), apple2(6), fontglide(6), ljlatest(6), dadadodo(1), webcollage(6), driftnet(1) EtherPEG, EtherPeek

## COPYRIGHT
Copyright © 2005 by Jamie Zawinski. Permission to use, copy, modify, distribute, and sell this software and its documentation for any purpose is hereby granted without fee, provided that the above copyright notice appear in all copies and that both that copyright notice and this permission notice appear in supporting documentation. No representations are made about the suitability of this software for any purpose. It is provided "as is" without express or implied warranty.

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


flurry

title: flurry(6)

summary: a colorful particle system

text:
# flurry(6)

## NAME
flurry - a colorful particle system

## SYNOPSIS
flurry [--display host:display.screen] [--visual visual] [--window] [--root] [--window-id number] [--preset <arg>] [--fps]

## DESCRIPTION
This is a port of the OSX screensaver flurry.

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

--window-id number

Draw on the specified window.

--preset <arg>

Select a preset (classic, fire, water, psychedelic, rgb, binary, random, insane) (Insane will never be selected at random, because it requires lots of CPU/GPU power)

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

XSCREENSAVER_WINDOW

The window ID to use with --root.

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

## COPYRIGHT
Copyright © 2002 by Calum Robinson. 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
OSX screen saver by Calum Robinson <calumr@mac.com>

XScreenSaver port by Tobias Sargeant <tobias.sargeant@bigpond.com>

## POSTCARDS
If you really like it, send me a postcard (after all, you're getting this for free!). Please check this address by downloading the latest version of Flurry just before you send me a postcard - I may have moved.

Calum Robinson

133 Sydenham Avenue

Belfast

Northern Ireland

BT4 2DQ


fluxcore

title: fluxcore(6)

summary: screen saver.

text:
# fluxcore(6)

## NAME
fluxcore - screen saver.

## SYNOPSIS
fluxcore [--display host:display.screen] [--visual visual] [--window] [--root] [--delay number] [--speed number] [--scale number] [--fps]

## DESCRIPTION
Long range space-based energy transmission requires a flux core to amplify and concentrate energy.

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

--scale number

Frame buffer resolution. 0.5 means halve the resolution for better performance but lower quality output. Default 1.0, full quality.

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

XSCREENSAVER_WINDOW

The window ID to use with --root.

## SEE ALSO
X(1), xscreensaver(1), https://www.shadertoy.com/view/ltlSWf

## COPYRIGHT
Copyright © 2015 by Otavio Good. 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
Otavio Good.


flyingtoasters

title: flyingtoasters(6)

text:
# flyingtoasters(6)

## NAME
flyingtoasters - 3d space-age jet-powered flying toasters (and toast)

## SYNOPSIS
flyingtoasters [--display host:display.screen] [--visual visual] [--window] [--root] [--window-id number] [--delay number] [--speed number] [--ntoasters number] [--nslices number] [--no-texture] [--no-fog] [--wireframe] [--fps]

## DESCRIPTION
Draws a squadron of shiny 3D space-age jet-powered flying toasters, and associated toast, flying across your screen.

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

--window-id number

Draw on the specified window.

--delay number

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

--speed number

How fast the toasters fly. Larger for faster. Default: 1.0.

--ntoasters number

How many toasters to draw. Default 20.

--nslices number

How many slices of toast to draw. Default 25.

--no-texture

Turn off texture mapping (for slow machines.)

--no-fog

Turn off fog (do not fade out distant toasters.)

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

XSCREENSAVER_WINDOW

The window ID to use with --root.

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

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

The original After Dark flying toasters, with the fluffy white wings, were a trademark of Berkeley Systems. Berkeley Systems ceased to exist some time in 1998, having been gobbled up by Sierra Online, who were subsequently gobbled up by Flipside and/or Vivendi (it's hard to tell exactly what happened when.)

I doubt anyone even cares any more, but if they do, hopefully this homage, with the space-age 3D jet-plane toasters, will be considered different enough that whoever still owns the trademark to the fluffy-winged 2D bitmapped toasters won't get all huffy at us.

## AUTHOR
Code by Jamie Zawinski. Object models by Baconmonkey.


gears

title: gears(6)

text:
# gears(6)

## NAME
gears - draw interlocking gears, for xscreensaver.

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

## DESCRIPTION
This draws a set of rotating gears.

## OPTIONS
gears accepts the following options:

--window

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

--root

Draw on the root window.

--window-id number

Draw on the specified 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.

--count integer

How many gears to draw. Default: 0 for random.

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

XSCREENSAVER_WINDOW

The window ID to use with --root.

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

An earlier version of this program by Brian Paul was written in 1997; this version was rewritten from scratch by jwz in 2007.


geodesic

title: geodesic(6)

summary: animates a mesh geodesic sphere.

text:
# geodesic(6)

## NAME
geodesic - animates a mesh geodesic sphere.

## SYNOPSIS
geodesic [--display host:display.screen] [--visual visual] [--window] [--root] [--window-id number] [--mode mode] [--no-wander] [--no-spin] [--fps] [--delay number] [--speed number] [--count number]

## DESCRIPTION
Animates a mesh geodesic sphere of increasing and decreasing complexity. A geodesic sphere is an icosohedron whose equilateral faces are sub-divided into non-equilateral triangles to more closely approximate a sphere.

The animation shows the equilateral triangles subdivided into four coplanar equilateral triangles; and then inflated outward, causing the sub-triangles to no longer be equilateral, but to more closely approximate the surface of a sphere.

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

--window-id number

Draw on the specified window.

--mode mesh | solid | stellated | stellated2 | wire

Face/edge display style. Default mesh.

--wander | --no-wander

Whether the object should wander around the screen.

--spin | --no-spin

Whether the object should spin.

--fps | --no-fps

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

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

Depth (frequency) of the geodesic sphere. Default: 4.

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

XSCREENSAVER_WINDOW

The window ID to use with --root.

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

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


geodesicgears

title: geodesicgears(6)

summary: gears on the surface of a sphere.

text:
# geodesicgears(6)

## NAME
geodesicgears - gears on the surface of a sphere.

## SYNOPSIS
geodesicgears [--display host:display.screen] [--visual visual] [--window] [--root] [--window-id number] [--delay number] [--timeout number] [--labels] [--numbers] [--wireframe] [--wander] [--no-spin] [--fps]

## DESCRIPTION
A set of meshed gears arranged on the surface of a sphere.

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

--window-id number

Draw on the specified window.

--delay number

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

--timeout number

Duration before switching to a new model. 5 - 120 seconds. Default: 20.

--labels | --no-labels

Whether to show the number of gears and teeth. Default: no.

--numbers | --no-numbers

Whether to label the gears with ID numbers. Default: no.

--wireframe | --no-wireframe

Render in wireframe instead of solid.

--wander | --no-wander

Whether the object should wander around the screen.

--spin | --no-spin

Whether the object should spin.

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

XSCREENSAVER_WINDOW

The window ID to use with --root.

## SEE ALSO
X(1), xscreensaver(1), geodesic(6), pinion(6)

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


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] [--window-id number][--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.

--window-id number

Draw on the specified 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-settings(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.

XSCREENSAVER_WINDOW

The window ID to use with --root.

## SEE ALSO
X(1), xscreensaver(1) xscreensaver-settings(1), xscreensaver-getimage(6)

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

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] [--window-id number] [--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.

--window-id number

Draw on the specified 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.

XSCREENSAVER_WINDOW

The window ID to use with --root.

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


gimbalharmonics

title: gimbalharmonics(6)

summary: screen saver.

text:
# gimbalharmonics(6)

## NAME
gimbalharmonics - screen saver.

## SYNOPSIS
gimbalharmonics [--display host:display.screen] [--visual visual] [--window] [--root] [--delay number] [--speed number] [--scale number] [--fps]

## DESCRIPTION
Disc-based visualization of different frequencies next to each other.

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

--scale number

Frame buffer resolution. 0.5 means halve the resolution for better performance but lower quality output. Default 1.0, full quality.

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

XSCREENSAVER_WINDOW

The window ID to use with --root.

## SEE ALSO
X(1), xscreensaver(1), https://www.shadertoy.com/view/llS3zd

## COPYRIGHT
Copyright © 2015 by Otavio Good. 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
Otavio Good.


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] [--window-id number] [--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.

--window-id number

Draw on the specified 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.

XSCREENSAVER_WINDOW

The window ID to use with --root.

## 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] [--window-id number][--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.

--window-id number

Draw on the specified 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.

XSCREENSAVER_WINDOW

The window ID to use with --root.

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

http://www.mtoussaint.de/bits.html

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


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] [--window-id number] [-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.

--window-id number

Draw on the specified 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.

XSCREENSAVER_WINDOW

The window ID to use with --root.

## 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] [--window-id number] [--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.

--window-id number

Draw on the specified 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.

XSCREENSAVER_WINDOW

The window ID to use with --root.

## 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] [--window-id number] [--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.

--window-id number

Draw on the specified 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.

XSCREENSAVER_WINDOW

The window ID to use with --root.

## 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] [--window-id number][--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.

--window-id number

Draw on the specified 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.

XSCREENSAVER_WINDOW

The window ID to use with --root.

## 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] [--window-id number] [--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.

--window-id number

Draw on the specified 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.

XSCREENSAVER_WINDOW

The window ID to use with --root.

## SEE ALSO
X(1), xscreensaver(1) dymaxionmap(6) 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] [--window-id number] [--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 the Craig Reynolds Boids algorithm to simulate a 3D school of fish. 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.

--window-id number

Draw on the specified 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.

XSCREENSAVER_WINDOW

The window ID to use with --root.

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

https://www.red3d.com/cwr/boids

## 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] [--window-id number] [--duration seconds] [--transition seconds] [--pan seconds] [--fade seconds] [--letterbox | --clip] [--zoom percent] [--titles] [--delay usecs] [--fps] [--verbose] [--debug] [--wireframe]

## DESCRIPTION
Displays a slideshow of images, with panning, zooming and crossfading effects.

To specify the directory that images are loaded from, run xscreensaver-settings(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.

--window-id number

Draw on the specified window.

--duration seconds

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

--transition seconds

When a new image is loaded, it transitions onto the screen by sliding in from the edges, spinning or flipping. This is how long that transition takes. Set it to 0 to disable the transition effects. Default 3 seconds.

--pan seconds

Once an image has been loaded, it is panned, zoomed and cross-faded against itself. This is how fast those pans are. Set this to 0 to disable the panning-and-crossfading effect. Default 6 seconds.

--fade seconds

When zooming and cross-fading, this is how long the "fade" portion takes. This value must be less than the "pan" option (it is inclusive). Set this to 0 to disable the panning-and-crossfading effect. Default 2 seconds.

--letterbox

Whether to fit the image on the screen (adding horizontal or vertical black bars) or to fill the screen (cropping the image). This is the default.

--clip

The opposite of --letterbox.

--zoom number

Zoom in on the image a little bit. This applies both to "transitions" and to "panning-and-crossfading". Default: 75, meaning that 75% or more of each image will always be visible. If you always want to see 100% of every image, then use "letterbox" and set "zoom" to 100%.

--titles

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

--delay number

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

--fps

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

--verbose

Prints debugging info to stderr.

--debug

Draw some diagnostic rectangles.

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

XSCREENSAVER_WINDOW

The window ID to use with --root.

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

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


glsnake

title: glsnake(6)

text:
# glsnake(6)

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

## SYNOPSIS
glsnake [--display host:display.screen] [--window] [--root] [--window-id number] [--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.

--window-id number

Draw on the specified 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.

XSCREENSAVER_WINDOW

The window ID to use with --root.

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

https://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] [--window-id number] [--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.

--window-id number

Draw on the specified 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.

XSCREENSAVER_WINDOW

The window ID to use with --root.

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

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


goldenapollian

title: goldenapollian(6)

summary: screen saver.

text:
# goldenapollian(6)

## NAME
goldenapollian - screen saver.

## SYNOPSIS
goldenapollian [--display host:display.screen] [--visual visual] [--window] [--root] [--delay number] [--speed number] [--scale number] [--fps]

## DESCRIPTION
Enter the golden fractal doorways.

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

--scale number

Resolution. 0.1 - 1.0. Default: 1.0.

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

XSCREENSAVER_WINDOW

The window ID to use with --root.

## SEE ALSO
X(1), xscreensaver(1), https://www.shadertoy.com/view/WlcfRS

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


gravitywell

title: gravitywell(6)

summary: spaaaaace.

text:
# gravitywell(6)

## NAME
gravitywell - spaaaaace.

## SYNOPSIS
gravitywell [--display host:display.screen] [--visual visual] [--window] [--root] [--window-id number] [--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.

--window-id number

Draw on the specified 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.

XSCREENSAVER_WINDOW

The window ID to use with --root.

## 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] [--window-id number] [--delay number] [--speed number] [--spin [XYZ]] [--no-wander] [--no-mask] [--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.

--window-id number

Draw on the specified 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.

--mask | --no-mask

Mask Headroom.

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

XSCREENSAVER_WINDOW

The window ID to use with --root.

## 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; suit model by Jared Williams.


hexplasma

title: hexplasma(6)

summary: hexagon plasma screen saver.

text:
# hexplasma(6)

## NAME
hexplasma - hexagon plasma screen saver.

## SYNOPSIS
hexplasma [--display host:display.screen] [--visual visual] [--window] [--root] [--delay number] [--speed number] [--scale number] [--fps]

## DESCRIPTION
A hexagon in a plasma field.

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

--scale number

Frame buffer resolution. 0.5 means halve the resolution for better performance but lower quality output. Default 1.0, full quality.

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

XSCREENSAVER_WINDOW

The window ID to use with --root.

## SEE ALSO
X(1), xscreensaver(1), https://www.shadertoy.com/view/3fy3z3

## COPYRIGHT
Copyright © 2025 by Nemerix. 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
Nemerix, 2025.


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] [--window-id number] [--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.

--window-id number

Draw on the specified 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.

XSCREENSAVER_WINDOW

The window ID to use with --root.

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


hextrail

title: hextrail(6)

summary: screen saver.

text:
# hextrail(6)

## NAME
hextrail - screen saver.

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

## DESCRIPTION
A network of colorful lines grows upon a hexagonal substrate.

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

Frame rate. 0 - 100000. Default: 30000.

--speed number

Speed. 0.1 - 20. Default: 1.0.

--count number

Hexagon Size. 2 - 80. Default: 20.

--thickness number

Line Thickness. 0.01 - 0.5. Default: 0.15.

--no-wander | --no--no-wander

Wander. Boolean.

--no-spin | --no--no-spin

Spin. Boolean.

--wireframe | --no--wireframe

Wireframe. Boolean.

--fps | --no--fps

Show frame rate. Boolean.

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

XSCREENSAVER_WINDOW

The window ID to use with --root.

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

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


highvoltage

title: highvoltage(6)

summary: high voltage transmission towers.

text:
# highvoltage(6)

## NAME
highvoltage - high voltage transmission towers.

## SYNOPSIS
highvoltage [--display host:display.screen] [--visual visual] [--window] [--root] [--delay number] [--speed number] [--spacing number] [--count number]

## DESCRIPTION
A leisurely flight past some high voltage transmission towers. Smell the ozone!

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

--spacing number

Spacing between towers. 2.0 means twice as far, 0.5 means half as far.

--count number

Number of towers rendered. 1 - 40. Default: 7.

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

XSCREENSAVER_WINDOW

The window ID to use with --root.

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

## COPYRIGHT
Copyright © 2024 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] [--window-id number] [--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.

--window-id number

Draw on the specified 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.

XSCREENSAVER_WINDOW

The window ID to use with --root.

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