1VideoDog(6) Games Manual VideoDog(6)
2
6 VideoDog - capture and process video from a video4linux device.
7
10 videodog [-hxywdpucblmsnijyrifqtSXYWH] or config file
11
15 Linux and v4l1.
16
19 VideoDog captures, process and deliver as fast as possible images from
20 a video device. One of its goals is to provide a simple application,
21 with no heavy dependencis on external libraries, as other do, and pro‐
22 vide options suck JPEG compression, timestamp in the image and a hook
23 for processing functions. VideoDog can be used as surveillance appli‐
24 cation, videoprocessing in realtime, and embedded systems. A simple
25 stock linux distribution will work ok in conjunction with videodog, due
26 to its independent nature. So, there are only the need to project
27 resources for the capture and processing, and nothing more, like
28 graphic enviroment and such. Another goal is the easy understanding of
29 the video API, and this is acomplished by the modular code and auxiliar
30 applications, as gtkpnm, xputjpeg and gtk_cam, which shows how to use
31 video and images under XWindow. They are not required to run videodog.
32 For more information on the filters or another features, please refer
33 to the documents in the distribution.
34
37 Required:
38 x - width
40 y - height
41 w - depth ( in bytes )
42 d - device
43 p - pnm output (24 or 8 bits only )
44 t - targa output
45 r - raw output
46 f - filename (needed)
47 Optional:
50 i - Input (if its set to -1, cycle input in loop mode)
52 m - Mode <NTSC|PAL|SECAM>
53 j - jpeg output
54 u - Hue
55 c - Contrast
56 b - Brightness
57 l - Colour
58 s - show device report
59 n - no capture, just setup and exit clean
60 q - if set, toggle loop capture on
61 Stamp
64 S - stamp text (if it doesn`t exists, there will be no stamp)
66 X - stamp X coordinate inside the image
67 Y - stamp Y coordinate inside the image
68 W - stamp weight font scale (zoom)
69 H - stamp height font scale (zoom)
70
75 ./videodog (will look for /etc/vd.conf and starts smoothly)
76 ./videodog -s -d /dev/video0 - query the device about settings.
79 videodog -x 320 -y 240 -w 3 -d /dev/video0 -p -f lelel.pnm ; cjpeg
82 lelel.pnm > lelel.jpg
83 videodog -x 640 -y 480 -w 3 -i 1 -m NTSC -d /dev/video -p -f out.pnm -
86 uses input 1 and NTSC mode to grab image
87 videodog -s -d /dev/video0 -u 200 - set Hue == 200 and query the
90 device
91 videodog -x 320 -y 240 -w 3 -d /dev/video0 -j -f leee.jpg - uses the
94 internal jpeg compressor ( aka jpeglib ).
95 videodog -x 320 -y 240 -w 3 -d /dev/video0 -j -q - loop capture at
98 maximum possible rate. this will record in the current folder, lots of
99 img-xx.ext,
100 videodog -x 320 -y 240 -w 3 -d /dev/video0 -j -f - - dumps the
103 image to stdout ( any format ) just change the filename by -
104 videodog -x 320 -y 240 -w 3 -d /dev/video0 -j -f + - filename will
107 be timestamp-sequence-input.fmt
108 videodog -x 640 -y 480 -w 3 -i i -1 -d /dev/video -j -f + -q -
111 cycle inputs and grab images as timestamp-seq-input
112 videodog -x 320 -y 240 -w 3 -d /dev/video0 -j -f + - image name
115 will be timestamp-sequence.( any format ); sequence is needed due to
116 loop capture ( more than 1 fps)
117 videodog -x 320 -y 240 -w 3 -d /dev/video0 -j -f leee.jpg -S "oi %Y"
120 -X 2 -Y 10 - generate an jpeg image called leee.jpg, with a stamp
121 containing oi and the year, at the 2, 10 (x,y)
122 videodog -x 320 -y 240 -w 3 -d /dev/video0 -j -f leee.jpg -S "oi %Y"
125 -X 2 -Y 10 -W 2 -H 2 - same as above, but scale the fonts by a
126 factor of 2 ( experimental )
127 NOTE: inside the stamp text, you should use the same simbols
129 than strftime. Check out man strftime to see all the possibili‐
130 ties.
131
134 Gleicon S. Moraes - gleicon@terra.com.br
135 VideoDog(6)