1xscreensaver-getimage(1)      XScreenSaver manual     xscreensaver-getimage(1)
2
3
4

NAME

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

SYNOPSIS

10       xscreensaver-getimage [-display host:display.screen]  [--verbose]  win‐
11       dow-id [pixmap-id]
12

DESCRIPTION

14       The  xscreensaver-getimage program is a helper program for the xscreen‐
15       saver hacks that manipulate images.  This is not a user-level command.
16
17       This program selects a random image, and puts it on the specified  win‐
18       dow  or  pixmap.   This  image might be a snapshot of the desktop; or a
19       frame captured from the system's video input;  or  a  randomly-selected
20       image from disk.
21
22       If  only a window ID is specified, the image will be painted there.  If
23       both a window ID and a pixmap ID are specified, then the image will  be
24       painted on the pixmap; and the window may be modified as a side-effect.
25

OPTIONS

27       xscreensaver-getimage  reads the ~/.xscreensaver file for configuration
28       information.  It uses these settings:
29
30       grabDesktopImages
31           Whether it is acceptable to grab snapshots  of  the  desktop.   The
32           security  paranoid  might  want  to turn this off, to avoid letting
33           people see (but not  touch!)  your  desktop  while  the  screen  is
34           locked.
35
36       grabVideoFrames
37           Whether  it is acceptable to grab frames of video from the system's
38           video input.  Grabbing of video is done by  invoking  the  xscreen‐
39           saver-getimage-video(1) program.
40
41       chooseRandomImages
42           Whether  it  is  acceptable to display random images found on disk.
43           Selection and loading of images is done by  invoking  the  xscreen‐
44           saver-getimage-file(1) program.
45
46       imageDirectory
47           When  loading  images  from  disk, this is the directory to search.
48           The directory will be searched recursively, and all files in it are
49           assumed to be images.
50
51       If none of the three options are set to True, then video colorbars will
52       be displayed instead.
53

BUGS

55       When grabbing desktop images, the window argument will be unmapped  and
56       have  its  contents  modified,  causing flicker.  (This does not happen
57       when loading image files or video frames.)
58

SEE ALSO

60       X(1),    xscreensaver(1)    xscreensaver-demo(1)    xscreensaver-getim‐
61       age-file(1) xscreensaver-getimage-video(1)
62

64       Copyright  ©  2001 by Jamie Zawinski.  Permission to use, copy, modify,
65       distribute, and sell this software and its documentation for  any  pur‐
66       pose  is  hereby granted without fee, provided that the above copyright
67       notice appear in all copies and that both  that  copyright  notice  and
68       this  permission  notice appear in supporting documentation.  No repre‐
69       sentations are made about the suitability of this software for any pur‐
70       pose.  It is provided "as is" without express or implied warranty.
71

AUTHOR

73       Jamie Zawinski <jwz@jwz.org>, 14-Apr-01
74
75
76
77X Version 11                 5.05-3 (06-Apr-2008)     xscreensaver-getimage(1)
Impressum