1vidwhacker(6x) XScreenSaver manual vidwhacker(6x)
2
3
4
6 vidwhacker - grab images and apply random filters to them
7
9 vidwhacker [--display host:display.screen] [--root] [--window-id num‐
10 ber][--verbose] [--stdin] [--stdout] [--delay seconds] [-directory di‐
11 rectory] [--fps]
12
14 Distorts an image using a random series of filters: edge detection,
15 subtracting the image from a rotated version of itself, etc.
16
17 Selection of random image files is done by running the xscreen‐
18 saver-getimage-file(6x) program. Capture of video frames (if re‐
19 quested) is done by running the xscreensaver-getimage-video(6x) pro‐
20 gram.
21
23 vidwhacker accepts the following options:
24
25 --root Draw on the root window. This is the default.
26
27 --window-id number
28 Draw on the specified window.
29
30 --verbose
31 Print diagnostics.
32
33 --stdin Instead of grabbing an image from disk or video, read an image
34 to manipulate from stdin. This image must be in ppm(5) format.
35 The program will still perform repeated random image transfor‐
36 mations, but it will always use this one image as its starting
37 point.
38
39 --delay seconds
40 How long to sleep between images. Default 5 seconds (the ac‐
41 tual elapsed time is significantly longer, due to processing
42 time.)
43
44 --stdout
45 Instead of displaying the image on a window or on the root,
46 write the new image on stdout, and exit.
47
48 --directory directory
49 Use this directory instead of the imageDirectory specified in
50 the ~/.xscreensaver file.
51
52 --fps Display the current frame rate and CPU load.
53
55 DISPLAY to get the default host and display number.
56
57 XENVIRONMENT
58 to get the name of a resource file that overrides the global
59 resources stored in the RESOURCE_MANAGER property.
60
61 XSCREENSAVER_WINDOW
62 The window ID to use with --root.
63
65 It is poorly named; originally it worked only on grabbed video frames,
66 before being expanded to work on any image.
67
68 It requires the various PBM tools, e.g., ppmrelief(1). Though still
69 available, the "pbmplus" suite has largely fallen out of favor these
70 days, so it would be nice if someone were to port this script to make
71 use of ImageMagick's convert(1) instead. That would also probably make
72 it faster.
73
75 X(1), xscreensaver(1), xscreensaver-getimage(6x), xscreensaver-getim‐
76 age-file(6x), xscreensaver-getimage-video(6x), ppmtogif(1), convert(1)
77
79 Copyright © 1998-2001 by Jamie Zawinski. Permission to use, copy, mod‐
80 ify, distribute, and sell this software and its documentation for any
81 purpose is hereby granted without fee, provided that the above copy‐
82 right notice appear in all copies and that both that copyright notice
83 and this permission notice appear in supporting documentation. No rep‐
84 resentations are made about the suitability of this software for any
85 purpose. It is provided "as is" without express or implied warranty.
86
88 Jamie Zawinski <jwz@jwz.org>, 18-Jan-98.
89
90
91
92X Version 11 6.08-1.fc39 (17-Oct-2023) vidwhacker(6x)