ftp://ftp.sunet.se/pub/vendor/sco/skunkware/osr5/x11/savers/xscreensaver/xscreensaver...
[xscreensaver] / local / man / cat.1 / attraction.1
diff --git a/local/man/cat.1/attraction.1 b/local/man/cat.1/attraction.1
new file mode 100644 (file)
index 0000000..629557b
--- /dev/null
@@ -0,0 +1,264 @@
+
+
+
+XScreenSaver(1)                                   XScreenSaver(1)
+
+
+N\bNA\bAM\bME\bE
+       attraction - interactions of opposing forces
+
+S\bSY\bYN\bNO\bOP\bPS\bSI\bIS\bS
+       a\bat\btt\btr\bra\bac\bct\bti\bio\bon\bn   [-display  _\bh_\bo_\bs_\bt_\b:_\bd_\bi_\bs_\bp_\bl_\ba_\by_\b._\bs_\bc_\br_\be_\be_\bn]  [-foreground
+       _\bc_\bo_\bl_\bo_\br]  [-background  _\bc_\bo_\bl_\bo_\br]  [-window]  [-root]   [-mono]
+       [-install] [-visual _\bv_\bi_\bs_\bu_\ba_\bl] [-points _\bi_\bn_\bt] [-threshold _\bi_\bn_\bt]
+       [-mode balls | lines | polygons | splines | filled-splines
+       |  tails  ]  [-size  _\bi_\bn_\bt]  [-segments  _\bi_\bn_\bt] [-delay _\bu_\bs_\be_\bc_\bs]
+       [-color-shift _\bi_\bn_\bt]  [-radius  _\bi_\bn_\bt]  [-vx  _\bi_\bn_\bt]  [-vy  _\bi_\bn_\bt]
+       [-glow]  [-noglow]  [-orbit]  [-viscosity  _\bf_\bl_\bo_\ba_\bt] [-mouse]
+       [-no-mouse] [-mouse-size]
+
+D\bDE\bES\bSC\bCR\bRI\bIP\bPT\bTI\bIO\bON\bN
+       The _\ba_\bt_\bt_\br_\ba_\bc_\bt_\bi_\bo_\bn  program  has  several  visually  different
+       modes of operation, all of which are based on the interac-
+       tions 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.
+
+O\bOP\bPT\bTI\bIO\bON\bNS\bS
+       _\ba_\bt_\bt_\br_\ba_\bc_\bt_\bi_\bo_\bn accepts the following options:
+
+       -\b-w\bwi\bin\bnd\bdo\bow\bw Draw  on  a  newly-created  window.   This  is the
+               default.
+
+       -\b-r\bro\boo\bot\bt   Draw on the root window.
+
+       -\b-m\bmo\bon\bno\bo   If  on  a  color  display,  pretend  we're  on   a
+               monochrome display.
+
+       -\b-i\bin\bns\bst\bta\bal\bll\bl
+               Install a private colormap for the window.
+
+       -\b-v\bvi\bis\bsu\bua\bal\bl _\bv_\bi_\bs_\bu_\ba_\bl
+               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.
+
+       -\b-p\bpo\boi\bin\bnt\bts\bs i\bin\bnt\bte\beg\bge\ber\br
+               How  many  control  points should be used, or 0 to
+               select the number randomly.  Default 0.  Between 3
+               and 15 works best.
+
+       -\b-t\bth\bhr\bre\bes\bsh\bho\bol\bld\bd i\bin\bnt\bte\beg\bge\ber\br
+               The  distance  (in  pixels)  from each particle at
+               which  the  attractive  force  becomes  repulsive.
+               Default 100.
+
+       -\b-m\bmo\bod\bde\be b\bba\bal\bll\bls\bs |\b| l\bli\bin\bne\bes\bs |\b| p\bpo\bol\bly\byg\bgo\bon\bns\bs |\b| t\bta\bai\bil\bls\bs |\b| s\bsp\bpl\bli\bin\bne\bes\bs |\b| f\bfi\bil\bll\ble\bed\bd-\b-
+               s\bsp\bpl\bli\bin\bne\bes\bs
+               In _\bb_\ba_\bl_\bl_\bs mode (the default) the control points are
+               drawn as filled circles.  The larger  the  circle,
+
+
+
+X Version 11                14-Jun-97                           1
+
+
+
+
+
+XScreenSaver(1)                                   XScreenSaver(1)
+
+
+               the more massive the particle.
+
+               In _\bl_\bi_\bn_\be_\bs mode, the control points are connected by
+               straight lines; the effect is something like  _\bq_\bi_\bx.
+
+               In _\bp_\bo_\bl_\by_\bg_\bo_\bn_\bs mode, the control points are connected
+               by straight lines, and filled in.   This  is  most
+               interesting in color.
+
+               In  _\bs_\bp_\bl_\bi_\bn_\be_\bs  mode, a closed spline is interpolated
+               from the control points.
+
+               In _\bf_\bi_\bl_\bl_\be_\bd_\b-_\bs_\bp_\bl_\bi_\bn_\be_\bs mode, the splines are filled  in
+               instead of being outlines.  This is most interest-
+               ing in color.
+
+               In _\bt_\ba_\bi_\bl_\bs mode, the path which each  particle  fol-
+               lows  is  indicated  by  a  worm-like trail, whose
+               length is controlled by the _\bs_\be_\bg_\bm_\be_\bn_\bt_\bs parameter.
+
+       -\b-s\bsi\biz\bze\be i\bin\bnt\bte\beg\bge\ber\br
+               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.
+
+       -\b-s\bse\beg\bgm\bme\ben\bnt\bts\bs i\bin\bnt\bte\beg\bge\ber\br
+               If  in  _\bl_\bi_\bn_\be_\bs  or  _\bp_\bo_\bl_\by_\bg_\bo_\bn_\bs mode, how many sets of
+               line segments or polygons should be drawn. Default
+               100.   This  has no effect in _\bb_\ba_\bl_\bl_\bs mode.  If _\bs_\be_\bg_\b-
+               _\bm_\be_\bn_\bt_\bs is 0, then no segments will ever  be  erased
+               (this is only useful in color.)
+
+       -\b-d\bde\bel\bla\bay\by m\bmi\bic\bcr\bro\bos\bse\bec\bco\bon\bnd\bds\bs
+               How  much  of a delay should be introduced between
+               steps of the animation.  Default 10000,  or  about
+               0.01 seconds.
+
+       -\b-c\bco\bol\blo\bor\br-\b-s\bsh\bhi\bif\bft\bt i\bin\bnt\bt
+               If  on a color display, the color of the line seg-
+               ments 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  num-
+               ber of colors are available, increasing this value
+               will  yield  smoother  transitions.)   Default  3.
+               This has no effect in _\bb_\ba_\bl_\bl_\bs mode.
+
+       -\b-r\bra\bad\bdi\biu\bus\bs 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.
+
+       -\b-g\bgl\blo\bow\bw   This  is consulted only in _\bb_\ba_\bl_\bl_\bs mode.  If this is
+
+
+
+X Version 11                14-Jun-97                           2
+
+
+
+
+
+XScreenSaver(1)                                   XScreenSaver(1)
+
+
+               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 _\bg_\bl_\bo_\bw 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.
+
+       -\b-n\bno\bog\bgl\blo\bow\bw Don't do ``glowing.''  This is the default.
+
+       -\b-v\bvx\bx p\bpi\bix\bxe\bel\bls\bs
+
+       -\b-v\bvy\by p\bpi\bix\bxe\bel\bls\bs
+               Initial velocity of the balls.  This has no effect
+               in -\b-o\bor\brb\bbi\bit\bt mode.
+
+       -\b-o\bor\brb\bbi\bit\bt  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.
+
+       -\b-v\bvm\bmu\bul\blt\bt f\bfl\blo\boa\bat\bt
+               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.
+
+       -\b-v\bvi\bis\bsc\bco\bos\bsi\bit\bty\by f\bfl\blo\boa\bat\bt
+               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 75 \
+                      -mouse -geometry =500x500
+
+               Give it a few seconds to settle down into a stable
+               clump,  and then move the mouse through it to make
+               "waves".
+
+       -\b-m\bmo\bou\bus\bse\be  This will cause the mouse to be considered a  con-
+               trol  point;  it  will  not  be drawn, but it will
+               influence the other points, so you  can  wave  the
+               mouse and influence the images being created.
+
+
+
+
+
+X Version 11                14-Jun-97                           3
+
+
+
+
+
+XScreenSaver(1)                                   XScreenSaver(1)
+
+
+       -\b-n\bno\bo-\b-m\bmo\bou\bus\bse\be
+               Turns off -\b-m\bmo\bou\bus\bse\be.
+
+       -\b-m\bmo\bou\bus\bse\be-\b-s\bsi\biz\bze\be i\bin\bnt\bte\beg\bge\ber\br
+               In  -\b-m\bmo\bou\bus\bse\be  mode,  this sets the mass of the mouse
+               (analagously to the -\b-s\bsi\biz\bze\be parameter.)
+
+E\bEN\bNV\bVI\bIR\bRO\bON\bNM\bME\bEN\bNT\bT
+       D\bDI\bIS\bSP\bPL\bLA\bAY\bY to get the default host and display number.
+
+       X\bXE\bEN\bNV\bVI\bIR\bRO\bON\bNM\bME\bEN\bNT\bT
+               to get the name of a resource file that  overrides
+               the  global  resources stored in the RESOURCE_MAN-
+               AGER property.
+
+S\bSE\bEE\bE A\bAL\bLS\bSO\bO
+       X\bX(1), x\bxs\bsc\bcr\bre\bee\ben\bns\bsa\bav\bve\ber\br(1)
+
+C\bCO\bOP\bPY\bYR\bRI\bIG\bGH\bHT\bT
+       Copyright (C) 1992, 1993, 1997 by Jamie Zawinski.  Permis-
+       sion to use, copy, modify, distribute, and sell this soft-
+       ware 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 pro-
+       vided "as is" without express or implied warranty.
+
+A\bAU\bUT\bTH\bHO\bOR\bR
+       Jamie Zawinski <jwz@jwz.org>, 13-aug-92.
+
+       Viscosity and mouse support by Philip Edward Cutone,  III.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+X Version 11                14-Jun-97                           4
+
+