View Source: xscreensaver-getimage(1) - Waikato Linux Users Group

Edit PageHistory Diff Info LikePages

XScreenSaver
!!!XScreenSaver
NAME
SYNOPSIS
DESCRIPTION
OPTIONS
BUGS
SEE ALSO
COPYRIGHT
AUTHOR
----
!!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 captured 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 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
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 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
!!AUTHOR


Jamie Zawinski
----

15 pages link to xscreensaver-getimage(1):

This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.

Last edited on Tuesday, June 4, 2002 12:23:03 am by "perry"

Edit PageHistory Diff Info LikePages