1twang(6x)                     XScreenSaver manual                    twang(6x)
2
3
4

NAME

6       twang - pluck pieces of the screen
7

SYNOPSIS

9       twang  [--display  host:display.screen]  [--foreground  color] [--back‐
10       ground color] [--window] [--root] [--window-id number] [--mono]  [--in‐
11       stall] [--visual visual] [--shm] [--no-shm] [--delay usecs] [--duration
12       secs] [--border-color color] [--border-width  integer]  [--event-chance
13       fraction]  [--friction  fraction] [--springiness fraction] [--tile-size
14       integer] [--transference fraction] [--fps]
15

DESCRIPTION

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

OPTIONS

22       twang accepts the following options:
23
24       --window
25               Draw on a newly-created window.  This is the default.
26
27       --root  Draw on the root window.
28
29       --window-id number
30               Draw on the specified window.
31
32       --mono  If on a color display, pretend we're on a monochrome display.
33
34       --install
35               Install a private colormap for the window.
36
37       --visual visual
38               Which visual to use.  Legal values are the  name  of  a  visual
39               class, or the id number (decimal or hex) of a specific visual.
40
41       --shm
42
43       --no-shm
44               Use  the  shared  memory  extension  (or not, respectively), if
45               available.  This may speed things up a bit, but probably  won't
46               make  that much difference. If available, defaults to true, re‐
47               source useSHM.
48
49       --delay microseconds
50               The interframe delay, in microseconds. Defaults to  10000,  re‐
51               source delay.
52
53       --duration seconds
54               How  long  to run before loading a new image.  Default 120 sec‐
55               onds.
56
57       --border-color color
58               Color of the border surrounding each tile.  Defaults  to  blue,
59               resource borderColor.
60
61       --border-width integer
62               Width  of  the border surrounding each tile. Defaults to 3, re‐
63               source borderWidth.
64
65       --event-chance fraction
66               The chance, per iteration, for  an  event  to  occur  (such  as
67               tweaking  the  orientation  of  a tile), in the range 0..1. De‐
68               faults to 0.01, resource eventChance.
69
70       --friction fraction
71               How much friction there is in the system, in  the  range  0..1.
72               This  is  the  amount by which velocities are damped per itera‐
73               tion.  Defaults to 0.05, resource friction.
74
75       --springiness fraction
76               How springy the tiles are, in the  range  0..1.   This  is  the
77               fraction of an orientation that gets turned into a velocity to‐
78               wards the center (resting point).  Defaults  to  0.1,  resource
79               springiness.
80
81       --tile-size integer
82               Size  (width  and height) of each tile, not including the outer
83               edge of the border. Defaults to 120, resource tileSize.
84
85       --transference fraction
86               How much a tile's neighbors affect it, in the range 0..1.  This
87               is  the  fraction  of  an  orientation  of a neighbor that gets
88               turned into a velocity in the same direction Defaults to 0.025,
89               resource transference.
90
91       --fps   Display the current frame rate and CPU load.
92

ENVIRONMENT

94       DISPLAY to get the default host and display number.
95
96       XENVIRONMENT
97               to  get  the  name of a resource file that overrides the global
98               resources stored in the RESOURCE_MANAGER property.
99
100       XSCREENSAVER_WINDOW
101               The window ID to use with --root.
102

X RESOURCES

104       There are resource equivalents for each option, noted above.
105

BUGS

107       twang should have more interesting events.
108
109       Ways of speeding it up need to be investigated. It's kinda sluggish,
110               especially on hugeass displays.
111

SEE ALSO

113       xscreensaver(1)
114
116       Copyright © 2002 by Dan Bornstein. All rights reserved.
117
118       Permission to use, copy, modify, distribute, and sell this software and
119       its  documentation  for any purpose is hereby granted without fee, pro‐
120       vided that the above copyright notice appear in  all  copies  and  that
121       both  that  copyright  notice and this permission notice appear in sup‐
122       porting documentation. No representations are made about the  suitabil‐
123       ity  of  this  software for any purpose. It is provided "as is" without
124       express or implied warranty.
125

AUTHOR

127       Dan Bornstein <danfuzz@milk.com>.
128
129
130
131X Version 11               6.08-1.fc38 (17-Oct-2023)                 twang(6x)
Impressum