home *** CD-ROM | disk | FTP | other *** search
/ The CDPD Public Domain Collection for CDTV 3 / CDPDIII.bin / pd / programming / amos / rainmakerdemo / rainmaker2.doc < prev    next >
Encoding:
Text File  |  1992-09-18  |  7.3 KB  |  159 lines
  1. ---------------------------------------------------------------------
  2.                  RainMaker v2.0
  3.             A rainbow-making utility for AMOS
  4.  
  5.                    by
  6.                  Dan Murrell Jr.
  7.  
  8.   This program is SHAREWARE.  If you find this program useful in any way,
  9. please show me by registering your copy.  Registering will cost $5, and
  10. in return you will recieve a disk containing the complete version, with
  11. no features disabled or crippled, as well as the source, and my sincere
  12. thanks.  Also, if I ever find time to revise this program again, you will
  13. recieve a copy of it free.
  14.  
  15. ---------------------------------------------------------------------
  16.  
  17. What is this?
  18. -------------
  19.   This program is inspired by the Example program 10.14 on the AMOS disk.
  20. That is just a simple rainbow, true, but I was surprised at how easy and
  21. smooth-looking such an effect could be (I had just gotten AMOS and hadn't
  22. really explored rainbows yet.)    I was amazed at how much color could be
  23. put on one screen, without sacrificing color registers, speed, and without
  24. the occasional shortcomings of HAM.  Looking around for the program that
  25. generated the rainbow, Rainbow Warrior, I eventually found it, but it was
  26. so big I couldn't afford to download it.  So, I decided to make my own.
  27. The first version was a learning experience-- I learned how to program in
  28. AMOS, as well as how NOT to program in AMOS.  It was a mild success, but
  29. from the moment I finished it, I began thinking of ways to improve it.
  30. Now, after weeks of experimenting, testing, and downright procrastination,
  31. I've finally forced myself to complete the new version.  It is better,
  32. easier to use, has a new feature, and is even 12k smaller than the first
  33. one, weighing in at 27k.  One of my main objectives in writing this thing
  34. was to make it small enough to use as an 'Other' program.  It can be a nice
  35. utility to have, but it's not important enough to take up all of your
  36. memory.  But next time you need a nice smoothly gradated background for the
  37. new game that you're working on, just click on 'Run Other' and...
  38.  
  39. What does it do?
  40. ----------------
  41.   RainMaker lets you build a rainbow using a simple set of tools, and allows
  42. you to save it and include it with your own AMOS programs.  The original
  43. version saved rainbows as an ASCII procedure, but the new version allows
  44. you to save as both an ASCII procedure and as an AMOS bank  I used bank 12,
  45. but you can easily modify the source to use another.
  46.  
  47. Features
  48. --------
  49.   RainMaker has a few tools and features, which are listed as follows:
  50.  
  51.     Up and Down cursor keys -- will move the rainbow to the top or bottom
  52.                    instantly
  53.     Clicking the right mouse button -- will clear the screen of all displays
  54.                        so that you can view the rainbow.  To
  55.                        return to the normal display, press it
  56.                        again
  57.     Clicking the left mouse button -- selects specific functions.  If not
  58.                       clicked on a 'button', then you will be
  59.                       allowed to change the color of the
  60.                       specific line you clicked on.  To alter
  61.                       the color, click in the R, G, or B
  62.                       slot that you wish to change.  The
  63.                       higher in that slot you click, the more
  64.                       of that color you will use.  Press the
  65.                       right button to enter the change and
  66.                       return to the normal mode.
  67.             Note: You may be asked to do this during other
  68.                   functions of the program, when setting a color
  69.                   is necessary
  70.     Buttons:
  71.     --------
  72.       NEW -- the new button will clear the entire rainbow to black
  73.  
  74.       UNDO -- will 'undo' the last operation performed
  75.  
  76.       COPY -- will allow you to copy a portion of the rainbow to another area
  77.  
  78.       GRAD -- will create a gradation between two lines.  You will not be
  79.           asked to change any colors, only to point out the lines.
  80.           Note: This function may not always create the colors you might
  81.             expect, because the Amiga mixes colors using RGB, not
  82.             RYB.  Therefore gradating from a blue to a yellow will
  83.             NOT yeild green.  To make such a gradation, put a green
  84.             line between the blue and yellow, then gradate each of
  85.             those to the green line.  One possible enhancement in
  86.             the future would be to allow RYB color mixing.
  87.  
  88.       BOX -- will ask for a starting and ending line and then ask for a color.
  89.          Set the color to what you want, and all the selected lines will
  90.          become that color.
  91.  
  92.       BAR -- is a new feature inspired by many eurodemos.  This allows you to
  93.          make a nice 'copper bar' effect to scroll text in front of, or
  94.          whatever, giving it a metallic look.  You are asked for the
  95.          center line, then it's color, and the bottom line, and it's
  96.          color.  A gradation between the two will take place, then the
  97.          bottom half will be mirrored across the middle, giving the
  98.          'highlighted bar effect.'
  99.  
  100.       LCHG -- is also a new feature, because unlike the original, RainMaker 2
  101.           can have rainbows larger than the screen size.  This function
  102.           lets you adjust the size up to 4096.
  103.           This opens the doors for effects like blasting off into space
  104.           and having the atmosphere go from sky blue to black with no
  105.           programming effort, or having a sun setting in the background,
  106.           dragging a rosy sky along with it until it becomes purple, then
  107.           dark blue, then black.
  108.  
  109.       LOAD -- allows you to load a rainbow bank.  Will NOT work for an ASCII
  110.           saved rainbow, only for an .Abk rainbow file.
  111.  
  112.       SAVE -- allows you to save the rainbow.  It saves according to the
  113.           button below which will display either '.ASC' or '.ABK'.  Provide
  114.           the information it needs, or press 'ok' to accept the default
  115.           name.  To load a saved ASCII file into your own programs, use
  116.           the merge ASCII function of AMOS.  Then call MAKE_RAINBOW to
  117.           display your rainbow.  Be sure to have your background cleared
  118.           to 0 to be able to see all of it.
  119.  
  120.       QUIT -- self-explanatory.  It has a safety feature- you must press the
  121.           right mouse button if you're sure that you want to quit.  If
  122.           not, just press the left button.
  123.  
  124.       File Save Type -- this button is not functional in the demo, but in the
  125.             registered version, it is a toggle switch between
  126.             saving as an ASCII procedure or as an AMOS bank.
  127.  
  128. Other Features:
  129. ---------------
  130.   There are a couple of other features worth noting.  One is a small box just
  131. below the File Save Type button that tells you which line your pointer is
  132. over.  Across the screen from that is a zoom window which shows the current
  133. line as well as the ones above and below it, so you can be sure to click on
  134. the exact line you want.  Another useful feature is that you can scroll the
  135. rainbow to get at lines that are above or below the visible portion of the
  136. screen.  To do this, simply position your pointer on the dotted lines at
  137. the top and bottom of the screen.
  138.  
  139.  
  140.   Well, that's it.  It is very simple, but it can yield very good results.
  141. Included are a few sample rainbows, which were created in only a few seconds,
  142. to give you an idea of how it can be used.  These are in bank form, and can
  143. be loaded even by the demo users.
  144.  
  145. Enhancements:
  146. -------------
  147.   I am open to any suggestions for enhancing this program, as well as any
  148. criticisms, complaints, or comments.  I can be reached at:
  149.  
  150. Dan Murrell Jr.
  151. 116 L  N. Montgomery
  152. Starkville, MS 39759
  153.  
  154. or djm2@ra.msstate.edu
  155.  
  156. Thank you and I hope you find this program useful.
  157.  
  158.                                Dan
  159.