Provided by: xscreensaver-data_5.15-2ubuntu1_i386 bug

NAME

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

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  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-demo(1)
       xscreensaver-getimage-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
       warranty.

AUTHOR

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