Text-Wandler V1.5 <><><><><><><><><> © 24.4.1992 by Kai Seidel Ein bischen Theorie: ******************** Da ich neben meinem Amiga noch einen MS-DOS Rechner für die Bearbeitung meiner Mailbox-Programme & Texte habe ist es immer lästig daß die AMIGA ASCII-Tabelle nicht mit der IBM-Tabelle übereinstimmt. Die AMIGA-Texte sind auf einem MS-DOS Rechner (fast) nicht lesbar. Aus diesem Grund habe ich mich entschlossen einen Text-Wandler zu schreiben, der die Texte zwischen beiden ASCII-Formaten umwandelt. Ebenso sind die unterschied- lichen Zeilenenden zwischen MS-DOS und AMIGA ein Problem. Der AMIGA benutzt ein $0a (=Zeilenvorschub) und der MS-DOS Rechner ein $0d0a (=Wagenrücklauf + Zeilenvorschub) für das Zeilenende. Zum Programm: ************* Mein Programm behebt diese Problematik. Es ist in 100% Assembler ge- schrieben und nutzt somit die VOLLE Rechnergeschwindigkeit aus. Es werden immer 16KByte (=16384 Bytes) von dem zu wandelnden Text- File eingelesen, umgewandelt und wieder unter dem neuen Namen abge- speichert. (Fast?) Alle Fehleingaben werden vom Programm abgefangen. Um eine möglichst hohe Geschwindigkeit zu erreichen, wurden im Pro- gramm zwei voneinander getrennte Routinen, eine für die Umwandlung von Texten ins MS-DOS-Format und eine für die Umwandlung ins Amiga- Format, integriert. Ebenfalls sind zwei komplette ASCII-Tabellen im Programm mit drin die es problemlos ermöglichen auch andere Zeichen als >ÄÖÜäöüß< umzuwandeln. Das Programm besitzt keinen STARTUP-Code. Warum sollte es auch, es ist ja nicht für den Start von der WB aus gedacht. Das Programm wandelt seit der Version 1.4 folgende Sonderzeichen: ÄÖÜäöüߢ£¡¤¥§ª«¬­°±²µ¶º»¼½¿ÅÆÇÉÑàáâåæçèéêëìíîïñòóôøúûÿ Diese Zeichen werden in beide Wandlungs-Richtungen korrekt Transferiert. Zum Aufruf: *********** Der Textwandler kann momentan auf zwei Arten aufgerufen werden: Text-Wandler -i oder: Text-Wandler -a Im ersten Fall wird ein Amiga-Text in einen MS-DOS-Text umgewandelt. Wichtig ist die Angabe "-i". Diese gibt die Wandlungsrichtung an. Bei wird der Filename des zu wandelnden Textes angegeben. Mit gibt man den neuen Filenamen des Textes an unter dem der fertige Text gepseichert werden soll. Wichtig zu beachten ist, daß beide Namen unterschiedlich sind! Ist das nicht der Fall, dann bricht das Programm ab. Im zweiten Fall wird ein MS-DOS-Text in einen Amiga-Text umgewandelt. Die Angabe "-a" signalisiert dem Programm daß es sich diesmal um einen MS-DOS-Text handelt. Danach werden wieder Quell-Datei und Ziel-Datei eingegeben. Der Text-Wandler unterstützt auch die Angabe der Filenamen durch ein >"< (Anführungszeichen od. Gänsefüßchen). Dies ist insofern notwendig, falls der Filename ein Leerzeichen enthält. Hier MUSS der Filename in Anführungszeichen stehen! Wenn ein File mit demselben Namen wie das Ziel-File schon existiert, so wird sicherheitshalber der Anwender gefragt, ob er das File über- schreiben will. Diese Abfrage kann man mit dem "-o" Switch abschalten . Das ist dann sinnvoll, wenn man den Text-Wandler in Zusammenhang mit anderen Pro- grammen benutzt. Z.B. mit dem Mailboxprogramm EUROMAIL in Verbindung mit einem OFFLINE Editor, oder mit dem Programm DIRECTORY OPUS. Wird statt der Ziel-Datei ein File-Pfad angegeben (z.B. DF0:), so wird die Quell-Datei in den File-Pfad mit dem Quell-Namen konvertiert. Das ist dann recht Nützlich, wenn man den Namen der Quell-Datei nicht unbedingt ändern will, aber das Directory für die Ziel-Datei. Kleines Beispiel: Diskette >DF0:< enthält einen Text namens >TEST.TXT<. Dieser Text ist im Amiga-Format und soll nun auf die Festplatte >DH0:< mit demselben Namen ins MS-DOS Format konvertiert werden. Der Aufruf des Programmes muß dann folgendermaßen lauten: Text-Wandler -i DF0:TEST.TXT DH0: Ist doch ganz einfach... oder ??? Tips zum Wandeln: ***************** Um längere Texte zu wandeln ist es ratsam diese ins RAM zu kopieren, sofern dieser groß genug ist, und die Texte von dort aus wandeln zu lassen, da die Zugriffsgeschwindigkeit der Laufwerke auf Diskette nicht gerade überwältigend ist. Das ist allerdings nicht das Problem meines Programms! Die Switches kann man an beliebiger Stelle setzen! Lediglich die Reihenfolge der QUELL-File- und ZIEL-File-Namen muß eingehalten werden! Bekannte Fehler: **************** Wie immer: MOMENTAN KEINE BEKANNT Die groben BUG's werden vor Ausgabe der neusten Version immer beho- ben. Meist sind es jedoch die kleinen, fiesen, die man erst durch länge- res Arbeiten mit dem Text-Wandler erkennt. Trotzdem versuche ich die erkannten Fehler sofort aus dem Programm zu entfernen! Für die Zukunft: **************** - Text-Wandler wandelt auch >Ä< in >Ae< - Text-Wandler erkennt selbständig, ob es sich beim Quell-File um einen AMIGA- oder MS-DOS-Text handelt - Ausgabe der aktuellen Text-Position - evtl. Fileauswahl über File-Requester - graphische Unterstützung, dadurch auch von der Workbench aus nutzbar - powerpacker.library Unterstützung, sodaß auch gepackte Textfiles gewandelt werden können Wichtige Informationen: *********************** !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! !! Ich übernehme hiermit keine Verantwortung für eventuelle Schäden die !! !! durch die Benutzung des Text-Wandlers entstehen. !! !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! Falls Fehler auftreten: *********************** Dann bitte an mich eine Message mit möglichst genauem Fehler-Report per ZERBERUS-Netz an SYSOP@CHIEMGAU oder an folgenden Adresse: Kai Seidel Ringstraße 63 8221 Grabenstätt oder per Telefon: 08661-544 Wenn Du Verbesserungsvorschläge hast, dann schreib mir doch, ruf mich an, oder schreib mir ne Nachricht übers Z-NETZ an SYSOP@CHIEMGAU. SHAREWARE-GEBÜHR: ***************** Solltest du an dem Programm Gefallen finden oder du es öfter benutzen, dann fände ich es fair, mir 5,- DM an die oben genannte Adresse zu schicken. Oder Du überweist mir das Geld auf folgendes Konto: Kreissparkasse Traunstein-Trostberg, Konto-Nr.: 856591 - BLZ: 710-520-50 Als Bemerkung bitte "Text-Wandler REGISTRIERUNG" oder ähnliches ange- ben. Wer die Banküberweisung vorzieht, der soll mich doch bitte noch zu- sätzlich per Post, oder MSG übers Zeberus-Netz darüber informieren, und mir seine Adresse zusenden. Du bist dann berechtigt, immer die neuste Version nutzen zu dürfen! Die NEUSTE VERSION bekommst Du von mir entweder in meiner Mailbox (Tel. 08661-658 ab 18 Uhr), oder Du schickst mir einen frankierten, an Dich adressierten Rückumschlag MIT Diskette, den ich umgehend mit der neuen, registrierten Text-Wandler-Version zurücksende! Verbreitungs-Hinweise: ********************** Betrifft nur die SHARE-WARE-Version: Das Programm darf nur mit dieser Anleitung und mit einer Höchstgebühr von 4,- DM für Kopiergebühren weitergegeben werden! Das Programm darf von jeder PD-Serie aufgenommen werden. WICHTIG !!! Die registrierte Version beinhaltet zwar keine Einschränkungen, darf aber NICHT weitergegeben oder auf PD-Serien angeboten werden! Ebenso ist es den REGISTRIERTEN Benutzern untersagt, seine Version an dritte weiterzugeben! Entwicklungs-Phasen: ******************** V1.0 Erste Version vom 25.4.92 V1.1 Version vom 1.5.92 -Unterstützung von Filenamen mit Leerzeichen durch Angabe mit Anführungszeichen eingebaut -Test, auf zwei gleiche Filenamen eingebaut V1.2 Version vom 3.7.92 -Schweren BUG beim Wandeln in Richtung IBM-Format entfernt! -Speicher-Allokier-Routine verschoben -> noch kürzere Wandlungs- zeiten! -Zusätzliche Optimierungen vorgenommen (beq.s, moveq ect.) V1.2a Version vom 6.7.92 -Falschen USAGE-Text berichtigt V1.3 Version vom 11.7.92 -Wandel-Puffer wurde auf 16384 heruntergesetzt. -Weiteren Wandel-BUG behoben; probleme gab's beim Wandeln von IBM-Texten ins AMIGA-Format. Die Returns ($0d0a), die durch den Puffer von 16384 getrennt werden, werden jetzt auch richtig gewandelt! -Weitere Optimierungen vorgenommen; Die Anzahl der Lade-Bytes und der Bytes die gespeichert werden ist gleich -> SUPERKURZE Wandlungszeiten auch von Festplatte auf Festplatte! -BUG, der ein einwandfreies Funktionieren unter Kick 1.2/1.3 verhindert, in letzter Minute entfernt. V1.4 Version vom 21.7.92 -Zusätzliche Sonderzeichen werden, neben den Umlauten, jetzt auch gewandelt (siehe oben). V1.5 Version vom 24.7.92 -Die Verwechslung des Zeichens "¦" mit "|" in der Version 1.4 wurde berichtigt (ist für die Konvertierung von z.B. C-Sourcen wichtig). -Bei Angabe eines Directories statt dem Ziel-Namen, wird der Text mit dem Quell-Namen dorthin Konvertiert. -Sicherheitsabfrage bei bereits existierenden Ziel-File eingebaut. -Neuen Switch (-o) eingebaut, der die Sicherheitsabfrage auf Exis- tenz eines Files mit gleichem Namen wie der Ziel-File-Name, ab- schaltet. -Ohne Angabe eines Switches wird der Text nun ins MS-DOS-Format konvertiert.