home *** CD-ROM | disk | FTP | other *** search
/ Fish 'n' More 2 / fishmore-publicdomainlibraryvol.ii1991xetec.iso / fish / fractals / sman / readme < prev    next >
Text File  |  1991-02-02  |  4KB  |  100 lines
  1.  
  2.  
  3.                   SMan (Super Mandelbrot Generator)
  4.                        by David M. McKinstry
  5.                         Copyright 1989-91
  6.  
  7.    The files in this archive have been placed into sub-directories.
  8.    To extract them so that they appear as described below, use the command
  9.  
  10.         'zoo x// SMan.zoo'
  11.  
  12.  
  13.    The following files are present within this archive (i.e. SMan.zoo).
  14.  
  15.       ReadMe (this file)
  16.       SMan.doc      A description of the program operation.
  17.  
  18.       In the directory CP,
  19.  
  20.          SManCP.c     'C' source code for SManCP
  21.          MandCP.asm   Assembly source code for SManCP
  22.          Ln.ManCP     Compiling/assembly/linking information
  23.          SManCP       Executable file that works only with 68020/30
  24.                       and 68881/82 combination
  25.  
  26.       In the directory Lib,
  27.  
  28.          SManLb.c     'C' source code for SManLb
  29.          MandLb.asm   Assembly source code for SManLb
  30.          Ln.ManLb     Compiling/assembly/linking information
  31.          SManLb       Executable file that works with any Amiga.
  32.          Ln.ManLbCP   Compiling/assembly/linking information for SManLbCP
  33.          SManLbCP     Executable file that works only with 68020/30
  34.                       and 68881/82 combination
  35.    
  36.    The above are provided for your pleasure and information only.
  37.  
  38.    Sources and executables for two versions are included, but are
  39.    copyrighted.  You may consider the material freely distributable, but
  40.    only in its complete form.  Basically, this means that I don't intend
  41.    to make any money off this program in the immediate future (but retain
  42.    all rights to do so), but don't expect anyone else to do so either.
  43.    If you want to pass these on to a friend, it's easiest to just pass
  44.    on the archived file 'SMan.zoo'.
  45.  
  46.    Of course, I would expect distribution at cost only, such as done by
  47.    Fred Fish, to be appropriate.
  48.  
  49.    I've called this program Super because it is in double precision and
  50.    permits magnifications of up to 10 to the 16th in the case of the
  51.    SManLb version and 10 to the 19th for the SManCP version.
  52.  
  53.  
  54.  
  55.    For those not having at least a 68020 and 68881 in their Amiga, it
  56.    will have to be considered super slow.  SManLb on a straight 68000
  57.    at 7 MHz takes about 45 minutes to run the default magnification of
  58.    160 centered at (0,0) with a resolution of 640 by 200, whereas SManCP
  59.    takes about 65 seconds on a   25 MHz A3000.  SManLbCP takes about 120
  60.    seconds for the same set of parameters on a 25 MHz A3000.
  61.  
  62.    All versions have been compiled and/or assembled using Aztec 5.0d,
  63.    with 5.0d includes and libraries.  Compilation with 5.0a or 5.0b
  64.    includes will give warnings, but should still compile properly.
  65.  
  66.    The differences of the three versions are as follows:
  67.  
  68.    SManCP has all the Mandelbrot calculations done in 68000 assembler
  69.    with the mc68881 flag set, and the pixel setting also done in
  70.    assembler.  The remainder of the program is written in 'C'.
  71.    Compilation/Assembly/Linking is shown in the file Ln.ManCP.  No
  72.    coprossesor flags have been used for compilation and linking.
  73.  
  74.    SManLb is written entirely in 'C', with the execption of the pixel
  75.    setting.  The libraries provide the double precsision mathematics.
  76.    This is the only version that will run on an Amiga without at least
  77.    both a 68020 and math copropcessor.
  78.  
  79.    SManLbCP is just SManLb that has been compiled and linked using the
  80.    flags for the 68020/68881 combination.  The difference is that the
  81.    libraries provide the coprocessor interface.
  82.  
  83.    The interface is identical for both versions, and described in
  84.    SMan.doc.  The version for the straight 68000 Amiga is so slow, that
  85.    I would recommend its use only if you aren't doing anything else
  86.    with your Amiga.  However, all versions provide a means to save the
  87.    image to an ILBM file, so generation for that particular set of
  88.    parameters won't have to be repeated.
  89.  
  90.    Have fun with your Mandelbrot images.
  91.  
  92.  
  93.                              David M. McKinstry
  94.                              M.S. 68
  95.                              Physics Department
  96.                              Eastern Washington University
  97.                              Cheney, WA  99004
  98.                              (509)-359-6958
  99.  
  100.