attraction

title: attraction(6)

summary: interactions of opposing forces

text:
# attraction(6)

## NAME
attraction - interactions of opposing forces

## SYNOPSIS
attraction [-display host:display.screen] [-foreground color] [-background color] [-window] [-root] [-mono] [-install] [-visual visual] [-points int] [-threshold int] [-mode balls | lines | polygons | splines | filled-splines | tails ] [-size int] [-segments int] [-delay usecs] [-color-shift int] [-radius int] [-vx int] [-vy int] [-glow] [-noglow] [-orbit] [-viscosity float] [-walls] [-nowalls] [-maxspeed] [-nomaxspeed] [-correct-bounce] [-fast-bounce] [-fps]

## DESCRIPTION
The attraction program has several visually different modes of operation, all of which are based on the interactions of a set of control points which attract each other up to a certain distance, and then begin to repel each other. The attraction/repulsion is proportional to the distance between any two particles.

## OPTIONS
attraction accepts the following options:

-window

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

-root

Draw on the root window.

-mono

If on a color display, pretend we're on a monochrome display.

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

-points integer

How many control points should be used, or 0 to select the number randomly. Default 0. Between 3 and 15 works best.

-threshold integer

The distance (in pixels) from each particle at which the attractive force becomes repulsive. Default 100.

-mode balls | lines | polygons | tails | splines | filled-splines

In balls mode (the default) the control points are drawn as filled circles. The larger the circle, the more massive the particle. In lines mode, the control points are connected by straight lines; the effect is something like qix.

In polygons mode, the control points are connected by straight lines, and filled in. This is most interesting in color.

In splines mode, a closed spline is interpolated from the control points.

In filled-splines mode, the splines are filled in instead of being outlines. This is most interesting in color.

In tails mode, the path which each particle follows is indicated by a worm-like trail, whose length is controlled by the segments parameter.

-size integer

The size of the balls in pixels, or 0, meaning to select the sizes randomly (the default.) If this is specified, then all balls will be the same size. This option has an effect in all modes, since the ``size'' of the balls controls their mass.

-segments integer

If in lines or polygons mode, how many sets of line segments or polygons should be drawn. Default 500. This has no effect in balls mode. If segments is 0, then no segments will ever be erased (this is only useful in color.)

-delay microseconds

How much of a delay should be introduced between steps of the animation. Default 10000, or about 0.01 seconds.

-color-shift int

If on a color display, the color of the line segments or polygons will cycle through the color map. This specifies how many lines will be drawn before a new color is chosen. (When a small number of colors are available, increasing this value will yield smoother transitions.) Default 3. This has no effect in balls mode.

-radius

The size in pixels of the circle on which the points are initially positioned. The default is slightly smaller than the size of the window.

-glow

This is consulted only in balls mode. If this is specified, then the saturation of the colors of the points will vary according to their current acceleration. This has the effect that the balls flare brighter when they are reacting to each other most strongly. In glow mode, all of the balls will be drawn the same (random) color, modulo the saturation shifts. In non-glow mode, the balls will each be drawn in a random color that doesn't change.

-noglow

Don't do ``glowing.'' This is the default.

-vx pixels

-vy pixels

Initial velocity of the balls. This has no effect in -orbit mode.

-orbit

Make the initial force on each ball be tangential to the circle on which they are initially placed, with the right velocity to hold them in orbit about each other. After a while, roundoff errors will cause the orbit to decay.

-vmult float

In orbit mode, the initial velocity of the balls is multiplied by this; a number less than 1 will make the balls pull closer together, and a larger number will make them move apart. The default is 0.9, meaning a slight inward pull.

-viscosity float

This sets the viscosity of the hypothetical fluid through which the control points move; the default is 1, meaning no resistance. Values higher than 1 aren't interesting; lower values cause less motion. One interesting thing to try is

```
attraction -viscosity 0.8 -points 300 -size 10 -geometry =500x500

```

Give it a few seconds to settle down into a stable clump, and then move the drag the mouse through it to make "waves".

-nowalls

This will cause the balls to continue on past the edge of the screen or window. They will still be kept track of and can come back.

-walls

This will cause the balls to bounce when they get to the edge of the screen or window. This is the default behavior.

-maxspeed

Imposes a maximum speed (default). If a ball ends up going faster than this, it will be treated as though there were .9 viscosity until it is under the limit. This stops the balls from continually accelerating (which they have a tendency to do), but also causes balls moving very fast to tend to clump in the lower right corner.

-nomaxspeed

If this is specified, no maximum speed is set for the balls.

-fast-bounce

Uses the old, simple bouncing algorithm (default). This simply moves any ball that is out of bounds back to a wall and reverses its velocity. This works fine for most cases, but under some circumstances, the simplification can lead to annoying effects.

-correct-bounce

Uses a more intelligent bouncing algorithm. This method actually reflects the balls off the walls until they are within bounds. This can be slow if balls are bouncing a whole lot, perhaps because of -nomaxspeed.

-graphmode none | x | y | both | speed

For "x", "y", and "both", displays the given velocities of each ball as a bar graph in the same window as the balls. For "speed", displays the total speed of each ball. Default is "none".

-fps

Display the current frame rate and CPU load.

## ENVIRONMENT
DISPLAY to get the default host and display number.

XENVIRONMENT

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

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

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

## AUTHOR
Jamie Zawinski <jwz@jwz.org>, 13-aug-92.

Viscosity support by Philip Edward Cutone, III.

Walls, speed limit options, new bouncing, graphs, and tail mode fix by Matthew Strait. 31 March 2001


binaryring

package: xscreensaver-modules

title: binaryring(6)

text:
# binaryring(6)

## NAME
binaryring - A system of path tracing particles evolves continuously from an initial creation.

## SYNOPSIS
binaryring [-fps] [-install] [-noinstall] [-mono] [-root] [-visual visual] [-window] [-window-id window-id] [-color] [-no-color] [-growth-delay delayms] [-particle-number particles] [-ring-radius radius]

## DESCRIPTION
A system of path tracing particles evolves continuously from an initial circular creation. Ages of darkness play arbitrarily with ages of light.

Ported (with some extensions) from the code by J. Tarbell at http://complexification.net

## OPTIONS
binaryring accepts the following options:

-fps

Display the current frame rate and CPU load.

-install

Install a private colormap for the window.

-mono

If on a color display, pretend we're on a monochrome display.

-noinstall

Don't install a private colormap for the window.

-root

Draw on the root window.

-visual visual

Specify which visual to use. Legal values are the name of a visual class or the id number (decimal or hex) of a specific visual.

-window

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

-window-id window-id

Specify which window id to use.

-color (Default)

Particles have random generated colors that gradually change over time.

-no-color

Use the original black and white visualization.

-growth-delay delayms (Default: 10000)

Delay in ms between growth cycles. More delay, slower (but less CPU intensive).

-particles-number particles (Default: 5000)

The number of particles in the system. With more particles the fps can also be affected.

-ring-radius radius (Default: 40)

The radius of the ring where the particles are born, in pixels.

## ENVIRONMENT
DISPLAY

to get the default host and display number.

XENVIRONMENT

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

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

