home *** CD-ROM | disk | FTP | other *** search
/ Fujiology Archive / fujiology_archive_v1_0.iso / !MAGS / !BONUS / COVERDSK / STFORMAT / STF03.ZIP / STF03.MSA / MANDSHOW / README.DOC < prev    next >
Text File  |  1985-11-20  |  9KB  |  226 lines
  1.  
  2.  
  3.                  MANDELSHOW Fractal Graphics Generator V1.1
  4.                  ==========================================
  5.  
  6.  
  7.  Okay, so you've seen the Mandelbrot Set being generated before... but by a
  8. bunch of Transputers ( a dozen 20MHz T800's maybe ) in no time flat. Well
  9. here's the same equation being chewed over by a single 8MHz MC68000.
  10.  It takes less than an hour to render a big, detailed picture - compare this
  11. to a program written in C on an IBM XT compatible, four hours or more with
  12. the same resolution as your ST - but in only four colours.
  13.  
  14.  Fractals are infinitely detailed, wierdly beautiful and addictive. I spent
  15. more time running this program than developing it !
  16.  
  17.  The program is fairly self-explanatory and I recommend that you play with it
  18. a bit before reading the rest of this documentation. Just one thing though,
  19. the STARTPOS.IFF picture is not absolutely necessary but does speed things up
  20. at the start. You can use any fractal image as the Start Position, the one on
  21. disk is the initial picture as generated by the default settings.
  22.  
  23.  Fractal pictures are saved off as IFF pictures, compatible with DEGAS ELITE,
  24. and just about any other graphics utility, so you can use the pictures in any
  25. way you like.
  26.  
  27.  
  28.                              The Menus
  29.                              =========
  30.  
  31. PROJECT
  32. =======
  33.  
  34. Redraw Picture    Draws the picture from scratch. You can break out to the
  35.                   menus by hitting the ESC key. See View Pic.
  36.  
  37. Continue Pic      Okay, you've drawn half a picture and pressed ESC. As long
  38.                   as you haven't changed anything ( except colours ) this
  39.                   command will recommence drawing. ESC aborts.
  40.  
  41. Load Position     You can load in a previously found position and continue
  42.                   exploring... Position files are very short, so you can save
  43.                   off your current location with no worries.
  44.  
  45. Save Position     Type in a file name and away you go ! The file created by
  46.                   this option holds information about the current position
  47.                   and magnification level. It is 20 bytes long.
  48.  
  49. Load Picture      Loads in an IFF picture that was saved by MandelShow. It
  50.                   contains position data ( as in a Position file ) so that
  51.                   you can quickly carry on from where you left off. Pics
  52.                   take much more room than Position files but are the only
  53.                   way to export your work.
  54.  
  55. Save Picture      Saves a compressed IFF picture with additional position
  56.                   information ( in a FRAC chunk ).
  57.                   If your picture has a different centre to your current
  58.                   position then you will be warned to Redraw. Click on "Okay"
  59.                   to abort or "Save it" to save the picture anyway, with the
  60.                   wrong position information in it.
  61.  
  62. About             The sign-on message window. Read it, press RETURN or click
  63.                   on the close-box to exit, then view the menu options.
  64.  
  65. Quit              The exit.  It double checks;- "Yes" to quit, "No" to stay.
  66.                   Your desktop colour scheme will be restored when you exit.
  67.  
  68.  
  69. VIEW
  70. ====
  71.  
  72. New Centre        This allows you to click on a point of interest and then
  73.                   zoom in on it. You will see that the pointer changes to a
  74.                   cross-hair cursor. If you decide not to change the centre
  75.                   point, just press ESC to abort. If you do change the centre
  76.                   then this menu item is disabled until you Redraw, because
  77.                   the picture no longer agrees with the position.
  78.  
  79. Big Picture       Sets the picture to its maximum size, the entire screen.
  80.                   This is best when you're fairly sure that the position is
  81.                   worth seeing in detail. Changing picture size temporarily
  82.                   disables New Centre until you Redraw and have a valid pic.
  83.  
  84. Small Picture     Sets the picture to its minimum size, one ninth of the
  85.                   screen. This is great for having a quick look at new
  86.                   positions, nine times faster than the Big Picture view.
  87.  
  88. Detailed Pic      This is the slow, deep setting that brings out lots of
  89.                   minor detail. You will probably want to use this mode with
  90.                   the Big Picture view only for screens to save onto disk.
  91.                   Use with Small Picture view to see extra detail.
  92.  
  93. Fast Picture      This produces a fast, approximate Mandelbrot picture that
  94.                   is great for exploring with. It works best at low levels
  95.                   of magnification.
  96.  
  97. View Picture      Select this to view a full screen in its correct palette -
  98.                   click the left button or press ESC to exit. Note that the
  99.                   palette is modified during menu operations so that the
  100.                   text is always visible.
  101.  
  102. Reset Params      Brings you back to minimum magnification, the standard
  103.                   initial values for position and the standard palette.
  104.  
  105.  
  106.  
  107. MAGNIFY
  108. =======
  109.  
  110. By 2   \
  111. By 4    >-        Zooms you in - starts redrawing immediately.
  112. By 8   /
  113.  
  114. By 1/2 \
  115. By 1/4  >-        Zooms you back out and starts redrawing immediately.
  116. By 1/8 /
  117.  
  118. Maximum           Zooms in as far as possible ... note that the mathematics
  119.                   starts to lose accuracy at the highest levels of
  120.                   magnification, so funny effects can arise - be warned !
  121.  
  122. Minimum           Zooms all the way out. Not terribly useful unless you are
  123.                   completely lost.
  124.  
  125.  
  126. COLOURS           There are six palettes to choose from, each giving a
  127. =======           different "feel" to a picture. You can change the colours
  128.                   of any IFF picture files that you save off using your
  129.                   favourite art package, but you won't be able to load them
  130.                   back in.
  131.  
  132.  
  133.                             Notes
  134.                             =====
  135.  
  136.  I use HiSoft's DEVPAC ( GenST, MonST ) on an old 1040 ST for text work and
  137. a newer 520 ST for testing my code. The MandelShow program was originally
  138. written an an Amiga A1000 ( sorry! ) with HiSoft's GenAm and MonAm.
  139.  This may be one of the few bits of software ever ported from the Amiga
  140. across to the ST ... It always seems to be the other way.
  141.  
  142.  Note that this version of the software runs over 15% faster than on the
  143. Amiga - this due to the ST's processor being faster and the operating system
  144. not getting in the way, like it does on the A500 / A1000.
  145.  
  146.  The code is 100% assembly, no compilers ( yuk ) or other stuff. It's fast,
  147. mean and lean but may have bugs. If you find any, DON'T TELL ME.
  148.  
  149.  The program looks for the initialisation picture/position under the names:-
  150.  
  151.    <current drive>:\STARTPOS.IFF
  152.  
  153.    <current drive>:\MANDSHOW\STARTPOS.IFF
  154.  
  155.    <current-directory>\STARTPOS.IFF
  156.  
  157.    <current-directory>\MANDSHOW\STARTPOS.IFF
  158.  
  159.  By default it's likely to be in one of these, so should cause no problems.
  160.  
  161.  If you change the contents of the file, i.e. save off a different picture,
  162. then that new position will become the default starting place on the Mandel-
  163. brot picture. Very handy for deep delvers.
  164.  
  165.  The total available space for exploration is over a million screens full,
  166. which should keep you occupied for a while.
  167.  
  168.  I use a modified version of this algorithm to calculate the colour value for
  169. each pixel :-
  170.  
  171.  for y=0 to screenheight-1
  172.   q:=y_start+y*stepsize             ;stepsize depends on magnification level
  173.  
  174.  for x=0 to screenwidth-1
  175.   counter=0
  176.   xvar:=0
  177.   yvar:=0
  178.   p:=x_start+x*stepsize             ;x_start & y_start depend on centre point
  179. loop:                               ;just a label
  180.   xtemp:=(xvar^2)-(yvar^2)+p
  181.   yvar:=2*xvar*yvar+q
  182.   xvar:=xtemp
  183.   counter:=counter+1                ;(ie counter++)
  184.   if (xvar^2)+(yvar^2) < trigger    ;exits if we're sure it's interesting
  185.   then
  186.     if counter < maximum_iterations ;exits if it's getting boring
  187.    then
  188.     loop                            ;this is a GOTO ( !!!! )
  189.   else
  190.   setcolour(count&15)               ;don't have to use this colouring rule
  191.   writepixel(x,y)                   ;hit the screen
  192.   next x,y
  193.   end
  194.  
  195.  
  196.  
  197.                           DISCLAIMER
  198.                           ==========
  199.  
  200.  PROGRAM DISCLAIMER: The program is provided "AS IS" without warranty of any
  201. kind, either expressed or implied, including, but not limited to, the implied
  202. warranties of merchantability and fitness for a particular purpose. The
  203. entire risk as to the results and performance of the program is assumed by
  204. the user.
  205.  
  206.  Or, in English, if Atari change the rules  or this little gem of a proglet
  207. gets stroppy with your 8-inch floppy, hard luck.
  208.  
  209.  I have tested this program as well as I am able and believe it to be stable,
  210. but somewhere, someone will crash it. C'est la vie.
  211.  
  212.  
  213.                           CONDITIONS
  214.                           ==========
  215.  
  216.  Feel free to distribute this code on a non-profit basis; the graphics that
  217. you create with it are yours to do with as you will, and none of my business.
  218.  It is important that you should spread this DOC file with the object code,
  219. but the pictures & positions are less important.
  220.  
  221.  Nic/89
  222.  
  223.  
  224.                             > Gaudete! <
  225.  
  226.