Provided by: xscreensaver-data_5.11-1ubuntu2_i386 bug

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(1)  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(1),  xscreensaver(1), xscreensaver-demo(1), xscreensaver-getimage(1),
       xv(1), xli(1), xloadimage(1), chbg(1)

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