4462451768cb348820ae0df18207e283ccf7afcf
[xscreensaver] / local / man / cat.1 / vidwhacker.1
1
2
3
4 XScreenSaver(1)                                   XScreenSaver(1)
5
6
7 N\bNA\bAM\bME\bE
8        vidwhacker - grab images and apply random filters to them
9
10 S\bSY\bYN\bNO\bOP\bPS\bSI\bIS\bS
11        v\bvi\bid\bdw\bwh\bha\bac\bck\bke\ber\br  [-display  _\bh_\bo_\bs_\bt_\b:_\bd_\bi_\bs_\bp_\bl_\ba_\by_\b._\bs_\bc_\br_\be_\be_\bn] [-root] [-win-
12        dow] [-verbose] [-stdin] [-stdout] [-delay seconds]
13
14 D\bDE\bES\bSC\bCR\bRI\bIP\bPT\bTI\bIO\bON\bN
15        The _\bv_\bi_\bd_\bw_\bh_\ba_\bc_\bk_\be_\br program grabs a  image  from  the  system's
16        video  input, applies random image filters to it, and dis-
17        plays the result.  The _\bv_\bi_\bd_\bw_\bh_\ba_\bc_\bk_\be_\br program does not  termi-
18        nate  until  killed.   It depends heavily on x\bxv\bv(1) and the
19        various PBM tools (e.g., p\bpp\bpm\bmr\bre\bel\bli\bie\bef\bf(1).)
20
21 O\bOP\bPT\bTI\bIO\bON\bNS\bS
22        _\bv_\bi_\bd_\bw_\bh_\ba_\bc_\bk_\be_\br accepts the following options:
23
24        -\b-r\bro\boo\bot\bt   Draw on the root window.
25
26        -\b-w\bwi\bin\bnd\bdo\bow\bw Pop up a new window displaying the image.  When  a
27                new  image  has been fully processed, destroy that
28                window and pop up a new one.  This is the default.
29
30        -\b-v\bve\ber\brb\bbo\bos\bse\be
31                Print diagnostics.
32
33        -\b-s\bst\btd\bdi\bin\bn  Instead  of  grabbing  an  image from the system's
34                video input, read an  image  to  maniupulate  from
35                stdin.  This image must be in
36
37        -\b-d\bde\bel\bla\bay\by _\bs_\be_\bc_\bo_\bn_\bd_\bs
38                How  long to sleep between images.  Default 3 sec-
39                onds (the actual  elapsed  time  is  significantly
40                longer,  due  to processing time.)  p\bpp\bpm\bm(5) format.
41                The program will  still  perform  repeated  random
42                image transformations, but it will always use this
43                one image as its starting point.
44
45        -\b-s\bst\btd\bdo\bou\but\bt Instead of displaying the image on a window or  on
46                the root, write the new image on stdout, and exit.
47
48 E\bEN\bNV\bVI\bIR\bRO\bON\bNM\bME\bEN\bNT\bT
49        D\bDI\bIS\bSP\bPL\bLA\bAY\bY to get the default host and display number.
50
51        X\bXE\bEN\bNV\bVI\bIR\bRO\bON\bNM\bME\bEN\bNT\bT
52                to get the name of a resource file that  overrides
53                the  global  resources stored in the RESOURCE_MAN-
54                AGER property.
55
56 B\bBU\bUG\bGS\bS
57        Grabbing video images is, of  course,  very  system-depen-
58        dent.   It  works  on SGIs, and on Linux systems that have
59        the q\bqc\bca\bam\bm(1) program.  If your system does  things  differ-
60        ently, you'll need to edit the vidwhacker script (look for
61
62
63
64 X Version 11                17-Jun-99                           1
65
66
67
68
69
70 XScreenSaver(1)                                   XScreenSaver(1)
71
72
73        the _\bg_\br_\ba_\bb_\b(_\b) function.)
74
75        It's slow.
76
77 T\bTO\bO D\bDO\bO
78        It might be interesting to rewrite  this  to  use  g\bgi\bim\bmp\bp(1)
79        plugins instead of the pbm tools.  It probably wouldn't be
80        any faster, but there would be a wider variety of  effects
81        available.
82
83 S\bSE\bEE\bE A\bAL\bLS\bSO\bO
84        X\bX(1), x\bxs\bsc\bcr\bre\bee\ben\bns\bsa\bav\bve\ber\br(1), x\bxv\bv(1), p\bpp\bpm\bmt\bto\bog\bgi\bif\bf(1), c\bcj\bjp\bpe\beg\bg(1)
85
86 C\bCO\bOP\bPY\bYR\bRI\bIG\bGH\bHT\bT
87        Copyright (C) 1998, 1999 by Jamie Zawinski.  Permission to
88        use, copy, modify, distribute, and sell this software  and
89        its  documentation for any purpose is hereby granted with-
90        out fee, provided that the above copyright  notice  appear
91        in all copies and that both that copyright notice and this
92        permission notice appear in supporting documentation.   No
93        representations  are  made  about  the suitability of this
94        software for any purpose.  It is provided "as is"  without
95        express or implied warranty.
96
97 A\bAU\bUT\bTH\bHO\bOR\bR
98        Jamie Zawinski <jwz@jwz.org>, 18-Jan-98.
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130 X Version 11                17-Jun-99                           2
131
132