## COPYRIGHT
Copyright © 2003 by J. Tarbell (complex@complexification.net, http://www.complexification.net).

Ported to XScreensaver by Emilio Del Tessandoro (emilio.deltessa@gmail.com)

## AUTHOR
J. Tarbell <complex@complexification.net>, Jun-03

Emilio Del Tessandoro <emilio.deltessa@gmail.com>, Aug-14


blaster

title: blaster(6)

summary: simulation of space combat

text:
# blaster(6)

## NAME
blaster - simulation of space combat

## SYNOPSIS
blaster [-display host:display.screen] [-visual visual] [-window] [-root] [-num_robots number] [-num_lasers number] [-num_stars number] [-delay number] [-fps]

## DESCRIPTION
Draws a simulation of flying space-combat robots (cleverly disguised as colored circles) doing battle in front of a moving star 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.

-num_robots number

Robots. 2 - 50. Default: 5.

-num_lasers number

Lasers. 1 - 100. Default: 3.

-num_stars number

Stars. 5 - 200. Default: 50.

-delay number

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

-fps

Display the current frame rate and CPU load.

## ENVIRONMENT
DISPLAY

to get the default host and display number.

XENVIRONMENT

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

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

## COPYRIGHT
Copyright © 2002 by Jonathan Lin. 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
Jonathan Lin.


blitspin

title: blitspin(6)

summary: rotate a bitmap in an interesting way

text:
# blitspin(6)

## NAME
blitspin - rotate a bitmap in an interesting way

## SYNOPSIS
blitspin [-display host:display.screen] [-foreground color] [-background color] [-window] [-root] [-mono] [-install] [-visual visual] [-bitmap filename] [-delay usecs] [-delay2 usecs] [-duration secs]

## DESCRIPTION
The blitspin program repeatedly rotates a bitmap by 90 degrees by using logical operations: the bitmap is divided into quadrants, and the quadrants are shifted clockwise. Then the same thing is done again with progressively smaller quadrants, except that all sub-quadrants of a given size are rotated in parallel. So this takes O(16*log2(N)) blits of size NxN, with the limitation that the image must be square, and the size must be a power of 2.

## OPTIONS
blitspin accepts the following options:

-window

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

-root

Draw on the root window.

-mono

If on a color display, pretend we're on a monochrome display.

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

-bitmap filename

The file name of a bitmap to rotate. It need not be square: it will be padded with the background color. If unspecified or the string (default), a builtin bitmap is used. If support for the XPM library was enabled at compile-time, the specified file may be in XPM format as well as XBM, and thus may be a color image.

The *bitmapFilePath resource will be searched if the bitmap name is not a fully-qualified pathname.

-grab-screen

If this option is specified, then the image which is spun will be grabbed from the portion of the screen underlying the blitspin window, or from the system's video input, or from a random file on disk, as indicated by the grabDesktopImages, grabVideoFrames, and chooseRandomImages options in the ~/.xscreensaver file; see xscreensaver-demo(1) for more details.

-delay microseconds

How long to delay between steps of the rotation process, in microseconds. Default is 500000, one-half second.

-duration seconds

How long to run before loading a new image. Default 120 seconds.

-delay2 microseconds

How long to delay between each 90-degree rotation, in microseconds. Default is 500000, one-half second. DISPLAY to get the default host and display number.

-fps

Display the current frame rate and CPU load.

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

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

## COPYRIGHT
Copyright © 1992, 1993, 1997, 2001 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>, 17-aug-92.

Based on SmallTalk code which appeared in the August 1981 issue of Byte magazine.


bouboule

title: bouboule(6)

summary: draws spinning 3D blobs

text:
# bouboule(6)

## NAME
bouboule - draws spinning 3D blobs

## SYNOPSIS
bouboule [-display host:display.screen] [-foreground color] [-background color] [-window] [-root] [-mono] [-install] [-visual visual] [-ncolors integer] [-delay microseconds] [-cycles integer] [-count integer] [-3d]

[-fps]

## DESCRIPTION
The bouboule program draws spinning 3D blobs.

## OPTIONS
bouboule accepts the following options:

-window

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

-root

Draw on the root window.

-mono

If on a color display, pretend we're on a monochrome display.

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

-ncolors integer

How many colors should be used (if possible). Default 64. The colors used cycle through the hue, making N stops around the color wheel.

-cycles integer

-count integer

-3d

Do red/blue 3d separations (for 3d glasses.)

-fps

Display the current frame rate and CPU load.

## ENVIRONMENT
DISPLAY

to get the default host and display number.

XENVIRONMENT

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

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

## COPYRIGHT
Copyright © 1996 by Jeremie Petit.

Permission to use, copy, modify, and distribute this software and its documentation for any purpose and without fee is hereby granted, provided that the above copyright notice appear in all copies and that both that copyright notice and this permission notice appear in supporting documentation.

## AUTHOR
Jeremie Petit <jpetit@essi.fr>, 1996.

3D support by Henrik Theiling <theiling@coli-uni-sb.de>, 04-Sep-96.

VMS support by Jouk Jansen <joukj@alpha.chem.uva.nl>, 01-Feb-96.

TrueColor support by David Bagley <bagleyd@bigfoot.com>, 01-Feb-96.

Ability to run standalone or with xscreensaver added by Jamie Zawinski <jwz@jwz.org>, 15-May-97.


boxfit

title: boxfit(6)

text:
# boxfit(6)

## NAME
boxfit - fills space with a gradient of growing boxes or circles.

## SYNOPSIS
boxfit [-display host:display.screen] [-visual visual] [-window] [-root] [-delay usecs] [-count int] [-growby int] [-spacing int] [-border int] [-circles | -squares | -random] [-grab] [-peek] [-fps]

## DESCRIPTION
Packs the screen with growing boxes or circles, colored according to a horizontal or vertical gradient. The objects grow until they touch, then stop. When the screen is full, they shrink away and the process restarts.

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

How much of a delay should be introduced between steps of the animation. Default 20000, or about 0.02 seconds.

-count int

How many boxes or circles to animate simultaneously; default 50. Smaller numbers yield larger boxes/circles.

-growby int

How many pixels the objects should grow by, each frame. Default 1.

-spacing int

How many pixels of space should be left between the objects. Default 1.

-border int

Thickness of the colored border around each object. Default 1.

-circles | -squares | -random

Draw circles, squares, or choose randomly (the default).

-grab

Normally it colors the boxes with a horizontal or vertical gradient. If -grab is specified, it will instead load a random image, and color the boxes according to the colors in that image. As the picture fills in, some features of the underlying image may become recognisable. When grabbing images, the image will be grabbed from the portion of the screen underlying the window, or from the system's video input, or from a random file on disk, as indicated by the grabDesktopImages, grabVideoFrames, and chooseRandomImages options in the ~/.xscreensaver file; see xscreensaver-demo(1) for more details.

-peek

This option says to briefly show you the underlying image before beginning. The default is not to show the unadulterated image at all. (This only has an effect when -grab is used.)

-fps

Display the current frame rate and CPU load.

## ENVIRONMENT
DISPLAY

to get the default host and display number.

XENVIRONMENT

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

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

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


braid

title: braid(6)

text:
# braid(6)

## NAME
braid - draws random color-cycling braids around a circle

## SYNOPSIS
braid [-display host:display.screen] [-foreground color] [-background color] [-window] [-root] [-mono] [-install] [-visual visual] [-ncolors integer] [-delay microseconds] [-cycles integer] [-count integer]

[-fps]

## DESCRIPTION
The braid program draws random color-cycling braids around a circle.

## OPTIONS
braid accepts the following options:

-window

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

-root

Draw on the root window.

-mono

If on a color display, pretend we're on a monochrome display.

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

-ncolors integer

How many colors should be used (if possible). Default 64. The colors used cycle through the hue, making N stops around the color wheel.

-cycles integer

-count integer

-fps

Display the current frame rate and CPU load.

## ENVIRONMENT
DISPLAY

to get the default host and display number.

XENVIRONMENT

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

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

## COPYRIGHT
Copyright © 1995 by John Neil.

Permission to use, copy, modify, and distribute this software and its documentation for any purpose and without fee is hereby granted, provided that the above copyright notice appear in all copies and that both that copyright notice and this permission notice appear in supporting documentation.

## AUTHOR
John Neil <neil@math.idbsu.edu>, 29-Aug-95.

Ability to run standalone or with xscreensaver added by Jamie Zawinski <jwz@jwz.org>, 10-May-97.


bsod

title: bsod(6)

summary: Blue Screen of Death emulator

text:
# bsod(6)

## NAME
bsod - Blue Screen of Death emulator

## SYNOPSIS
bsod [-display host:display.screen] [-foreground color] [-background color] [-window] [-root] [-mono] [-install] [-visual visual] [-delay seconds] [-fps]

## DESCRIPTION
The bsod program is the finest in personal computer emulation.

bsod steps through a set of screens, each one a recreation of a different failure mode of an operating system. Systems depicted include Windows 3.1, Windows 95, Windows NT, MS-DOS, AmigaDOS 1.3, Linux, SCO UNIX, BSD UNIX, HPUX, Solaris, Tru64, VMS, HVX/GCOS6, IBM OS/390, OS/2, MacOS (MacsBug, Bomb, Sad Mac, and OSX), Atari ST, Apple ][+, VMware and NCD X Terminals.

## OPTIONS
bsod accepts the following options:

-window

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

-root

Draw on the root window.

-mono

If on a color display, pretend we're on a monochrome display.

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

The duration each crash-mode is displayed before selecting another.

-only which

Tell it to run only one mode, e.g., -only HPUX.

-fps

Display the current frame rate and CPU load.

## ENVIRONMENT
DISPLAY

to get the default host and display number.

XENVIRONMENT

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

## X RESOURCES
Notable X resources supported include the following, which control which hacks are displayed and which aren't. doWindows, doNT, doWin2K, doWin10, doRansomware, doAmiga, doMac, doMac1, doMacsBug, doMacX, doSCO, doAtari, doBSD, doLinux, doSparcLinux, doHPPALinux, doBlitDamage, doSolaris, doHPUX, doApple2, doOS390, doTru64, doVMS, doMSDOS, doOS2, doHVX, doVMware, and doATM. Each of these is a Boolean resource, they all default to true, except for doAtari, doBSD, doSparcLinux, and doHPPALinux, which are turned off by default, because they're really not all that interesting looking unless you're a fan of those systems.

There are command-line options for all of these: e.g., -bsd, -no-bsd. (Also note the -only option.)

## BUGS
Unlike the systems being simulated, bsod does not require a reboot after running.

## SEE ALSO
X(1), xscreensaver(1), http://www.microsoft.com/, http://www.apple.com/, http://www.sco.com/, http://www.kernel.org/, and http://www.amiga.de/.

## TRADEMARKS
Microsoft Windows, Microsoft Windows 95, and Microsoft Windows NT are all registered trademarks of Microsoft Corporation. Apple Macintosh is a registered trademark of Apple Computer. Amiga is a registered trademark of Amiga International, Inc. Solaris is a trademark of Sun Microsystems. HP-UX is a trademark of HP Hewlett Packard Group LLC. Nvidia is a tradmark of Nvidia Corporation. VMS is probably a trademark of Digital Equipment Corporation. Atari ST is probably a trademark, too, but it's hard to tell who owns it. SCO is probably still a trademark of somebody these days, I guess. Linux is a registered trademark of Linus Torvalds, but it isn't his fault. OS/2 is a registered trademark of International Business Machines Corporation. VMware is a registered trademark of VMware, Inc. Android is a trademark of Google LLC. GladOS is a trademark of Aperture Science Incorporated.

## COPYRIGHT
Copyright © 1998-2018 by Jamie Zawinski. Permission to use, copy, modify, distribute, and sell this software and its documentation for any purpose is hereby granted without fee, provided that the above copyright notice appear in all copies and that both that copyright notice and this permission notice appear in supporting documentation. No representations are made about the suitability of this software for any purpose. It is provided "as is" without express or implied warranty. No animals were harmed during the testing of these simulations. Always mount a scratch monkey.

## AUTHOR
Concept cribbed from Stephen Martin <smartin@mks.com>. This version is by Jamie Zawinski <jwz@jwz.org>, with contributions from many others.


bumps

title: bumps(6)

text:
# bumps(6)

## NAME
bumps - move distorting spotlight around desktop

## SYNOPSIS
bumps [-display host:display.screen] [-foreground color] [-background color] [-window] [-root] [-mono] [-install] [-visual visual] [-delay usecs] [-duration secs] [-fps]

## DESCRIPTION
The bumps program takes an image and exposes small, distorted sections of it as if through an odd wandering spotlight beam.

The image that it manipulates will be grabbed from the portion of the screen underlying the window, or from the system's video input, or from a random file on disk, as indicated by the grabDesktopImages, grabVideoFrames, and chooseRandomImages options in the ~/.xscreensaver file; see xscreensaver-demo(1) for more details.

## OPTIONS
bumps accepts the following options:

-window

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

-root

Draw on the root window.

-mono

If on a color display, pretend we're on a monochrome display.

-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

Slow it down.

-duration seconds

How long to run before loading a new image. Default 120 seconds.

-fps

Display the current frame rate and CPU load.

## ENVIRONMENT
DISPLAY

to get the default host and display number.

XENVIRONMENT

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

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

## COPYRIGHT
Copyright © 1999 by Shane Smit. 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.

## CREDITS
Shane Smit <blackend@inconnect.com>, 8-Oct-1999.


ccurve

title: ccurve(6)

summary: self-similar linear fractals.

text:
# ccurve(6)

## NAME
ccurve - self-similar linear fractals.

## SYNOPSIS
ccurve [-display host:display.screen] [-visual visual] [-window] [-root] [-delay number] [-pause number] [-limit number] [-fps]

## DESCRIPTION
Generates self-similar linear fractals, including the classic ``C Curve.''

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

Delay. 0 - 60. Default: 1.

-pause number

Duration. 1 - 60. Default: 3.

-limit number

Density. 3 - 300000. Default: 200000.

-fps

Display the current frame rate and CPU load.

## ENVIRONMENT
DISPLAY

to get the default host and display number.

XENVIRONMENT

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

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

## COPYRIGHT
Copyright © 2002 by Rick Campbell. 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
Rick Campbell.


celtic

title: celtic(6)

summary: draws celtic cross-stich patterns

text:
# celtic(6)

## NAME
celtic - draws celtic cross-stich patterns

## SYNOPSIS
ifs [-display host:display.screen] [-visual visual] [-window] [-root] [-delay number] [-delay2 number] [-ncolors number] [-graph mode] [-fps]

## DESCRIPTION
The celtic program repeatedly draws random cross-stitch patterns.

## OPTIONS
-visual visual

Specify which visual to use. Legal values are the name of a visual class, or the id number (decimal or hex) of a specific visual.

-window

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

-root

Draw on the root window.

-delay number

Per-frame delay, in microseconds. Default: 10000.

-delay2 number

Delay between patterns, in seconds. Default: 5.

-ncolors number

Number of colours to use. Default: 20.

-graph

Whether to render the underlying graph. Default: no.

-fps

Display the current frame rate and CPU load.

## ENVIRONMENT
DISPLAY

to get the default host and display number.

XENVIRONMENT

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

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

## COPYRIGHT
Copyright © 2005 by Max Froumentin. 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
Max Froumentin <max@lapin-bleu.net>


cloudlife

title: cloudlife(6)

text:
# cloudlife(6)

## NAME
cloudlife - a cellular automaton based on Conway's Life

## SYNOPSIS
cloudlife [-display host:display.screen] [-foreground color] [-background color] [-window] [-root] [-mono] [-install] [-visual visual] [-ncolors integer] [-cycle-delay microseconds] [-cycle-colors integer][-cell-size integer] [-initial-density integer] [-max-age integer]

[-fps]

## DESCRIPTION
The cloudlife program draws a cellular automaton based on Conway's Life, except that cells have a maximum age, and only one pixel per cell is drawn every tick.

## OPTIONS
cloudlife accepts the following options:

-window

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

-root

Draw on the root window.

-mono

If on a color display, pretend we're on a monochrome display.

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

-cycle-delay integer

Time in microseconds to sleep between ticks. Default 25000.

-cycle-colors integer

How many ticks should elapse between cycling colors. 0 to disable color cycling. Default 2.

-ncolors integer

How many colors should be used (if possible). Default 64. The colors are chosen randomly.

-cell-size integer

Size of each cell, in powers of 2. Default 3 (8-pixel cells).

-initial-density integer

Percentage of cells that are alive at start and when the field is repopulated. Default 30.

-max-age integer

Maximum age for a cell. Default 64.

-fps

Display the current frame rate and CPU load.

## ENVIRONMENT
DISPLAY

to get the default host and display number.

XENVIRONMENT

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

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

## COPYRIGHT
Copyright © 2003 by Don Marti. Based on examples from the hacks directory of xscreensaver, Copyright (c) 1997, 1998, 2002 Jamie Zawinski <jwz@jwz.org>

This man page based on the man page of sierpinski, Copyright © 1996 by Desmond Daignault.

Permission to use, copy, modify, and distribute this software and its documentation for any purpose and without fee is hereby granted, provided that the above copyright notice appear in all copies and that both that copyright notice and this permission notice appear in supporting documentation.

## AUTHOR
Don Marti <dmarti@zgp.org> 20 May 2003.


compass

title: compass(6)

summary: draws a spinning compass.

text:
# compass(6)

## NAME
compass - draws a spinning compass.

## SYNOPSIS
compass [-display host:display.screen] [-visual visual] [-window] [-root] [-delay number] [-no-db] [-fps]

## DESCRIPTION
This draws a compass, with all elements spinning about randomly, for that ``lost and nauseous'' feeling.

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

-db | -no-db

Double Buffer. Boolean.

-fps

Display the current frame rate and CPU load.

## ENVIRONMENT
DISPLAY

to get the default host and display number.

XENVIRONMENT

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

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

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


coral

title: coral(6)

text:
# coral(6)

## NAME
coral - simulates coral growth, albeit somewhat slowly.

## SYNOPSIS
coral [-display host:display.screen] [-visual visual] [-window] [-root] [-delay2 number] [-delay number] [-density number] [-seeds number] [-fps]

## DESCRIPTION
Simulates coral growth, albeit somewhat slowly.

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

-delay2 number

Per-frame delay, in microseconds. Default: 1000 (0.001 seconds.).

-delay number

Duration. 1 - 60. Default: 5.

-density number

Density. 1 - 90. Default: 25.

-seeds number

Seeds. 1 - 100. Default: 20.

-fps

Display the current frame rate and CPU load.

## ENVIRONMENT
DISPLAY

to get the default host and display number.

XENVIRONMENT

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

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

## COPYRIGHT
Copyright © 2002 by Frederick Roeber. 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
Frederick Roeber.


crystal

title: crystal(6)

summary: kaleidescope.

text:
# crystal(6)

## NAME
crystal - kaleidescope.

## SYNOPSIS
crystal [-display host:display.screen] [-visual visual] [-window] [-root] [-grid] [-no-cell] [-centre] [-nx number] [-ny number] [-count number] [-delay number] [-ncolors number] [-fps]

## DESCRIPTION
Moving polygons, similar to a kaleidescope (more like a kaleidescope than the hack called `kaleid,' actually.)

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

-grid | -no-grid

Whether to draw grid.

-cell | -no-cell

Whether to draw the cell.

-centre | -no-centre

Whether to center on screen

-nx number

Horizontal Symmetries. -10 - 10. Default: -3.

-ny number

Vertical Symmetries. -10 - 10. Default: -3.

-count number

Count. -5000 - 5000. Default: -500.

-delay number

Per-frame delay, in microseconds. Default: 60000 (0.06 seconds.).

-ncolors number

Number of Colors. Default: 100.

-fps

Display the current frame rate and CPU load.

## ENVIRONMENT
DISPLAY

to get the default host and display number.

XENVIRONMENT

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

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

## COPYRIGHT
Copyright © 2002 by Jouk Jansen. 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
Jouk Jansen.


cwaves

title: cwaves(6)

summary: languid sinusoidal colors

text:
# cwaves(6)

## NAME
cwaves - languid sinusoidal colors

## SYNOPSIS
cwaves [-display host:display.screen] [-foreground color] [-background color] [-window] [-root] [-mono] [-install] [-visual visual] [-delay usecs] [-waves int] [-colors int] [-fps]

## DESCRIPTION
The cwaves program draws a languidly-scrolling vertical field of sinusoidal colors.

## OPTIONS
cwaves accepts the following options:

-window

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

-root

Draw on the root window.

-mono

If on a color display, pretend we're on a monochrome display.

-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 20000, or about 1/50th second.

-waves int

How many cosines to add together. The more waves, the more complex the apparent motion.

-colors int

How many colors to use. Default 800. The more colors, the smoother the blending will be.

-fps

Display the current frame rate and CPU load.

## ENVIRONMENT
DISPLAY

to get the default host and display number.

XENVIRONMENT

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

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

## COPYRIGHT
Copyright © 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 <jwz@jwz.org>, 2-Jul-2007.


cynosure

title: cynosure(6)

text:
# cynosure(6)

## NAME
cynosure - gentle overlapping squares screen saver.

## SYNOPSIS
cynosure [-display host:display.screen] [-visual visual] [-window] [-root] [-delay number] [-ncolors number] [-iterations number] [-fps]

## DESCRIPTION
A hack similar to `greynetic', but less frenetic. The first implementation was by Stephen Linhart; then Ozymandias G. Desiderata wrote a Java applet clone. That clone was discovered by Jamie Zawinski, and ported to C for inclusion here.

## 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: 500000 (0.50 seconds.).

-ncolors number

Number of Colors. Default: 128.

-iterations number

Duration. 2 - 200. Default: 100.

-fps

Display the current frame rate and CPU load.

## ENVIRONMENT
DISPLAY

to get the default host and display number.

XENVIRONMENT

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

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

## COPYRIGHT
Copyright © 2002 by Stephen Linhart, Ozymandias G. Desiderata, 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
Stephen Linhart, Ozymandias G. Desiderata, and Jamie Zawinski.


decayscreen

title: decayscreen(6)

summary: make a screen meltdown.

text:
# decayscreen(6)

## NAME
decayscreen - make a screen meltdown.

## SYNOPSIS
decayscreen [-display host:display.screen] [-window] [-root] [-mono] [-install] [-visual visual] [-delay usecs] [-duration secs] [-mode mode] [-fps]

## DESCRIPTION
The decayscreen program creates a melting effect by randomly shifting rectangles around the screen.

The image that it manipulates will be grabbed from the portion of the screen underlying the window, or from the system's video input, or from a random file on disk, as indicated by the grabDesktopImages, grabVideoFrames, and chooseRandomImages options in the ~/.xscreensaver file; see xscreensaver-demo(1) for more details.

## OPTIONS
decayscreen accepts the following options:

-window

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

-root

Draw on the root window.

-mono

If on a color display, pretend we're on a monochrome display.

-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

Slow it down.

-duration seconds

How long to run before loading a new image. Default 120 seconds.

-mode mode

The direction in which the image should tend to slide. Legal values are random (meaning pick one), up, left, right, down, upleft, downleft, upright, downright, shuffle (meaning prefer no particular direction), in (meaning move things toward the center), out (meaning move things away from the center), melt (meaning melt straight downward), stretch (meaning stretch the screen downward), and fuzz (meaning go blurry instead of melty).

-fps

Display the current frame rate and CPU load.

## ENVIRONMENT
DISPLAY

to get the default host and display number.

XENVIRONMENT

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

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

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

## AUTHOR
Vivek Khera <khera@cs.duke.edu>, 05-Aug-93; based on code by David Wald, 1988. Modified by jwz, 28-Nov-1997. Modified by Rick Schultz <rick@skapunx.net> 05-Apr-1999. Modified by Vince Levey <vincel@vincel.org> 25-Oct-2001.


deco

title: deco(6)

summary: draw tacky 70s basement wall panelling

text:
# deco(6)

## NAME
deco - draw tacky 70s basement wall panelling

## SYNOPSIS
deco [-display host:display.screen] [-foreground color] [-background color] [-window] [-root] [-mono] [-install] [-visual visual] [-delay seconds] [-max-depth int] [-min-width int] [-min-height int] [-line-width yIint] [-smooth-colors] [-golden-ratio] [-mondrian] [-fps]

## DESCRIPTION
The deco program subdivides and colors rectangles randomly. It looks kind of like Brady-Bunch-era rec-room wall paneling. (Raven says: "This screensaver is ugly enough to peel paint.") Can also produce more aesthetically pleasing displays via options.

## OPTIONS
deco accepts the following options:

-window

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

-root

Draw on the root window.

-mono

If on a color display, pretend we're on a monochrome display.

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

How long to wait before starting over. Default 5 seconds.

-max-depth integer

How deep to subdivide. Default 12.

-min-width integer

-min-height integer

The size of the smallest rectangle to draw. Default 20x20.

-line-width integer

Width of lines drawn between rectangles. Default zero (minimal width).

-smooth-colors

-no-smooth-colors

Whether to use a smooth color palette instead of a random one. Less jarring. Default False.

-golden-ratio

-no-golden-ratio

Whether to subdivide rectangles using the golden ratio instead of 1/2. This ratio is supposed to be more aesthetically pleasing. Default false.

-mondrian

-no-mondrian

Whether to imitiate style of some famous paintings by Piet Mondrian. Overrides line-width and colormap options. Default false.

-fps

Display the current frame rate and CPU load.

## ENVIRONMENT
DISPLAY

to get the default host and display number.

XENVIRONMENT

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

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

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

## AUTHOR
Jamie Zawinski <jwz@jwz.org>, 26-Apr-97, based on code by Michael D. Bayne <mdb@go2net.com>. Golden ratio and Mondrian settings by Lars Huttar.


deluxe

title: deluxe(6)

text:
# deluxe(6)

## NAME
deluxe - pulsing sequence of stars, circles, and lines.

## SYNOPSIS
deluxe [-display host:display.screen] [-visual visual] [-window] [-root] [-delay number] [-thickness number] [-count number] [-ncolors number] [-transparent] [-no-db] [-fps]

## DESCRIPTION
This draws a pulsing sequence of stars, circles, and lines.

## 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: 5000 (0.01 seconds.).

-thickness number

Thickness of lines. Default: 50.

-count number

Number of objects. Default: 5.

-ncolors number

Number of colors. Default: 20.

-transparent | -no-transparent

Whether to use transparency.

-db | -no-db

Whether to double buffer.

-fps

Display the current frame rate and CPU load.

## ENVIRONMENT
DISPLAY

to get the default host and display number.

XENVIRONMENT

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

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

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


demon

title: demon(6)

summary: cellular automaton.

text:
# demon(6)

## NAME
demon - cellular automaton.

## SYNOPSIS
demon [-display host:display.screen] [-visual visual] [-window] [-root] [-count number] [-cycles number] [-delay number] [-ncolors number] [-size number] [-fps]

## DESCRIPTION
A cellular automaton that starts with a random field, and organizes it into stripes and spirals.

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

-count number

States. 0 - 20. Default: 0.

-cycles number

Timeout. 0 - 800000. Default: 1000.

-delay number

Per-frame delay, in microseconds. Default: 50000 (0.05 seconds.).

-ncolors number

Number of Colors. Default: 64.

-size number

Cell Size. -20 - 20. Default: -7.

-fps

Display the current frame rate and CPU load.

## ENVIRONMENT
DISPLAY

to get the default host and display number.

XENVIRONMENT

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

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

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


discrete

title: discrete(6)

text:
# discrete(6)

## NAME
discrete - discrete map iterative function fractal systems.

## SYNOPSIS
discrete [-display host:display.screen] [-visual visual] [-window] [-root] [-cycles number] [-delay number] [-ncolors number] [-fps]

## DESCRIPTION
More ``discrete map'' systems, including new variants of Hopalong and Julia, and a few others.

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

-cycles number

Timeout. 100 - 10000. Default: 2500.

-delay number

Per-frame delay, in microseconds. Default: 1000 (0.001 seconds.).

-ncolors number

Number of Colors. Default: 100.

-fps

Display the current frame rate and CPU load.

## ENVIRONMENT
DISPLAY

to get the default host and display number.

XENVIRONMENT

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

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

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

## AUTHOR
Tim Auckland.


distort

title: distort(6)

text:
# distort(6)

## NAME
distort - distort the content of the screen in interesting ways

## SYNOPSIS
distort [-root] [-window] [-mono] [-install] [-noinstall] [-visual visual] [-window-id window-id] [-delay usecs] [-duration secs] [-radius pixels] [-speed int] [-number int] [-swamp] [-bounce] [-reflect] [-vortex] [-magnify] [-blackhole] [-slow] [-shm] [-no-shm] [-fps]

## DESCRIPTION
The distort program takes an image and lets circular zones of distortion wander randomly around it, distorting what is under them. The mode of distortion and the overall behaviour of the zones can be influenced in various ways.

The image that it manipulates will be grabbed from the portion of the screen underlying the window, or from the system's video input, or from a random file on disk, as indicated by the grabDesktopImages, grabVideoFrames, and chooseRandomImages options in the ~/.xscreensaver file; see xscreensaver-demo(1) for more details.

## OPTIONS
distort accepts the following options:

-root

Draw on the root window.

-window

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

-mono

If on a color display, pretend we're on a monochrome display.

-install

Install a private colormap for the window.

-noinstall

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

-window-id window-id

Specify which window id to use.

-delay usecs

Specify the delay between subsequent animation frames in microseconds.

-duration seconds

How long to run before loading a new image. Default 120 seconds.

-radius pixels

Specify the radius of the distortion zone in pixels.

-speed int

Specify the speed at which the distortion zone moves, where 0 is slow, higher numbers are faster (10 is pretty fast.)

-number int

Specify the number of distortion zones.

-swamp

Instead of letting zones wander around, let small zones pop up like bubbles in a swamp and leave permanent distortion. WARNING: this option uses a colossal amount of memory: keep the -radius small when using -swamp.

-bounce

Let zones wander around and bounce off the window border. This is the default.

-reflect

Mode of distortion that resembles reflection by a cylindrical mirror.

-vortex

Whirlpool-shaped distortion. Way cool.

-magnify

This mode of distortion looks like a magnifying glass.

-blackhole

Suck your pixels beyond the event horizon. Favourite mode of Dr Stephen Hawking.

-slow

Make the zone wander slower.

-shm

Use shared memory extension.

-no-shm

Don't use shared memory extension.

-fps

Display the current frame rate and CPU load.

## ENVIRONMENT
DISPLAY

to get the default host and display number

XENVIRONMENT

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

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

## COPYRIGHT
Copyright © 1998 by Jonas Munsin 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.

## AUTHORS
Jonas Munsin <jmunsin@iki.fi> and Jamie Zawinski <jwz@jwz.org>. This manual page by Matthias Warkus <mawa@iname.com>, 17-Oct-1999.


drift

title: drift(6)

text:
# drift(6)

## NAME
drift - draws drifting recursive fractal cosmic flames

## SYNOPSIS
drift [-display host:display.screen] [-foreground color] [-background color] [-window] [-root] [-mono] [-install] [-visual visual] [-ncolors integer] [-delay microseconds] [-count integer] [-grow] [-no-grow] [-liss] [-no-liss]

[-fps]

## DESCRIPTION
The drift program draws drifting recursive fractal cosmic flames

## OPTIONS
drift accepts the following options:

-window

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

-root

Draw on the root window.

-mono

If on a color display, pretend we're on a monochrome display.

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

-ncolors integer

How many colors should be used (if possible). Default 200. The colors used cycle through the hue, making N stops around the color wheel.

-count integer

-grow

-no-grow

Whether fractals should grow; otherwise, they are animated.

-liss

-no-liss

Whether we should use lissajous figures to get points.

-fps

Display the current frame rate and CPU load.

## ENVIRONMENT
DISPLAY

to get the default host and display number.

XENVIRONMENT

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

## SEE ALSO
flame(6), X(1), xscreensaver(1), xlock(1)

## COPYRIGHT
Copyright © 1991, 1995 by Scott Draves.

Permission to use, copy, modify, and distribute this software and its documentation for any purpose and without fee is hereby granted, provided that the above copyright notice appear in all copies and that both that copyright notice and this permission notice appear in supporting documentation.

## AUTHOR
Scott Draves <spot@cs.cmu.edu>, 06-Jun-91, 01-Jun-95.

Ability to run standalone or with xscreensaver added by Jamie Zawinski <jwz@jwz.org>, 10-May-97.


epicycle

title: epicycle(6)

text:
# epicycle(6)

## NAME
epicycle - draws a point moving around a circle which moves around a cicle which...

## SYNOPSIS
epicycle [-display host:display.screen] [-root] [-window] [-mono] [-install] [-noinstall] [-visual viz] [-colors N] [-foreground name] [-color-shift N] [-delay microseconds] [-holdtime seconds] [-linewidth N] [-min_circles N] [-max_circles N] [-min_speed number] [-max_speed number] [-harmonics N] [-timestep number] [-divisor_poisson probability] [-size_factor_min number] [-size_factor_max number] [-fps]

## DESCRIPTION
The epicycle program draws the path traced out by a point on the edge of a circle. That circle rotates around a point on the rim of another circle, and so on, several times. The random curves produced can be simple or complex, convex or concave, but they are always closed curves (they never go in indefinitely).

You can configure both the way the curves are drawn and the way in which the random sequence of circles is generated, either with command-line options or X resources.

## OPTIONS
-display host:display.screen

Specifies which X display we should use (see the section DISPLAY NAMES in X(1) for more information about this option).

-root

Draw on the root window.

-window

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

-mono

If on a color display, pretend we're on a monochrome display. If we're on a mono display, we have no choice.

-install

Install a private colormap for the window.

-noinstall

Don't install a private colormap for the window.

-visual viz

Specify which visual to use. Legal values are the name of a visual class, or the id number (decimal or hex) of a specific visual. Possible choices include

default, best, mono, monochrome, gray, grey, color, staticgray, staticcolor, truecolor, grayscale, greyscale, pseudocolor, directcolor, number If a decimal or hexadecimal number is used, XGetVisualInfo(3X) is consulted to obtain the required visual.

-colors N

How many colors should be used (if possible). The colors are chosen randomly.

-foreground name

With -mono, this option selects the foreground colour.

-delay microseconds

Specifies the delay between drawing successive line segments of the path. If you do not specify -sync, some X servers may batch up several drawing operations together, producing a less smooth effect. This is more likely to happen in monochrome mode (on monochrome servers or when -mono is specified).

-holdtime seconds

When the figure is complete, epicycle pauses this number of seconds.

-linewidth N

Width in pixels of the body's track. Specifying values greater than one may cause slower drawing. The fastest value is usually zero, meaning one pixel.

-min_circles N

Smallest number of epicycles in the figure.

-max_circles N

Largest number of epicycles in the figure.

-min_speed number

Smallest possible value for the base speed of revolution of the epicycles. The actual speeds of the epicycles vary from this down to min_speed / harmonics.

-max_speed number

Smallest possible value for the base speed of revolution of the epicycles.

-harmonics N

Number of possible harmonics; the larger this value is, the greater the possible variety of possible speeds of epicycle.

-timestep number

Decreasing this value will reduce the distance the body moves for each line segment, possibly producing a smoother figure. Increasing it may produce faster results.

-divisor_poisson probability

Each epicycle rotates at a rate which is a factor of the base speed. The speed of each epicycle is the base speed divided by some integer between 1 and the value of the -harmonics option. This integer is decided by starting at 1 and tossing a biased coin. For each consecutive head, the value is incremented by one. The integer will not be incremented above the value of the -harmonics option. The argument of this option decides the bias of the coin; it is the probability that that coin will produce a head at any given toss.

-size_factor_min number

Epicycles are always at least this factor smaller than their parents.

-size_factor_max number

Epicycles are never more than this factor smaller than their parents.

-fps

Display the current frame rate and CPU load.

## RESOURCES

```
Option            Resource               Default Value
------            --------               -------------
-colors           .colors                100
-delay            .delay                 1000
-holdtime         .holdtime              2
-linewidth        .lineWidth             4
-min_circles      .minCircles            2
-max_circles      .maxCircles            10
-min_speed        .minSpeed              0.003
-max_speed        .maxSpeed              0.005
-harmonics        .harmonics             8
-timestep         .timestep              1.0
-divisor_poisson  .divisorPoisson        0.4
-size_factor_min  .sizeFactorMin         1.05
-size_factor_max  .sizeFactorMax         2.05

                  .timestepCoarseFactor  1.0
```

Before the drawing of the figure is begun, a preliminary calculation of the path is done in order to scale the radii of the epicycles so as to fit the figure on the screen or window. For the sake of speed, This calculation is done with a larger timestep than the actual drawing. The time-step used is the value of the -timestep option multiplied by the timestepCoarseFactor resource. The default value of 1 will almost always work fast enough and so this resource is not available as a command-line option.

## USER INTERFACE
The program runs mostly without user interaction. When running on the root window, no input is accepted. When running in its own window, the program will exit if mouse button 3 is pressed. If any other mouse button is pressed, the current figure will be abandoned and another will be started.

## HISTORY
The geometry of epicycles was perfected by Hipparchus of Rhodes at some time around 125 B.C., 185 years after the birth of Aristarchus of Samos, the inventor of the heliocentric universe model. Hipparchus applied epicycles to the Sun and the Moon. Ptolemy of Alexandria went on to apply them to what was then the known universe, at around 150 A.D. Copernicus went on to apply them to the heliocentric model at the beginning of the sixteenth century. Johannes Kepler discovered that the planets actually move in elliptical orbits in about 1602. The inverse-square law of gravity was suggested by Boulliau in 1645. Isaac Newton's Principia Mathematica was published in 1687, and proved that Kepler's laws derived from Newtonian gravitation.

## BUGS
The colour selection is re-done for every figure. This may generate too much network traffic for this program to work well over slow or long links.

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

## AUTHOR
James Youngman <jay@gnu.org>, April 1998.


eruption

title: eruption(6)

summary: eruption of pieces of hot volcanic rock

text:
# eruption(6)

## NAME
Eruption - eruption of pieces of hot volcanic rock

## SYNOPSIS
Eruption [-display host:display.screen] [-visual visual] [-window] [-root] [-ncolors number] [-nParticles number] [-Heat number] [-Cooling number] [-Gravity number] [-delay number] [-cycles number] [-fps]

## DESCRIPTION
This hack creates an eruption of pieces of hot volcanic rock. Ported from the demo effects collection (http://demo-effects.sourceforge.net)

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

-ncolors number

Number of Colors. Default: 256.

-particles number

Number of Particles. Default: 300.

-cooloff number

Eruption Cooloff. Default: 2.

-heat number

Heat of Eruption. Default: 256.

-gravity number

Gravity. Default: 1.

-delay number

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

-cycles number

Duration. 10 - 3000. Default: 80.

-fps

Display the current frame rate and CPU load.

## ENVIRONMENT
DISPLAY

to get the default host and display number.

XENVIRONMENT

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

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

## COPYRIGHT
Copyright © 2002-2003 by W.P. van Paassen. 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
W.P. van Paassen


title: euler2d(6)

text:
# euler2d(6)

## NAME
euler2d - two dimensional incompressible inviscid fluid flow.

## SYNOPSIS
euler2d [-display host:display.screen] [-visual visual] [-window] [-root] [-count number] [-eulertail number] [-cycles number] [-ncolors number] [-delay number] [-fps]

## DESCRIPTION
Simulates two dimensional incompressible inviscid fluid flow.

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

-count number

Particles. 2 - 5000. Default: 1024.

-eulertail number

Trail Length. 2 - 500. Default: 10.

-cycles number

Duration. 100 - 5000. Default: 3000.

-ncolors number

Number of Colors. Default: 64.

-delay number

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

-fps

Display the current frame rate and CPU load.

## ENVIRONMENT
DISPLAY

to get the default host and display number.

XENVIRONMENT

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

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

## COPYRIGHT
Copyright © 2002 by Stephen Montgomery-Smith. 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
Stephen Montgomery-Smith.


fadeplot

title: fadeplot(6)

text:
# fadeplot(6)

## NAME
fadeplot - draws a waving ribbon following a sinusoidal path.

## SYNOPSIS
fadeplot [-display host:display.screen] [-visual visual] [-window] [-root] [-count number] [-cycles number] [-delay number] [-ncolors number] [-fps]

## DESCRIPTION
Draws what looks like a waving ribbon following a sinusoidal path.

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

-count number

Count. 0 - 20. Default: 10.

-cycles number

How many frames until the shape changes. Default: 1500.

-delay number

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

-ncolors number

Number of colors. Default: 64.

-fps

Display the current frame rate and CPU load.

## ENVIRONMENT
DISPLAY

to get the default host and display number.

XENVIRONMENT

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

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

## COPYRIGHT
Copyright © 2002 by Bas van Gaalen and Charles Vidal. 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
Bas van Gaalen and Charles Vidal.


fiberlamp

title: fiberlamp(6)

summary: Fiber Optic Lamp

text:
# fiberlamp(6)

## NAME
fiberlamp - Fiber Optic Lamp

## SYNOPSIS
fiberlamp [-display host:display.screen] [-visual visual] [-window] [-root] [-count number] [-cycles number] [-delay number] [-ncolors number] [-fps]

## DESCRIPTION
Displays a Fiber Optic Lamp.

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

-count number

Number of Fibers. 10 - 500. Default: 500.

-cycles number

Number of cycles before the lamp is knocked sideways. 100 - 10000. Default: 10000.

-delay number

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

-ncolors number

Number of Colors. Default: 64.

-fps

Display the current frame rate and CPU load.

## ENVIRONMENT
DISPLAY

to get the default host and display number.

XENVIRONMENT

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

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

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

## AUTHOR
Tim Auckland.


filmleader

title: filmleader(6)

summary: screen saver.

text:
# filmleader(6)

## NAME
filmleader - screen saver.

## SYNOPSIS
filmleader [-display host:display.screen] [-visual visual] [-window] [-root] [-tv-color number] [-tv-tint number] [-noise number] [-tv-brightness number] [-tv-contrast number] [-fps]

## DESCRIPTION
Displays a looping countdown based on the SMPTE Universal Film leader on a simulation of an old analog television.

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

-tv-color number

Color Knob. 0 - 1000. Default: 70.

-tv-tint number

Tint Knob. 0 - 100. Default: 5.

-noise number

Noise. 0.0 - 0.2. Default: 0.04.

-tv-brightness number

Brightness Knob. 0 - 200. Default: 150.

-tv-contrast number

Contrast Knob. 0 - 1500. Default: 1000.

-fps | -no-fps

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

## ENVIRONMENT
DISPLAY

to get the default host and display number.

XENVIRONMENT

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

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

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


fireworkx

title: fireworkx(6)

summary: pyrotechnic explosions eye-candy.

text:
# fireworkx(6)

## NAME
fireworkx - pyrotechnic explosions eye-candy.

## SYNOPSIS
fireworkx [-display host:display.screen] [-visual visual] [-window] [-root] [-verbose] [-noflash] [-shoot] [-delay number] [-maxlife number] [-fps]

## DESCRIPTION
Animates explosions.

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

-noflash

Turn off light flash effect. (Runs faster)

-shoot

Fire shells up using mortar.

-delay number

Delay between frames. In microseconds. (Default: 10000)

-maxlife number

Maximum decay period for an explosion. (Range: 0-100)

-verbose

For scientific research purposes only..!

-fps

Display the current frame rate and CPU load.

## ENVIRONMENT
DISPLAY

to get the default host and display number.

XENVIRONMENT

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

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

## COPYRIGHT
Copyright © 1999-2013 by Rony B Chandran. 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
Written by Rony B Chandran <ronybc@gmail.com>

Additional programming and support:

--------------------------------------------------------------------

Rugmini R Chandran <rugmini@ronybc.com>

Renuka S <renuka@ronybc.com>

Jean-Pierre Demailly <Jean-Pierre.Demailly@ujf-grenoble.fr>

Nicholas Miell <nmiell@gmail.com>

## URL
http://www.ronybc.com


flame

title: flame(6)

summary: draw weird cosmic fractals

text:
# flame(6)

## NAME
flame - draw weird cosmic fractals

## SYNOPSIS
flame [-display host:display.screen] [-foreground color] [-background color] [-window] [-root] [-mono] [-install] [-visual visual] [-colors integer] [-iterations integer] [-points integer] [-delay microseconds] [-delay2 microseconds] [-fps]

## DESCRIPTION
The flame program generates colorful fractal displays.

## OPTIONS
flame accepts the following options:

-window

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

-root

Draw on the root window.

-mono

If on a color display, pretend we're on a monochrome display.

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

-colors integer

How many colors should be used (if possible). Default 64.

-iterations integer

How many fractals to generate. Default 25.

-points integer

How many pixels to draw for each fractal. Default 10000.

-delay microseconds

How long we should wait between drawing each fractal. Default 50000, or about 1/20th second.

-delay2 microseconds

How long we should wait before clearing the screen when each run ends. Default 2000000, or two seconds.

-fps

Display the current frame rate and CPU load.

## ENVIRONMENT
DISPLAY

to get the default host and display number.

XENVIRONMENT

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

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

## COPYRIGHT
Copyright © 1991 by Patrick J. Naughton

Permission to use, copy, modify, and distribute this software and its documentation for any purpose and without fee is hereby granted, provided that the above copyright notice appear in all copies and that both that copyright notice and this permission notice appear in supporting documentation.

## AUTHOR
Scott Graves <spot@cs.cmu.edu>, 06-Jun-91.n

Ability to run standalone or with xscreensaver added by Jamie Zawinski <jwz@jwz.org>, 18-Oct-93.


flow

title: flow(6)

summary: strange attractors.

text:
# flow(6)

## NAME
flow - strange attractors.

## SYNOPSIS
flow [-display host:display.screen] [-visual visual] [-window] [-root] [-count number] [-cycles number] [-periodic|-no-periodic] [-search|-no-search] [-rotate|-no-rotate] [-ride|-no-ride] [-box|-no-box] [-dbuf|-no-dbuf] [-ncolors number] [-delay number] [-fps]

## DESCRIPTION
Strange attractors formed of flows in a 3D differential equation phase space. Features the popular attractors described by Lorentz, Roessler, Birkhoff and Duffing, and can discover entirely new attractors by itself.

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

-count number

Number of particles in the flow. Default: 3000

-size number

Length of particle trails. Negative values indicate randomness. The computational load of a given flow depends on (particle count) * (trail length). Default: -10

-cycles number

Timeout before changing objects. 0 - 800000. Default: 10000.

-periodic

-no-periodic

turn on/off periodic attractors. These are flows in 2 dependent variables, with a periodic dependence on a third independent variable (eg time). Flow will sometimes choose to start all the particles in the same phase to illustrate the flow's cross-section. Default: on

-search

-no-search

turn on/off search for new attractors. If this is enabled, a fraction of the computing cycles is directed to searching a 60-dimensional parameter space for new strange attractors. If periodic flows are enabled, these can be searched too. Watch carefully - you are quite likely to see mathematical objects that have never been seen before, and since the parameters are not recorded, you'll probably never see them again! Default: on

-rotate

-no-rotate

turn on/off rotating around attractor. Default: on

-ride

-no-ride

turn on/off ride in the flow. Default: on If both -rotate and -ride are enabled the viewpoint will occasionally fly between the two views.

-box

-no-box

turn on/off bounding box. Default: on

-dbuf

-no-dbuf

turn on/off double buffering. If Flow runs slowly in full screen, but fast in a smaller window (eg on old graphics cards with too little memory), try turning this option off. Default: on

-ncolors number

Number of Colors. Default: 200.

-delay number

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

-fps

Display the current frame rate and CPU load.

## ENVIRONMENT
DISPLAY

to get the default host and display number.

XENVIRONMENT

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

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

## COPYRIGHT
Copyright (c) 1996 by Tim Auckland <Tim.Auckland@Procket.com> Incorporating some code from Stephen Davies Copyright (c) 2000

Search code based on techniques described in "Strange Attractors: Creating Patterns in Chaos" by Julien C. Sprott

Permission to use, copy, modify, and distribute this software and its documentation for any purpose and without fee is hereby granted, provided that the above copyright notice appear in all copies and that both that copyright notice and this permission notice appear in supporting documentation.

This file is provided AS IS with no warranties of any kind. The author shall have no liability with respect to the infringement of copyrights, trade secrets or any patents by this file or any part thereof. In no event will the author be liable for any lost revenue or profits or other special, indirect and consequential damages.

Adapted from swarm.c Copyright (c) 1991 by Patrick J. Naughton.

Adapted from xswarm by Jeff Butterworth. (butterwo@ncsc.org).

## AUTHOR
Tim Auckland


fluidballs

title: fluidballs(6)

summary: the physics of bouncing balls.

text:
# fluidballs(6)

## NAME
fluidballs - the physics of bouncing balls.

## SYNOPSIS
fluidballs [-display host:display.screen] [-visual visual] [-window] [-root] [-count number] [-size number] [-gravity number] [-wind number] [-elasticity number] [-delay number] [-nonrandom] [-no-shake] [-fps]

## DESCRIPTION
Models the physics of bouncing balls, or of particles in a gas or fluid, depending on the settings. If "Shake Box" is selected, then every now and then, the box will be rotated, changing which direction is down (in order to keep the settled balls in motion.)

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

-count number

How many balls to display. Default: 300.

-size number

Maximum size of each ball. Default: 25.

-gravity number

Coefficient of gravity. Useful values are < 0.1. Default: 0.01.

-wind number

Wind. Useful values are < 0.1. Default: 0.00.

-elasticity number

Coefficient of elasticity. Useful values are 0.2 to 1.0. Default: 0.97. Lower numbers make less bouncy balls.

-delay number

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

-nonrandom

Make all balls be the same size.

-no-nonrandom

Make the balls be random sizes. Default.

-shake | -no-shake

Whether to shake the box if the system seems to have settled down. "Shake" means "change the direction of Down."

-fps

Display the current frame rate and CPU load.

## ENVIRONMENT
DISPLAY

to get the default host and display number.

XENVIRONMENT

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

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

## COPYRIGHT
Copyright © 2002 by Peter Birtles 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
Peter Birtles, Jamie Zawinski, and Steven Barker.


fontglide

title: fontglide(6)

text:
# fontglide(6)

## NAME
fontglide - characters float onto the screen to form words

## SYNOPSIS
fontglide [-display host:display.screen] [-window] [-root] [-install] [-visual visual] [-delay usecs] [-scroll] [-page] [-random] [-speed float] [-linger float] [-program sh-command] [-font font-name] [-bw int] [-trails] [-db] [-debug] [-fps]

## DESCRIPTION
The fontglide program reads text from a subprocess and puts it on the screen using large characters that glide in from the edges, assemble, then disperse. Alternately, it can simply scroll whole sentences from right to left.

## OPTIONS
fontglide accepts the following options:

-window

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

-root

Draw on the root window.

-install

Install a private colormap for the window.

-visual visual

Specify which visual to use. Legal values are the name of a visual class, or the id number (decimal or hex) of a specific visual.

-delay usecs

The delay between steps of the animation, in microseconds: default 10000.

-page

With this option, a page full of text will glide in, and disperse.

-scroll

With this option, sentences will scroll by from right to left.

-random

The default is to pick randomly between -page and -scroll.

-speed float

How fast to animate; 2 means twice as fast, 0.5 means half as fast. Default 1.0.

-linger float

How long to leave the assembled text on the screen in -page mode; 2 means twice as long, 0.5 means half as long. Default 1.0. (The more words there are on the screen, the longer it lingers.)

-program sh-command

The command to run to generate the text to display. This option may be any string acceptable to /bin/sh. The program will be run at the end of a pipe, and any words that it prints to stdout will end up on the window. (Whitespace and line breaks are ignored.) If the program exits, it will be launched again after we have processed all the text it produced. Default: xscreensaver-text(1).

-font string

The base font pattern to use when loading fonts. The default is to search for any Latin1 scalable proportional fonts on the system. Once a base font is selected, it will be loaded in a random size.

-bw int

How thick an outline to draw around the characters. Default 2 pixels.

-trails

Leave "vapor trails" behind the moving text. Default off.

-no-db

Turn off double-buffering. It may be faster, but will flicker.

-debug

Draw some boxes showing character metrics, and print the name of the current font to stderr.

-fps

Display the current frame rate and CPU load.

## ENVIRONMENT
DISPLAY

to get the default host and display number.

XENVIRONMENT

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

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

## 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 <jwz@jwz.org>, 15-Sep-2003.


fuzzyflakes

title: fuzzyflakes(6)

summary: falling snowflakes/flower shapes

text:
# fuzzyflakes(6)

## NAME
fuzzyflakes - falling snowflakes/flower shapes

## SYNOPSIS
fuzzyflakes [-display host:display.screen] [-foreground color] [-background color] [-window] [-root] [-mono] [-install] [-visual visual] [-delay usecs] [-speed int] [-arms int] [-thickness int] [-bthickness int] [-radius int] [-layers int] [-density int] [-no-db] (-color string) (-random-colors) [-fps]

## DESCRIPTION
The fuzzyflakes program draws falling pastel colored snowflake/flower shapes. Inspired by the credits of the anime "Azumanga Daioh".

## OPTIONS
fuzzyflakes accepts the following options:

-window

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

-root

Draw on the root window.

-mono

If on a color display, pretend we're on a monochrome display.

-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 steps of the animation, in microseconds. Default: 250000.

-speed int

How fast, 1-50. Default 10.

-arms int

How many arms on the flakes; default 5.

-thickness int

How thick to make the lines; default 10 pixels.

-bthickness int

How thick to make the borders; default 3 pixels.

-radius int

Radius of the objects; default 20 pixels.

-layers int

How many layers of objects; default 3.

-density int

Default 5.

-no-db

Disable double-buffering.

-color string

The base color for the color scheme. Typed as a hexadecimal triplet with or with out the leading #. ie. fa4563 & #43cd12 are both acceptable. If the saturation of you color is too low (<0.03) the random color generator will kick in. The default color is #efbea5

-random-colors

This enables the random color generation. It is disabled by default. It overrides anything from -color

-fps

Display the current frame rate and CPU load.

## ENVIRONMENT
DISPLAY

to get the default host and display number.

XENVIRONMENT

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

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

## COPYRIGHT
Copyright © 2004 Barry Dmytro. 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
Barry Dmytro <badcherry@mailc.net>

## CREDITS
The color generation algorithm was borrowed from a friend <ZoeB> from #vegans@irc.blitzed.org. Her site was [REDACTED]. To see her original code in action visit her site.


galaxy

title: galaxy(6)

summary: draws spinning galaxies

text:
# galaxy(6)

## NAME
galaxy - draws spinning galaxies

## SYNOPSIS
galaxy [-display host:display.screen] [-foreground color] [-background color] [-window] [-root] [-mono] [-install] [-visual visual] [-ncolors integer] [-delay microseconds] [-cycles integer] [-count integer] [-size integer] [-tracks] [-no-tracks] [-spin] [-no-spin]

[-fps]

## DESCRIPTION
The galaxy program draws spinning galaxies.

## OPTIONS
galaxy accepts the following options:

-window

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

-root

Draw on the root window.

-mono

If on a color display, pretend we're on a monochrome display.

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

-ncolors integer

How many colors should be used (if possible). Default 64. The colors used cycle through the hue, making N stops around the color wheel.

-cycles integer

-count integer

-size integer

-tracks

-no-tracks

-spin

-no-spin

-fps

Display the current frame rate and CPU load.

## ENVIRONMENT
DISPLAY

to get the default host and display number.

XENVIRONMENT

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

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

## COPYRIGHT
Copyright © 1994 by Hubert Feyrer.

Permission to use, copy, modify, and distribute this software and its documentation for any purpose and without fee is hereby granted, provided that the above copyright notice appear in all copies and that both that copyright notice and this permission notice appear in supporting documentation.

## AUTHOR
Original Amiga version by Uli Siegmund <uli@wombat.okapi.sub.org>

for EGS in Cluster.

Ported from Cluster/EGS to C/Intuition by Harald Backert.

Ported to X11 and xlockmore by Hubert Feyrer <hubert.feyrer@rz.uni-regensburg.de>, 30-Sep-94.

Modified by David Bagley <bagleyd@bigfoot.com>, 23-Oct-94.

Modified by Dave Mitchell <davem@magnet.com>, 7-Apr-97.

Ability to run standalone or with xscreensaver added by Jamie Zawinski <jwz@jwz.org>, 10-May-97.


glitchpeg

title: glitchpeg(6)

summary: glitched image screen saver.

text:
# glitchpeg(6)

## NAME
glitchpeg - glitched image screen saver.

## SYNOPSIS
glitchpeg [-display host:display.screen] [-visual visual] [-window] [-root] [-delay number] [-duration number] [-count number]

## DESCRIPTION
Loads an image, corrupts it, and then displays the corrupted version, several times a second. After a while, finds a new image to corrupt.

It glitches the image by altering random bytes in the compressed image file before de-compressing it. This creates interesting visual effects on JPEG files, but doesn't work well on PNG files, since PNG contains checksums that detect simple corruption.

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

-duration number

How many seconds before loading a new image. Default: 120.

-count number

Number of glitches to introduce per iteration. Default: 100.

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

## SECURITY
Because this program is feeding intentionally-invalid data into your operating system's image-decoding libraries, it is possible that it may crash as a result of that corrupted data.

That should not be possible -- but it might be.

Please note that if this happens, that indicates a serious security bug in your system's image libraries! It likely means that your libraries are susceptible to buffer overflow attacks or similar, which can lead to remote code execution. You should report that bug to the maintainers of those image libraries.

In the context of xscreensaver, when configured to load only local image files, this should not be a direct security concern: this screen saver crashing will not affect the xscreensaver daemon and will not unlock your screen.

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

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


goop

title: goop(6)

text:
# goop(6)

## NAME
goop - squishy transparent oil and bubble screenhack

## SYNOPSIS
goop [-display host:display.screen] [-foreground color] [-background color] [-window] [-root] [-mono] [-install] [-visual visual] [-transparent] [-non-transparent] [-additive] [-subtractive] [-xor] [-no-xor] [-fps]

## DESCRIPTION
The goop program draws a simulation of bubbles in layers of overlapping multicolored translucent fluid.

## OPTIONS
goop accepts the following options:

-window

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

-root

Draw on the root window.

-mono

If on a color display, pretend we're on a monochrome display.

-install

Install a private colormap for the window.

-visual visual

Specify which visual to use. Legal values are the name of a visual class, or the id number (decimal or hex) of a specific visual.

-count integer

How many bubbles to draw per layer. Default: random.

-planes integer

How many planes to draw. Default: random, based on screen depth.

-delay microseconds

How much of a delay should be introduced between steps of the animation. Default 12000, or about 0.012 seconds.

-transparent

If -layers is greater than 1, then each layer will be drawn in one color, and when they overlap, the colors will be mixed. This is the default.

-non-transparent

Turns off -transparent.

-additive

If -transparent is specified, then this option means that the colors will be mixed using an additive color model, as if the blobs were projected light. This is the default.

-subtractive

If -transparent is specified, then this option means that the colors will be mixed using a subtractive color model, as if the blobs were translucent filters.

-xor

Draw with xor instead of the other color tricks.

-fps

Display the current frame rate and CPU load.

## ENVIRONMENT
DISPLAY

to get the default host and display number.

XENVIRONMENT

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

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

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

## AUTHOR
Jamie Zawinski <jwz@jwz.org>, 11-Jun-97.