git.hungrycats.org Git - xscreensaver/blob - local/man/cat.1/attraction.1

   1
   2
   3
   4 XScreenSaver(1)                                   XScreenSaver(1)
   5
   6
   7 N\bNA\bAM\bME\bE
   8        attraction - interactions of opposing forces
   9
  10 S\bSY\bYN\bNO\bOP\bPS\bSI\bIS\bS
  11        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
  12        _\bc_\bo_\bl_\bo_\br]  [-background  _\bc_\bo_\bl_\bo_\br]  [-window]  [-root]   [-mono]
  13        [-install] [-visual _\bv_\bi_\bs_\bu_\ba_\bl] [-points _\bi_\bn_\bt] [-threshold _\bi_\bn_\bt]
  14        [-mode balls | lines | polygons | splines | filled-splines
  15        |  tails  ]  [-size  _\bi_\bn_\bt]  [-segments  _\bi_\bn_\bt] [-delay _\bu_\bs_\be_\bc_\bs]
  16        [-color-shift _\bi_\bn_\bt]  [-radius  _\bi_\bn_\bt]  [-vx  _\bi_\bn_\bt]  [-vy  _\bi_\bn_\bt]
  17        [-glow]  [-noglow]  [-orbit]  [-viscosity  _\bf_\bl_\bo_\ba_\bt] [-mouse]
  18        [-no-mouse] [-mouse-size]
  19
  20 D\bDE\bES\bSC\bCR\bRI\bIP\bPT\bTI\bIO\bON\bN
  21        The _\ba_\bt_\bt_\br_\ba_\bc_\bt_\bi_\bo_\bn  program  has  several  visually  different
  22        modes of operation, all of which are based on the interac-
  23        tions of a set of control points which attract each  other
  24        up  to  a  certain  distance, and then begin to repel each
  25        other.  The attraction/repulsion is  proportional  to  the
  26        distance between any two particles.
  27
  28 O\bOP\bPT\bTI\bIO\bON\bNS\bS
  29        _\ba_\bt_\bt_\br_\ba_\bc_\bt_\bi_\bo_\bn accepts the following options:
  30
  31        -\b-w\bwi\bin\bnd\bdo\bow\bw Draw  on  a  newly-created  window.   This  is the
  32                default.
  33
  34        -\b-r\bro\boo\bot\bt   Draw on the root window.
  35
  36        -\b-m\bmo\bon\bno\bo   If  on  a  color  display,  pretend  we're  on   a
  37                monochrome display.
  38
  39        -\b-i\bin\bns\bst\bta\bal\bll\bl
  40                Install a private colormap for the window.
  41
  42        -\b-v\bvi\bis\bsu\bua\bal\bl _\bv_\bi_\bs_\bu_\ba_\bl
  43                Specify which visual to use.  Legal values are the
  44                name of a visual class, or the id number  (decimal
  45                or hex) of a specific visual.
  46
  47        -\b-p\bpo\boi\bin\bnt\bts\bs i\bin\bnt\bte\beg\bge\ber\br
  48                How  many  control  points should be used, or 0 to
  49                select the number randomly.  Default 0.  Between 3
  50                and 15 works best.
  51
  52        -\b-t\bth\bhr\bre\bes\bsh\bho\bol\bld\bd i\bin\bnt\bte\beg\bge\ber\br
  53                The  distance  (in  pixels)  from each particle at
  54                which  the  attractive  force  becomes  repulsive.
  55                Default 100.
  56
  57        -\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-
  58                s\bsp\bpl\bli\bin\bne\bes\bs
  59                In _\bb_\ba_\bl_\bl_\bs mode (the default) the control points are
  60                drawn as filled circles.  The larger  the  circle,
  61
  62
  63
  64 X Version 11                14-Jun-97                           1
  65
  66
  67
  68
  69
  70 XScreenSaver(1)                                   XScreenSaver(1)
  71
  72
  73                the more massive the particle.
  74
  75                In _\bl_\bi_\bn_\be_\bs mode, the control points are connected by
  76                straight lines; the effect is something like  _\bq_\bi_\bx.
  77
  78                In _\bp_\bo_\bl_\by_\bg_\bo_\bn_\bs mode, the control points are connected
  79                by straight lines, and filled in.   This  is  most
  80                interesting in color.
  81
  82                In  _\bs_\bp_\bl_\bi_\bn_\be_\bs  mode, a closed spline is interpolated
  83                from the control points.
  84
  85                In _\bf_\bi_\bl_\bl_\be_\bd_\b-_\bs_\bp_\bl_\bi_\bn_\be_\bs mode, the splines are filled  in
  86                instead of being outlines.  This is most interest-
  87                ing in color.
  88
  89                In _\bt_\ba_\bi_\bl_\bs mode, the path which each  particle  fol-
  90                lows  is  indicated  by  a  worm-like trail, whose
  91                length is controlled by the _\bs_\be_\bg_\bm_\be_\bn_\bt_\bs parameter.
  92
  93        -\b-s\bsi\biz\bze\be i\bin\bnt\bte\beg\bge\ber\br
  94                The size of the balls in pixels, or 0, meaning  to
  95                select  the sizes randomly (the default.)  If this
  96                is specified, then all  balls  will  be  the  same
  97                size.   This  option  has  an effect in all modes,
  98                since the ``size'' of  the  balls  controls  their
  99                mass.
 100
 101        -\b-s\bse\beg\bgm\bme\ben\bnt\bts\bs i\bin\bnt\bte\beg\bge\ber\br
 102                If  in  _\bl_\bi_\bn_\be_\bs  or  _\bp_\bo_\bl_\by_\bg_\bo_\bn_\bs mode, how many sets of
 103                line segments or polygons should be drawn. Default
 104                100.   This  has no effect in _\bb_\ba_\bl_\bl_\bs mode.  If _\bs_\be_\bg_\b-
 105                _\bm_\be_\bn_\bt_\bs is 0, then no segments will ever  be  erased
 106                (this is only useful in color.)
 107
 108        -\b-d\bde\bel\bla\bay\by m\bmi\bic\bcr\bro\bos\bse\bec\bco\bon\bnd\bds\bs
 109                How  much  of a delay should be introduced between
 110                steps of the animation.  Default 10000,  or  about
 111                0.01 seconds.
 112
 113        -\b-c\bco\bol\blo\bor\br-\b-s\bsh\bhi\bif\bft\bt i\bin\bnt\bt
 114                If  on a color display, the color of the line seg-
 115                ments or polygons will  cycle  through  the  color
 116                map.   This specifies how many lines will be drawn
 117                before a new color is chosen.  (When a small  num-
 118                ber of colors are available, increasing this value
 119                will  yield  smoother  transitions.)   Default  3.
 120                This has no effect in _\bb_\ba_\bl_\bl_\bs mode.
 121
 122        -\b-r\bra\bad\bdi\biu\bus\bs The  size  in  pixels  of  the circle on which the
 123                points are initially positioned.  The  default  is
 124                slightly smaller than the size of the window.
 125
 126        -\b-g\bgl\blo\bow\bw   This  is consulted only in _\bb_\ba_\bl_\bl_\bs mode.  If this is
 127
 128
 129
 130 X Version 11                14-Jun-97                           2
 131
 132
 133
 134
 135
 136 XScreenSaver(1)                                   XScreenSaver(1)
 137
 138
 139                specified, then the saturation of  the  colors  of
 140                the  points  will  vary according to their current
 141                acceleration.  This has the effect that the  balls
 142                flare  brighter  when  they  are  reacting to each
 143                other most strongly.
 144
 145                In _\bg_\bl_\bo_\bw mode, all of the balls will be  drawn  the
 146                same (random) color, modulo the saturation shifts.
 147                In non-glow mode, the balls will each be drawn  in
 148                a random color that doesn't change.
 149
 150        -\b-n\bno\bog\bgl\blo\bow\bw Don't do ``glowing.''  This is the default.
 151
 152        -\b-v\bvx\bx p\bpi\bix\bxe\bel\bls\bs
 153
 154        -\b-v\bvy\by p\bpi\bix\bxe\bel\bls\bs
 155                Initial velocity of the balls.  This has no effect
 156                in -\b-o\bor\brb\bbi\bit\bt mode.
 157
 158        -\b-o\bor\brb\bbi\bit\bt  Make the initial force on each ball be  tangential
 159                to  the circle on which they are initially placed,
 160                with the right velocity  to  hold  them  in  orbit
 161                about  each other.  After a while, roundoff errors
 162                will cause the orbit to decay.
 163
 164        -\b-v\bvm\bmu\bul\blt\bt f\bfl\blo\boa\bat\bt
 165                In orbit mode, the initial velocity of  the  balls
 166                is  multiplied  by this; a number less than 1 will
 167                make the balls pull closer together, and a  larger
 168                number  will make them move apart.  The default is
 169                0.9, meaning a slight inward pull.
 170
 171        -\b-v\bvi\bis\bsc\bco\bos\bsi\bit\bty\by f\bfl\blo\boa\bat\bt
 172                This sets the viscosity of the hypothetical  fluid
 173                through which the control points move; the default
 174                is 1, meaning no resistance.  Values higher than 1
 175                aren't   interesting;   lower  values  cause  less
 176                motion.
 177
 178                One interesting thing to try is
 179
 180                     attraction -viscosity 0.8 -points 75 \
 181                       -mouse -geometry =500x500
 182
 183                Give it a few seconds to settle down into a stable
 184                clump,  and then move the mouse through it to make
 185                "waves".
 186
 187        -\b-m\bmo\bou\bus\bse\be  This will cause the mouse to be considered a  con-
 188                trol  point;  it  will  not  be drawn, but it will
 189                influence the other points, so you  can  wave  the
 190                mouse and influence the images being created.
 191
 192
 193
 194
 195
 196 X Version 11                14-Jun-97                           3
 197
 198
 199
 200
 201
 202 XScreenSaver(1)                                   XScreenSaver(1)
 203
 204
 205        -\b-n\bno\bo-\b-m\bmo\bou\bus\bse\be
 206                Turns off -\b-m\bmo\bou\bus\bse\be.
 207
 208        -\b-m\bmo\bou\bus\bse\be-\b-s\bsi\biz\bze\be i\bin\bnt\bte\beg\bge\ber\br
 209                In  -\b-m\bmo\bou\bus\bse\be  mode,  this sets the mass of the mouse
 210                (analagously to the -\b-s\bsi\biz\bze\be parameter.)
 211
 212 E\bEN\bNV\bVI\bIR\bRO\bON\bNM\bME\bEN\bNT\bT
 213        D\bDI\bIS\bSP\bPL\bLA\bAY\bY to get the default host and display number.
 214
 215        X\bXE\bEN\bNV\bVI\bIR\bRO\bON\bNM\bME\bEN\bNT\bT
 216                to get the name of a resource file that  overrides
 217                the  global  resources stored in the RESOURCE_MAN-
 218                AGER property.
 219
 220 S\bSE\bEE\bE A\bAL\bLS\bSO\bO
 221        X\bX(1), x\bxs\bsc\bcr\bre\bee\ben\bns\bsa\bav\bve\ber\br(1)
 222
 223 C\bCO\bOP\bPY\bYR\bRI\bIG\bGH\bHT\bT
 224        Copyright (C) 1992, 1993, 1997 by Jamie Zawinski.  Permis-
 225        sion to use, copy, modify, distribute, and sell this soft-
 226        ware and its  documentation  for  any  purpose  is  hereby
 227        granted  without  fee,  provided  that the above copyright
 228        notice appear in all copies and that both  that  copyright
 229        notice  and  this  permission  notice appear in supporting
 230        documentation.  No  representations  are  made  about  the
 231        suitability  of this software for any purpose.  It is pro-
 232        vided "as is" without express or implied warranty.
 233
 234 A\bAU\bUT\bTH\bHO\bOR\bR
 235        Jamie Zawinski <jwz@jwz.org>, 13-aug-92.
 236
 237        Viscosity and mouse support by Philip Edward Cutone,  III.
 238
 239
 240
 241
 242
 243
 244
 245
 246
 247
 248
 249
 250
 251
 252
 253
 254
 255
 256
 257
 258
 259
 260
 261
 262 X Version 11                14-Jun-97                           4
 263
 264