X-Git-Url: http://git.hungrycats.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=hacks%2Fattraction.man;h=f49257863d82ccb2b1e8881435993b7a9c8d6245;hb=3c58fb6311db49c46f1670922933b27c6ea0c065;hp=e3f94243a7005430b29fc4a95fab545f2f9d65f5;hpb=ccbc9f87eb59497b23bd0424ee1ed20ad7c7db54;p=xscreensaver diff --git a/hacks/attraction.man b/hacks/attraction.man index e3f94243..f4925786 100644 --- a/hacks/attraction.man +++ b/hacks/attraction.man @@ -11,12 +11,21 @@ .if n .sp 1 .if t .sp .5 .. -.TH XScreenSaver 1 "14-Dec-95" "X Version 11" +.TH XScreenSaver 1 "14-Jun-97" "X Version 11" .SH NAME attraction - interactions of opposing forces .SH SYNOPSIS .B attraction -[\-display \fIhost:display.screen\fP] [\-foreground \fIcolor\fP] [\-background \fIcolor\fP] [\-window] [\-root] [\-mono] [\-install] [\-visual \fIvisual\fP] [\-points \fIint\fP] [\-threshold \fIint\fP] [\-mode balls | lines | polygons | splines | filled-splines | tails ] [\-color-mode cycle | random] [\-size \fIint\fP] [\-segments \fIint\fP] [\-delay \fIusecs\fP] [\-color-shift \fIdegrees\fP] [\-radius \fIint\fP] [\-vx \fIint\fP] [\-vy \fIint\fP] [\-glow] [\-noglow] [\-orbit] [\-viscosity \fIfloat\fP] [\-mouse] [\-no-mouse] [\-mouse-size] +[\-display \fIhost:display.screen\fP] [\-foreground \fIcolor\fP] +[\-background \fIcolor\fP] [\-window] [\-root] [\-mono] [\-install] +[\-visual \fIvisual\fP] [\-points \fIint\fP] [\-threshold \fIint\fP] +[\-mode balls | lines | polygons | splines | filled-splines | tails ] +[\-size \fIint\fP] [\-segments \fIint\fP] [\-delay \fIusecs\fP] +[\-color-shift \fIint\fP] [\-radius \fIint\fP] +[\-vx \fIint\fP] [\-vy \fIint\fP] [\-glow] [\-noglow] +[\-orbit] [\-viscosity \fIfloat\fP] [\-mouse] [\-no-mouse] [\-mouse-size] +[\-walls] [\-nowalls] [\-maxspeed] [\-nomaxspeed] +[\-correct-bounce] [\-fast-bounce] .SH DESCRIPTION The \fIattraction\fP program has several visually different modes of operation, all of which are based on the interactions of a set of control @@ -71,9 +80,6 @@ In \fItails\fP mode, the path which each particle follows is indicated by a worm-like trail, whose length is controlled by the \fIsegments\fP parameter. .TP 8 -.B \-color-mode cycle | random -Whether colors should cycle through the spectrum, or be picked randomly. -.TP 8 .B \-size integer 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 @@ -90,10 +96,11 @@ is only useful in color.) How much of a delay should be introduced between steps of the animation. Default 10000, or about 0.01 seconds. .TP 8 -.B \-color-shift degrees +.B \-color-shift int If on a color display, the color of the line segments or polygons will -cycle through the spectrum. This specifies how far the hue of each segment -should be from the next, in degrees on the HSV wheel. Default 3. +cycle through the color map. This specifies how many lines will be drawn +before a new color is chosen. (When a small number of colors are available, +increasing this value will yield smoother transitions.) Default 3. This has no effect in \fIballs\fP mode. .TP 8 .B \-radius @@ -127,7 +134,8 @@ to decay. .B \-vmult float 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 1, meaning stability. +number will make them move apart. The default is 0.9, meaning a slight +inward pull. .TP 8 .B \-viscosity float This sets the viscosity of the hypothetical fluid through which the control @@ -153,9 +161,42 @@ Turns off \fB\-mouse\fP. .B \-mouse-size integer In \fB\-mouse\fP mode, this sets the mass of the mouse (analagously to the \fB\-size\fP parameter.) -.SH ENVIRONMENT -.PP .TP 8 +.B \-nowalls +This will cause the balls to continue on past the edge of the +screen or window. They will still be kept track of and can come back. +.TP 8 +.B \-walls +This will cause the balls to bounce when they get +to the edge of the screen or window. This is the default behavior. +.TP 8 +.B \-maxspeed +Imposes a maximum speed (default). If a ball ends up going faster than +this, it will be treated as though there were .9 viscosity until it is +under the limit. This stops the balls from continually accelerating (which +they have a tendancy to do), but also causes balls moving very fast to +tend to clump in the lower right corner. +.TP 8 +.B \-nomaxspeed +If this is specified, no maximum speed is set for the balls. +.TP 8 +.B \-fast-bounce +Uses the old, simple bouncing algorithm (default). This simply moves any +ball that is out of bounds back to a wall and reverses its velocity. +This works fine for most cases, but under some circumstances, the +simplification can lead to annoying effects. +.TP 8 +.B \-correct-bounce +Uses a more intelligent bouncing algorithm. This method actually reflects +the balls off the walls until they are within bounds. This can be slow +if balls are bouncing a whole lot, perhaps because of -nomaxspeed. +.TP 8 +.B \-graphmode none | x | y | both | speed +For "x", "y", and "both", displays the given velocities of each ball as a +bar graph in the same window as the balls. For "speed", displays the total +speed of each ball. Default is "none". +.BR +.SH ENVIRONMENT .B DISPLAY to get the default host and display number. .TP 8 @@ -166,14 +207,17 @@ stored in the RESOURCE_MANAGER property. .BR X (1), .BR xscreensaver (1) .SH COPYRIGHT -Copyright \(co 1992, 1993 by Jamie Zawinski. Permission to use, copy, modify, -distribute, and sell this software 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 provided "as is" without -express or implied warranty. +Copyright \(co 1992, 1993, 1997 by Jamie Zawinski. Permission to use, copy, +modify, distribute, and sell this software 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 provided +"as is" without express or implied warranty. .SH AUTHOR -Jamie Zawinski , 13-aug-92. +Jamie Zawinski , 13-aug-92. Viscosity and mouse support by Philip Edward Cutone, III. + +Walls, speed limit options, new bouncing, graphs, and tail mode fix by +Matthew Strait. 31 March 2001