vidwhacker(6x) XScreenSaver manual vidwhacker(6x)
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.
X Version 11 5.15 (28-Sep-2011) vidwhacker(6x)