bionic (6) twang.6x.gz

Provided by: xscreensaver-data-extra_5.36-1ubuntu1_amd64 bug

NAME

       twang - pluck pieces of the screen

SYNOPSIS

       twang  [-display  host:display.screen]  [-foreground color] [-background color] [-window] [-root] [-mono]
       [-install] [-visual visual] [-shm]  [-no-shm]  [-delay  usecs]  [-duration  secs]  [-border-color  color]
       [-border-width integer] [-event-chance fraction] [-friction fraction] [-springiness fraction] [-tile-size
       integer] [-transference fraction] [-fps]

DESCRIPTION

       Twang divides the screen into equal-sized tiles, and then plucks them in various ways. Tiles are affected
       by their neighbors, so waves of motion flow through the grid. This manpage describes v1.3 of the program.

OPTIONS

       twang 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
               Which  visual  to use.  Legal values are the name of a visual class, or the id number (decimal or
               hex) of a specific visual.

       -shm

       -no-shm Use the shared memory extension (or not, respectively), if available.  This may speed things up a
               bit,  but  probably  won't  make  that  much difference. If available, defaults to true, resource
               useSHM.

       -delay microseconds
               The interframe delay, in microseconds. Defaults to 10000, resource delay.

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

       -border-color color
               Color of the border surrounding each tile. Defaults to blue, resource borderColor.

       -border-width integer
               Width of the border surrounding each tile. Defaults to 3, resource borderWidth.

       -event-chance fraction
               The chance, per iteration, for an event to occur (such as tweaking the orientation of a tile), in
               the range 0..1. Defaults to 0.01, resource eventChance.

       -friction fraction
               How  much  friction  there  is  in  the  system,  in the range 0..1.  This is the amount by which
               velocities are damped per iteration.  Defaults to 0.05, resource friction.

       -springiness fraction
               How springy the tiles are, in the range 0..1.  This is the fraction of an orientation  that  gets
               turned into a velocity towards the center (resting point). Defaults to 0.1, resource springiness.

       -tile-size integer
               Size  (width  and  height)  of each tile, not including the outer edge of the border. Defaults to
               120, resource tileSize.

       -transference fraction
               How much a tile's neighbors affect it, in the range 0..1.  This is the fraction of an orientation
               of  a neighbor that gets turned into a velocity in the same direction Defaults to 0.025, resource
               transference.

       -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

       There are resource equivalents for each option, noted above.

BUGS

       twang should have more interesting events.

       Ways of speeding it up need to be investigated. It's kinda sluggish,
               especially on hugeass displays.

SEE ALSO

       xscreensaver(1)

       Copyright © 2002 by Dan Bornstein. All rights reserved.

       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

       Dan Bornstein <danfuzz@milk.com>.