Small ANSI-Master V1.01 (kurz SAM): =================================== Inhalt: ------- 1. Programmänderungen 2. Wozu SAM? 3. Warum (der Name) SAM? 4. TextPlus 5. Die Benutzung von SAM 5.1 Die WB-Version 5.2 Die CLI-Version 6. Kopierbestimmungen und Sonstiges 1. Programmänderungen: V1.0 (05.02.91): - erste offizielle Version V1.01 (13.03.91): - Falls man V1.0 vom CLI startete hatte man nachher ein CLI mit einer TaskPriorität von -50. Nun wird die alte Task- Priorität wieder restauriert. 2. Wozu SAM? SAM wandelt eine Brief-Datei von TextPlus in eine ANSI-Datei um, so daß diese mit den entsprechenden ANSI-Codes für fett, kursiv und unterstrichen versehen wird und z.B. mit MuchMore angezeigt werden kann. Zusätzlich kann man auch alle ANSI-Codes aus einer Datei entfernen. 3. Warum (der Name) SAM? Hinter SAM stecken eigentlich nur zwei Proceduren aus einem Programm, daß ich im Moment schreibe. Das Programm heißt natürlich ANSI-Master und wird (falls es jemals fertig werden sollte) alles bis jetzt dagewesene an ANSI-Editoren in den Schatten stellen!!! Da erst 1/5 von ANSI-Master fertig programmiert ist und die Proceduren "converttptoansi" und "removeansi" schon funktionier- ten und mir recht nützlich erschienen, habe ich daraus SAM gemacht. Eigent- lich wollte ich dieses Programm ja SAU (Small ANSI Utility) nennen, aber SAM klang aus irgendeinem Grund ein wenig seriöser. 4. TextPlus: Jeder, der sich ein wenig auf dem PD-Markt auskennt, kennt warscheinlich die Shareware-Textverarbeitung TextPlus von Martin Steppler (z.B. auf AmigaJUICE 24), die ich persönlich auch sehr empfehlen kann. Um nun einen ASCII-Text in eine ANSI-Datei umzuwandeln, die dann z.B. mit MuchMore angezeigt werden kann geht man so vor: - Man lädt in TextPlus einen Text ein. - Mit Hilfe des Menus "Schrift" kann man nun den Text kursiv, unterstrichen und fett darstellen. - Falls im Menu "Einstellungen" "Brief" nicht angeschaltet ist, wird dieses nun aktiviert. - Fertig editierten Text abspeichern. - Normalerweise hat der Text nun die Endung ".txp" und kann nun mit Hilfe von SAM umgewandelt werden (siehe 4.) 5. Die Benutzung von SAM: SAM ist einmal in einer CLI- und einmal in einer WorkBench-Version (die aber auch vom CLI gestartet werden kann) in diesem Directory vorhanden. Beide Ver- sionen tun eigentlich genau dasselbe, nur, daß die WB-Version den Filere- quester der Req-Library benutzt und 2 KB länger ist, während der CLI-Version alle Parameter beim Programmstart übergeben werden müssen. Bei beiden Versionen können Quell- und Ziel-Datei nicht identisch sein, da die Quell-Datei Byte für Byte untersucht wird. 5.1 Die WB-Version: Startet man die WB-Version, so erscheint ein kleines Window mit 3 Gadgets. TextPlus ---> ANSI: Klickt man dieses Gadget mit der Maus an, so erscheint (falls sich die Req- Library im LIBS:-Verzeichnis befindet) ein Filerequester, in dem man die mit TextPlus abgespeicherte Brief-Datei auswählt. Ist kein Fehler aufgetreten, so gibt man den Namen der Datei ein, die nun von SAM erstellt werden soll. So- bald SAM die Datei umgewandelt hat, erscheint ein "Fertig"-Requester. Diese neu erstellte Datei enthällt nun anstatt den TextPlus-Steuerkommandos ANSI- Codes, die z.B. mit MuchMore oder PPMore (oder jedem anderem vernünftigen Textanzeigeprogramm) angezeigt werden können. ANSI ---> ASCII: Klickt man dieses Gadget mit der Maus an, so erscheint ein Filerequester, in dem man eine ANSI-Datei auswählt. Ist kein Fehler aufgetreten, so gibt den Namen der Datei ein, die nun von SAM erstellt werden soll. Sobald SAM die Da- tei umgewandelt hat, erscheint ein "Fertig"-Requester. Diese neu erstellte Datei enthällt nun keinerlei ANSI-Codes mehr, ist also eine reine ASCII-Da- tei. Info: Es erscheinen einige Informationen über SAM. 5.2 Die CLI-Version: Die CLI-Version kann logischerweise nur vom CLI gestartet werden! Wird SAM ohne Parameter aufgerufen, so erscheint eine kurze Hilfe. Wird SAM mit einem Fragezeichen aufgerufen, so erscheint ein kurzer Infotext. Will man mit SAM eine Datei umwandlen, so müßen immer drei Parameter angegeben werden: SAM Modus Quell-Datei Ziel-Datei Modus: Entweder C oder R. C steht für Convert und wandelt eine TextPlus-Datei in ei- ne ANSI-Datei um. R steht für Remove und entfernt alle ANSI-Codes aus einer Datei. Quell-Datei: Bei C(onvert) TextPlus-Datei sonst ANSI-Datei. Ziel-Datei: Bei C(onvert) ANSI-Datei sonst ASCII-Datei. Achtung!!! Gibt man Dateinamen an, die Leerzeichen enthalten, so müssen die beiden Namen mit einem "|" voneinander getrennt werden! (An dieses Zeichen gelangt man in- dem man die Shift-Taste und die Taste, die sich direkt links neben der Back- space-Taste befindet, drückt.) Man kann dieses Zeichen auch verwenden, wenn wenn keine Leerzeichen verwendet werden. 6. Kopierbestimmungen und Sonstiges: SAM ist Freeware! Alle Rechte und das Copyright liegen bei mir! SAM ist voll- ständig in Gfa-Basic 3.0 geschrieben. SAM darf nicht ohne meine Erlaubnis in irgendeine PD-Serie aufgenommen werden werden. Ich habe deshalb in jede Version einen Vermerk gesetzt, in dem steht, für wen diese SAM Version ist. Andere PD-Anbieter, die nicht versuchen einen Gewinn zu erwirtschaften, können bei mir jeweils die neuste Version bekommen. Kein Bestandteil von SAM darf verändert werden! SAM sollte nicht mehr weiter- gegeben werden, wenn eines der Files SAM, SAM.LST, SAM_CLI, SAM_CLI.LST, SAM.dok und die zugehörigen Icons, die alle unverändert sein sollten, fehlt! SAM ist vollständig in Gfa-Basic 3.0 geschrieben. (Version 3.05 für die In- teressierten.) Reproduzierbare Fehlerbeschreibungen, Wünsche für zukünftige Versionen, Hei- ratsanträge (bitte mit Foto ;-) und sonstige Briefe bitte an: Sandro Paolini Freiligrathstr. 79 W-5600 Wuppertal 2 Tel.: 0202 / 62 88 66 (nachmittags)