GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  XSCREENSAVER-GETIMAGE (1)

NAME

xscreensaver-getimage - put some randomly-selected image on the root window

CONTENTS

Synopsis
Description
Options
Bugs
See Also
Copyright
Author

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 is not a user-level command.

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 information. It uses these settings:
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.

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-demo(1) xscreensaver-getimage-file(1) xscreensaver-getimage-video(1)

COPYRIGHT

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 warranty.

AUTHOR

Jamie Zawinski <jwz@jwz.org>, 14-Apr-01
Search for    or go to Top of page |  Section 1 |  Main Index


X Version 11 XSCREENSAVER (1) 20-Mar-2005 (4.21)

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.