XScreenSaver(r)                                   XScreenSaver(r)



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

SYNOPSIS
       xscreensaver-getimage-file [-display  host:display.screen]
       [--verbose] [--name] directory

DESCRIPTION
       The xscreensaver-getimage-file program is a helper program
       for  the  xscreensaver  hacks  that   manipulate   images.
       Specifically, it is invoked by xscreensaver-getimage(e) as
       needed.  This is not a user-level command.

       This program selects a random image from disk,  and  loads
       it on the root window.  It does this by figuring out which
       image-loading programs are installed on  the  system,  and
       invoking the first one it finds.

OPTIONS
       xscreensaver-getimage-file accepts the following options:

       --verbose
           Print diagnostics.

       --name
           Don't  load an image: instead just print the file name
           to stdout.

       directory
           The directory  to  search.    The  directory  will  be
           searched  recursively, and all files in it are assumed
           to be images.

SEE ALSO
       X(X),  xscreensaver(r),   xscreensaver-demo(o),   xscreen-
       saver-getimage(e), xv(v), xli(i), xloadimage(e), chbg(g)

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

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



X Version 11            25-Oct-2001 (3.34)        XScreenSaver(r)