Manual Reference Pages - XSCREENSAVER-GETIMAGE (1)
xscreensaver-getimage - put some randomly-selected image on the root window
xscreensaver-getimage [-display host:display.screen] [--verbose] window-id [pixmap-id]
The xscreensaver-getimage program is a helper program for the
xscreensaver hacks that manipulate images. This is not a user-level
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 systems 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
xscreensaver-getimage reads the ~/.xscreensaver file for configuration information.
It uses these settings:
If none of the three options are set to True, then video
colorbars will be displayed instead.
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.
Whether it is acceptable to grab frames of video from the systems video
input. Grabbing of video is done by invoking the
Whether it is acceptable to display random images found on disk.
Selection and loading of images is done by invoking the
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.
When grabbing desktop images, the window argument will be unmapped
and have its contents modified, causing flicker. (This does not happen
when loading image files or video frames.)
Copyright © 2001 by Jamie Zawinski. Permission to use, copy,
modify, distribute, and sell this software and its documentation for
any purpose is hereby granted without fee, provided that the above
copyright notice appear in all copies and that both that copyright
notice and this permission notice appear in supporting documentation.
No representations are made about the suitability of this software for
any purpose. It is provided "as is" without express or implied
Jamie Zawinski <firstname.lastname@example.org>, 14-Apr-01
|X Version 11 ||XSCREENSAVER (1) ||20-Mar-2005 (4.21) |
Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.