File: vgrabbj.conf.5

package info (click to toggle)
vgrabbj 0.9.3-1
  • links: PTS
  • area: main
  • in suites: sarge
  • size: 488 kB
  • ctags: 286
  • sloc: sh: 2,594; ansic: 2,379; makefile: 62
file content (258 lines) | stat: -rw-r--r-- 10,402 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
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
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
.\"                                      Hey, EMACS: -*- nroff -*-
.\" First parameter, NAME, should be all caps
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
.\" other parameters are allowed: see man(7), man(1)
.TH VGRABBJ.CONF 5 "February  24, 2002"
.\" Please adjust this date whenever revising the manpage.
.\"
.\" Some roff macros, for reference:
.\" .nh        disable hyphenation
.\" .hy        enable hyphenation
.\" .ad l      left justify
.\" .ad b      justify to both left and right margins
.\" .nf        disable filling
.\" .fi        enable filling
.\" .br        insert line break
.\" .sp <n>    insert n+1 empty lines
.\" for manpage-specific macros, see man(7)
.SH NAME
\fBvgrabbj.conf\fP \- configuration file for vgrabbj
.SH OVERVIEW
vgrabbj purpose is to read data from a v4l-device and put it in a file,
formatted as jpeg, png, or pnm. Except for the ftp-options described
below everything can also handled on the commandline.
Here the configuration statements are described.
.P
Syntax is <keyword> <value>. Comments start with a ';' or '#'. Those
lines are ignored by vgrabbj. Case of the keywords and named options
doesn't matter except for the timestamp option as well as any filename.
.P
The configuration file is parsed line by line. If any keyword appears
twice or more often, the last one is the one used.
.P
On startup, the pre-defined configuration file /etc/vgrabbj.conf is
read. Then, commandline parameters are evaluated one by one, the last is
the most significant, if one option is provide twice or more often.
Same applies for the commandline parameter -c <config-file>.
.SH GENERAL OPTIONS
.TP
\fBDaemonSeconds\fP \fIseconds\fP
Daemonize & loop with \fIseconds\fP intervals (min. 1).
.TP
\fBDaemon\fP \fImicroseconds\fP 
Daemonize & loop \fImicroseconds\fP intervals (min. 1). Same as \fB\-l\fP
except you can control it more precisely.
.TP
\fBBrightness\fP \fIOn\fP|\fIOff\fP
Defines if vgrabbj's brightness adjustment is used. This option works only
if the device supports data fetch via read and RGB24 videopalette. See 
\fBForcePalette\fP on how-to set RGB24. Some device do not support RGB24,
hence, \fBBrightness\fP is ignored.
.TP
\fBQuality\fP \fIquality\fP
Sets the quality of a jpeg output to \fIquality\fP (1-100, default: 75).
.TP
\fBImageSize\fP \fIimagesize\fP
Sets the imagesize of input device, where \fIimagesize\fP is one of: 
.IP
.nf
.ta 5 \w' sqcif = 128x96      '\u
 sqcif= 128x96,     qsif = 160x120, 
 qcif = 176x144,    sif  = 320x240, 
 cif  = 352x288,    vga  = 640x480, 
 svga = 800x600,    xga  = 1024x768, 
 sxga = 1280x1024,  uxga = 1600x1200, 
