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