Provided by: xscreensaver-data-extra_5.08-0ubuntu3_i386 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] [-bor-
        der-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  pro-
        gram.
 

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 sec-
                onds.
 
        -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.
        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.
        xscreensaver(1)
 

COPYRIGHT

        Copyright (C) 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, pro-
        vided that the above copyright notice appear in  all  copies  and  that
        both  that  copyright  notice and this permission notice appear in sup-
        porting documentation. No representations are made about the  suitabil-
        ity  of  this  software for any purpose. It is provided "as is" without
        express or implied warranty.
 

AUTHOR

        Dan Bornstein <danfuzz@milk.com>.