0 Kurzbeschreibung ViTe dient zur Verarbeitung von Videotext-Seiten. Diese werden von einer Dekoderkarte gelesen und in einer Datei gepuffert. Während die Karte angeforderte Seiten sucht und findet, kann man sich bereits gelesene Seiten in aller Ruhe am Bildschirm ansehen. Dadurch ist ein komfortables Lesen des Videotextes möglich. Mit AutoGet liest ViTe so schnell wie möglich alle Seiten ein, die gerade gesendet werden. ViTe zeigt bis zu 4 Seiten gleichzeitig am Bildschirm an. Ach ja, ViTe ist ein Akronym für VideoText - wer des Französischen mächtig ist, kann sich den Rest ja denken. 1 Leistungsmerkmale - Unterscheidung verschiedener Sender - Seitenanzahl nur durch Speichermedium beschränkt - Packen der Seiten möglich - gleichzeitige Darstellung von bis zu 4 Seiten - Darstellung in 1-3 Bitplanes (für genervte Benutzer unbeschleu- nigter Amigas, s.u.) - Suche nach bis zu 4 Seiten gleichzeitig (durch Dekoder beschränkt) - beliebig viele explizite Seitenanforderungen werden in einer Warteschlange organisiert - auf Wunsch werden Seiten, nachdem sie gefunden wurden, wieder angefordert, d.h. in der Warteschlange wieder hinten eingereiht. - schnelles Einlesen aller gesendeten Seiten - komfortable Angabe der gewünschten Seite durch Ziffern, Cursor oder Maus - Steuerung über Maus oder Tastatur - Übersicht über bereits gelesene Seiten - Ausgabe der Seiten als Ascii-Text - Unterstützung von Französisch und Englisch - TopText-Unterstützung - Suche nach Strings auf den VT-Seiten - schnell dank Assembler (grrr) in zeitkritischen Funktionen. Alle Angaben beziehen sich auf einen Amiga 500 mit 7 MHz (gähn) bei 2 Bitplanes - bei 3 Bitplanes schlafen einem die Füße ein, weil der Copper dem Prozessor ständig Zyklen stiehlt. Der Seiten- puffer liegt in RAM: - Seite von der Karte lesen : 0.092 sec - Seite darstellen : 0.22 sec - AutoGet (SAT.1) : 170 Seiten in 30 sec - AutoGet, gepackt mit CBR0 (SAT.1) : 150 Seiten in 30 sec - mittels Konfigurationsdatei stark konfigurierbar. Diese Version von ViTe ist keine Vollversion, Einschränkungen siehe im Kapitel Copyright. 2 System-Anforderungen Zum Betrieb von ViTe benötigen Sie: - einen Amiga mit Kickstart 1.3 oder höher. 2.0 oder höher konnte von mir mangels Masse nicht getestet werden, aber mir fällt auf Anhieb kein Grund ein, warum es damit nicht laufen sollte. - eine Videotext-Dekoderkarte, wie sie in der C't in den Heften 11/91, 2/92, 3/92 und 7/92 oder im Projekt von Wilhelm Nöker auf der Franz-PD 318 beschrieben ist. Es sollte aber auch mit allen anderen Karten funktionieren, die den Dekoderbaustein SAA 5246 und eine identische Belegung der seriellen Schnittstelle mit den Signalen des I²C-Busses benutzen. - ein BAS-Signal. Dieses liegt z.B. an der SCART-Buchse von Fern- sehern oder Videorekordern an. Da ich leider keinen beschleunigten Amiga zur Verfügung habe, weiß ich leider nicht, ob die Kommunikation mit der Dekoderkarte auch mit diesen funktioniert. Falls das Programm also nicht in der Lage ist, Seiten zu empfangen, schicken Sie mir doch bitte eine kurze Notiz (mit der Bestellung der Vollversion ? :-)). 3 Installation Leider ist ViTe von einer ganzen Menge Libraries abhängig, da Kickstart 1.3 so ziemlich überhaupt nichts zur Verfügung stellt, was man zum komfortablen Programmieren benötigt. Zum Betrieb werden folgende Resourcen benötigt: - in libs: - diskfont.library © commodore (r.i.p.) - arp.library © arp authors - intuisup.library © Thomas Gansow - listwin.library © Thomas Gansow - tgreq.library © Thomas Gansow - time.library © Thomas Gansow - mem.library © Thomas Gansow - tgsort.library © Thomas Gansow - vt.library © Thomas Gansow - xpkmaster.library © U. Dominik Mueller - compressors/xpkCBR0.library © ? - iff.library © Christian A. Weber Die letzten 3 Libraries werden nur zur Nutzung bestimmter Features benötigt, d.h. Seitenkomprimierung und IFF-Ausgabe. - in devs: - vt.device © Thomas Gansow - in fonts: - vt_ascii.font - vt_ascii/9 - vt_gfx.font - vt_gfx/9 Das ist zugegebenermaßen eine ganze Menge, aber ich hatte keine Lust, die Funktionen in ViTe selbst zu integrieren, nachdem ich sie vorher (teilweise vor Jahren) in eine Library gestopft hatte. Außerdem stört es mich, wenn ich ein kleines Tool schreibe, das im Kern 2 KByte lang ist, durch Linklibs auf 80 KByte aufgeblasen wird. Ich hoffe nur, daß es zu keinerlei Namenskollisionen kommt. Die fonts wurden aus dem PD-font pearl.font entwickelt, dessen Autor mir leider unbekannt ist. 3 Betrieb Vorausgesetzt, alle Resourcen sind korrekt installiert - die Fehler- diagnose ist ein wenig schlapp - öffnet sich nach dem Start von ViTe ein Custom-Screen. Vorher wird in s: die Datei vt.config gesucht, die zum Betrieb zwar nicht notwendig aber sehr nützlich ist. In dieser Seite stehen die Sender, die ViTe kennt, wie groß der Seitenpuffer für diese Sender sein soll, welche Seiten bei Programmstart angefordert werden sollen und weitere Konfigurationsinformationen. Die Bildschirmdarstellung besteht aus 2 Teilen. Oben werden VT-Seiten dargestellt, im unteren Teil sind Statusinformationen wie z.B. Belegung der Suchkanäle, eingestellter Sender, Uhrzeit u.s.w zu sehen. Die unterstrichenen Buchstaben in der Bildschirmmitte bedeuten von links nach rechts: - 1-3 Anzahl der für die Bildschirmdarstellung verwendeten Bitplanes und damit der Farben. - X Die Seiten im Pufferspeicher werden mit der xkpmaster.library und der entsprechenden sublibrary gepackt. - H Die aktuelle Kopfzeile im Videotextdekoder wird ständig links oben angezeigt. - A Es werden auch "schlechte" Seiten in den Pufferspeicher aufgenommen. "Schlechte" Seiten sind solche, bei denen die Seitennummer nicht in der Kopfzeile steht. - E Es werden bei der automatischen Suche auch Seiten gespeichert, die schon im Pufferspeicher vorhanden sind. Sonst werden schon gespeicherte Seiten nicht noch einmal aufgenommen. - B Das Blinken von entsprechend codierten Seitenteilen ist aktiv. Dabei wird die Seite, über der sich der Mauszeiger gerade befindet, ständig neu dargestellt. - U Neu in den Pufferspeicher aufgenommene Seiten werden am Bildschirm dargestellt, falls gerade die gleiche Seite schon sichtbar ist. Dadurch ist ständig die aktuellste Version der Seite zu sehen. - 2-4 Anzahl der bei der automatischen Suche verwendeten Such- kanäle. Falls 2-3 Kanäle verwendet werden, kann auf den freien weiterhin nach bestimmten Seiten gesucht werden. - O Die Seiten werden 2-farbig dargestellt. Dabei wird Graphik durch Umrißlinien dargestellt. 4 Bedienung - Tastatur T S C a h t s i r t f l e t HELP Zeigt eine Hilfedatei an ESC Beenden von ViTe ESC * Beenden von ViTe und Löschen aller Seitenpuffer F1 Darstellung am Fernseher auf TV-Bild F1 * Bildschirm auf 2 Farben umstellen F2 Darstellung am Fernseher auf Videotext F2 * Bildschirm auf 4 Farben umstellen F3 Darstellung am Fernseher auf Videotext/TV gemischt F3 * Bildschirm auf 8 Farben umstellen F4 Darstellung am Fernseher auf Videotext und TV F4 * Benutzt bei automatischer Suche 2 Kanäle F5 * Benutzt bei automatischer Suche 3 Kanäle F6 Darstellung am Fernseher auf normale Höhe F6 * Darstellung am Fernseher auf doppelte Höhe F6 * Benutzt bei automatischer Suche 4 Kanäle F7 Darstellung am Fernseher auf obere Hälfte F7 * Darstellung am Fernseher auf untere Hälfte F8 Stellt verborgene Zeichen nicht dar F8 * Stellt verborgene Zeichen dar F9 invertiert die Farbpalette F10 Umschalten der Bildschirmgröße 1 * Übersicht über die Seiten 100-199 2 * Übersicht über die Seiten 200-299 3 * Übersicht über die Seiten 300-399 4 * Übersicht über die Seiten 400-499 5 * Übersicht über die Seiten 500-599 6 * Übersicht über die Seiten 600-699 7 * Übersicht über die Seiten 700-799 8 * Übersicht über die Seiten 800-899 A Schaltet das Speichern defekter Seiten um B Umschalten des Blinkens C Löschen aller Suchkanäle D Löschen aller Seiten des aktuellen Senders D * Löschen aller Seiten aller Sender E Liest bei Autoget schon gelesene Seiten neu ein F Stringsuche ab erster Seite F * Stringsuche ab erster Seite (case sensitiv) G Umschalten zwischen automatischer/einfacher Seitensuche G * Fordert die auf der aktuellen Seite angegebenen Seiten an H Umschalten der Darstellung der Titelzeile H * Gibt die aktuelle Seite als hexdump in eine Datei aus I Gibt die aktuelle Seite als ifffile in eine Datei aus I * Druckt die aktuelle Seite aus L Setzen des Locks für die einfache Seitensuche L * Setzen des Locks für die automatische Seitensuche L * Informiert über die Sprache der aktuellen Seite M Stellt die vorher angezeigt Seite wieder dar N Stringsuche ab nächster Seite N * Stringsuche ab nächster Seite (case sensitiv) O Setzen des Timeouts der einfachen Seitensuche P Gibt die aktuelle Seite in eine Datei aus P * Hängt die aktuelle Seite an eine Datei an Q Informiert über die Qualität der Video- und Textsignale R Fordert die aktuelle Seite neu an S Einstellen eines anderen Senders (nicht während automatischer Seitensuche) T Testet auf Vollständigkeit der Seiten T * Fordert TOP-Text an T * * Löscht TOP-Text U Löschen des Locks für die einfache Seitensuche U * Löschen des Locks für die automatische Seitensuche U * Umschalten des Updatings neuer Seiten am Bildschirm V Informiert über die Version von ViTe W Schreibt die Seite auf den Speicher der Dekoderkarte X Schaltet das Packen der Seiten um - Cursortasten links vorherige Unterseite anzeigen links * vorherige Seite anzeigen links * erste Seite anzeigen links * * erste Seite des vorherigen Magazins rechts nächste Unterseite anzeigen rechts * nächste Seite anzeigen rechts * letzte Seite anzeigen rechts * * erste Seite des nächsten Magazins hoch springt zur nächsten dreistelligen Zahl runter springt zur vorigen dreistelligen Zahl return anfordern einer mit hoch oder runter angewählten Zahl - Ziffern Durch Eingabe von 3 Ziffern wird die entsprechende Seite ange- fordert. Das Löschen von einer falschen Ziffer ist durch möglich. löscht alle eingegebenen Ziffern. Falls bei der Eingabe gedrückt ist, wird die Seite auf jeden Fall neu gesucht, vorher aber angezeigt, falls sie schon im Seitenpuffer ist. Falls gedrückt ist, passiert das gleiche wie bei , zusätzlich wird die Seite ständig neu angefordert, wenn sie gefunden wird. - Maus Wenn sich der Mauszeiger über einer dreistelligen Zahl auf einer VT-Seite befindet, kann die Seite mit der linken Maustaste angezeigt und mit der rechten Maustaste gesucht werden. 5 Konfigurationsdatei s:vt.config Text, der in einer Zeile nach % steht, wird ignoriert. Die Kommandos und ihre Parameter haben folgende Bedeutung: - $PageDirectory DIRECTORYNAME Directory, in dem die Seitenpuffer angelegt werden. - $PagesFor SENDERNAME KLARNAME MAXNUM Macht ViTe den Sender bekannt und gibt die maximale Anzahl der zu speichernden Seiten an. Falls die Seitenzahl erreicht wird, werden die Seiten aus dem Puffer entfernt, deren letze Darstellung am längsten zurückliegt (LRU). - $PagesDefault MAXNUM Falls ein Sender empfangen wird, der noch nicht in der Senderliste steht, wird die Puffergröße auf MAXNUM Seiten gesetzt. - $Pages+ SEITENLISTE Inklusiv-Liste für automatische Suche, d.h. Seiten, die in der SEITENLISTE stehen, werden, auch wenn sie in der Exklusiv-Liste stehen, gespeichert. - $Pages- SEITENLISTE Exklusiv-Liste für automatische Suche, d.h. Seiten, die in der SEITENLISTE stehen, werden nicht gespeichert. - $Autoget Aktiviert bei Programmstart die automatische Suche. - $InitRead SEITENLISTE Fordert beim Programmstart die in SEITENLISTE stehenden Seiten an. - $RefPage SEITENLISTE Definiert eine Liste von Indexseiten. Wenn eine Seite aus der Liste neu gelesen wird, werden die auf der Seite referenzierten Seiten angefordert. - $WatchPage SEITENLISTE Schreibt die in SEITENLISTE stehenden Seiten in die Watchliste. Alle Seiten, die in der Watchliste stehen, werden zyklisch neu angefordert - $InputLock QUADRANTNUMMER Setzen des Locks, d.h. Seiten, die bei manueller Suche neu eingelesen werden, werden auf dem angegebenen Quadranten dargestellt. QUADRANTNUMMER kann je nach Bildschirmgröße Werte von 0--1 oder 0--3 annehmen. - $AutoInputLock QUADRANTNUMMER Setzen des Locks für automatische Suche, d.h. Seiten, die bei automatischer Suche neu eingelesen werden, werden auf dem angegebenen Quadranten dargestellt. - $TimeOut SEKUNDEN Setzen des Timeout für manuelle Seitensuche. Falls nach der angegebenen Zeit die angeforderte Seiten nicht gefunden ist, wird die Suche abgebrochen. - $Headline Stellt ständig die aktuelle Kopfzeile des Dekoders am Bildschirm dar. - $invertColors SENDERNAME Invertiert beim angegebenen Sender die Farbpalette. - $Copper Aktiviert die Copperliste, d.h. im unteren Bildschirmteil werden andere Farben verwendet. - $Bigscreen Öffnet einen großen Bildschirm, auf dem 4 Videotextseiten gleichzeitig dargestellt werden können. - $outLineMode Stellt die Graphik der Seiten als Umrißlinien dar. - $packPages Packt die Seiten im Seitenpuffer, falls die xpkmaster.library gefunden wird. Es ergibt sich dadurch eine Speicherersparnis von ca. 25-40\%, je nach verwendetem Packer. Bei Sendern, bei denen öfter Fehler - insbesondere leere Zeilen - auftreten, empfiehlt es sich, nicht mit gepackten Seiten zu arbeiten, da für diese fehlerhaften Seiten meist 2 Puffer angelegt werden und sich dadurch die Seitendatei vergrößert. - $xpkPacker NAME Name des xpk-Packers, der verwendet werden soll. Standardwert ist CBR0, mit dem ca. 25\% erreicht werden und der schnell genug ist. - $addBadPages Speichert auch Seiten, deren Seitennumer nicht in der Kopfzeile steht (wahrscheinlich eine defekte Seite). - $everyPage Liest bei automatischer Suche schon gelesene Seiten neu ein. Normalerweise werden Seiten, die sich schon im Puffer befinden, nicht wieder eingelesen. - $screenDepth NUM Setzt die Anzahl der Bitplanes - und damit der Farben - für den Bildschirm. NUM darf Werte von 1 bis 3 annnehmen. - $autogetChannels NUM Setzt die Anzahl der Kanäle, die bei automatischer Suche verwendet werden. NUM darf Werte von 2 bis 4 annnehmen. - $slowStation SENDERNAME SENDERNAME ist ein Sender, der die Seiten besonders langsam sendet. Falls bei diesem Sender $slowStation nicht angegeben wird, sind die gelesenen Seiten oft unvollständig (z.B. DSF, Stand Januar 1994). - $sillyStation SENDERNAME SENDERNAME ist ein Sender, der zwar Mehrfachseiten sendet, diese jedoch nicht korrekt codiert, bzw. deren Unterseitennummer immer 0 ist. Voraussetzung ist, daß irgendwo auf der Seite eine Angabe in der Form 2/4 steht (2. Unterseite von 4). Eurosport ist z.B. eine sillyStation (Stand Juni 1994). 6 Copyright u.s.w. Ich lehne die Verantwortung für jegliche Schäden an Hardware, Software oder Geist, die durch den evtl. fehlerhaften Betrieb von ViTe entstehen, ab. Sie benutzen ViTe auf Ihre eigene Verantwortung. Allerdings benutze ich ViTe selbst oft und gerne. Alle Rechte für ViTe, diese Dokumentation, die verwendeten libraries (intuisup.library, listwin.library, tgreq.library, time.library, mem.library, tgsort.library und vt.library) und das vt.device liegen bei Thomas Gansow. Alle genannten Teile dürfen frei weitergegeben werden, solange sie komplett und nicht verändert werden und keine Gebühr über DM 5.00 für die Diskette verlangt wird. Da es sich bei der vorliegenden Version um keine Vollversion handelt, gibt es folgende kleine Einschränkungen: - bei Programmstart erscheint ein Info-Requester. - maximal 20 Seiten pro Sender (Vollversion: beliebig) - bei Senderwechsel erscheint ein Info-Requester - nur 2-seitige Darstellung der VT-Seiten (Vollversion: 4-seitig) - keine TopText-Unterstützung - bei automatische Suche nur halb so schnell auf 7 MHz Amigas Falls Sie diese Einschränkungen nicht stören, können sie ViTe in der FreeWare-Version solange und sooft benutzen und weitergeben wie Sie wollen. Sollten Sie jedoch Interesse an einer Vollversion ohne diese Einschränkungen haben, ist diese für DM 40.00 (nicht viel, wenn man bedenkt, wieviele Stunden Entwicklung dahinter stecken) bei mir erhältlich. Diese Vollversion darf dann allerdings nicht weitergegeben werden. Für weitere DM 10.00 erhalten Sie auch die Dokumentation zur vt.library. Um die Vollversion zu erhalten, schicken Sie am besten einen Euroscheck an folgende Addresse: Thomas Gansow Lameystraße 19 D-76185 Karlsruhe Falls irgendwelche Wünsche (was ViTe angeht) offenbleiben, Probleme oder Fehler im Betrieb von ViTe oder dessen Dokumentation auftreten oder Sie einfach nur ein Statement zu ViTe abgeben wollen, schreiben Sie ebenfalls an obenstehende Addresse (you can say you to me). Bei auftretenden Fehlern geben Sie bitte ihre Rechnerkonfiguration an, bei evtl. falsch dargestellten Seiten die Seite im Hex-Format (Shift-H).