home *** CD-ROM | disk | FTP | other *** search
/ Crawly Crypt Collection 2 / crawlyvol2.bin / graphics / fractal / fractal.doc next >
Text File  |  1985-11-20  |  7KB  |  155 lines
  1.  
  2.                    MandelZoom 1.0 User's Guide
  3.  
  4.  
  5. This  program  will allow you to plot the Mandelbrot  set  on  any 
  6. Atari ST computer (high resolution monochrome,  medium  resolution 
  7. color,  and  low  resolution  color).   Due to  the  large  memory 
  8. requirements  of  this  program,  you  must  have  TOS  rom  chips 
  9. installed  in your computer.   If you are using a 520ST,  you  may 
  10. have  to remove desk accessories that use large amounts of  memory 
  11. (e.g. ramdisks).
  12.  
  13. For  information about the Mandelbrot set,   see  the   references 
  14. listed later in this document.
  15.  
  16.  
  17.                         Using the Program
  18.  
  19. After  double-clicking fractal.prg,  a menu bar will  appear  with 
  20. four menus,  "desk",  "file", "pixel size", and "command".  
  21.  
  22.  
  23.                           The Desk Menu
  24.  
  25. If you select the desk menu by moving the mouse near it,  you  can 
  26. learn  about  the author of the program by  selecting  the  "About 
  27. MandelZoom 1.0" submenu.   Any desk accessories can be accessed by 
  28. selecting the desk menu.
  29.  
  30.  
  31.                           The File Menu
  32.  
  33. This  menu  has  three  submenus,   "load",  "save",  and  "quit".  
  34. Selecting  the load submenu allows the user to plot a  portion  of 
  35. the Mandelbrot set that has been previously plotted and saved.
  36.  
  37. After  a  portion of the Mandelbrot set has been  plotted  with  a 
  38. pixel size of 1 X 1, it can be saved in a disk file for later use.  
  39. (Pixel sizes are discussed later).  
  40.  
  41. When you save a file,  you will be in a certain resolution.  After 
  42. the file is saved,  it can be loaded only when you are in the same 
  43. resolution that you were in when it was saved.   For  example,  if 
  44. you  save  a plot while in low-resolution mode,  it  can  only  be 
  45. loaded when you are in low-resolution mode.
  46.  
  47. Since  each saved plot has a resolution associated with  it,  save 
  48. all  high resolution files with a type of  .hig  (e.g.  first.hig, 
  49. big.hig).   Save all medium-resolution files with a type of  .med, 
  50. and all low resolution files should have a type of .low.
  51.  
  52. Selecting the quit submenu terminates the program and returns  you 
  53. to the GEM desktop.  Always be sure to save the current plot prior 
  54. to quitting if you want to keep it!
  55.  
  56.  
  57.                        The Pixel Size Menu
  58.  
  59. A pixel ("picture element") is a dot on a computer's screen.  When 
  60. this  program makes a plot,  its pixels can be much larger than  a 
  61. single  dot.   If  you select a pixel size of 16 X  16,  the  dots 
  62. plotted  by  the program will be sixteen pixels wide  and  sixteen 
  63. pixels high.  When such large dots are plotted, the resulting plot 
  64. is very crude,  but is drawn quickly.   Selecting a smaller  pixel 
  65. size (e.g. 1 X 1) will result in better looking pictures, but they 
  66. will be drawn much more slowly.   You  may find it  convenient  to 
  67. first make a plot with large pixels,  and if it looks interesting, 
  68. plot it again with smaller pixels.
  69.  
  70. A  plot  can only be saved as a disk file if it has  been  plotted 
  71. with a  pixel  size of 1 X 1.  If a plot is made with 1 X 1 pixels 
  72. and later plotted with  larger pixels,  it can still be saved.
  73.  
  74.  
  75.                          The Command Menu
  76.  
  77. A  portion of the Mandelbrot set can be plotted by  selecting  the 
  78. plot submenu.   Although plots made with small pixel size may take 
  79. a long time to finish the first time,  once a plot has been  done, 
  80. it can be redrawn very quickly by selecting the plot submenu again 
  81. without first decreasing the pixel size.   If  you got  the   file 
  82. total.hig  with the program,  you can load this file and plot  the 
  83. picture  if  you have a monochrome system.   If you got  the  file 
  84. total.low,  it  can  be loaded and plotted when you  are  in  low-
  85. resolution mode.  If you didn't get these files, you can make them 
  86. yourself.   Just  run MandelZoom,  select a pixel size of 1  X  1, 
  87. select the plot submenu,  and when the plot is complete,  save  it 
  88. in a file.
  89.  
  90. When a plot has been performed,  there may be a portion of it that 
  91. you would like to enlarge.   First select the zoom submenu.   Then 
  92. place the crosshairs at the top lefthand corner of the square that 
  93. you  would like to blow up.   Press the left mouse button  slowly.  
  94. Now repeat this process for the bottom right corner of the square.  
  95. After you have selected the square to enlarge, it will be enclosed 
  96. in dashed lines.   The square enclosed in dashed lines may  differ 
  97. slightly from  what  you  expected  if  your  two  points   really
  98. described a rectangle with unequal sides.
  99.  
  100. Now  that  the square is shown,  after a short pause you  will  be 
  101. asked  if you still want to do the zoom.   If you answer  no,  the 
  102. current plot will be unchanged.   If you answer yes, the zoom will 
  103. start,  and the current plot will be completely lost.  Always save 
  104. the current plot prior to zooming if you want to have it later.
  105.  
  106. If you have decided to go through with the zoom, the chosen square 
  107. will  be plotted,  and its plot will take up the  entire  plotting 
  108. window.
  109.  
  110.  
  111.                    Stopping a Plot Prematurely
  112.  
  113. Often after starting a plot or a zoom, one wants to stop the plot.  
  114. To do this, press and  hold   down the left mouse button.    In a 
  115. little while you  will be asked whether or not you want  to  stop 
  116. the  plot.   If you  decide  to stop the plot and later change  
  117. your  mind,  don't worry,  you can still redo the plot by 
  118. selecting the plot submenu.  If you stopped a plot half way through,  
  119. when you replot  it,  the first half will be drawn very rapidly 
  120. (so stopping a plot  doesn't throw away the results of the plot).
  121.  
  122. The  final submenu of the command menu is print.   Selecting  this 
  123. command  will cause the plotting window to be printed out on  your 
  124. printer.   In  order  to  prevent  the mouse  and  the  menu  from 
  125. appearing in the printout, the plot is first quickly redrawn.
  126.  
  127.  
  128.             More Information about the Mandelbrot Set
  129.  
  130. By all means read A.  K.  Dewdney's Computer Recreations column in 
  131. the August,  1985 Scientific American.  If you are a mathematician 
  132. and can stand Benoit Mandelbrot's egotism,  his "Fractal  Geometry 
  133. of  Nature" is the authoritative work on the subject.   A  program 
  134. similar  to MandelZoom for the Macintosh computer is discussed  in 
  135. the  November,  1986  issue of "Dr.  Dobb's  Journal  of  Software 
  136. Tools".
  137.  
  138.  
  139.                More Information about this Program
  140.  
  141. Queries about MandelZoom should be sent to the following  address.  
  142. Be sure to enclose a stamped, self-addressed envelope.  If you are 
  143. not   in  the  U.S.A.,   please  enclose  the  proper  number   of 
  144. international reply coupons.
  145.  
  146. Eric Bergman-Terrell
  147. Cadenza Software, Ltd.
  148. 1704 Imperial Ridge
  149. Las Cruces, NM  88001
  150.  
  151.  
  152. Enjoy the program!
  153.  
  154.  
  155.