http://www.tienza.es/crux/src/www.jwz.org/xscreensaver/xscreensaver-5.06.tar.gz

[xscreensaver] / hacks / distort.man

diff --git a/hacks/distort.man b/hacks/distort.man
index 92facfc38d8ecc4dbf9cdc485e8fed172ae1447c..ee97bca234cebe08727ffaa96be332211fab44f6 100644 (file)
--- a/hacks/distort.man
+++ b/hacks/distort.man
@@ -3,12 +3,35 @@
 distort \- distort the content of the screen in interesting ways
 .SH SYNOPSIS
 .B distort
 distort \- distort the content of the screen in interesting ways
 .SH SYNOPSIS
 .B distort

-[\-root] [\-window] [\-mono] [\-install] [\-noinstall] [\-visual \fIvisual\fP] [\-window\-id \fIwindow\-id\fP] [\-delay \fIusecs\fP] [\-radius \fIpixels\fP] [\-speed \fIint\fP] [\-number \fIint\fP] [\-swamp] [\-bounce] [\-reflect] [\-vortex] [\-magnify] [\-blackhole] [\-slow] [\-shm] [\-no\-shm]
+[\-root] [\-window] [\-mono] [\-install] [\-noinstall] [\-visual \fIvisual\fP]
+[\-window\-id \fIwindow\-id\fP]
+[\-delay \fIusecs\fP]
+[\-duration \fIsecs\fP]
+[\-radius \fIpixels\fP]
+[\-speed \fIint\fP]
+[\-number \fIint\fP]
+[\-swamp]
+[\-bounce]
+[\-reflect]
+[\-vortex]
+[\-magnify]
+[\-blackhole]
+[\-slow]
+[\-shm] [\-no\-shm]

 .SH DESCRIPTION
 .SH DESCRIPTION

-The \fIdistort\fP program lets circular zones of distortion wander
-randomly around its window, apparently distorting what is under them
-due to the window's pseudo-transparency. The mode of distortion and
-the overall behaviour of the zones can be influenced in various ways.
+The \fIdistort\fP program takes an image and lets circular zones of
+distortion wander randomly around it, distorting what is under them.
+The mode of distortion and the overall behaviour of the zones can be
+influenced in various ways.
+
+The image that it manipulates will be grabbed from the portion of
+the screen underlying the window, or from the system's video input,
+or from a random file on disk, as indicated by
+the \fIgrabDesktopImages\fP, \fIgrabVideoFrames\fP,
+and \fIchooseRandomImages\fP options in the \fI~/.xscreensaver\fP
+file; see
+.BR xscreensaver-demo (1)
+for more details.

 .SH OPTIONS
 .I distort
 accepts the following options:
 .SH OPTIONS
 .I distort
 accepts the following options:


@@ -38,6 +61,9 @@ Specify which window id to use.
 .B \-delay \fIusecs\fP
 Specify the delay between subsequent animation frames in microseconds.
 .TP 8
 .B \-delay \fIusecs\fP
 Specify the delay between subsequent animation frames in microseconds.
 .TP 8

+.B \-duration \fIseconds\fP
+How long to run before loading a new image.  Default 120 seconds.
+.TP 8

 .B \-radius \fIpixels\fP
 Specify the radius of the distortion zone in pixels.
 .TP 8
 .B \-radius \fIpixels\fP
 Specify the radius of the distortion zone in pixels.
 .TP 8


@@ -50,7 +76,9 @@ Specify the number of distortion zones.
 .TP 8
 .B \-swamp
 Instead of letting zones wander around, let small zones pop up like
 .TP 8
 .B \-swamp
 Instead of letting zones wander around, let small zones pop up like

-bubbles in a swamp and leave permanent distortion.
+bubbles in a swamp and leave permanent distortion.  \fBWARNING:\fP
+this option uses a \fIcolossal\fP amount of memory: keep the \fI\-radius\fP
+small when using \fI\-swamp\fP.

 .TP 8
 .B \-bounce
 Let zones wander around and bounce off the window border. This is the
 .TP 8
 .B \-bounce
 Let zones wander around and bounce off the window border. This is the


@@ -88,7 +116,9 @@ to get the name of a resource file that overrides the global resources
 stored in the RESOURCE_MANAGER property.
 .SH SEE ALSO
 .BR X (1),
 stored in the RESOURCE_MANAGER property.
 .SH SEE ALSO
 .BR X (1),

-.BR xscreensaver (1)
+.BR xscreensaver (1),
+.BR xscreensaver\-demo (1),
+.BR xscreensaver\-getimage (1)

 .SH COPYRIGHT
 Copyright \(co 1998 by Jonas Munsin and Jamie Zawinski.  Permission to use, 
 copy, modify, distribute, and sell this software and its documentation for
 .SH COPYRIGHT
 Copyright \(co 1998 by Jonas Munsin and Jamie Zawinski.  Permission to use, 
 copy, modify, distribute, and sell this software and its documentation for