xscreensaver-getimage(1)      XScreenSaver manual     xscreensaver-getimage(1)



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

SYNOPSIS
       xscreensaver-getimage [-display host:display.screen]  [--verbose]  win-
       dow-id [pixmap-id]

DESCRIPTION
       The  xscreensaver-getimage program is a helper program for the xscreen-
       saver hacks that manipulate images.  This is not a user-level command.

       This program selects a random image, and puts it on the specified  win-
       dow  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  xscreen-
           saver-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  xscreen-
           saver-getimage-file(1) 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 ran-
           dom 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-demo(1)    xscreensaver-getim-
       age-file(1) xscreensaver-getimage-video(1)

COPYRIGHT
       Copyright  (C)  2001-2011  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 war-
       ranty.

AUTHOR
       Jamie Zawinski <jwz@jwz.org>, 14-Apr-01



X Version 11                  5.30 (11-Sep-2014)      xscreensaver-getimage(1)
