home *** CD-ROM | disk | FTP | other *** search
/ AMOS PD CD / amospdcd.iso / 076-100 / apd077 / rwarriordoc.asc < prev    next >
Text File  |  1990-09-24  |  11KB  |  229 lines
  1.   ==========================================================================
  2.  
  3.                      Rainbow Warrior ! - Amos Rainbow Kit
  4.  
  5.                  Written and Produced by Spadge The Unwilling
  6.  
  7.                       Exclusive for Newsflash Issue 15!
  8.  
  9.                     Version 1.1a.09373785748578 Wibbly Woo
  10.  
  11.   ==========================================================================
  12.  
  13.          This program is dedicated to Daisy - Francois Lionet`s dog.
  14.          It was inspired by several Pink Floyd album covers and by
  15.          the remarkable music of Bjorn Lynne - freak out to space
  16.          Deleria.. far out.. way out.. I`m out..
  17.  
  18.   =========================================================================
  19.  
  20.   NOTE TO EVERYONE!! Please ONLY distribute the VERY LATEST version of this
  21.   program or I`ll go all miserable, I don`t want early poxy versions flying
  22.   around! If unsure please call me - or write and I`ll send a new version,
  23.   the latest version was edited and fixed on Nov 7th 1990. Version 1.1
  24.  
  25.  
  26.                                  Foreword.
  27.  
  28.  
  29.   Amos, as most of the people who own  it will know, lays claim to providing
  30.   the opportunity to use 4096 colour  Copper-Bars and copper-routines in the
  31.   form of the Rainbow command. So far so  wonderful but quite a lot of users
  32.   will have found out that actually forming the data for the rainbows can be
  33.   long winded and confusing... not any more... Rainbow Warrior is here!
  34.  
  35.   RW gives you the opportunity to  "paint" with the copper/rainbows and save
  36.   them out for direct inclusion  in  your  own  programs, indeed the program
  37.   outputs ascii blocks so that they can  be merged directly! Of course RW is
  38.   itself written in AMOS so users can  adapt,  mix and merge their own stuff
  39.   in there too..
  40.  
  41.   Apart from Amos  though,  the  program  outputs  data  for K-Seka, Devpac,
  42.   Binary, Decimal, Hex and it's own formats.. so it can be used for whatever
  43.   evil and sickly reason you may deem fit.
  44.  
  45.   It offers an easy way  to  create  "copper  bars" - those metallic looking
  46.   bars seen in many a demo... there's magnify, cut&paste, extend and fill..
  47.   what more could an Amos user ever dream of? :-)
  48.  
  49.  
  50.                            What you need to run RW
  51.                            -----------------------
  52.  
  53.                                      Amos
  54.                       An Amiga (I guess you're ok there)
  55.                                  Some fingers
  56.                                   A monitor
  57.                                 A disk or two
  58.                        A brain functioning on low-power
  59.          A bottle of Newky Brown to celebrate the Rainbow revolution
  60.  
  61.  
  62.                               First Things First
  63.                               ------------------
  64.  
  65.                               Turn your Amiga on
  66.  
  67.  
  68.                               Running Rwarrior
  69.                               ----------------
  70.  
  71.   Just load it up into AMOS and  hit  run... soon you'll be greeted with the
  72.   obligatory credits bit  and  Newsflash  promo..  just  hit  the mouse butt
  73.   a couple of times and you're in. You'll see a  menu  at the top and a
  74.   square in the centre of the screen, denoting current colour. Hang on, no
  75.   you won`t because I`ve changed the program since and now the current
  76.   colour sits on the menu thingy-wotsit. Anyway it looks better there.
  77.  
  78.   The menu can be moved using the  cursor-keys,  so  you can shift it out of
  79.   the way when you're painting in different  areas of the screen. The square
  80.   is the currently selected colour which  will  be  used when you paint, you
  81.   paint with the left mouse button and remove with the right.
  82.  
  83.  
  84.                         Rwarrior Commands and Features
  85.                         ------------------------------
  86.  
  87.   Although the menu  shows  most  of  the  commands,  some  are available by
  88.   pressing shift instead and  the  key,  giving  a totally different result.
  89.   Here's a full run down on what you can do, and how...
  90.  
  91.   X - This one exits, Don't bother pressing it just now!
  92.   ? - This one pops the credits and Newsflash info on again, in case you
  93.       missed it the first time around. (Can't blame me for that)
  94.   c - Pressing c alone will clear the current screen to all-black.
  95.   C - Shift-C will clear the screen and fill it with the current colour
  96.       shown by the box in the middle. It also sets the new background colour
  97.       and delete will have the effect of painting in this colour.
  98.   n - This key automatically moves the cursor down and selects the next
  99.       darker shade. This way it is VERY easy to produce copper-fades to
  100.       black. Just select your colour, either a random one, a popular one or
  101.       make your own up and keep pressing N (or hold it down). You`ll soon
  102.       have half a bar.. just use M to Mirror it and hey presto.. Bar Magic!
  103.   N - This does the same as above but moves the cursor upwards.
  104.   G - Grab the current colour and store it.
  105.   R - Recall a colour grabbed with "G"
  106.   D - Select the next shade in the range. (Also "-")
  107.   B - Select the next brighter shade in the range. (Also "+")
  108.   * - Random Colour Select. (use to grab a random colour)
  109.   / - Go through popular colour list.
  110.   M - Mirror a section of the screen. (Use with "n" to create "bars")
  111.   k - Copies a section of the screen into the paste buffer.
  112.   K - Shift-K will cut the section completely and put it in the paste buffer
  113.   P - Pastes the current contents of the paste buffer onto the screen at the
  114.       current cursor location.
  115.   F - Fill a region of the screen in the current colour.
  116.   U - Undo. Retreive a screen saved with "Z".
  117.   Z - Copy the current screen into ram. Retrieve with "U". (Like Undo)
  118.   H - Grab the colour under the cursor.
  119.   E - Expand. Easy way to create large copper displays, eg Sea types with
  120.       gaps of colour. Create a blue-black fade with "N" at the top of the
  121.       screen and use extend to stretch it all down the screen. It's usual
  122.       to use extend from the top of the screen, but not necessary.
  123.   S - Save Options (See Later)
  124.   l - Load a previously created RWarrior screen (*.RWS) Just load in some
  125.       of those trendy demo screens and drop that jaw, well be a bit giddy!
  126.   L - Load a previously created RWarrior Buffer (*.BUF)
  127.   i - Load an IFF Image onto the screen. This let`s you load a 4-plane
  128.       lo-res iff picture onto the screen, as the rainbow command is only
  129.       able to change colours 0-15. You can, of course load 1,2 or 3 plane
  130.       images and work on those if you so wish.
  131.       This allows you to position text and graphics that might be affected
  132.       by the rainbow command. Eg if you want to have a font "filled" by
  133.       rainbows. For a demo of the command press "i" and load
  134.       "templatedemo.tmp". Then press "l" and load the "tempdemo.rws" -
  135.       this is a screen to designed for colour 1 usage, to see what I mean
  136.       - now press the "A" key.. magic eh?
  137.   I - Kill an IFF Template.
  138.   A - Change affected rainbow-colour to 1-15 instead of background, use with
  139.       iff images. To move through the available colours use "[" and "]".
  140.       Press "A" again after you`ve finished viewing.
  141.   1 - Decrease Red   Colour Value
  142.   2 - Decrease Green Colour Value
  143.   3 - Decrease Blue  Colour Value
  144.   4 - Increase Red   Colour Value
  145.   5 - Increase Green Colour Value
  146.   6 - Increase Blue  Colour Value
  147.  
  148.  
  149.                                  SAVE OPTIONS
  150.                                  ------------
  151.  
  152.   [1] Save AMOS data -  Saves  a  complete  mergeable routine!! Edit the SET
  153.   RAINBOW and RAINBOW commands  to  your  own  purpose,  ie  Which colour is
  154.   affected and where the rainbow is to be positioned.
  155.  
  156.   [2] Save Seka Data - Saves data compatible with the Seka Assembler.
  157.  
  158.   [3] Save Devpac Data - Saves data compatible with the Devpac Assembler.
  159.  
  160.   [4] Save Binary Data - Saves a chunk of code with the values.
  161.  
  162.   [5] Save Decimal Data - Saves lists of data seperated with commas for use
  163.                           in other applications.
  164.  
  165.   [6] Save Decimal Data - Saves data in a 'list'.
  166.  
  167.   [7] Save Hex Data - Saves lists of hex data seperated by commas.
  168.  
  169.   [8] Save Hex Data - Saves data in a single list.
  170.  
  171.   [9] Save current screen.
  172.  
  173.   [0] Save current clip buffer.
  174.  
  175.  
  176.                                Notes & Comments
  177.                                ----------------
  178.  
  179.   As this is the 1st  version,  any  hints,  tips  and  other ideas would be
  180.   welcome for inclusion in any possible upgrades.. send your comments etc to
  181.   me (Spadge) at Po  Box  13,  Ossett,  W.Yorks,  WF5  OXA.  Upgrades for V2
  182.   include a colour spread feature  with  different colour points and fades..
  183.   Your feedback will make or break V2.0!! Also call the Spadge Factory BBS
  184.   0924 265593 after 7pm daily... zany bbs`s rule ok.
  185.  
  186.   This routine, doc and the other  bits  are  all Tupperware and as such are
  187.   freely distributable... as long as...  1)  This  doc  and the program come
  188.   completely un-altered in anyway shape or  form.  2)  It does not appear on
  189.   any single disk costing £3 or more.
  190.  
  191.   If you do something that isn't legal  with respect to the copper, you will
  192.   be told so and the program will carry on.. don't panic! - Actually I have
  193.   removed just about all cases where there could be an error so you shouldnt
  194.   get many, if any!
  195.  
  196.   Anyway, mess around and before  too  long  you'll discover that it's quite
  197.   easy to produce fabulous copper displays in a matter of minutes...
  198.  
  199. ----------------------------------------------------------------------------
  200.   History:
  201. ----------------------------------------------------------------------------
  202.  
  203.   Along time ago in a land, far, far away there lived a.. whoops...
  204.  
  205.   Version 1.01 Finished and complete. (At least I thought it was) Oct 8/90
  206.  
  207.   Version 1.01b [Bugs removed] October 9/90.
  208.  
  209.   No physical differences except for cutting out of outlandish errors that
  210.   were generated by trying to access the copper off the screen (!)
  211.   Next shade bug removed after much head scratching and twitching.
  212.   Expand optimized and error-free. Now works very well. (sort of)
  213.  
  214.   Version 1.1  One major bug removed (whahhayy!) Colour Back added and also
  215.   the groovy Template option and Affect button. All works fine - Wunderba!
  216.  
  217.   Well I thought it all worked fine until I spotted a wee nasty in the save
  218.   clip routine but I bashed it`s brains in before it had chance to squeal
  219.   loudly. (November 7th 1990 - by the way I thought I`d better get a move
  220.   on `cos Mandarin had advertised this program!! An old version at that!!
  221.   Ne`er mind...
  222.  
  223.   Seeya.
  224.  
  225.   Spadge. Nov 7/90. - do read NEWSFLASH - you don`t know what you`re
  226.   missing! You`ld have had this a LOT earlier too!!!
  227.  
  228. ---------------------------------------------------------------------------
  229.