home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 5 / amigaformatcd05.iso / readerstuff / richard_thompson / cool_stars! / readme.doc < prev   
Encoding:
Text File  |  1996-08-13  |  9.7 KB  |  220 lines
  1. Cool Stars! V1.0 - Command extension for AMOS PRO
  2. -------------------------------------------------
  3.  
  4. © July '96 Richard Thompson
  5.  
  6. This is the USABLE -*SHAREWARE*- VERSION! - Please support shareware!
  7.             ---------------------------------------------------------
  8.  
  9. Distribution
  10. ------------
  11.  
  12.     This shareware version of Cool Stars! may be distributed worldwide,
  13. providing all files are included and remain unmodified.  I encourage AMOS
  14. clubs to make this extension available to AMOS users through their club.
  15. Feel free to bundle this extension in with AMOS compilations or on AMOS
  16. disk magazines etc.  Magazines are more than welcome to put this version of
  17. Cool Stars! on their coverdisks.  All good PD libraries should spread this
  18. shareware version of Cool Stars!.  Spread this version all around!!
  19.  
  20.     The above only applies to the shareware version!  The registered
  21. version is not freely distributable.
  22.  
  23. Bugs
  24. ----
  25.  
  26.     This extension has gone through extensive testing sessions by me and
  27. other AMOS Pro users.  All bugs appear to have been ironed out.  If one of
  28. these nasty creatures raises it's head, please let me know.  It's important
  29. that my extensions are bug free.
  30.  
  31. What is Cool Stars!?
  32. --------------------
  33.  
  34.     Cool Stars! is an extension which adds 22 more commands to the current
  35. AMOS Pro command set.  These 22 commands allow you to create, manipulate
  36. and display a wide range of different starfield effects.  A starfield is a
  37. collection of individual points which can be manipulated at lightening fast
  38. speeds.
  39.  
  40.     Starfields could be produced with the AMOS Pro Plot command but the
  41. resulting starfields would be too slow and jerky that it wouldn't be
  42. practical in most cases.  You'd rather use Cool Stars! which is coded in
  43. 100% assembler.  Cool Stars! can manipulate starfields at lightening fast
  44. speeds.  Literally hundreds or even thousands of stars can be manipulated
  45. in your -*SILK SMOOTH*- starfields!  Even with a MC68000 processor, it's
  46. possible to display hundreds of stars per vbl!!
  47.  
  48.     Starfields are most commonly seen in games and demos but can be used in
  49. any type of AMOS Pro program.  Starfields look great on the title screen of
  50. your latest game or demo.  Stars can fly through logos, fly across your
  51. high score table, they can fly just about anywhere!  Starfields can even be
  52. used in educational software or utility programs.  Cool Stars! starfields
  53. can radically boost the presentation of your programs, giving your programs
  54. that professional touch.  Your programs will always get more attention in
  55. the eye of a user if it has nice presentation.  Using Cool Stars! is a very
  56. simple and easy step you can take to achieve this!
  57.  
  58. Features of Cool Stars!
  59. -----------------------
  60.  
  61.     If your already thinking this is simply another run of the mill
  62. starfield extension, forget it NOW!!!!  Cool Stars! has MANY features which
  63. other starfield extensions simply don't have...
  64.  
  65.     -*MULTICOLOURED STARFIELDS*-  This is where Cool Stars! really shines
  66. out from the crowd.  Most starfield extensions only use the first bitplane
  67. of a screen, allowing only single coloured stars to be displayed.  Cool
  68. Stars! will allow -*EITHER*- single coloured stars or -*MULTICOLOURED*-
  69. stars!!  Multicoloured stars use the first 2 bitplanes, so each star in a
  70. starfield can be one of 4 colours.  A good application of this feature is
  71. to assign each star a different shade of grey, so each star appears to be
  72. of different brightness.  Stars which are moving faster can be given a
  73. lighter colour, whilst stars moving slower can be given a darker colour.
  74. This gives a rather cool parallax effect!
  75.  
  76.     -*ORIGINS*-  Cool Stars! has unique commands which let you control the
  77. origins of individual stars.  So it's possible to have your stars flying
  78. from the middle towards the edge of the screen.  This gives a wonderful
  79. impression of the stars "shooting out of the screen" towards you!  This
  80. gives great opportunity for some excellent program presentation.
  81.  
  82.     -*ABILITY TO SAVE BACKGROUNDS*-  With most starfield extensions, the
  83. bitplane the stars are being drawn onto gets corrupted.  This is usually
  84. okay if nothing is on the screen but if you intend your stars to fly over a
  85. graphic such as a logo or high score table, this is no good at all since
  86. the graphic will get corrupted.  A way around this is to use more bitplanes
  87. than necessary.  However, Cool Stars! provides commands which can save the
  88. background, rather like AMOS Pro's Bobs.  This enables you to pass stars
  89. over graphics without corrupting them.
  90.  
  91.     -*LIMITING STARS*-  Cool Stars! provides a command to confine your
  92. stars to just a rectangular area of the screen.  This can be very useful.
  93.  
  94.     -*SPEED*-  The extension is written in 100% assembler for maximum
  95. speed.  Cool Stars! commands are highly optimised for speed too,
  96. particularly the star clearing and drawing routines which use some
  97. precalculated data.
  98.  
  99.     -*It's a TRUE extension!*-  Unlike some so call 'extensions', Cool
  100. Stars! isn't just a list of procedures, it's a true extension!  Commands
  101. are used just like any other AMOS Pro commands.  The extension is fully
  102. compatible with the AMOS Pro compiler!
  103.  
  104.     -*Double Buffering*-  The starfield commands will work fine on double
  105. buffered screens when Autoback 0 is used.
  106.  
  107.     -*Only £5 to register!!*-  Yes, it's absolutely true.  It's only £5 to
  108. get yourself a registered version - undoubtably the bargain of the
  109. century!!
  110.  
  111.     Plus loads more!!
  112.  
  113. Installation
  114. ------------
  115.  
  116.     Okay, you know what the extension is about, you know how deprived
  117. you'll be if you don't use it, so now is the time to install it.  INSTALL
  118. THE EXTENSION -*NOW*- AND START USING IT TODAY!!!
  119.  
  120.     If you are using AMOS Pro V1.0, you may have problems using Cool
  121. Stars!.  This is because early versions of AMOS Pro had many bugs.  If you
  122. are still using AMOS Pro V1.0, you're strongly advised to upgrade to V1.1
  123. at least (updater disks are available from all good PD libraries) before
  124. installing Cool Stars!.
  125.  
  126.     The extension is very easy to install.  Simply follow these
  127. instructions -*EXACTLY*- and you'll have the extension installed within a
  128. few minutes.  May I remind you -*NOT*- to use your original AMOS Pro system
  129. disk, if you do something wrong, AMOS Pro may refuse to boot - always use a
  130. copy!
  131.  
  132.     1) Copy the 'AMOSPro_Cool_Stars!.Lib' file included with this
  133. distribution into your APSystem folder on your AMOSPro System disk.
  134.     2) Boot AMOS Pro as normal.  When it's loaded choose 'Set Interpreter'
  135. from the 'Config' menu.
  136.     3) Click on 'Load Default Configuration' followed by 'Set Loaded
  137. Extensions'.
  138.     4) Click on extension number 17 and type -*EXACTLY*-
  139. 'AMOSPro_Cool_Stars!.Lib'.  Now click on 'Okay'.
  140.     5) Now click on 'Exit' followed by 'Save Configuration'.
  141.     6) You'll now have to reboot AMOS Pro.  The extension has now been
  142. installed and you can now get down to using the Cool Stars! commands!
  143.  
  144. Examples
  145. --------
  146.  
  147.     I've bundled in a few small starfield examples with this distribution.
  148. Take a look at them and don't be afraid to experiment.  You can learn a lot
  149. by experimenting.  When you've finished, take a look at the 'Commands.Doc'
  150. file which contains documentation on every command in the Cool Stars!
  151. command set.
  152.  
  153. Limitations of the shareware version
  154. ------------------------------------
  155.  
  156.     You now have the shareware version of Cool Stars!.  Note that I haven't
  157. crippled the extension in any way which renders the extension as useless.
  158. This is because crippling programs totally often inhibits users from trying
  159. out software.
  160.  
  161.     Instead, I've gone for the method which a lot of shareware programmers
  162. use, the pop up requester!  You'll notice a small(?) requester which pops
  163. up on the screen every so often, encouraging you to register. :-)  Also, in
  164. the shareware version, the option to create multicoloured starfields has
  165. been disabled.  Users who don't register will therefore be stuck with
  166. single coloured stars as well as the annoying pop up requester!
  167.  
  168. Registering Cool Stars!
  169. -----------------------
  170.  
  171.     To register your copy of Cool Stars!, simply send a cheque, postal
  172. order or £5 bank note to the address below.  Please don't send any foreign
  173. money.  Feel free to write to me before registering if you have any further
  174. questions you'd like answering.  I am pretty fast writing back.  I try to
  175. dispatch orders same day if possible, if not it shouldn't be any longer
  176. than a week (nothing worse than waiting is there?).
  177.  
  178.     Registering will get you:
  179.  
  180.     * A copy of the latest registered version.  You'll now be able to use
  181. those nice multicoloured stars and there will be no pop up requester
  182. encouraging you to register.
  183.     * The right to distribute your programs which use the Cool Stars!
  184. extension as freeware, PD, shareware, licenseware, commercialware or
  185. whatever for no extra cost.
  186.     * Help, if you need it.
  187.     * Updates at a reduced fee (or free for minor updates such as bug
  188. fixes, just send a blank disk and SAE).
  189.  
  190.     Here is my address:
  191.  
  192.     Richard Thompson
  193.     50 Chesterfield Road
  194.     Shirland
  195.     Alfreton
  196.     Derbyshire
  197.     DE55 6BN
  198.     England
  199.  
  200.     Thank you for supporting shareware.  Let's keep the Amiga alive with
  201. new shareware products!
  202.  
  203. The future?
  204. -----------
  205.  
  206.     Cool Stars! is my first extension I've ever written.  The extension is
  207. pretty good as it is, even though this is the first version!  If you have
  208. any further ideas for Cool Stars!, drop me a line at the above address.  3D
  209. stars may be a possible idea for the future, I'll have to think about it.
  210.  
  211.     I may also be converting the Cool Stars! extension over to Blitz BASIC
  212. 2.  I already have a few ideas for another AMOS Pro extension (can't say
  213. what yet, it's all top secret! :-) ).
  214.  
  215.     Remember that I'll only continue to write extensions if enough interest
  216. is shown by users registering my extensions.  Many hours go into the
  217. creation of an extension and I need your support!
  218.  
  219.     Okay, that's the end of the doc file.  Enjoy Cool Stars! :-)
  220.