NAME

       spotlight - move spotlight around desktop

SYNOPSIS

       spotlight  [--display  host:display.screen] [--foreground color] [--background color] [--window] [--root]
       [--window-id number][--mono] [--install] [--visual visual] [--delay usecs]  [--duration  secs]  [--radius
       pixels] [--fps]

DESCRIPTION

       The spotlight program takes an image and exposes small sections of it as if through a wandering spotlight
       beam.

       The image that it manipulates will be grabbed from the portion of the screen underlying  the  window,  or
       from  the  system's  video  input,  or from a random file on disk, as indicated by the grabDesktopImages,
       grabVideoFrames, and chooseRandomImages options in the ~/.xscreensaver file; see xscreensaver-settings(1)
       for more details.

OPTIONS

       spotlight accepts the following options:

       --window
               Draw on a newly-created window.  This is the default.

       --root  Draw on the root window.

       --window-id number
               Draw on the specified window.

       --mono  If on a color display, pretend we're on a monochrome display.

       --install
               Install a private colormap for the window.

       --visual visual
               Specify  which  visual  to  use.   Legal  values are the name of a visual class, or the id number
               (decimal or hex) of a specific visual.

       --delay microseconds
               Slow it down.

       --duration seconds
               How long to run before loading a new image.  Default 120 seconds.

       --radius pixels
               Radius of the spotlight in pixels.

       --fps   Display the current frame rate and CPU load.

ENVIRONMENT

       DISPLAY to get the default host and display number.

       XENVIRONMENT
               to get the  name  of  a  resource  file  that  overrides  the  global  resources  stored  in  the
               RESOURCE_MANAGER property.

       XSCREENSAVER_WINDOW
               The window ID to use with --root.

SEE ALSO

       X(1), xscreensaver(1), xscreensaver-settings(1), xscreensaver-getimage(6x)

COPYRIGHT

       Copyright  ©  1999  by Rick Schultz.  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 "as is" without express or implied warranty.

CREDITS

       Hacked  together  by  Rick Schultz <rick@skapunx.net>, based on StefView for BackSpace by Darcy Brockbank
       and on several other xscreensaver hacks.