home *** CD-ROM | disk | FTP | other *** search
/ No Fragments Archive 10: Diskmags / nf_archive_10.iso / MAGS / POWERMAG / POWER11.MSA / STSCROLL_README.DOC < prev    next >
Encoding:
Text File  |  2004-02-19  |  7.1 KB  |  210 lines
  1. *****************************************************************
  2. *                    The ST MESSAGE SCROLLER                    *
  3. *                                                               *
  4. *                              BY                               *
  5. *                                                               *
  6. *                         CHRIS SHARP                           *
  7. *****************************************************************
  8.  
  9.  
  10. Why
  11. ---
  12.  
  13. I wrote this program because I was bored one sunday afternoon. I get
  14. bored very easily you see, which is why I am writing this long
  15. DOC file!
  16.  
  17.  
  18.  
  19.  
  20. About
  21. -----
  22.  
  23. This version of the ST Message Scroller contains 15 commands.
  24. This may not sound much, but if you try them all out, I think you'll
  25. agree that there is plenty of variety.
  26.  
  27.  
  28.  
  29.  
  30. Uh-Oh
  31. -----
  32.  
  33. I have worked very hard to bring this program up to an acceptable
  34. release level, and therefore I feel I should be entitled to a small
  35. something for my work.
  36. I have added a limitation to this version of the software, to encourage
  37. people to register with me. This limitation is that you cannot display
  38. text files over 300 bytes (300 characters) long.
  39. When you register (details of how to register below) I will send you a
  40. fully operational copy with no limitations. This means that you will 
  41. then be able to display text files of up to 400 kilobytes on a 520STFM
  42. and more on an upgraded system!
  43.  
  44. To Register, send £5 to the address below (Cash or Postal orders, which ever
  45. you feel happiest with).
  46.  
  47.              Chris Sharp (Scroller Disk)
  48.              4 Sunnycroft Lane
  49.              Dinas Powys
  50.              South Glamorgan
  51.              Wales
  52.              CF64 4QQ
  53.  
  54.  
  55.  
  56.  
  57. What you get when registering
  58. -----------------------------
  59. You get one of my disks, with a fully working version of the software on
  60. it! You also get a few of my latest pieces of code, as yet unreleased!
  61. As well as all of that, you get loads of example text files, and how
  62. they work.
  63.  
  64. And on top of that, if you register, and you wish for an extra feature to 
  65. be added, then I will do my utmost to make sure that the command is added
  66. in an update of the software.
  67.  
  68.  
  69.  
  70.  
  71. Yes thats all very well, but what can I use this scroller for?
  72. --------------------------------------------------------------
  73.  
  74. Well, for instance, If you were writing some code for the Public Domain
  75. or Shareware libraries and needed just that little bit of extra
  76. flare for your software then you could put the instructions to the game in
  77. your scrolling message. You could write a list of Hello-To's in your
  78. message, and upload it on a bulletin board.
  79. If you register the software, you get instructions on how to get the
  80. message to automatically boot up when you place the disk in the drive
  81. and turn the computer on!
  82.  
  83.  
  84.  
  85.  
  86. Legalities
  87. ----------
  88.  
  89. Basically, If you use my program [scroller.prg] then you use it at
  90. your own risk. This generally means that if you wreck your disk
  91. collection as use or misuse of this software then its not my fault.
  92. Sorry!
  93.  
  94. You may give away copies of this program, providing that the text file
  95. (README.DOC) goes with it, and is not altered in ANY way.
  96.  
  97.  
  98.  
  99. Command Lists
  100. -------------
  101.  
  102. Here is a list of the commands that this version can use. These
  103. commands can be placed anywhere in the textfile (SCROLTXT.TXT).
  104.  
  105.  
  106. *   Denotes end of message file. You only need one in the entire
  107.     file. Place it right at the end when you want your message
  108.     to wrap araound and start again.
  109.  
  110. "   Turns multi coloured text on. Each letter's colour will be 
  111.     selected from a choice of ten different colours. Occasionally
  112.     2 letters in a row have the same colour, but this doesn't look
  113.     odd.
  114.  
  115. £   This turns off multicoloured text, and then the message is
  116.     displayed in white, until another colour command is chosen.
  117.  
  118. ^   If you would prefer your message to scroll faster than it normally
  119.     does, then add this commmand anywhere in the text, and it speeds
  120.     up when the position is reached.
  121.  
  122. %   This is the slow scroll speed, and is selected by default. If you
  123.     have selected fast scroll speed with ^ and decide you would like 
  124.     the text to scroll slower again, you can put this command in the
  125.     textfile (SCROLTXT.TXT), at any place, and the command will start
  126.     working as soon as the position in the text is reached.
  127.  
  128. &   This command allows you to change the colour of the text on the screen
  129.     The syntax of this command is -:
  130.  
  131.     &N        { Where N is a number, ranging from 01-15.   }
  132.               { If you want to use a colour number between }
  133.               { 1 and 9, then you must put a 0 in front of }
  134.               { it, e.g.      &05                          }
  135.  
  136.     The colours corresponding with the numbers are
  137.  
  138.     01 - White
  139.     02 - Green
  140.     03 - Black {Cannot be seen}
  141.     04 - Yellow
  142.     05 - Dark brown
  143.     06 - Light brown
  144.     07 - Pea Green
  145.     08 - Light Grey
  146.     09 - Dark Grey
  147.     10 - Red
  148.     11 - Green
  149.     12 - Yellow
  150.     13 - Blue
  151.     14 - Purple
  152.     15 - Cyan
  153.  
  154. (   This command enables you to scroll the message down, out of view.
  155.     can be placed anywhere in the message text file.
  156.  
  157. )   This command is the same as the one above, but scrolls the message
  158.     up out of view instead.
  159.  
  160. +   This command stops the message moving for half a second. You can
  161.     place several (up to 1000) in a row.
  162.  
  163. -   This command fades the text out of view. Once you have faded the text,
  164.     there is no way of getting it back, until the message has wrapped 
  165.     around, displaying it for the next time.
  166.   
  167.     The syntax of this command is
  168.  
  169.     -N           {Where N is a number ranging from 1 to 9}
  170.                  {1 is the fastest fade speed, and 9}
  171.                  {is the slowest.}
  172.  
  173. #   This command enables you to add sound effects to your scrolling
  174.     messages.
  175.  
  176.     The syntax of this command is
  177.  
  178.     #N           {Where N is a number between 01 and 50}
  179.                  {If you want to use a number between  }
  180.                  {1 and 9, then you must place a zero  }
  181.                  {in front of it, e.g.    #05          }
  182.  
  183. ~   This command enables the text to be exploded off the screen.
  184.  
  185. @   This command inverses the colours Black (&03) and White(&01),
  186.     meaning you now have a white screen, with black writing (Unless you
  187.     have changed the writing to a different colour in the meantime
  188.     of course!).
  189.  
  190. |   This command cancels out the inverse command, so if you have inversed
  191.     the colours, and then later on in the message want the colours to
  192.     go back to normal, then use this command.
  193.  
  194.  
  195.  
  196.  
  197. Finally
  198. -------
  199.  
  200. Don't forget that this version can only display text files of up to 300
  201. bytes (300 characters) long.
  202. When you register (Details given at start of document) you can scroll up
  203. to 400 kilobytes (400000+ characters) of text in your message, which is
  204. about the same as a medium sized novel!
  205. Also when you register, you can suggest ideas to be implemented in the 
  206. next version of the program, making it even more powerful!
  207.  
  208.  
  209. Have Fun,
  210.                            Chris Sharp