|Linux & Unix Commands - Search Man Pages
xscreensaver-getimage - put some randomly-selected image on the root window
xscreensaver-getimage [-display host:display.screen] [--verbose] window-id
The xscreensaver-getimage program is a helper program for the xscreensaver hacks that
manipulate images. This is not a user-level command.
This program selects a random image, and puts it on the specified window. 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.
xscreensaver-getimage reads the ~/.xscreensaver file for configuration information. It
uses these settings:
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 system's video input. Grab-
bing of video is done by invoking the xscreensaver-getimage-video(1) program.
Whether it is acceptable to display random images found on disk. Selection and load-
ing of images is done by invoking the xscreensaver-getimage-file(1) program.
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
If the target window is not the root window, then this program will always grab a desktop
image. This means that if an image-manipulating xscreensaver mode is run in a normal win-
dow, it will always operate on a desktop image; it's only when it is run in -root mode (or
when invoked by xscreensaver) that it will load image files or grab video.
X(1), xscreensaver(1) xscreensaver-demo(1) xscreensaver-getimage-file(1) xscreen-
Copyright (C) 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 warranty.
Jamie Zawinski <firstname.lastname@example.org>, 14-Apr-01
X Version 11 03-Feb-2003 (4.07) XScreenSaver(1)
All times are GMT -4. The time now is 05:56 AM.