home *** CD-ROM | disk | FTP | other *** search
/ No Fragments Archive 10: Diskmags / nf_archive_10.iso / MAGS / MUCH / MSG01.MSA / ARTICLES_COOKER.DOC < prev    next >
Text File  |  1993-07-23  |  4KB  |  125 lines
  1.                       COLOUR COOKER - Raster creator
  2.                      --------------------------------
  3.  
  4. This utility was written with STOS Basic. There are two versions of it,
  5. the GEM-runnable version, and the ACB version to be run from STOS as an
  6. accessory. Although it was  written  in  STOS,  Colour Cooker outputs a
  7. binary file which can be used by anybody in any language (therefore the
  8. PRG version).
  9.  
  10.  
  11. What's the point?
  12. -----------------
  13.  
  14. If you are a demo coder  who  codes  demos regularly, you may find that
  15. programming the  data  for  the  rasters  (of  whatever)  to  be rather
  16. monotonous. This utility creates  a  list  of  colours  for  you to use
  17. easily and quickly. If you are not  a  demo coder, you may just like to
  18. look at the pretty colours!
  19.  
  20.  
  21. General specifications
  22. ----------------------
  23.  
  24. 9 different methods/types of colour creation.
  25. Maximum of 30000 colours.
  26. 5 different colour view modes.
  27.  
  28.  
  29. Main menu
  30. ---------
  31.  
  32. Here, you have 7 options:
  33.  
  34. VIEW CURRENT COLOURS - Flicks to the VIEW COLOURS sub-menu where you
  35.                        can see what the created colours are like.
  36. CLEAR COLOURS - Clears the memory ready for the next set of colour
  37.                 data.
  38. SAVE CURRENT COLOURS - Saves the data in memory as a binary file.
  39.                        (see "Format of Output file" later on)
  40. RANDOMIZE NEW DATA - You select the method of creation, and the
  41.                      computer creates the new data.
  42. OPTIONS - You can set various parameters here.
  43. HELP! - Displays the various types of colour creation.
  44. QUIT - Exits the program, either back to STOS, or the Desktop.
  45.  
  46.  
  47. View colours
  48. ------------
  49.  
  50. There are six options here.
  51.  
  52. TEXT LIST - Prints out the hexadecimal values of the colour data.
  53. FLASH/GLOW - Glows the screen with the colour. Press Space to glow a
  54.              bar, and then to glow some text.
  55. STATIC RASTER - You select the height of each raster bar (1-16). The
  56.                 program then displays the first few colours (depending
  57.                 upon raster size) as a static raster.
  58. FLOWING RASTER - You again select the raster height. Every colour now
  59.                  flows up the screen, and loops when it reaches the
  60.                  end.
  61. STROBE - This displays two strobes with the colours flowing along them.
  62. QUIT - Returns to the main menu.
  63.  
  64.  
  65. Options
  66. -------
  67.  
  68. NUMBER OF COLOURS?  (5 - 30000) If mirror colours is on, the program
  69. generates 7 less colours (see next)
  70. MIRROR COLOURS? (Y/N) If this is  off,  you  get an ugly overlap of the
  71. first and last colours  in  the  rasters.  This  option  fades the last
  72. colour back to the first colour within the last 7 colour datas.
  73. INITIAL VALUES? (0-7) You set the starting RGB values of the colours.
  74. ALLOW FOR PAUSES? (Y/N) If on,  this  allows for random 'pauses' in the
  75. colour data. Maybe looks OK, maybe not (probably not, but never mind)
  76. LENGTH OF PAUSE? (1->) Sets the maximum pause length (if pause is on)
  77. TRACE METHOD? (O/A/V/R)  When  the  program  has  to  trace between two
  78. colours (eg red to blue.) It  can  do  it  by using three methods. One,
  79. All, or Variable.
  80.  
  81. ONE only traces one colour at a time. (eg. red [7-0], THEN blue [0-7])
  82. ALL traces all colours at the same time (eg. red [7-0] AND blue [0-7])
  83. VARIABLE traces either or all of the necessary colours
  84.         (eg. red-1, red-1, blue+1, red-1, blue+1, blue+1, blue+1...etc)
  85. R means RANDOM and chooses one of the above three.
  86.  
  87.  
  88. Format of Output file
  89. ---------------------
  90.  
  91. The length of each data file is twice the maximum number of colours, so
  92. if you wanted 500 colours, the file would be 1000 bytes long.
  93. From the very start of the file, each colour exists as a word:
  94.  
  95. OFFSET FROM START   LENGTH   DATA
  96.        0              2      $000
  97.        2              2      $110
  98.        4              2      $220
  99.        6              2      $330
  100.        8              2      $440
  101.        .              .        .
  102.        .              .        .
  103.        .              .        .
  104.  
  105.  
  106.  
  107. Credits
  108. -------
  109.  
  110. All code, ideas, etc...      BLACK EAGLE
  111. Music...                     MAD MAX
  112. Additional code...           TOP NOTCH SOFTWARE
  113.  
  114.  
  115. End
  116. ---
  117.  
  118. I hope that you find this program  useful,  and that it saves you a lot
  119. of typing $...$...$...$...$...$...$...$...$...$...$...$...$...$...$...$
  120. ....$...$.......!
  121.  
  122. Make no errors...
  123. BLACK EAGLE
  124. -----------
  125.