home *** CD-ROM | disk | FTP | other *** search
/ Sauce 'n' Code 1 / sauce-n-code-01.adf / AMOS_Extension / stars.doc < prev    next >
Text File  |  1995-05-06  |  5KB  |  212 lines
  1.  __________   __________   __________   __________   __________   __________ 
  2. | ` |  _|· | | ` |  _|· | | ` |  _|· | | ` |  _|· | | ` |  _|· | | ` |  _|· |
  3. |_,_|_|/_,_| |_,_|_|/_,_| |_,_|_|/_,_| |_,_|_|/_,_| |_,_|_|/_,_| |_,_|_|/_,_|
  4. =============================================================================
  5.                            AMOS "STARS" EXTENSION
  6. =============================================================================
  7.  
  8. This file is freely distributable in its original archive, provided no profit
  9. is involved.
  10.  
  11. It may not be distributed on a cover disk.
  12.  
  13.  
  14.  
  15. The archive should contain the following files:-
  16.  
  17. stars.doc (this)
  18. stars.lib
  19. starspro.lib
  20. stars.lib.info
  21. starspro.lib.info
  22.  
  23.  
  24.  
  25. Seperate distribution of these files is forbidden.
  26.  
  27. All  files  are  copyright 1993 J.G.Doig, and may not be modified in any way,
  28. without prior written consent.
  29.  
  30.  
  31.  
  32. AMOS Stars Extension V2.23b.    **SHAREWARE VERSION**
  33.  
  34. By Jason G Doig
  35.  
  36.  
  37.  
  38. Introduction.
  39. ¯¯¯¯¯¯¯¯¯¯¯¯¯
  40. Stars  is  an  Amos  (and  AmosPro)  system extension, that provides many new
  41. commands to the Amos instruction set.
  42.  
  43.  
  44.  
  45. Installation.
  46. ¯¯¯¯¯¯¯¯¯¯¯¯¯
  47. My  apologies  for  the lack of an installation script, this is being written
  48. very  late  the night before I leave for a short holiday, and I simply do not
  49. have time right now.
  50.  
  51.  
  52.  
  53. To install the Extension, load workbench and find the relevant file:-
  54.  
  55. 'stars.lib' for Amos 1.3
  56.  
  57. 'starspro.lib' for AmosPro
  58.  
  59.  
  60.  
  61. You  will  then  need  to  copy  this  to  the relevant system drawer, either
  62. "amos_system"  or  "ap_system".   Now boot up Amos, and use the configuration
  63. program supplied with Amos to set the loaded extensions.
  64.  
  65. Type the path of the of the stars library into location #20.  To see what the
  66. necessary  file  path is, simply look at the early positions in the extenrion
  67. list,  as  the  standard  system extensions are in the same place as you have
  68. just put stars.lib.
  69.  
  70. Now reboot Amos.
  71.  
  72. Please work with a copy of your normal boot disk, as if you give an incorrect
  73. path, then Amos may refuse to boot.
  74.  
  75. Please mail me if you have any problems.
  76.  
  77.  
  78.  
  79. Commands
  80. ¯¯¯¯¯¯¯¯
  81.  The commands are as follows:-
  82.  
  83.  
  84.  
  85. STARS BLAST
  86.  
  87. Does a fancy fade effect on the current screen.
  88.  
  89.  
  90.  
  91. STARS VBL
  92.  
  93. Does the same as WAIt VBL, but shows idle processor time.
  94.  
  95.  
  96.  
  97. The  following  are  the  actual starfield commands.  These plot stars, under
  98. interrupt onto a given screen.  Please note that these plot not in a specific
  99. colour,  but  straight  onto  the last bitplane of a screen, so please try to
  100. keep  this clear or it will get corrupted.  The easiest way to put stars on a
  101. screen  is  to have one plane more than you actually use.  So use a 32 colour
  102. screen  to display a 16 colour logo.  Then copy the first half of the palette
  103. to  the  second.   Change the respective upper colour where you want stars to
  104. show  through.   e.g.  Change Colour, to show through colour 0 on our example
  105. above.
  106.  
  107.  
  108.  
  109. STARS ON screen,direction,number
  110.  
  111. Displays  [number]  stars,  traveling  in  a  specific  direction,  on screen
  112. [screen]
  113. Only one screen can have stars at one time.
  114. The maximum number of stars is 128
  115.  
  116. The directions are:-
  117.  
  118. 0 Left
  119. 1 Right
  120. 2 Up
  121. 3 Down
  122. 4 Stationary
  123.  
  124.  
  125.  
  126. STARS OFF
  127.  
  128. Switches off the stars and removes them.
  129.  
  130. STARS DIR direction
  131.  
  132. Changes the direction of the current starfield
  133.  
  134.  
  135.  
  136. The  next  few commands complement the built in COP commands.  See the manual
  137. for details.
  138.  
  139.  
  140.  
  141. COP PALETTE a TO b,address
  142.  
  143. Reads  12bit  colours  from  memory,  and  builds  o copper list to put these
  144. colours  in palette registers a to b.  a and b can be in the range 0-255, but
  145. a < b.
  146.  
  147. A colour takes up one word.
  148.  
  149.  
  150.  
  151. COP TRUE PALETTE a TO b,address
  152.  
  153. This is the same as above, but takes colour in the form Red Byte, Green Byte,
  154. Blue Byte, ie.  24bit.
  155.  
  156. A colour therefore takes 3 bytes.
  157.  
  158.  
  159.  
  160. =COP CURRENT
  161.  
  162. Returns  the address the copper list is currently being built at.  This makes
  163. poking straight into it easier.
  164.  
  165.  
  166.  
  167. Look  out  for  my  friend  Gary's forthcoming game, which uses these and the
  168. extra commands found in the full version of stars.
  169.  
  170. The extra commands include:-
  171.  
  172. COP SCREEN, which sets up a copperlist for a whole screen (in an AGA mode if 
  173. you want!)
  174.  
  175. STARS RAIN, which builds multiple 24bit Rainbows.
  176.  
  177. register now for these and more!
  178.  
  179.  
  180.  
  181. All  stars  commands  will also work on non-aga machines (or have equivalents
  182. which do the same job).
  183.  
  184.  
  185.  
  186. To register your copy send £10 to:-
  187.  
  188. Jason G Doig
  189. 20, Queens Crescent
  190. Kinghorn
  191. Fife
  192. KY3 9RG
  193.  
  194.  
  195.  
  196. Please feel free to contact me with comments, suggestions or bug reports.
  197.  
  198. I can also be contacted term time, by E-Mail :    JasonD@uk.ac.hw.cee
  199.  
  200. Upgrades  will  be sent out to registered users only.  (although feel free to
  201. ask   for  more  details  on  the  current  version  before  you  register  -
  202. unregistered users should send an SAE).
  203.  
  204. Please note that the AmosPro extension requires AmosPro V1.1, due to a bug in
  205. Amos.  The updater should be available where you obtained this archive.
  206.  
  207.  
  208.  
  209.  
  210.  
  211.  
  212.