**************************************************************************** EcceS Version 1.0 -------- Autor : Norbert Süßdorf -------------- 31.03.1989 ---------------------------------------------------------------------------- Copyrights : Keine. Aber : EcceS ist Public-domain und darf von jedem kopiert, weitergegeben, modifiziert und etc. werden - unter Einhaltung folgender Bedingungen : Die Weitergabe muß kostenlos und immer in Verbindung mit diesem Dokument erfolgen. Mein Name darf nicht aus dem Programm entfernt werden. Falls jemand EcceS modifiziert, muß er seinen Namen im Programm angeben und in diesem Dokument auf sich und die vorgenommenen Modifikationen hinweisen. Für Modifikationen gilt : Nicht am Original-Programm- code, sondern nur am ModulaII-Quellcode unter Erstel- lung eines eigenen Compilats! (Der Quellcode erscheint evtl. auf einer AMOK-Diskette). Ausnahmen : Wenn EcceS unsichtbar - ohne Ikone - weitergegeben wird (z.B. als Default-Tool für 'ReadMe'-, bzw. 'Lies_Mich'- Texte oder zur Verwendung in der 'startup-sequence' - also nur als Mittel zum Zweck), kann auf die Weitergabe dieses Dokuments verzichtet werden. Nutzung : EcceS darf zwar nicht kommerziell weitergegeben, aber Teile davon dürfen in kommerziellen Programmen verwendet werden, und EcceS selbst darf auch kommer- ziell genutzt werden (z.B. Schaufenster-Werbung). Dafür erhebe ich k e i n e Gebühren. Eigenschaften und Bedienung : EcceS liest, über Klick auf die EcceS-Ikone, dann [SHIFT] und Doppelklick auf die Ikone der Text-Datei, diese Datei komplett (solange genug Haupt- speicher frei ist!) in einen Puffer und gibt den Text zum Lesen auf dem Bildschirm aus. EcceS kann auch im 'Info' der Text-Datei als 'Default-Tool' eingetragen werden, und wird dann bei Doppelklick auf die Ikone der Text- Datei gestartet. EcceS entspricht somit Programmen wie 'More','Less', 'MuchMore' und ähnlichen. Dabei kann in der Version 1.0 nur seitenweise (24 oder 21 Zeilen pro Seite) durch die Datei geblättern werden. Sobald die Datei eingelesen ist, wird sie ordnungsgemäß geschlossen und steht für andere Zwecke zur Verfügung. Über die Taste [Help] kann während des Programmlaufs im Normal-Modus eine kurze Bedienungsanleitung abgerufen werden. Die wesentlichen Funktionen sind dort beschrieben; deshalb gehe ich hier nicht mehr darauf ein. EcceS als Text-Slideshow : EcceS kann auch vom CLI unter Angabe mehrerer Parameter gestartet werden. Der erste Parameter muß den Namen der zu öffnenden Text-Datei unter An- gabe des Pfadnamens - falls die Datei nicht im selben Verzeichnis liegt - beinhalten. Die vier nächsten Parameter können wahlweise angegeben werden. Der erste dieser nachfolgenden Parameter beeinflußt die Hintergrund- farbe der Textausgabe (vier Möglichkeiten). Der zweite entscheidet über die Text-Schatten-Kombination (zwölf Mög- lichkeiten). Der dritte gibt an, ob EcceS normal, als Slideshow mit, oder ohne Ver- lassen des Programms gestartet wird (EcceS geht in diesem Fall am Ende der Slideshow in den Normal-Modus über). Außerdem entscheidet dieser Pa- rameter über die Anzeigedauer pro Seite. Ein negativer Wert führt zum autom. Verlassen von EcceS. Der vierte Parameter legt die Erscheinungsposition des EcceS-Ausgabe- fensters fest (Y-Koordinate von Screen-Oberkante(0) aus). Ein negati- ves Vorzeichen schaltet dabei die Schriftgröße Topaz9 ein. (Beispiel siehe nächste Seite) Beispiel: EcceS df1:Meine_Nachricht 1 0 -10 -0 / \ / | | | \ Pfad Text-Datei | | | Y-Position und Topaz9 Papierfarbe | zehn sec. pro Seite und Ende Textfarbe Im Slideshow-Modus können aus dem Programm heraus auch CLI-Befehle (oder andere Programme unter Angabe des Pfadnamens, falls sich diese nicht im aktuellen Verzeichnis befinden) gestartet werden. Zu diesem Zweck muß der CLI-Befehl 'RUN' und natürlich auch der auf- zurufende CLI-Befehl im c-Verzeichnis der System-diskette vorhanden sein. Die Aufrufprozedur dieser Programme wird im Text der Slideshow unter- gebracht. Sie muß jeweils in der letzten Zeile der Ausgabeseite - bei Topaz8 in den Zeilen 24,48,72 usw., bei Topaz9 in Zeile 21,42,63 usw. - stehen und von einem speziellen Zeichen eingeleitet werden. Dieses Zeichen erhält man in einem Text-Editor durch Tastenkombination [ALT]+[p] (deutsche Tastatur) oder [ALT]+[6] (amerik. Tastatur). Es wird in einigen Programmen als Paragraph-Ende-Zeichen verwendet und von EcceS grundsätzlich als Zeilenende interpretiert und auch nicht auf dem Bildschirm ausgegeben. Deshalb kann ich es hier auch nicht mit EcceS darstellen. Im Text-Editor (z.B. Microemacs) ist dieses ¶echo "Dieser Text wurde von EcceS ausgegeben." Zeichen natürlich sichtbar. (Schaut Euch dieses Dokument mit 'Less','More','Muchmore' oder einem Text-Editor an. Wenn Ihr dieses Dokument als Text-Slideshow startet - in Topaz8 - , habt Ihr auch gleich ein Demo-Beispiel). Wird in der Aufrufprozedur ein autom.-endendes Programm aufgerufen, z.B. der CLI-Befehl 'Echo', dann fährt EcceS erst nach Ende dieses Programms mit der Text-Slideshow fort. Nicht autom.-endende Programme müssen erst vom Benutzer beendet werden. Um dies zu umgehen, kann man Programme auch mit RUN Programmname... als neuen Task starten. Im Slideshow-Modus sind das Close-Gadget und die Tastatur-Befehle nicht aktiviert. Die Slideshow kann also nicht vorzeitig beendet werden. WICHTIG : Läuft EcceS als Slideshow (nur vom CLI möglich) als eigener Task (RUN EcceS Dateiname...) und werden dabei von dieser Slideshow Programme aufgerufen, dann darf das CLI-Fenster während der Laufzeit N I C H T geschlossen werden! (TASK HELD...) WARNUNG : Einige CLI-Befehle sind sehr mächtig und können katastrophale Folgen haben. Ich bitte daher, keinen Unfug mit EcceS-Slide- shows zu treiben. Grundsätzlich übernehme ich keine Haftung für Schäden irgendwelcher Art, die sich aus der Anwendung von EcceS ergeben. ---------------------------------------------------------------------------- Hier sollten die Modifikationen und der Name des jeweiligen Autors aufgeführt werden : Autor : Norbert Süßdorf Modifikation : EcceS Version 1.1 Zusätzliche Möglichkeit den Text auf dem Drucker auszugeben. Dazu muß man die [F5]-Taste drücken, worauf ein Requester erscheint. Bei positiver Antwort sollte der Drucker bereit und mit Papier gefüttert sein. Falls der Text Steuerzeichen enthält (die von EcceS ja nicht berücksichtigt werden), werden auch diese an den Drucker übermittelt. ****************************************************************************