http://ftp.nluug.nl/pub/os/Linux/distr/pardusrepo/sources/xscreensaver-5.02.tar.gz
[xscreensaver] / hacks / ifs.man
index 2d04eef31be42606ea6de41f029b53e847fecc5f..77408878870385f150a3c0ca4e6dec1b9bbc0336 100644 (file)
@@ -1,15 +1,28 @@
-.TH XScreenSaver 1 "10-May-97" "X Version 11"
+.TH XScreenSaver 1 "" "X Version 11"
 .SH NAME
 ifs - draws spinning, colliding iterated-function-system images
 .SH SYNOPSIS
 .B ifs
-[\-display \fIhost:display.screen\fP] [\-foreground \fIcolor\fP] [\-background \fIcolor\fP] [\-window] [\-root] [\-mono] [\-install] [\-visual \fIvisual\fP] [\-ncolors \fIinteger\fP] [\-delay \fImicroseconds\fP]
-
+[\-display \fIhost:display.screen\fP]
+[\-visual \fIvisual\fP]
+[\-window]
+[\-root]
+[\-no\-db]
+[\-delay \fInumber\fP]
+[\-detail \fInumber\fP]
+[\-colors \fInumber\fP]
+[\-functions \fInumber\fP]
+[\-iterate | \-recurse]
+[\-no\-rotate]
+[\-no\-scale]
+[\-no\-translate]
 .SH DESCRIPTION
 The \fIifs\fP program draws spinning, colliding iterated-function-system images.
 .SH OPTIONS
-.I ifs
-accepts the following options:
+.TP 8
+.B \-visual \fIvisual\fP
+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.
 .TP 8
 .B \-window
 Draw on a newly-created window.  This is the default.
@@ -17,20 +30,44 @@ Draw on a newly-created window.  This is the default.
 .B \-root
 Draw on the root window.
 .TP 8
-.B \-mono 
-If on a color display, pretend we're on a monochrome display.
+.B \-no\-db
+Disable double-buffering.
 .TP 8
-.B \-install
-Install a private colormap for the window.
+.B \-delay \fInumber\fP
+Per-frame delay, in microseconds.  Default: 20000
 .TP 8
-.B \-visual \fIvisual\fP
-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 \-colors \fInumber\fP
+Number of colours to use. Default: 200
+.TP 8
+.B \-detail \fInumber\fP
+In \fI\-iterate\fP mode, number of times to randomly iterate the
+functions, in thousands.  In \fI\-recurse\fP mode, number of times
+to apply functions (recursion depth) before drawing each point.
+Default: 9
 .TP 8
-.B \-ncolors \fIinteger\fP
-How many colors should be used (if possible).  Default 200.
-The colors used cycle through the hue, making N stops around
-the color wheel.
+.B \-functions \fInumber\fP
+Number of functions to be iterated. Default: 3
+.TP 8
+.B \-iterate
+Calculate by iteratively applying the functions in a random order,
+usually faster than \fI\-recurse\fP.  This is the default.
+.TP 8
+.B \-recurse
+Calculate by recursively applying all combinations of the functions.
+This is the historical behavior and may produce neater output than
+\fI\-iterate\fP.
+.TP 8
+.B \-no-rotate
+Disable the rotation component of the functions.
+.TP 8
+.B \-no-scale
+Disable the scaling component of the functions.
+.TP 8
+.B \-no-translate
+Disable the varying translation component of the functions.
+.TP 8
+.B \-no-multi
+Turn off multi-coloured mode, only one colour is used to colour the whole set.
 .SH ENVIRONMENT
 .PP
 .TP 8
@@ -43,17 +80,28 @@ stored in the RESOURCE_MANAGER property.
 .SH SEE ALSO
 .BR X (1),
 .BR xscreensaver (1),
-.BR xlock (1)
+.BR ifs (MANSUFFIX)
 .SH COPYRIGHT
-Copyright \(co 1997 by Massimino Pascal.
+Copyright \(co Chris Le Sueur and Robby Griffin, 2005-2006
 
-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. 
-.SH AUTHOR
-Massimino Pascal <Pascal.Massimon@ens.fr>, 1997.
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
 
-Ability to run standalone or with \fIxscreensaver\fP added by 
-Jamie Zawinski <jwz@jwz.org>, 10-May-97.
+The above copyright notice and this permission notice shall be included
+in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
+OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE X CONSORTIUM BE LIABLE FOR ANY CLAIM, DAMAGES OR
+OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
+ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+OTHER DEALINGS IN THE SOFTWARE.
+.SH AUTHOR
+This version by Chris Le Sueur <thefishface@gmail.com>, Feb 2005
+Many improvements by Robby Griffin <rmg@terc.edu>, Mar 2006