bionic (6) vidwhacker.6x.gz

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.