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
|
Test programs
unicode
Prints all Teletext and Closed Caption character sets used
by libzvbi in UTF-8 format. Purpose: compare against specifications
to verify libzvbi character code to Unicode conversions.
uclist
Lists all Unicode characters used in a UTF-8 coded text on
stdin. NB this script needs access to <http://www.unicode.org/
Public/UNIDATA/NamesList.txt>. Purpose: verify the libzvbi built-in
fonts contain all required glyphs.
glyph
Prints all Teletext and Closed Caption character sets used
by libzvbi as PPM images. Purpose: compare against specifications
to verify libzvbi exp-gfx.c Unicode to glyph conversions.
explist
Lists all export modules and their respective options. If option
-c/--check given, tests the export [module] api. Use this to test
new modules.
export
Exports a Teletext page from a TTX sample stream on stdin, eg.
./export "text;charset=ISO-8859-1,control=1" 100 \
<samples/s1-swr >foo.txt
./capture --sim --pal --sliced | ./export "png" 100 >foo.png
./capture --pes | ./export "html" 300 >foo.html
Purpose: test teletext decoder and export modules. (Sample streams
are in CVS zapping/libvbi/samples, versions before 2003-11.)
caption
Closed Caption test displaying a hello world message or the
CC sample stream on stdin, to debug the CC decoder.
Note this works only on a X11 5:6:5 LE display. The keys
F1-F8 switch between the Closed Caption channels 1-4
and Text channels 1-4.
osc
Raw vbi data visualization. Purpose: test vbi device interface,
raw vbi decoder. Works only on X11 5:6:5 LE display.
Options:
-d | --device name
Default is /dev/vbi.
-s | --sim Create artificial raw vbi data instead of
opening a vbi device, to test decoding in
absence of a real source.
-v | --verbose Trace device access on stderr, may reveal
why opening a device failed.
-p | --pal,
-n | --ntsc Video standard hint for simulation and v4l.
When not given libzvbi may have to guess
which can fail. Default is PAL.
-1 | --v4l On Linux, use the bttv / V4L interface if
supported by the driver.
-2 | --v4l2-read
Use V4L2 interface in read mode.
-3 | --v4l2-mmap
Use V4L2 interface in mmap mode (default).
-e | --ignore-error
Ignore read errors.
(--long options are only available on GNU systems.)
capture
Capture sliced vbi data. Purpose: test vbi device interface,
raw vbi decoder. Options:
-d | --device name
Default is /dev/vbi.
-s | --sim Create artificial raw vbi data instead of
opening a vbi device, to test decoding in
absence of a real source.
-v | --verbose Trace device access on stderr, may reveal
why opening a device failed. -vv enables
ioctl logging.
-p | --pal,
-n | --ntsc Video standard hint for simulation and v4l.
When not given libzvbi may have to guess
which can fail. Default is PAL.
-1 | --v4l On Linux, use the bttv / V4L interface if
supported by the driver.
-2 | --v4l2-read
Use V4L2 interface in read mode.
-3 | --v4l2-mmap
Use V4L2 interface in mmap mode (default).
-i | --pid n Use Linux DVB interface instead and filter out
VBI packets with this PID.
-e | --ignore-error
Ignore read errors.
-r | --strict n How strictly shall the raw VBI decoder match
VBI services against driver capabilities?
0 - loose, let's try anyway (default)
1 - medium, usually no problems with the
accepted services (see --verbose)
2 - pedantic, when the signal is good all
accepted services will work
--read Use libzvbi capture read interface (default).
--pull Use libzvbi capture pull interface, to test
if it works.
Options to write sliced vbi data _as_ASCII_ to standard output
(these are moving to test/decode, see there for more options):
--dump-wss Wide Screen Signalling (PAL & NTSC-Japan).
--dump-vps Video Programming System (PAL in DE/AT/CH).
--dump-sliced Everything.
Options to write sliced vbi data _in_binary_format_ to standard
output. This can be piped
"./capture <options> --pes | ./export <options>" or
"./capture <options> --sliced | ./decode <options>" or
"./capture <options> --sliced | ./caption".
-l | --sliced Write sliced vbi data (an old ad-hoc format).
-P | --pes Write DVB PES packets. Note when the source is a
DVB device this will not pass through but de- and
remultiplex PES packets. PES output is experimental,
use at your own risk.
-T | --ts Write TS packets with PID 999 (experimental)
The caption, decode and export tools all support --sliced and
--pes format (may require a --pes option to recognize the format).
--long options are only available on GNU & compatible systems.
Note you will need another application to tune in a channel,
for example v4lctl from the xawtv package or czap/szap/tzap from
the dvbutils package:
v4lctl setstation BBC
./capture --device /dev/vbi --sliced | ./export text 100
tzap BBC # keep it running in another terminal window
./capture --device /dev/dvb/adapter0/demux0 --pid 1234 --sliced | \
./export text 100
The capture tool cannot automatically determine the PID of the
DVB VBI stream. To find it you will need another tool evaluating
the service information tables transmitted by the network, or you
can look for the PID of the video stream in the tzap config file
and try a slightly higher number.
decode
Decodes sliced VBI data on stdin, e. g.
./capture --sliced | ./decode --ttx
Also a test of the libzvbi low-level decoders.
Type ./decode -h for options.
sliced2pes
Converts ./capture --sliced format to DVB PES. For example
"./capture --sliced | ./sliced2pes >file" is equivalent to
"./capture --pes >file".
Type ./sliced2pes -h for options.
ttxfilter
Filters Teletext pages out of a VBI stream. Useful mostly
to extract subtitles, for example
"./capture --sliced | ./ttxfilter 150 777 300-400 >file".
Type ./ttxfilter -h for options.
test-*.cc
Unit tests (make check).
The ultimate test is http://zapping.sourceforge.net, the TV viewer this
library was written for.
|
