diff options
Diffstat (limited to '')
| -rw-r--r-- | util/alevt/README | 72 | ||||
| -rw-r--r-- | util/alevt/README.OLD | 78 |
2 files changed, 150 insertions, 0 deletions
diff --git a/util/alevt/README b/util/alevt/README new file mode 100644 index 0000000..83985f0 --- /dev/null +++ b/util/alevt/README @@ -0,0 +1,72 @@ +Hi, + +this software is not just a program, it's moreover a legend. +It is THE protagonist of all videotext applications under Linux. + +During the past 10 years the video standards, the APIs, the kernel +have seen lots of changes. +But unfortunately this program has NOT seen much maintenance. +The results of that misfit appearance are: + +1. lots of forks flying around in the Internet +2. lots of patches flying around, some good, some disgusting, some out of time +3. lots of cruft which is completely outdated or obsolete for other reasons + +To handle all that in one big effort I decided to redesign the program +completely, enlarging its capabilities for DVB-S at the same time. + +So here are the changes: + +1. Erasure of old help pages and rename / reorganize / update the rest +-> redesign of the online help system / implying alevt-date and alevt-cap + +2. Erasure of old outdated integers, functions, parameters: + +- bell, big_buf, debug, display, editor, erc, fine_tune, newbttv, +- oldbttv + +3. Coding style cleanups (no superfluous comments, not more than + 80 characters per column, no uncommented code. + +4. No strange characters in the outfile, latin alphabet in purity instead. + +5. Alevt can be started in 4 modes now if you are running it in DVB mode: + +- by service id (sid) +- by teletext pid (ttpid) +- by channel name +- without parameter + +6. Starting it in DVB mode on the command line it presents you +a table with human readable values such as sid, teletext pid, +PMT (Program Map Table), provider name, service name, language, service type. +This makes it easier for you to start multiple teletext windows +in multiple console sessions manually. + +If working with a script and the option -o (outfile) you can +also start multiple teletext windows of all channels in a transponder. +I develop a GUI using TCL / TK 8.5 and Iwidgets 4.01 to do that and other +tasks graphically (i. e. by mouse click). + +7. If you install the program on the command line by typing "make & + make install" there is an uninstaller now to revert the installation: + "make uninstall". + +ENJOY IT! + +Uwe Bugla, February 11th, 2010. + +External dependencies + +AleVT needs some system libraries to be installed in your system. +They are zlib, libX11, libpng and libzvbi. + +Credits go to: +- Andreas Rottmann from debian.org for compiler fixes and + other kinds of investigation. +- Francesco Lavra for supplying a kernel patch to avoid kernel demux + incompatibilities with kernels >= 2.6.32 +- Andy Walls for helpful investigation in kernelspace +- Edgar Toernig for providing the source version 1.6.2 and doing all the + development for the basic versions +- Tom Zoerner for the implementation of libzvbi diff --git a/util/alevt/README.OLD b/util/alevt/README.OLD new file mode 100644 index 0000000..4fb0e41 --- /dev/null +++ b/util/alevt/README.OLD @@ -0,0 +1,78 @@ +Hi, Menden, 21 Sep 2000 + + This program decodes and displays Videotext/Teletext from a + /dev/vbi device. + + +COMPILE & INSTALL: + + There's nothing to configure. A simple 'make' is all. + If you do not want png support remove the WITH_PNG in + the Makefile. Additionally, if you want a smaller font + uncomment the "FONT=neep9" line. + + It gives you 'alevt', 'alevt-date', and 'alevt-cap' and + their man pages 'alevt.1x', 'alevt-date.1', and 'alevt-cap.1'. + + You can install them where ever you want (i.e. /usr/local/bin). + The programs are self-contained and require no other files. + + NOTE: Be careful with 'make install'. It's just for me :-) + + +PROBLEMS: + + If you have a lot of decoding errors (lot of these lightning symbols) + you may try pressing the 'f' and 'F' key. This allows fine tuning of + the decoder circuit. There's also a -finetune command line option. + This should only be necessary on really bad signals. + + Maybe, I add autotuning later... + + UPDATE: added autotuning. It's the default. If you add -debug the + the actions of the pll are printed to stdout. + + To get the old (pre finetune) behaviour start it with -finetune 0. + + UPDATE: disabled autotuning *g* sometimes it's too jumpy... + + +ALEVT-DATE: + I added a little tool to set the system time from the videotext + time. The date is not interpreted (not even transmitted on some + channels). So it allows only adjustment of +/-12 hours. + The default allowed adjustment is limited to +/-2 hours (use + -delta to change). Without the -set option it just display + the date in the format of the date command. Look at strftime(3) + for possible control sequences you may use in the -format option. + + +HACKING: + + If you want to play with the font size, you may resize it with + xv (xv font1.xbm). Just make sure, that its width is a multiple of + 32 and its height a multiple of 8. A simple make will create + a version of AleTV with the new font. Warning: a make clean + will erase font1.xbm. The next make will recreate font.xbm from + vtxt.bdf. + + AleVT has a built in page editor. If you start it with -editor + you may press 'E' to invoke it. For the usage you have to consult + the sources. (It's very crude!) + + +TODO: (no specific order) + + - Error correction in alevt-cap + - Better language support. Internal 16-bit charset. + - Separated graphics. + - Rewrite the whole stuff. A networked teletext daemon and clients + that connect to it for display, capture, cgi, ... + + +NEWER VERSIONS: + + The primary site of AleVT is http://goron.de/~froese + +Have fun, +Edgar Toernig (froese@gmx.de) |