vidwhacker
Section: XScreenSaver manual (6)
Updated: 5.40 (12-Aug-2018)
Page Index
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.