ftp://ftp.krokus.ru/pub/OpenBSD/distfiles/xscreensaver-4.06.tar.gz

[xscreensaver] / hacks / distort.man

diff --git a/hacks/distort.man b/hacks/distort.man
index 92facfc38d8ecc4dbf9cdc485e8fed172ae1447c..ccc1c5bb31eea4d3ca620cc1940731adc1cce874 100644 (file)
--- a/hacks/distort.man
+++ b/hacks/distort.man
@@ -3,12 +3,24 @@
 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] [\-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:


@@ -50,7 +62,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 +102,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