NAME

       vidwhacker - grab images and apply random filters to them

SYNOPSIS

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

DESCRIPTION

       Distorts an image using a random series of filters: edge detection, subtracting the image from a  rotated
       version of itself, etc.

       Selection  of  random image files is done by running the xscreensaver-getimage-file(6x) program.  Capture
       of video frames (if requested) is done by running the xscreensaver-getimage-video(6x) program.

OPTIONS

       vidwhacker accepts the following options:

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

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

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

       XSCREENSAVER_WINDOW
               The window ID to use with --root.

BUGS

       It  is  poorly named; originally it worked only on grabbed video frames, before being expanded to work on
       any image.

       It requires the various PBM tools, e.g., ppmrelief(1).  Though still available, the "pbmplus"  suite  has
       largely  fallen  out of favor these days, so it would be nice if someone were to port this script to make
       use of ImageMagick's convert(1) instead.  That would also probably make it faster.

SEE ALSO

       X(1),         xscreensaver(1),         xscreensaver-getimage(6x),         xscreensaver-getimage-file(6x),
       xscreensaver-getimage-video(6x), ppmtogif(1), convert(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                                   6.08 (10-Oct-2023)                                 vidwhacker(6x)