home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 562.lha / ZScroll_v1.0 / ZScroll.doc < prev    next >
Encoding:
Text File  |  1991-09-19  |  4.5 KB  |  100 lines
  1. ZScroll Dokumentation
  2.  
  3.  
  4. Bedienung
  5.  
  6.   ZScroll  Version  1.00  ist ein Scrollprogramm für ASCII-Texte,
  7. das  im  Multitasking-Betrieb  arbeitet. Es wurde mit dem DEVPAC-
  8. Assembler geschrieben, wobei allerdings keine DEVPAC-spezifischen
  9. Funktionen  (Makros,  Sections,...)  verwendet  wurden,  was eine
  10. leichte  Übertragung  auf  andere Assembler-Pakete gewährleistet.
  11. Der Start des Programms ist nur vom CLI aus möglich und geschieht
  12. auf folgende Weise:
  13.  
  14. ZScroll/ZScroll Dateiname [-speed (0-9)]
  15.  
  16.   Zu den Parametern:
  17. -  Dateiname:  Der  Name der Textdatei, die mit ZScroll gescrollt
  18.              werden  soll.  Das  Programm  überprüft nicht, ob es
  19.              sich  dabei  wirklich  um  einen ASCII-Text handelt.
  20.              Unter  Umständen  erscheint  also Zeichensalat, wenn
  21.              eine  Datei  dargestellt wird, die kein Text ist. Es
  22.              können  so  aber auch unbekannte Dateien nach ASCII-
  23.              Texten durchsucht werden.
  24. -  [-speed]:  Wird so verwendet: -0, -1,...,-9. Es wird damit die
  25.             Geschwindigkeit   der   Laufschrift  (eigentlich  die
  26.             Pausen  zwischen  dem Printen zweier Zeichen) angege-
  27.             ben.  -0  bedeutet Höchstgeschwindigkeit (Achtung auf
  28.             eventuell  als  Hintergrundtasks  installierte Radar-
  29.             fallen!)   und   -9   Schneckentempo.  Die  langsamen
  30.             Geschwindigkeiten  sind evtl. für Turbokartenbesitzer
  31.             von  Nutzen,  ich hatte allerdings nicht die Möglich-
  32.             keit das auszuprobieren. (Voreingestellt: -1)
  33.   ZScroll  kann natürlich auch mit RUN als eigener Task gestartet
  34. werden.  Das ist wohl auch am sinnvollsten, denn das Programm ist
  35. vor  allem aus dem Wunsch entstanden, die Anleitung eines PD-Pro-
  36. gramms während dessen Ausführung lesen zu können.
  37.   Wenn  alles  geklappt  hat,  öffnet  ZScroll ein kleines Window
  38. unten am Workbenchscreen. Dieses kann vertikal verschoben werden.
  39. Der  Text  wird  dann  von  rechts nach links gescrollt. Wenn das
  40. Textende  erreicht  ist, wird von vorne begonnen. Durch Betätigen
  41. des Close-Gadgets wird dem Spuk ein Ende bereitet.
  42.  
  43. Fehlermeldungen
  44.  
  45.   ZScroll  gibt  im Falle eines Fehlers die Fehlermeldung im CLI-
  46. Window aus. Die einzelnen Meldungen sind:
  47. -  Zu  wenig Speicher: Die Textdatei konnte nicht in den Speicher
  48.   geladen werden. Mögliche Abhilfe schafft hier das Schließen von
  49.   nicht  mehr  benötigten  Fenstern  bzw.  das  Beenden von über-
  50.   flüssigen Tasks.
  51. -  Datei  nicht  gefunden:  Die angegebene (Text-)Datei existiert
  52.   überhaupt nicht. Ja und was nicht da ist, kann klarerweise auch
  53.   nicht auf den Bildschirm kommen...
  54. - Datei konnte nicht geöffnet werden.
  55. - Lesefehler:  Die Datei wurde zwar gefunden,  ist aber irgendwie
  56.   defekt, sodaß sie nicht geladen werden kann.
  57.  
  58.  
  59. Programm & Probeme
  60.  
  61.   Das  Listing von ZScroll ist sehr ausführlich bis zu viel doku-
  62. mentiert,  sodaß  ich  mir  eine  Ablaufbeschreibung sparen kann.
  63. Einige Bemerkungen habe ich dennoch auf Lager. So werden zum Bei-
  64. spiel  immer  zwei  Zeichen auf einmal ausgegeben, was vielleicht
  65. den einen oder anderen Ästhetiker unter den Usern vergrämen könn-
  66. te.
  67.   Das leichte Ruckeln der Laufschrift liegt nicht im Progamm son-
  68. dern  in  der  Scrollroutine  des Betriebssystems begründet, läßt
  69. sich  also  kaum umgehen. Die Laufschrift wird außerdem umso trä-
  70. ger,  je mehr Tasks parallel laufen. Bei hohen Scrollgeschwindig-
  71. keiten  macht  sich dieser Effekt am stärksten bemerkbar. Apropos
  72. hohe  Geschwindigkeiten: wenn ZScroll in der Startup-Sequence mit
  73. Parameter  -0  aufgerufen  wird,  kann  es sein, daß die Startup-
  74. Sequence  nicht vollständig abgearbeitet wird, weil dem System zu
  75. wenig  Zeit  zum Laden der Programme zur Verfügung steht. Die Ge-
  76. schwindigkeit ist also gegebenenfalls zu erniedrigen.
  77.   Weiters  muß  dafür  gesorgt  werden, daß sich der Amiga im 80-
  78. Zeichen-Modus befindet und der Standardfont (Topaz 8) eingestellt
  79. ist. Nur mit diesen Vorraussetzungen kann ZScroll einwandfrei ar-
  80. beiten.
  81.  
  82.  
  83. ...und aus!!!
  84.  
  85. Da  es  sich  bei  ZScroll um mein erstes etwas längeres Programm
  86. handelt,  sind  Verbesserungsvorschläge  oder Erweiterungswünsche
  87. immer  willkommen.  Sollten  Sie Fehler im Programm finden, bitte
  88. ich Sie, mir diese mitzuteilen!
  89.  
  90. Das  Programm  ist  Public Domain. Ich übernehme keine Verantwor-
  91. tung für irgendwelche Dinge, die das Programm macht (aber eigent-
  92. lich  sollte  es ohnehin nur das machen, was ich oben beschrieben
  93. habe!!).
  94.  
  95.         Meine Adresse:
  96.                         Mark Zeindlinger
  97.                         Derfflingerstr. 6
  98.                         A - 4240 Freistadt
  99.                         AUSTRIA
  100.