Penguin
Recent Changes
Blame: xscreensaver-getimage(1)
EditPageHistoryDiffInfoLikePages
Annotated edit history of xscreensaver-getimage(1) version 5, including all changes. View license author blame.
Rev Author # Line
1 perry 1 XScreenSaver
2 !!!XScreenSaver
3 NAME
4 SYNOPSIS
5 DESCRIPTION
6 OPTIONS
7 BUGS
8 SEE ALSO
9 COPYRIGHT
10 AUTHOR
11 ----
12 !!NAME
13
14
15 xscreensaver-getimage - put some randomly-selected image on the root window
16 !!SYNOPSIS
17
18
19 __xscreensaver-getimage__ [[-display
20 ''host:display.screen''] [[--verbose]
21 window-id
22 !!DESCRIPTION
23
24
25 The ''xscreensaver-getimage'' program is a helper program
26 for the xscreensaver hacks that manipulate images. This is
27 not a user-level command.
28
29
30 This program selects a random image, and puts it on the
31 specified window. This image might be a snapshot of the
32 desktop; or a frame captured from the system's video input;
33 or a randomly-selected image from disk.
34 !!OPTIONS
35
36
37 ''xscreensaver-getimage'' reads the
38 ''~/.xscreensaver'' file for configuration information.
39 It uses these settings:
40
41
42 __grabDesktopImages__
43
44
45 Whether it is acceptable to grab snapshots of the desktop.
46 The security paranoid might want to turn this off, to avoid
47 letting people see (but not touch!) your desktop while the
48 screen is locked.
49
50
51 __grabVideoFrames__
52
53
54 Whether it is acceptable to grab frames of video from the
55 system's video input. Grabbing of video is done by invoking
5 perry 56 the xscreensaver-getimage-video(1)
1 perry 57 program.
58
59
60 __chooseRandomImages__
61
62
63 Whether it is acceptable to display random images found on
64 disk. Selection and loading of images is done by invoking
5 perry 65 the xscreensaver-getimage-file(1)
1 perry 66 program.
67
68
69 __imageDirectory__
70
71
72 When loading images from disk, this is the directory to
73 search. The directory will be searched recursively, and all
74 files in it are assumed to be images.
75
76
77 If none of the three options are set to True, then video
78 colorbars will be displayed instead.
79 !!BUGS
80
81
82 If the target window is not the root window, then this
83 program will ''always'' grab a desktop image. This means
84 that if an image-manipulating xscreensaver mode is run in a
85 normal window, it will always operate on a desktop image;
86 it's only when it is run in ''-root'' mode (or when
87 invoked by xscreensaver) that it will load image files or
88 grab video.
89 !!SEE ALSO
90
91
5 perry 92 X(1), xscreensaver(1)
93 xscreensaver-demo(1)
94 xscreensaver-getimage-file(1)
95 xscreensaver-getimage-video(1)
1 perry 96 !!COPYRIGHT
97
98
99 Copyright 2001 by Jamie Zawinski. Permission to use, copy,
100 modify, distribute, and sell this software and its
101 documentation for any purpose is hereby granted without fee,
102 provided that the above copyright notice appear in all
103 copies and that both that copyright notice and this
104 permission notice appear in supporting documentation. No
105 representations are made about the suitability of this
106 software for any purpose. It is provided
107 !!AUTHOR
108
109
110 Jamie Zawinski
111 ----
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.