This program selects a random image, and puts it on the specified window or pixmap. This image might be a snapshot of the desktop; or a frame captured from the system's video input; or a randomly-selected image from disk.

If only a window ID is specified, the image will be painted there. If both a window ID and a pixmap ID are specified, then the image will be painted on the pixmap; and the window may be modified as a side-effect.

grabDesktopImages

Whether it is acceptable to grab snapshots of the desktop. The security paranoid might want to turn this off, to avoid letting people see (but not touch!) your desktop while the screen is locked.

grabVideoFrames

Whether it is acceptable to grab frames of video from the system's video input. Grabbing of video is done by invoking the xscreensaver-getimage-video(1) program.

chooseRandomImages

Whether it is acceptable to display random images found on disk. Selection and loading of images is done by invoking the xscreensaver-getimage-file(1) program.

imageDirectory

When loading images from disk, this is the directory to search. The directory will be searched recursively, and all files in it are assumed to be images.

If none of the three options are set to True, then video colorbars will be displayed instead.