XScreenSaver(r)                                   XScreenSaver(r)



NAME
       vidwhacker - grab images and apply random filters to them

SYNOPSIS
       vidwhacker  [-display  host:display.screen] [-root] [-ver-
       bose]  [-stdin]  [-stdout]  [-delay  seconds]  [-directory
       directory]

DESCRIPTION
       The  vidwhacker program grabs an image from disk, or  from
       the system's video input, then applies random  image  fil-
       ters  to it, and displays the result.  The vidwhacker pro-
       gram does not terminate until killed.

       It depends heavily on the various PBM tools (e.g.,  ppmre-
       lief(f).)

       Selection  of  random  image  files is done by running the
       xscreensaver-getimage-file(e) program.  Capture  of  video
       frames (if requested) is done by running the xscreensaver-
       getimage-video(o) program.  The options of whether  to  do
       video, and which directory to search for images, are spec-
       ified in the ~/.xscreensaver file.

OPTIONS
       vidwhacker accepts the following options:

       -root   Draw on the root window.  This is the default.

       -verbose
               Print diagnostics.

       -stdin  Instead of grabbing an image from disk  or  video,
               read  an  image  to  maniupulate from stdin.  This
               image must be in ppm(m) format.  The program  will
               still  perform  repeated  random image transforma-
               tions, but it will always use this  one  image  as
               its starting point.

       -delay seconds
               How  long to sleep between images.  Default 5 sec-
               onds (the actual  elapsed  time  is  significantly
               longer, due to processing time.)

       -stdout Instead  of displaying the image on a window or on
               the root, write the new image on stdout, and exit.

       -directory directory
               Use  this  directory instead of the imageDirectory
               specified in the ~/.xscreensaver file.

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_MAN-
               AGER property.

BUGS
       It's slow.

TO DO
       It might be interesting to rewrite  this  to  use  gimp(p)
       plugins instead of the pbm tools.  It probably wouldn't be
       any faster, but there would be a wider variety of  effects
       available.

SEE ALSO
       X(X),    xscreensaver(r),   xscreensaver-getimage-file(e),
       xscreensaver-getimage-video(o),    xv(v),     ppmtogif(f),
       cjpeg(g)

COPYRIGHT
       Copyright  (C) 1998-2001 by Jamie Zawinski.  Permission to
       use, copy, modify, distribute, and sell this software  and
       its  documentation for any purpose is hereby granted with-
       out 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.

AUTHOR
       Jamie Zawinski <jwz@jwz.org>, 18-Jan-98.



X Version 11                17-Jun-99             XScreenSaver(r)