← Back to branch summary

~ubuntu-branches/ubuntu/dapper/xscreensaver/dapper

« back to all changes in this revision

Viewing changes to driver/xscreensaver-getimage.man

  • Committer: Bazaar Package Importer
  • Author(s): Oliver Grawert
  • Date: 2005-10-11 21:00:42 UTC
  • mfrom: (2.1.1 sarge)
  • Revision ID: james.westby@ubuntu.com-20051011210042-u7q6zslgevdxspr3
Tags: 4.21-4ubuntu17
updated pt_BR again, fixed to UTF-8 

Show diffs side-by-side

added added

removed removed

Lines of Context:
driver/xscreensaver-getimage.man
1
 
.TH XScreenSaver 1 "25-Oct-2001 (3.34)" "X Version 11"
 
1
.TH XScreenSaver 1 "20-Mar-2005 (4.21)" "X Version 11"
2
2
.SH NAME
3
3
xscreensaver-getimage - put some randomly-selected image on the root window
4
4
.SH SYNOPSIS
5
5
.B xscreensaver-getimage
6
 
[\-display \fIhost:display.screen\fP] [\--verbose] window-id
 
6
[\-display \fIhost:display.screen\fP] [\--verbose] window-id [pixmap-id]
7
7
.SH DESCRIPTION
8
8
The \fIxscreensaver\-getimage\fP program is a helper program for the
9
9
xscreensaver hacks that manipulate images.  This is not a user-level
10
10
command.
11
11
 
12
12
This program selects a random image, and puts it on the specified
13
 
window.  This image might be a snapshot of the desktop; or a frame
14
 
captured from the system's video input; or a randomly-selected image
15
 
from disk.
 
13
window or pixmap.  This image might be a snapshot of the desktop; or
 
14
a frame captured from the system's video input; or a randomly-selected
 
15
image from disk.
 
16
 
 
17
If only a window ID is specified, the image will be painted there.
 
18
If both a window ID and a pixmap ID are specified, then the image will
 
19
be painted on the pixmap; and the window \fImay\fP be modified as a
 
20
side-effect.
16
21
.SH OPTIONS
17
22
.I xscreensaver-getimage
18
23
reads the \fI~/.xscreensaver\fP file for configuration information.
43
48
If none of the three options are set to True, then video
44
49
colorbars will be displayed instead.
45
50
.SH BUGS
46
 
If the target window is not the root window, then this program 
47
 
will \fIalways\fP grab a desktop image.  This means that if an 
48
 
image-manipulating xscreensaver mode is run in a normal window,
49
 
it will always operate on a desktop image; it's only when it is
50
 
run in \fI-root\fP mode (or when invoked by xscreensaver) that
51
 
it will load image files or grab video.
 
51
When grabbing desktop images, the \fIwindow\fP argument will be unmapped
 
52
and have its contents modified, causing flicker.  (This does not happen
 
53
when loading image files or video frames.)
52
54
.SH SEE ALSO
53
55
.BR X (1),
54
56
.BR xscreensaver (1)