Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   20652 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

XScreenSaver(1)						       XScreenSaver(1)

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

SYNOPSIS
       xscreensaver-getimage [-display host:display.screen]  [--verbose]  win‐
       dow-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.   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  xscreen‐
	   saver-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-getim‐
       age-file(1) xscreensaver-getimage-video(1)

COPYRIGHT
       Copyright  ©  2001 by Jamie Zawinski.  Permission to use, copy, modify,
       distribute, and sell this software and its documentation for  any  pur‐
       pose  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 repre‐
       sentations are made about the suitability of this software for any pur‐
       pose.  It is provided "as is" without express or implied warranty.

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

X Version 11		      11-Jun-2002 (4.05)	       XScreenSaver(1)

Vote for polarhome