  ==========================================================================

                     Rainbow Warrior ! - Amos Rainbow Kit

                 Written and Produced by Spadge The Unwilling

                      Exclusive for Newsflash Issue 15!

                    Version 1.1a.09373785748578 Wibbly Woo

  ==========================================================================

         This program is dedicated to Daisy - Francois Lionet`s dog.
         It was inspired by several Pink Floyd album covers and by
         the remarkable music of Bjorn Lynne - freak out to space
         Deleria.. far out.. way out.. I`m out..

  =========================================================================

  NOTE TO EVERYONE!! Please ONLY distribute the VERY LATEST version of this
  program or I`ll go all miserable, I don`t want early poxy versions flying
  around! If unsure please call me - or write and I`ll send a new version,
  the latest version was edited and fixed on Nov 7th 1990. Version 1.1


                                 Foreword.


  Amos, as most of the people who own  it will know, lays claim to providing
  the opportunity to use 4096 colour  Copper-Bars and copper-routines in the
  form of the Rainbow command. So far so  wonderful but quite a lot of users
  will have found out that actually forming the data for the rainbows can be
  long winded and confusing... not any more... Rainbow Warrior is here!

  RW gives you the opportunity to  "paint" with the copper/rainbows and save
  them out for direct inclusion  in  your  own  programs, indeed the program
  outputs ascii blocks so that they can  be merged directly! Of course RW is
  itself written in AMOS so users can  adapt,  mix and merge their own stuff
  in there too..

  Apart from Amos  though,  the  program  outputs  data  for K-Seka, Devpac,
  Binary, Decimal, Hex and it's own formats.. so it can be used for whatever
  evil and sickly reason you may deem fit.

  It offers an easy way  to  create  "copper  bars" - those metallic looking
  bars seen in many a demo... there's magnify, cut&paste, extend and fill..
  what more could an Amos user ever dream of? :-)


                           What you need to run RW
                           -----------------------

                                     Amos
                      An Amiga (I guess you're ok there)
                                 Some fingers
                                  A monitor
                                A disk or two
                       A brain functioning on low-power
         A bottle of Newky Brown to celebrate the Rainbow revolution


                              First Things First
                              ------------------

                              Turn your Amiga on


                              Running Rwarrior
                              ----------------

  Just load it up into AMOS and  hit  run... soon you'll be greeted with the
  obligatory credits bit  and  Newsflash  promo..  just  hit  the mouse butt
  a couple of times and you're in. You'll see a  menu  at the top and a
  square in the centre of the screen, denoting current colour. Hang on, no
  you won`t because I`ve changed the program since and now the current
  colour sits on the menu thingy-wotsit. Anyway it looks better there.

  The menu can be moved using the  cursor-keys,  so  you can shift it out of
  the way when you're painting in different  areas of the screen. The square
  is the currently selected colour which  will  be  used when you paint, you
  paint with the left mouse button and remove with the right.


                        Rwarrior Commands and Features
                        ------------------------------

  Although the menu  shows  most  of  the  commands,  some  are available by
  pressing shift instead and  the  key,  giving  a totally different result.
  Here's a full run down on what you can do, and how...

  X - This one exits, Don't bother pressing it just now!
  ? - This one pops the credits and Newsflash info on again, in case you
      missed it the first time around. (Can't blame me for that)
  c - Pressing c alone will clear the current screen to all-black.
  C - Shift-C will clear the screen and fill it with the current colour
      shown by the box in the middle. It also sets the new background colour
      and delete will have the effect of painting in this colour.
  n - This key automatically moves the cursor down and selects the next
      darker shade. This way it is VERY easy to produce copper-fades to
      black. Just select your colour, either a random one, a popular one or
      make your own up and keep pressing N (or hold it down). You`ll soon
      have half a bar.. just use M to Mirror it and hey presto.. Bar Magic!
  N - This does the same as above but moves the cursor upwards.
  G - Grab the current colour and store it.
  R - Recall a colour grabbed with "G"
  D - Select the next shade in the range. (Also "-")
  B - Select the next brighter shade in the range. (Also "+")
  * - Random Colour Select. (use to grab a random colour)
  / - Go through popular colour list.
  M - Mirror a section of the screen. (Use with "n" to create "bars")
  k - Copies a section of the screen into the paste buffer.
  K - Shift-K will cut the section completely and put it in the paste buffer
  P - Pastes the current contents of the paste buffer onto the screen at the
      current cursor location.
  F - Fill a region of the screen in the current colour.
  U - Undo. Retreive a screen saved with "Z".
  Z - Copy the current screen into ram. Retrieve with "U". (Like Undo)
  H - Grab the colour under the cursor.
  E - Expand. Easy way to create large copper displays, eg Sea types with
      gaps of colour. Create a blue-black fade with "N" at the top of the
      screen and use extend to stretch it all down the screen. It's usual
      to use extend from the top of the screen, but not necessary.
  S - Save Options (See Later)
  l - Load a previously created RWarrior screen (*.RWS) Just load in some
      of those trendy demo screens and drop that jaw, well be a bit giddy!
  L - Load a previously created RWarrior Buffer (*.BUF)
  i - Load an IFF Image onto the screen. This let`s you load a 4-plane
      lo-res iff picture onto the screen, as the rainbow command is only
      able to change colours 0-15. You can, of course load 1,2 or 3 plane
      images and work on those if you so wish.
      This allows you to position text and graphics that might be affected
      by the rainbow command. Eg if you want to have a font "filled" by
      rainbows. For a demo of the command press "i" and load
      "templatedemo.tmp". Then press "l" and load the "tempdemo.rws" -
      this is a screen to designed for colour 1 usage, to see what I mean
      - now press the "A" key.. magic eh?
  I - Kill an IFF Template.
  A - Change affected rainbow-colour to 1-15 instead of background, use with
      iff images. To move through the available colours use "[" and "]".
      Press "A" again after you`ve finished viewing.
  1 - Decrease Red   Colour Value
  2 - Decrease Green Colour Value
  3 - Decrease Blue  Colour Value
  4 - Increase Red   Colour Value
  5 - Increase Green Colour Value
  6 - Increase Blue  Colour Value


                                 SAVE OPTIONS
                                 ------------

  [1] Save AMOS data -  Saves  a  complete  mergeable routine!! Edit the SET
  RAINBOW and RAINBOW commands  to  your  own  purpose,  ie  Which colour is
  affected and where the rainbow is to be positioned.

  [2] Save Seka Data - Saves data compatible with the Seka Assembler.

  [3] Save Devpac Data - Saves data compatible with the Devpac Assembler.

  [4] Save Binary Data - Saves a chunk of code with the values.

  [5] Save Decimal Data - Saves lists of data seperated with commas for use
                          in other applications.

  [6] Save Decimal Data - Saves data in a 'list'.

  [7] Save Hex Data - Saves lists of hex data seperated by commas.

  [8] Save Hex Data - Saves data in a single list.

  [9] Save current screen.

  [0] Save current clip buffer.


                               Notes & Comments
                               ----------------

  As this is the 1st  version,  any  hints,  tips  and  other ideas would be
  welcome for inclusion in any possible upgrades.. send your comments etc to
  me (Spadge) at Po  Box  13,  Ossett,  W.Yorks,  WF5  OXA.  Upgrades for V2
  include a colour spread feature  with  different colour points and fades..
  Your feedback will make or break V2.0!! Also call the Spadge Factory BBS
  0924 265593 after 7pm daily... zany bbs`s rule ok.

  This routine, doc and the other  bits  are  all Tupperware and as such are
  freely distributable... as long as...  1)  This  doc  and the program come
  completely un-altered in anyway shape or  form.  2)  It does not appear on
  any single disk costing £3 or more.

  If you do something that isn't legal  with respect to the copper, you will
  be told so and the program will carry on.. don't panic! - Actually I have
  removed just about all cases where there could be an error so you shouldnt
  get many, if any!

  Anyway, mess around and before  too  long  you'll discover that it's quite
  easy to produce fabulous copper displays in a matter of minutes...

----------------------------------------------------------------------------
  History:
----------------------------------------------------------------------------

  Along time ago in a land, far, far away there lived a.. whoops...

  Version 1.01 Finished and complete. (At least I thought it was) Oct 8/90

  Version 1.01b [Bugs removed] October 9/90.

  No physical differences except for cutting out of outlandish errors that
  were generated by trying to access the copper off the screen (!)
  Next shade bug removed after much head scratching and twitching.
  Expand optimized and error-free. Now works very well. (sort of)

  Version 1.1  One major bug removed (whahhayy!) Colour Back added and also
  the groovy Template option and Affect button. All works fine - Wunderba!

  Well I thought it all worked fine until I spotted a wee nasty in the save
  clip routine but I bashed it`s brains in before it had chance to squeal
  loudly. (November 7th 1990 - by the way I thought I`d better get a move
  on `cos Mandarin had advertised this program!! An old version at that!!
  Ne`er mind...

  Seeya.

  Spadge. Nov 7/90. - do read NEWSFLASH - you don`t know what you`re
  missing! You`ld have had this a LOT earlier too!!!

---------------------------------------------------------------------------