.fi
.IP
(default: cif)
.TP
\fBImageWidth\fP \fIwidth\fP
Sets the width of the image to \fIwidth\fP. Needs \fB\-H\fP.
The v4l-device has to support the image width you set with
this option.
.TP
\fBImageHeight\fP \fIheight\fP
Sets the height of the image to \fIheight\fP. Needs \fB\-w\fP.
The v4l-device has to support the image height you set with
this option.
.TP 
\fBOutputFormat\fP \fIformat\fP
Sets the output to \fIformat\fP (either \fBjpeg\fP, \fBpng\fP, or 
\fBpnm\fP, default: jpeg). Alternative, you may provide jpg for
jpeg.
.TP
\fBOutputFile\fP <\fIfilename\fP>
Output is written to \fIfilename\fP (default: \fI/dev/stdout\fP)
.TP
\fBArchive\fP <\fIpath/filename\fP>
Additional output is written to \fIpath/filename\fP (default: \fInot set\fP),
whereas the path-filename can include any strftime component. The path-
filename must not be on a different filesystem as the output defined above.
Additionally, you need to take care of the number of files stored. There is
no upper ceiling for archiving.
.TP
\fBVideoDevice\fP <\fIdevice\fP> 
Sets the input device to \fIdevice\fP (default: \fI/dev/video\fP)
.TP
\fBOpenOnce\fP \fIOn\fP|\fIOff\fP
Defines if \fBvgrabbj\fP opens the device only while image data is grabbed
(\fIOff\fP) or keeps it opened while it is running (\fIOn\fP). 
Setting it to \fIOff\fP is helpful if you need access to the device besides
vgrabbj. This use is discouraged though, due to possible problems with memory
fragmentation. Default is \fIOn\fP.
.TP
\fBSetImageSize\fP \fIOn\fP|\fIOff\fP
Defines if the image size (see \fB\-i\fP, \fB\-H\fP, and \fB\-w\fP) of the
device is set by vgrabbj. Necessary for certain v4l-devices which do not
support to be set to a particular image size (e.g. IBM-usb-cam, QuickCam).
For these devices you have to specify the size at module load time.
Default is \fIOn\fP.
.TP
\fBSwitchColor\fP \fIOn\fP|\fIOff\fP
Switches colormap from BGR to RGB (or vice versa) if set to \fIOn\fP. Default
is \fIOff\fP. Use if you have odd colors.
.TP
\fBSwapRL\fP \fIOn\fP|\fIOff\fP
Swaps left and right of the image like a mirror.. Default
is \fIOff\fP.
.TP
\fBNoUseMmap\fP \fIOn\fP|\fIOff\fP
Turns off the use of mmap'ed (better) memory allocation for grabbing frames.
Some (very rare) cams cannot use mmap'ed memory and have to use read. If you
want to switch easily, use this switch. If you don't know what I'm talking
about, leafe it like it is: Default is \fIOff\fP.
.TP
\fBDebugLevel\fP \fIvalue\fP
Sets the loglevel of vgrabbj. Valid for \fIvalue\fP are 0, 2, 3, 4, 6, 7
(default: 4). 0 means no messages at all, 7 is debug. Don't use 7 if
you are running vgrabbj in daemon mode, it'll surely fill your syslog.
Be aware, that loglevel 7 will also post you ftp-password (if defined)
in the logfile!
.TP
\fBUseTmpOut\fP \fIOn\fP|\fIOff\fP
Sets the use of the temporary outputfile. Default is \fIOn\fP. Ignored in case
the default output (\fI/dev/stdout\fP) is used. If set to \fIOff\fP, the data
is written directly to the file defined by \fBOutputFile\fP. 
.Sp
If \fIfilename\fP is different from \fI/dev/stdout\fP (given via \fB-f\fP
parameter or \fIOutputFile\fP, vgrabbj defaults to use a temporary file called
\fIfilename\fP.tmp to write the image. This file is then renamed to
\fIfilename\fP to shorten the time period corrupt data may be read from
\fIfilename\fP.
.TP
\fBForcePalette\fP \fIpalette\fP
Force the usage of the specified \fIpalette\fP. If \fIpalette\fP is not
supported by either \fBvgrabbj\fP or the v4l-device, fallback to a palette
supported by both is provided. If no common denominator is available, vgrabbj
exits. Supported palettes are marked with * below. Possible values are (copy
from videodev.h):
.IP
.nf
.ta 5 \w' 2  VIDEO_PALETTE_HI240     High 240 cube (BT848) '\u
 1  VIDEO_PALETTE_GREY      Linear greyscale
 2  VIDEO_PALETTE_HI240     High 240 cube (BT848)
 3  VIDEO_PALETTE_RGB565    565 16 bit RGB
 4 *VIDEO_PALETTE_RGB24     24bit RGB
 5 *VIDEO_PALETTE_RGB32     32bit RGB
 6  VIDEO_PALETTE_RGB555    555 15bit RGB
 7 *VIDEO_PALETTE_YUV422    YUV422 capture
 8 *VIDEO_PALETTE_YUYV
 9  VIDEO_PALETTE_UYVY
 10*VIDEO_PALETTE_YUV420
 10 VIDEO_PALETTE_YUV411    YUV411 capture
 11 VIDEO_PALETTE_RAW       RAW capture (BT848)
 12 VIDEO_PALETTE_YUV422P   YUV 4:2:2 Planar
 13 VIDEO_PALETTE_YUV411P   YUV 4:1:1 Planar
 14*VIDEO_PALETTE_YUV420P   YUV 4:2:0 Planar
 15 VIDEO_PALETTE_YUV410P   YUV 4:1:0 Planar
 16 VIDEO_PALETTE_PLANAR
 17 VIDEO_PALETTE_COMPONENT
.fi
.IP
(no default, depends on v4l-device).
.TP
\fBDiscardFrames\fP \fIvalue\fP
\fIvalue\fP images are grabbed and immediately discarded. Only the
last image is written to the output. This might be helpful if your v4l-device
needs to take a couple of images to auto-adjust to the current light.
.SH TIMESTAMP OPTIONS
.Sp
The following options are available only if vgrabbj was compiled with
the freetype library available. The timestamp will only be enabled if
you all values evaluated (inlcuding defaults) lead to a valid configuration.
.TP
\fBFontFile\fP \fIfilename\fP
The TrueType font to be used for the timestamp
(default \fI/usr/X11R6/lib/X11/fonts/TrueType/Arialn.ttf\fP).
.TP
\fBFontSize\fP \fIsize\fP
Set the fontsize to \fIsize\fP for timestamp (3-100, default: 12).
.TP
\fBTimeStamp\fP \fIformat-str\fP
Defines the timestamp. \fIformat-str\fP can be plain text or any
strftime format. Any '""' at the beginning or the end will be eliminated
for compatibility reasons, i.e. they are not necessary (default: "%a, %e.
%B %Y \- %T" \- see \fBstrftime\fP(3) for details).
.TP
\fBPosition\fP \fIvalue\fP
Alignment of the timestamp in the image. Possible 
\fIvalue\fP:
.IP
.nf
.ta \w' 0 = upper left,    '\u
ul = upper left,    ur = upper right,
ll = lower left,    lr = lower right,
uc = upper center,  lc = lower center
.fi
.IP
(default: upper right). You can use either the short or the long version.
.TP
\fBBlend\fP \fIvalue\fP
Defines the blend between font background and image (1-100, default: 60).
.TP
\fBBorderSize\fP \fIvalue\fP
\fIvalue\fP pixels will be used as border around the timestamp string (1-255,
default: 2).
.SH FTP OPTIONS
.P
There are no options for ftp-upload on the command line. This is due to the need
to provide a password which would be visible via the \fBps\fP(1) command.
.TP
\fBEnableFtp\fP \fIOn\fP|\fIOff\fP
Ftp-Connection will only be opened if set to \fIOn\fP. Be aware that this
might bring up a dial-up connection. See \fBKeepAlive\fP.
.TP
\fBRemoteHost\fP \fIhostname\fP
Host to which a ftp-connection will be established everytime an image has
been written (see also: \fBDaemon\fP, \fBDaemonSeconds\fP, \fBKeepAlive\fP,
no default).
.TP
\fBRemoteImage\fP \fIfilename\fP
The \fIfilename\fP consists of the full path and filename on the remote host
defined by \fBRemoteHost\fP (no default).
.TP
\fBUsername\fP \fIusername\fP
The name of the user to log on the remote ftp-server (no default).
.TP
\fBPassword\fP \fIpassword\fP
The password of the user to log on the remote ftp-server (no default).
.TP
\fBKeepAlive\fP \fIOn\fP|\fIOff\fP
If set to \fIOn\fP, the connection will be kept. This will cause a dial-up
line to be up all the time, which in turn may cost a lot of money! If set
to \fIOff\fP, the connection will be established after an image was written
to the \fBOutputFile\fP. After transmission, the ftp-connection will be ended.
This may also result in phone charges, for which Author takes no responsibility.
See License.
.TP
\fBTryHarder\fP \fIOn\fP|\fIOff\fP
Not implemented, yet.
.SH BUGS
.P
No bugs are known at this time.
.SH SEE ALSO
\fBvgrabbj\fP(1), \fBstrftime\fP(3), \fBps\fP(1)
.SH AUTHOR
This manual page was originally written by Michael Janssen 
<janssen@cns.uni.edu>, for the Debian GNU/Linux system and enhanced by 
Jens Gecius <devel@gecius.de>.