X-Git-Url: http://git.hungrycats.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=hacks%2Fflow.man;h=ea3a2956b6cb4bca036755930a5a835ab5f083d5;hb=c1b9b55ad8d59dc05ef55e316aebf5863e7dfa56;hp=6215286f7bbfe2fabacc668e81c5fd32b5609824;hpb=13dbc569cdc6e29019722c0ef9b932a925efbcad;p=xscreensaver diff --git a/hacks/flow.man b/hacks/flow.man index 6215286f..ea3a2956 100644 --- a/hacks/flow.man +++ b/hacks/flow.man @@ -9,18 +9,20 @@ flow - strange attractors. [\-root] [\-count \fInumber\fP] [\-cycles \fInumber\fP] -[\-delay \fInumber\fP] +[\-periodic|\-no\-periodic] +[\-search|\-no\-search] +[\-rotate|\-no\-rotate] +[\-ride|\-no\-ride] +[\-box|\-no\-box] +[\-dbuf|\-no\-dbuf] [\-ncolors \fInumber\fP] -[\-rotate \fIbool\fP] -[\-ride \fIbool\fP] -[\-zoom \fIbool\fP] -[\-box \fIbool\fP] -[\-freeze \fIbool\fP] -[\-allow2d \fIbool\fP] -[\-slow \fIbool\fP] +[\-delay \fInumber\fP] +[\-fps] .SH DESCRIPTION -Another series of strange attractors: a flowing series of points, making -strange rotational shapes. +Strange attractors formed of flows in a 3D differential equation phase +space. Features the popular attractors described by \fBLorentz\fP, +\fBRoessler\fP, \fBBirkhoff\fP and \fBDuffing\fP, and can discover +entirely new attractors by itself. .SH OPTIONS .TP 8 .B \-visual \fIvisual\fP @@ -34,37 +36,69 @@ Draw on a newly-created window. This is the default. Draw on the root window. .TP 8 .B \-count \fInumber\fP -Number of pixels. Default: 500. +Number of particles in the flow. Default: 3000 +.TP 8 +.B \-size \fInumber\fP +Length of particle trails. Negative values indicate +randomness. The computational load of a given flow depends on +(particle count) * (trail length). Default: -10 .TP 8 .B \-cycles \fInumber\fP -Timeout before changing objects. 0 - 800000. Default: 3000. +Timeout before changing objects. 0 - 800000. Default: 10000. .TP 8 -.B \-delay \fInumber\fP -Per-frame delay, in microseconds. Default: 1000 (0.001 seconds.). +.B \-periodic .TP 8 -.B \-ncolors \fInumber\fP -Number of Colors. Default: 200. +.B \-no\-periodic +turn on/off periodic attractors. These are flows in 2 dependent +variables, with a periodic dependence on a third independent variable +(eg time). Flow will sometimes choose to start all the particles in +the same phase to illustrate the flow's cross-section. Default: +on +.TP 8 +.B \-search +.TP 8 +.B \-no\-search +turn on/off search for new attractors. If this is enabled, a fraction +of the computing cycles is directed to searching a 60-dimensional +parameter space for new strange attractors. If periodic flows are +enabled, these can be searched too. Watch carefully - you are quite +likely to see mathematical objects that have never been seen before, +and since the parameters are not recorded, you'll probably never see +them again! Default: on .TP 8 .B \-rotate -Rotate Around Attractor. +.TP 8 +.B \-no\-rotate +turn on/off rotating around attractor. Default: on .TP 8 .B \-ride -Ride a Trained Bee. .TP 8 -.B \-zoom -Zoom In and Out. +.B \-no\-ride +turn on/off ride in the flow. Default: on + +If both -rotate and -ride are enabled the viewpoint will occasionally +fly between the two views. .TP 8 .B \-box -Show Bounding Box. .TP 8 -.B \-freeze -Freeze Some Bees. +.B \-no\-box +turn on/off bounding box. Default: on +.TP 8 +.B \-dbuf .TP 8 -.B \-allow2d -Allow 2D Attractors. +.B \-no\-dbuf +turn on/off double buffering. If Flow runs slowly in full screen, but +fast in a smaller window (eg on old graphics cards with too little +memory), try turning this option off. Default: on +.TP 8 +.B \-ncolors \fInumber\fP +Number of Colors. Default: 200. +.TP 8 +.B \-delay \fInumber\fP +Per-frame delay, in microseconds. Default: 10000 (0.01 seconds.). .TP 8 -.B \-slow -Slow Bees with Antifreeze. +.B \-fps +Display the current frame rate and CPU load. .SH ENVIRONMENT .PP .TP 8 @@ -78,12 +112,26 @@ stored in the RESOURCE_MANAGER property. .BR X (1), .BR xscreensaver (1) .SH COPYRIGHT -Copyright \(co 2002 by Jeff Butterworth. 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 (c) 1996 by Tim Auckland +Incorporating some code from Stephen Davies Copyright (c) 2000 + +Search code based on techniques described in "Strange Attractors: +Creating Patterns in Chaos" by Julien C. Sprott + +Permission to use, copy, modify, and distribute this software and its +documentation for any purpose and without fee is hereby granted, +provided that the above copyright notice appear in all copies and that +both that copyright notice and this permission notice appear in +supporting documentation. + +This file is provided AS IS with no warranties of any kind. The author +shall have no liability with respect to the infringement of copyrights, +trade secrets or any patents by this file or any part thereof. In no +event will the author be liable for any lost revenue or profits or +other special, indirect and consequential damages. + +Adapted from swarm.c Copyright (c) 1991 by Patrick J. Naughton. + +Adapted from xswarm by Jeff Butterworth. (butterwo@ncsc.org). .SH AUTHOR -Jeff Butterworth. +Tim Auckland