[\-spacing \fIint\fP]
[\-border \fIint\fP]
[\-circles | \-squares | \-random]
+[\-grab]
+[\-peek]
.SH DESCRIPTION
Packs the screen with growing boxes or circles, colored according to a
horizontal or vertical gradient. The objects grow until they touch,
.TP 8
.B \-circles\fB | \-squares\fP | \-random\fP
Draw circles, squares, or choose randomly (the default).
+.TP 8
+.B \-grab
+Normally it colors the boxes with a horizontal or vertical gradient.
+If \fI\-grab\fP is specified, it will instead load a random image,
+and color the boxes according to the colors in that image.
+As the picture fills in, some features of the underlying image
+may become recognisable.
+
+When grabbing images, the image 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.
+.TP 8
+.B \-peek
+This option says to briefly show you the underlying image before
+beginning. The default is not to show the unadulterated image at all.
+(This only has an effect when \fI\-grab\fP is used.)
.SH ENVIRONMENT
.PP
.TP 8
.SH SEE ALSO
.BR X (1),
.BR xscreensaver (1)
+.BR xscreensaver\-demo (1),
+.BR xscreensaver\-getimage (1)
.SH COPYRIGHT
Copyright \(co 2005 by Jamie Zawinski. Permission to use, copy, modify,
distribute, and sell this software and its documentation for any purpose is