home *** CD-ROM | disk | FTP | other *** search
/ Vectronix 2 / VECTRONIX2.iso / FILES_07 / FRACTENG.LZH / DOCUMENT.FE2 / QUICKREF.TXT < prev   
Text File  |  1996-04-28  |  10KB  |  192 lines
  1.  
  2. The Fractal Engine v2 for the Atari ST family by Dan Grace
  3.  
  4. Reference Guide and Quick-Start Tutorial by Mike Harris
  5.  
  6. (c) gh Fractals July 1993
  7.  
  8. ------------------------------------------------------------------------------
  9.  
  10. Reference Guide. 
  11. ---------------
  12.  
  13. The Fractal Engine is run by double clicking on the item FRACENG2.PRG from the
  14. GEM desktop.  Once the application has loaded, you are presented with the main
  15. screen.  This is known as the main menu and is the root from which all
  16. operations available are selected and performed.  The main menu screen has three
  17. main regions:
  18.  
  19. Top window - displays the title and any other relevant information. 
  20.  
  21. Menu window - this contains the current menu in operation. 
  22.  
  23.     julia    - select new parameters for drawing Julia sets. 
  24.     zoom     - magnify the current image, if it exists. 
  25.     draw     - transforms the current co-ordinates into an image. 
  26.     methods  - select a different drawing method for current fractal type
  27.          - go to methods menu options. 
  28.     edit cd  - edit the current co-ordinates (parameters). 
  29.     copy cd  - transforms the current image into textural co-ordinates. 
  30.     load cd  - load co-ordinates from file into parameters window. 
  31.     save cd  - store co-ordinates in parameters window to file. 
  32.     load pic - load image and co-ordinates from file. 
  33.     save pic - save image and co-ordinates to file. 
  34.     storepic - store the current image in memory. 
  35.     restore  - recall a previously stored image from memory. 
  36.     batch    - menu of operations for multiple drawing of images
  37.          - go to batch menu options. 
  38.     view     - view the current image. 
  39.     types      - select a new fractal type with default co-ordinates
  40.          - go to types menu options. 
  41.     palettes - palette operations to change image colours
  42.          - go to palettes menu options. 
  43.     save pal - saves all palette data to disk. 
  44.     quit      - why would you want to do that?
  45.  
  46. Parameters window - displays the current co-ordinates which will take effect
  47. next time draw is selected. 
  48.  
  49.  
  50. Methods menu - displays the drawing methods available to the current fractal
  51. type.  This is dependant on the fractal type selected.  The methods are as
  52. follows for the complex fractals types:
  53.  
  54.     normal      - fast two-dimensional image of fractal. 
  55.     LEM      - slower than normal but with more control over image. 
  56.     sphere      - a three-dimensional sphere with your fractal on the surface. 
  57.     scape      - a three-dimensional landscape of your fractal. 
  58.     sml nrml - quarter-size image using normal method. 
  59.     sml LEM  - quarter-size image using normal method. 
  60.  
  61. Types menu - displays the different fractal types available, as follows:
  62.  
  63.     quad      - quadratic complex fractal type - the beetle. 
  64.     conj      - conjugate of quadratic complex fractal. 
  65.     cub1      - complex fractal of standard cubic equation. 
  66.     cub2      - our very own cubic complex fractal. 
  67.     spid      - complex fractal which looks like a spider!
  68.     fish      - complex fractal which looks like a jellyfish!
  69.     cosn      - complex fractal using the cosine function. 
  70.     sine      - complex fractal using the sine function. 
  71.     newt      - quadratic complex fractal using Newton's method. 
  72.     barn      - one of Michael Barnsley's complex alternatives. 
  73.     deg4      - complex fractal based on model of magnetism. 
  74.     popcorn  - strange attractors looking like popcorn, wood or your skin!
  75.     p-dla    - diffusion limited aggregation grows your own plants!
  76.     l-dla      - looks a bit like chromatography (?)
  77.     clouds      - random fractal plasma clouds or sky for mountains. 
  78.     mntns      - random fractal mountains with sea!
  79.     choose      - select new fractal type and return to main menu. 
  80.     exit      - return to main menu without selecting new type. 
  81.  
  82.  
  83. Palettes menu - allows you to select between different palettes and modes,
  84. rotate the current palette or choose to edit the palette. 
  85.  
  86.     pal   - / pal + - decrement and increment the current palette number. 
  87.     mode  - / mode + - decrement and increment the current mode number. 
  88.     swirl - rotate the current colour palette. 
  89.     hide  - hide the palette menu to view the screen beneath. 
  90.     edit  - edit the current palette - go to edit palette menu. 
  91.     exit  - return to the main menu. 
  92.  
  93.  
  94. Edit Palette menu - allows you to edit the amount of red, green and blue for
  95. each colour of the current palette. 
  96.  
  97.     red - / red +      - adjusts the amount of red in the current colour. 
  98.     green - / green +  - adjusts the amount of green in the current colour. 
  99.     blue - / blue +    - adjusts the amount of blue in the current colour. 
  100.     colour             - selects a new current colour with mouse. 
  101.     exit               - back to the palette menu for you, sonny. 
  102.  
  103.  
  104. Batch menu - operations for drawing loads of images all at once.  As a folder of
  105. separate images, an animation sequence or a poster to liven up your drab
  106. surroundings. 
  107.  
  108.     zoomanim - zoom animation of complex fractals. 
  109.     jul anim - Julia set animation of complex fractals. 
  110.     convert - convert a folder of co-ordinate files into images. 
  111.     poster - produce a poster to disk or printer from any image or file. 
  112.     exit - return to main menu. 
  113.  
  114. -----------------------------------------------------------------------------
  115.  
  116. Quick-start Tutorial - Julia sets, zooming and 3D Landscapes.
  117. -------------------- 
  118.  
  119. Let's try searching for a Julia set and producing a three-dimensional landscape:
  120.  
  121. 1.  First of all, we need select a fractal type to draw images from.  For this
  122. example we shall use the quadratic (quad) complex fractal type.  This is the
  123. default type selected when you first run the program.  If you've been playing
  124. around a bit and this is no longer the current type then click on the types
  125. button from the main menu, then quad and choose buttons from the types menu. 
  126. You are now back at the main menu. 
  127.  
  128. 2.  Click on the methods button and select sml nrml for the quarter-size screen
  129. basic drawing method. 
  130.  
  131. 3.  Next click on draw.  FE2 draws a quarter-size picture of the quadratic
  132. Mandelbrot set and returns you to the main menu.  You can use view to see it
  133. again.  Now what we need to do is select a decent Julia set for our landscape. 
  134. As the Mandelbrot set represents a directory of all our possible Julia set
  135. images, choosing a set from the screen visually makes the task easier. 
  136.  
  137. 4.  Before we do this, let's zoom-in on the Mandelbrot set so that we can be
  138. more accurate about choosing our Julia set co-ordinates.  Click on the zoom
  139. option and you are flipped to the Mandelbrot set image and the zoom-box is
  140. displayed.  This can be manipulated by pressing the left mouse button to make it
  141. smaller and the right button to make it larger; Moving the mouse around
  142. correspondingly moves the zoom-box around.  Let's put the zoom-box over the
  143. second-largest disk of the Mandelbrot set (the black bit).  Once your happy with
  144. this, press the spacebar which selects the new window size and click on draw. 
  145. Once again your image is drawn. 
  146.  
  147. (A good point to note at this juncture is if your picture looks a little
  148. bit blocky around the edges of the black, you may be running out iterations. 
  149. This is indicated by the outside colours looking rather like blobby fingers and
  150. can be remedied by increasing the iterations value.  Use edit cd and press the
  151. return key until you are at the iters field.  The default value is thirty, so
  152. try something like fifty.  If you zoom in even further, a value of eighty or
  153. even a hundred may be needed - best experimenting.)
  154.  
  155. 5.  One last thing to do before we start drawing a Julia set: Click on 
  156. storepic.  This saves your Mandelbrot zoom in memory so that if you make a 
  157. mistake or are unhappy with your Julia set, you can recall it and try again. 
  158.     
  159. 6.  Click on julia, you are asked whether you want to enter the Julia set
  160. parameters from keyboard or visually.  Click on visually and your Mandelbrot
  161. zoom appears and you can move the mouse pointer around the screen.  You select a
  162. Julia set by clicking the left mouse button.  Go for one somewhere in the set or
  163. close to the boundary (between the black and colour bands outside).  Once you
  164. have selected a Julia set, click on draw and a quarter-size image appears. 
  165.  
  166. If you don't like the look of it, click on restore to bring back the
  167. Mandelbrot set image saved in memory and do step 6 again until you are happy. 
  168.  
  169. 7.  Right, at last we can go for a 3-D landscape of our Julia set: Click on
  170. methods and select scape.  Back to the main menu, click on draw.  You will be
  171. asked whether you wish to overlay over an existing screen, select no.  The 3-D
  172. scape will take longer to draw as the mathematics involved in ray-tracing and
  173. rendering landscapes is a lot more complicated and they're always full-sized
  174. pictures.  Remember that all good things come in time, so be patient! 8.  Your
  175. finished Julia set! At this point, I would save the image to disk by clicking on
  176. save pic.  When asked which file format to save the image in, choose .FE2; this
  177. will allow to picture to be re-loaded at a later date.  FE2 will suggest a file
  178. name for you; FRAC_000.FUL, for example.  If this is a little anonymous for your
  179. tastes, enter one of your own.  Once saved, it can be loaded back in with load
  180. pic. 
  181.  
  182. Remember, you still have your Mandelbrot zoom saved in memory and it
  183. stays there until you overwrite it with another storepic or you quit from FE2. 
  184.  
  185. Try experimenting with Julia sets from different regions to get a feel of their
  186. relationships with Mandelbrot sets. 
  187.  
  188. This may seem a little complicated, but it's not and you'll soon get used to 
  189. it.  We've covered a lot in this example so it's a good idea to follow it 
  190. several times to get a clear picture of what exactly is going on in all the
  191. chaos!
  192.