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

X Version 11                                   5.45 (08-Dec-2020)                                 vidwhacker(6x)