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