

                  SMan (Super Mandelbrot Generator)
                       by David M. McKinstry
                        Copyright 1989-91

   The files in this archive have been placed into sub-directories.
   To extract them so that they appear as described below, use the command

        'zoo x// SMan.zoo'


   The following files are present within this archive (i.e. SMan.zoo).

      ReadMe (this file)
      SMan.doc      A description of the program operation.

      In the directory CP,

         SManCP.c     'C' source code for SManCP
         MandCP.asm   Assembly source code for SManCP
         Ln.ManCP     Compiling/assembly/linking information
         SManCP       Executable file that works only with 68020/30
                      and 68881/82 combination

      In the directory Lib,

         SManLb.c     'C' source code for SManLb
         MandLb.asm   Assembly source code for SManLb
         Ln.ManLb     Compiling/assembly/linking information
         SManLb       Executable file that works with any Amiga.
         Ln.ManLbCP   Compiling/assembly/linking information for SManLbCP
         SManLbCP     Executable file that works only with 68020/30
                      and 68881/82 combination
   
   The above are provided for your pleasure and information only.

   Sources and executables for two versions are included, but are
   copyrighted.  You may consider the material freely distributable, but
   only in its complete form.  Basically, this means that I don't intend
   to make any money off this program in the immediate future (but retain
   all rights to do so), but don't expect anyone else to do so either.
   If you want to pass these on to a friend, it's easiest to just pass
   on the archived file 'SMan.zoo'.

   Of course, I would expect distribution at cost only, such as done by
   Fred Fish, to be appropriate.

   I've called this program Super because it is in double precision and
   permits magnifications of up to 10 to the 16th in the case of the
   SManLb version and 10 to the 19th for the SManCP version.



   For those not having at least a 68020 and 68881 in their Amiga, it
   will have to be considered super slow.  SManLb on a straight 68000
   at 7 MHz takes about 45 minutes to run the default magnification of
   160 centered at (0,0) with a resolution of 640 by 200, whereas SManCP
   takes about 65 seconds on a   25 MHz A3000.  SManLbCP takes about 120
   seconds for the same set of parameters on a 25 MHz A3000.

   All versions have been compiled and/or assembled using Aztec 5.0d,
   with 5.0d includes and libraries.  Compilation with 5.0a or 5.0b
   includes will give warnings, but should still compile properly.

   The differences of the three versions are as follows:

   SManCP has all the Mandelbrot calculations done in 68000 assembler
   with the mc68881 flag set, and the pixel setting also done in
   assembler.  The remainder of the program is written in 'C'.
   Compilation/Assembly/Linking is shown in the file Ln.ManCP.  No
   coprossesor flags have been used for compilation and linking.

   SManLb is written entirely in 'C', with the execption of the pixel
   setting.  The libraries provide the double precsision mathematics.
   This is the only version that will run on an Amiga without at least
   both a 68020 and math copropcessor.

   SManLbCP is just SManLb that has been compiled and linked using the
   flags for the 68020/68881 combination.  The difference is that the
   libraries provide the coprocessor interface.

   The interface is identical for both versions, and described in
   SMan.doc.  The version for the straight 68000 Amiga is so slow, that
   I would recommend its use only if you aren't doing anything else
   with your Amiga.  However, all versions provide a means to save the
   image to an ILBM file, so generation for that particular set of
   parameters won't have to be repeated.

   Have fun with your Mandelbrot images.


                             David M. McKinstry
                             M.S. 68
                             Physics Department
                             Eastern Washington University
                             Cheney, WA  99004
                             (509)-359-6958

