xscreensaver-getimage-file(1) [opendarwin man page]

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

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

X Version 11							5.15 (28-Sep-2011)				     xscreensaver-getimage-file(1)

XScreenSaver(1) 					      General Commands Manual						   XScreenSaver(1)

NAME

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

SYNOPSIS

       xscreensaver-getimage [-display host:display.screen] [--verbose] window-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.  This image might be a snapshot of the desktop; or a frame cap-
       tured from the system's video input; or a randomly-selected image from disk.

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

       If the target window is not the root window, then this program will always grab a desktop image.  This means that if an	image-manipulating
       xscreensaver  mode  is  run  in a normal window, it will always operate on a desktop image; it's only when it is run in -root mode (or when
       invoked by xscreensaver) that it will load image files or grab video.

SEE ALSO

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

X Version 11							03-Feb-2003 (4.07)						   XScreenSaver(1)