Manual Pages for UNIX Operating System command usage for man xscreensaver-getimage

XScreenSaver manual                      xscreensaver-getimage(1)



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

SYNOPSIS
     /usr/lib/xscreensaver/bin/xscreensaver-getimage    [-display
     host:display.screen] [--verbose] window-id [pixmap-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 or pixmap.  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.

     If only a window ID is specified, the image will be  painted
     there.   If  both a window ID and a pixmap ID are specified,
     then the image will be painted on the pixmap; and the window
     may be modified as a side-effect.

OPTIONS
     xscreensaver-getimage reads  the  ~/.xscreensaver  file  for
     configuration information.  It uses these settings:

     grabDesktopImages
         Whether it is acceptable to grab snapshots of the  desk-
         top.  The security paranoid might want to turn this off,
         to avoid letting people see (but not touch!) your  desk-
         top 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.





X Version 11     Last change: 5.11 (13-Apr-2010)                1






XScreenSaver manual                      xscreensaver-getimage(1)



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

SEE ALSO
     X(1),          xscreensaver(1)          xscreensaver-demo(1)
     xscreensaver-getimage-file(1) xscreensaver-getimage-video(1)

COPYRIGHT
     Copyright cO 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  permis-
     sion   notice   appear   in  supporting  documentation.   No
     representations are  made  about  the  suitability  of  this
     software  for  any  purpose.  It is provided "as is" without
     express or implied warranty.

AUTHOR
     Jamie Zawinski , 14-Apr-01


ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | desktop/xscreensaver        |
    |_____________________________|_____________________________|
    | Interface Stability         | Private                     |
    |_____________________________|_____________________________|



















X Version 11     Last change: 5.11 (13-Apr-2010)                2