xscreensaver-getimage(6) XScreenSaver manual xscreensaver-getimage(6) NAME xscreensaver-getimage - loads a randomly-selected image onto an X11 Draw- able for use by screen savers SYNOPSIS xscreensaver-getimage [--display host:display.screen] [--verbose] window-id [pixmap-id] DESCRIPTION The xscreensaver-getimage program is a helper program for the xscreensaver hacks that manipulate images. 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. OPTIONS xscreensaver-getimage reads the ~/.xscreensaver file for configuration in- formation. It uses these settings: grabDesktopImages Whether it is acceptable to grab snapshots of the desktop. The secu- rity 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 xscreen- saver-getimage-video(6) program. chooseRandomImages Whether it is acceptable to display random images found on disk. Se- lection and loading of images is done by invoking the xscreen- saver-getimage-file(6) program. imageDirectory When loading images from disk, this is the directory to find them in. The directory will be searched recursively for images. It may also be the URL of an RSS or Atom feed, in which case a random image from that feed will be selected instead. The contents of the feed will be cached locally and refreshed periodically as needed. If none of the three options are set to True, then video colorbars will be displayed instead. BUGS 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.) SEE ALSO X(1), xscreensaver(1) xscreensaver-settings(1) xscreensaver-getim- age-file(6) xscreensaver-getimage-video(6) COPYRIGHT Copyright (C) 2001-2021 by Jamie Zawinski. Permission to use, copy, mod- ify, distribute, and sell this software and its documentation for any pur- pose is hereby granted without fee, provided that the above copyright no- tice appear in all copies and that both that copyright notice and this per- mission notice appear in supporting documentation. No representations are made about the suitability of this software for any purpose. It is pro- vided "as is" without express or implied warranty. AUTHOR Jamie Zawinski <jwz@jwz.org>, 14-Apr-2001 X Version 11 6.15 (30-Mar-2026) xscreensaver-getimage(6)
NAME | SYNOPSIS | DESCRIPTION | OPTIONS | BUGS | SEE ALSO | COPYRIGHT | AUTHOR
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=xscreensaver-getimage&sektion=6&manpath=FreeBSD+Ports+15.1.quarterly>