X-Git-Url: http://git.hungrycats.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=hacks%2Fdecayscreen.man;h=76823f3dd89b88a7e1e481a39f2979ab37452b68;hb=de460e831dc8578acfa8b72251ab9346c99c1f96;hp=8dc0a0e7aaee8e820e64f4c005049b644fe643c8;hpb=df7adbee81405e2849728a24b498ad2117784b1f;p=xscreensaver diff --git a/hacks/decayscreen.man b/hacks/decayscreen.man index 8dc0a0e7..76823f3d 100644 --- a/hacks/decayscreen.man +++ b/hacks/decayscreen.man @@ -3,10 +3,27 @@ decayscreen - make a screen meltdown. .SH SYNOPSIS .B decayscreen -[\-display \fIhost:display.screen\fP] [\-window] [\-root] [\-mono] [\-install] [\-visual \fIvisual\fP] [\-delay \fIusecs\fP] [\-mode \fImode\fP] +[\-display \fIhost:display.screen\fP] +[\-window] +[\-root] +[\-mono] +[\-install] +[\-visual \fIvisual\fP] +[\-delay \fIusecs\fP] +[\-duration \fIsecs\fP] +[\-mode \fImode\fP] .SH DESCRIPTION The \fIdecayscreen\fP program creates a melting effect by randomly shifting rectangles around the screen. + +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 decayscreen accepts the following options: @@ -30,38 +47,18 @@ or the id number (decimal or hex) of a specific visual. .B \-delay \fImicroseconds\fP Slow it down. .TP 8 +.B \-duration \fIseconds\fP +How long to run before loading a new image. Default 120 seconds. +.TP 8 .B \-mode \fImode\fP The direction in which the image should tend to slide. Legal values are \fIrandom\fP (meaning pick one), \fIup\fP, \fIleft\fP, \fIright\fP, \fIdown\fP, \fIupleft\fP, \fIdownleft\fP, \fIupright\fP, \fIdownright\fP, -\fIshuffle\fP (meaning perfer no particular direction), \fIin\fP (meaning +\fIshuffle\fP (meaning prefer no particular direction), \fIin\fP (meaning move things toward the center), \fIout\fP (meaning move things away -from the center), \fImelt\fP (meaning melt straight downward), and \fIstretch\fP -(meaning stretch the screen downward). -.SH RESOURCES -On some systems (currently, only SGIs), this program can, instead of grabbing -a desktop image, grab a frame of video from an external camera and manipulate -that instead. The following resources control that. -.PP -.TP 8 -.B grabVideoProbability \fR(Float)\fP -What portion of the time to grab video rather than a screen image, -between 0.0 and 1.0. Defaults to 0.5, or half the time. -.TP 8 -.B videoDevice \fR(Integer)\fP -The number of the default video input device to check first. If unspecified, -the default camera (from videopanel(1)) will be checked first. After that, all -other available video input devices will be checked in order. - -The first one which produces a non-black image will be used. If all images -are black, the others will be re-checked a few times before giving up and -falling back to simply grabbing a desktop image (but note that this takes a -few seconds, so if you don't actually have any video sources hooked up, you -should consider turning off video grabbing by setting -\fBgrabVideoProbability\fP to 0.0.) -.TP 8 -.B videoGain \fR(Float)\fP -The amount by which to brighten the grabbed image. This defaults to 2.2. +from the center), \fImelt\fP (meaning melt straight +downward), \fIstretch\fP (meaning stretch the screen downward), +and \fIfuzz\fP (meaning go blurry instead of melty). .SH ENVIRONMENT .PP .TP 8 @@ -72,8 +69,10 @@ to get the default host and display number. to get the name of a resource file that overrides the global resources stored in the RESOURCE_MANAGER property. .SH "SEE ALSO" -X(1), -xscreensaver(1) +.BR X (1), +.BR xscreensaver (1), +.BR xscreensaver\-demo (1), +.BR xscreensaver\-getimage (1) .SH COPYRIGHT Copyright 1992 by Vivek Khera. Permission to use, copy, modify, distribute, and sell this software and its documentation for any purpose is hereby granted @@ -84,5 +83,6 @@ of this software for any purpose. It is provided "as is" without express or implied warranty. .SH AUTHOR Vivek Khera , 05-Aug-93; based on code by David Wald, 1988. -Modified by jwz, 28-Nov-97. Modified by Rick Schultz 05-Apr-1999. - +Modified by jwz, 28-Nov-1997. +Modified by Rick Schultz 05-Apr-1999. +Modified by Vince Levey 25-Oct-2001.