home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 562.lha / ZScroll_v1.0 / ZScrollE.doc < prev    next >
Encoding:
Text File  |  1991-09-19  |  3.6 KB  |  86 lines
  1. Documentation of ZScroll
  2.  
  3. How to use ZScroll
  4.  
  5.   ZScroll V1.00 is a neat scrolly-proggy for ASCII-Files.  It is
  6. designed to run in multitasking  -  could be started via the CLI
  7. only, though, as follows:
  8.  
  9. ZScroll/ZScrollE Filename [speed (0-9)]
  10.  
  11. -  Filename:   The name of the textfile you want to scroll across
  12.            your  screen. The prog, however, does not check if you
  13.            are  really  feeding it ASCII-files. So, if you try to
  14.            scroll  a non-ASCII you may get a mess at your screen.
  15.            Probably  this  could be useful when searching text in
  16.            unknown files.
  17. - [speed]:  Optional parameter. Type -0, -1, -2,...,-9 to set the
  18.           speed   of  the  scroll  (actually  the  pause  between
  19.           printing  two characters). -0 means maximum speed and -
  20.           surprise!  -   -9  is  deadly slow. The last one may be
  21.           useful  for owners of turbo-boards but I could not test
  22.           it. (Default is -1)
  23.  
  24.   Running the prog  with RUN is the most sensible way to start it
  25. because  it  was  originally designed to be able to read the doc-
  26. file of a PD proggy while running it.
  27.   If  everything`s  OK ZScroll opens a small window at the bottom
  28. of  the  workbenchscreen. You can move this window up and down on
  29. the  screen.  The text then scrolls from right to left side (cur-
  30. rently  I`m  working  on  an  Arabic version of the proggy, which
  31. scrolls  from  left  to  right.........). Reaching the end of the
  32. text it  restarts. You can quit ZScroll by clicking at the close-
  33. gadget at the top left corner of the window.
  34.  
  35. Error Messages
  36.  
  37.   If  an  error  occurs  ZScroll  informs  you with the following
  38. messages about it:
  39. - Not  enough  memory:   Allocating  mem for the text went wrong.
  40.   Probably  it helps to kill unused tasks or to close superfluous
  41.   windows.
  42. - File not found: the textfile does not exist or you have given a
  43.   wrong path so that it can`t be found.
  44. - Opening textfile failed.
  45. - Read  Error:  file was found but is corrupt and could therefore
  46.   not be opened.
  47.  
  48. Program & Problems
  49.  
  50.   The source-code which could be found in this directory, too, is
  51. documented in detail (maybe too much). So it should be no problem
  52. for  the programmers among you to alter the code corresponding to
  53. your wishes. I just  want to give you a few notes about its prob-
  54. lems.
  55.   The flickering  of the scroll is no fault of ZScroll itself but
  56. of  the  scrollroutine  of the graphics-library. Furthermore, the
  57. more  tasks  are  running at the same time, the slower the scroll
  58. moves. This effect increases with the chosen speed.
  59.   When  starting  ZScroll  in the startup-sequence you should NOT
  60. use  speed -0  because it then gets most of the system`s time and
  61. your  Amiga  will  not be able to get on in the startup-sequence.
  62. Just test it for yourself!
  63.   It  is  essential  for ZScroll that your computer is running in
  64. text  mode  80 and with the standard topaz font. Only under these
  65. circumstances the prog will work correctly!
  66.  
  67. The End!
  68.  
  69.   ZScroll  is my first "not-too-short" proggy written in assembly
  70. language,  so  your suggestions, wishes, bug reports,... are wel-
  71. come indeed. If you just like the proggy and find it useful, also
  72. send a few words  to the adress below - I`ll keep updating it, if
  73. you want me to!!!
  74.   ZScroll is public domain. However, I can take no responsibility
  75. for anything  the program does (although it should just do what I
  76. described above!).
  77.  
  78.         The adress you should write to is:
  79.                         Mark Zeindlinger
  80.                         Derfflingerstr. 6
  81.                         A - 4240 Freistadt
  82.                         AUSTRIA
  83.  
  84. P.S:  If someone among you feels offended by my bloodily horrible
  85.       English I would like to apologize humbly!
  86.