Provided by: xscreensaver-data-extra_5.15-2ubuntu1_i386 bug

NAME

       vidwhacker - grab images and apply random filters to them

SYNOPSIS

       vidwhacker  [-display  host:display.screen] [-root] [-verbose] [-stdin]
       [-stdout] [-delay seconds] [-directory directory] [-fps]

DESCRIPTION

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

       It depends heavily on the various PBM tools (e.g., ppmrelief(1).)

       Selection of random image files is done by  running  the  xscreensaver-
       getimage-file(1)  program.   Capture  of video frames (if requested) is
       done  by  running  the  xscreensaver-getimage-video(1)  program.    The
       options  of  whether  to  do  video,  and which directory to search for
       images, are specified 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 manipulate from stdin.  This image must be in ppm(5) format.
               The  program  will  still   perform   repeated   random   image
               transformations,  but  it will always use this one image as its
               starting point.

       -delay seconds
               How long to sleep  between  images.   Default  5  seconds  (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.

       -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.

BUGS

       It's slow.

TO DO

       It  might be interesting to rewrite this to use gimp(1) 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(1),   xscreensaver(1),  xscreensaver-getimage-file(1),  xscreensaver-
       getimage-video(1), xv(1), ppmtogif(1), cjpeg(1)

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 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.

AUTHOR

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