home *** CD-ROM | disk | FTP | other *** search
/ 17 Bit Software 2: Collection B / 17Bit_Collection_B.iso / files / 2021.dms / in.adf / Sieve / Sieve.Doc < prev    next >
Encoding:
Text File  |  1992-06-07  |  7.7 KB  |  224 lines
  1.  
  2.                             Sieve V1.0
  3.  
  4.                       (c) 1991 Richard Kelly
  5.  
  6.  
  7.  
  8. BACKGROUND
  9.  
  10. The idea for this program came from the Scientific American but I don't
  11. remember which issue that was.  It generates pictures using simple rules.
  12. The program allows you to change the colour palette easily.  It has several 
  13. inbuilt palettes and you can easily modify the one that is displayed to 
  14. produce smooth or striped palettes.  The pictures that the program generates 
  15. look quite different with different palettes so its worth experimenting with 
  16. the various options in the "Colours Menu".
  17.  
  18.  
  19.  
  20. THE PICTURE RULES
  21.  
  22. The basic idea is to colour each x,y point depending upon the value of
  23. some 2 variable function F(x,y).  The colour index number is the remainder
  24. of F(x,y) when divided by the maximum number of colours.  In other words
  25.  
  26.         Colour index of point (x,y) = F(x,y) MOD number_of_colours
  27.  
  28. The resulting pictures can be very surprising.  It is reasonable to expect
  29. contours of colours giving banding effects.  You see this for some formulae 
  30. but the formula    2       2    gives some very interesting patterns.
  31.                   X   +   Y
  32.  
  33. The program has several inbuilt formulae (see the "Formulae" Menu).  There is
  34. a scaling factor used in generating the pictures.  The scaling factor is used
  35. to translate the screen co-ordinates to the x,y values used in the function.
  36. The co-ordinates of the point (x,y) within the picture box are multiplied by
  37. the scaling factor before being used in the formula.  With different values of
  38. the scaling factor You can get some quite different pictures for the same 
  39. formulae.
  40.  
  41.  
  42.  
  43. USING THE PROGRAM
  44.  
  45. When the program is loaded you will recognise the following different areas
  46. in the display:-
  47.  
  48.     a)    A 10 item menu at the top right
  49.  
  50.     b)    3 slider bars just under the menu
  51.  
  52.     c)    A palette strip along the middle
  53.  
  54.     d)    3 picture boxes at the bottom
  55.  
  56. One picture box has a thick frame - this is the currently selected box.
  57. Operations which effect a picture box will operate on the current box.
  58.  
  59. Initially the picture boxes are empty and each has a two line header above
  60. it.  This shows the formula that will next be used for the picture and the 
  61. scaling factor that will be applied in generating the picture from the 
  62. formula.
  63.  
  64.  
  65.  
  66. Using Menus
  67.  
  68. Selection from the menu options can be made by clicking the mouse (either 
  69. button) or by the Amiga keyboard function keys as shown below.
  70.  
  71.                 ________________________________________________________
  72.                 |          |          |          |          |          |
  73.                 |    F1    |    F2    |    F3    |    F4    |    F5    |
  74.                 |__________|__________|__________|__________|__________|
  75.                 |          |          |          |          |          |
  76.                 |    F6    |    F7    |    F8    |    F9    |    F10   |
  77.                 |__________|__________|__________|__________|__________|
  78.  
  79.  
  80. There are four different menus:-  The "Main" menu, the "Formulae" menu, the 
  81. "Colours" menu and the "Palettes" menu.  Each menu has selections which will
  82. take you to another menu; for example F10 in all except the "Main" menu will
  83. take you back to the main menu.
  84.  
  85. There is a shortcut method to get at each menu selection without heving to
  86. navigate through the menu selections:-
  87.  
  88.     The Cltr key gives the "Palettes" menu
  89.     The Shift key gives the "Colours" menu
  90.     The left Alt key gives the "Formulae" menu
  91.     The right Alt key gives the "Main" menu
  92.  
  93.  
  94.  
  95. Using the colour sliders
  96.  
  97. Each individual colour can be set to any value using the Red / Green / Blue
  98. sliders.  Click on the colour you wish to change in the palette strip and its 
  99. current RGB values will be shown on the sliders.  Click to the new values or 
  100. hold the mouse button down and slide to the new values.
  101.  
  102. The currently selected colour is indicated by a coloured block underneath it. 
  103. The left and right arrows on the Amiga keyboard can be used instead of the 
  104. mouse to select the colour from the palette strip.
  105.  
  106.  
  107.  
  108. Selecting the picture box
  109.  
  110. Some of the options apply to the currently selected picture box.  The selected
  111. picture box has a thick border.  The box may be selected by either clicking
  112. inside the box or by use of the keys "1", "2" and "3" on the keyboard.
  113.  
  114.  
  115.  
  116. THE MAIN MENU (right Alt)
  117.  
  118. F1    Plot / Pause / Resume - Picture generation control
  119. F2    About
  120. F3    Formulae Menu - Select new formula
  121. F4    Factors - Select scaling factor
  122. F5    Clear - Clear picture box
  123. F6    Load - Load previously saved pictures from disk
  124. F7    Save - Save current pictures to disk
  125. F8    Colours Menu - Play around with the colours
  126. F9    Cycle / Stop Cycle - Colour cycling
  127. F10    Quit
  128.  
  129. Notes
  130.  
  131. F1 displays "Plot" if no picture is being generated.  When "Plot" is selected
  132. a new picture will be generated in the currently selected box.  The menu
  133. option then changes to "Pause n" (where n is the box number).  When "Pause n"
  134. is selected the generation will be suspended and the option will change to
  135. "Resume n".  Selecting "Resume n" will resume the generation of the picture
  136. in box "n" (the one seleceted when the plot started) even though a different 
  137. box may be currently slected.  When the picture generation is complete the 
  138. menu option will return to "Plot".
  139.  
  140. When the plot is started the current formula and scaling factor will be 
  141. displayed underneath the box (but not for NTSC verion - Soory).  This will 
  142. show the values used for the completed picture.  When the formula (F3) or 
  143. scaling factor (F4) are changed (before generating a new picture) these will 
  144. be shown above the box.  When the values are different then the values below 
  145. the box apply to the displayed picture and the values above will be those 
  146. used if "Plot" is selected.
  147.  
  148. F3, F4 and F5 will apply to the currently selected box.
  149.  
  150. When colour cycling is taking place (F9) it can be speeded up and slowed down
  151. by the up and down arrows on the Amiga keyboard.  The down arrow key will 
  152. change the cycle direction when the speed is minimum.
  153.  
  154.  
  155.  
  156. FORMULAE MENU (left Alt)
  157.  
  158. F1-F9    - Choose a new formula for the selected box.
  159. F10    Main Menu
  160.  
  161.  
  162.  
  163. COLOURS MENU (Shift)
  164.  
  165. F1    Swap - Swap two colours
  166. F2    Copy - Copy one colour value to another
  167. F3    Reverse - Reverse the colours in a specified range
  168. F4    Alternate - Alternate the colours in a specified range
  169. F5    Spread - Change the colours in the range to form a gradual spread
  170.         from the first colour to the last
  171. F6    Repeat - Repeat the selected colour range through the whole palette
  172. F7    Palettes Menu - Select built-in palettes
  173. F8    Reverse All - Reverse the whole palette
  174. F9    Altern All - Alternate all the colours in the palette
  175. F10    Main Menu
  176.  
  177. Notes
  178.  
  179. F1 to F6 require a second colour to be selected.  The mouse pointer will 
  180. change to cross-wires and a second colour must be selected by clicking with
  181. the mouse before you can continue.
  182.  
  183.  
  184.  
  185. PALETTES MENU (Ctrl)
  186.  
  187. F1-F3 and F6-F8 :- Select a built-in Palette
  188. F4    Store - Stores the current palette for later restore (F9)
  189. F9    Restore - Restore the last stored (F4) palette
  190. F5    Colours Menu
  191. F10    Main Menu
  192.  
  193.  
  194.  
  195. CREDITS and COPYRIGHT
  196.  
  197. Written in AMOS Basic - AMOS (c) 1990 Mandarin/Jawx
  198.  
  199. by Richard Kelly - 17 Birch Grove, Windsor, Berks, ENGLAND
  200.  
  201. This program remains the copyright of Richard Kelly but may be freely copied
  202. and distributed subject to these conditions:-
  203.  
  204.     1)    All three files Sieve.Doc, Sieve.IFF and Sieve 
  205.         must be supplied unmodified.
  206.  
  207.     2)    No charge may be made other than nominal charges to cover 
  208.                 costs of copying and distribution.
  209.  
  210. The spirit is that it is Public Domain and profit making from its copying
  211. or distribution is not allowed.
  212.  
  213. The program was developed and tested on the following configuration:-
  214.     A500
  215.     1/2Mb expansion RAM
  216.     GVP A500-HD+ with 2Mb RAM
  217.     Workbench Version 1.3.2
  218.     AMOS Version 1.3
  219.     PAL monitor
  220.  
  221. Bug reports and suggestions for changes are welcomed. 
  222.  
  223. Enjoy using the program.
  224.