git.hungrycats.org Git - xscreensaver/blob - hacks/attraction.hlp

   1 1 ATTRACTION
   2 Interactions of opposing forces
   3
   4 SYNOPSIS
   5
   6  $ attraction [-display host:display.screen] [-foreground color]
   7               [-background color] [-window] [-root] [-mono] [-points int]
   8               [-threshold int]
   9            [-mode balls | lines | polygons | splines | filled-splines | tails ]
  10               [-color-mode cycle | random] [-size int] [-segments int]
  11               [-delay usecs] [-color-shift degrees] [-radius int] [-vx int]
  12               [-vy int] [-glow] [-noglow] [-orbit]
  13
  14 2 DESCRIPTION
  15 The attraction program has several visually different modes of
  16 operation, all of which are based on the interactions of a set of control
  17 points which attract each other up to a certain distance, and then begin
  18 to repel each other.  The attraction/repulsion is proportional to the
  19 distance between any two particles.
  20
  21 2 OPTIONS
  22 Attraction accepts the following options:
  23
  24     -window
  25 Draw on a newly-created window.  This is the default.
  26
  27     -root
  28 Draw on the root window.
  29
  30     -mono
  31 If on a color display, pretend we're on a monochrome display.
  32
  33     -points integer
  34 How many control points should be used, or 0 to select the number randomly.
  35 Default 0.  Between 3 and 15 works best.
  36
  37     -threshold integer
  38 The distance (in pixels) from each particle at which the attractive force
  39 becomes repulsive.  Default 100.
  40
  41     -mode "balls | lines | polygons | tails | splines | filled-splines"
  42 In balls mode (the default) the control points are drawn as filled
  43 circles.  The larger the circle, the more massive the particle.
  44
  45 In lines mode, the control points are connected by straight lines;
  46 the effect is something like qix.
  47
  48 In polygons mode, the control points are connected by straight
  49 lines, and filled in.  This is most interesting in color.
  50
  51 In splines mode, a closed spline is interpolated from the control
  52 points.
  53
  54 In filled-splines mode, the splines are filled in instead of being
  55 outlines.  This is most interesting in color.
  56
  57 In tails mode, the path which each particle follows is indicated
  58 by a worm-like trail, whose length is controlled by the segments
  59 parameter.
  60
  61     -color-mode cycle | random
  62 Whether colors should cycle through the spectrum, or be picked randomly.
  63
  64     -size integer
  65 The size of the balls in pixels, or 0, meaning to select the sizes
  66 randomly (the default.)  If this is specified, then all balls will be
  67 the same size.  This option has an effect in all modes, since the ``size''
  68 of the balls controls their mass.
  69
  70     -segments integer
  71 If in lines or polygons mode, how many sets of line segments
  72 or polygons should be drawn. Default 100.  This has no effect in balls
  73 mode.  If segments is 0, then no segments will ever be erased (this
  74 is only useful in color.)
  75
  76     -delay microseconds
  77 How much of a delay should be introduced between steps of the animation.
  78 Default 10000, or about 0.01 seconds.
  79
  80     -color-shift degrees
  81 If on a color display, the color of the line segments or polygons will
  82 cycle through the spectrum.  This specifies how far the hue of each segment
  83 should be from the next, in degrees on the HSV wheel.  Default 3.
  84 This has no effect in balls mode.
  85
  86     -radius
  87 The size in pixels of the circle on which the points are initially positioned.
  88 The default is slightly smaller than the size of the window.
  89
  90     -glow
  91 This is consulted only in balls mode.  If this is specified, then
  92 the saturation of the colors of the points will vary according to their
  93 current acceleration.  This has the effect that the balls flare brighter
  94 when they are reacting to each other most strongly.
  95
  96 In glow mode, all of the balls will be drawn the same (random)
  97 color, modulo the saturation shifts.  In non-glow mode, the balls will
  98 each be drawn in a random color that doesn't change.
  99
 100     -noglow
 101 Don't do ``glowing.''  This is the default.
 102
 103     -vx pixels
 104
 105     -vy pixels
 106 Initial velocity of the balls.  This has no effect in \fB\-orbit mode.
 107
 108     -orbit
 109 Make the initial force on each ball be tangential to the circle on which
 110 they are initially placed, with the right velocity to hold them in orbit
 111 about each other.  After a while, roundoff errors will cause the orbit
 112 to decay.
 113
 114     -vmult float
 115 In orbit mode, the initial velocity of the balls is multiplied by this;
 116 a number less than 1 will make the balls pull closer together, and a larger
 117 number will make them move apart.  The default is 1, meaning stability.
 118
 119 2 COPYRIGHT
 120 Copyright (co 1992, 1993 by Jamie Zawinski.  Permission to use, copy, modify,
 121 distribute, and sell this software and its documentation for any purpose is
 122 hereby granted without fee, provided that the above copyright notice appear
 123 in all copies and that both that copyright notice and this permission notice
 124 appear in supporting documentation.  No representations are made about the
 125 suitability of this software for any purpose.  It is provided "as is" without
 126 express or implied warranty.
 127
 128 2 AUTHOR
 129 Jamie Zawinski <jwz@mcom.com>, 13-aug-92.