home *** CD-ROM | disk | FTP | other *** search
/ Creative Computers / CreativeComputers.iso / shareware / fractals / dem / dem.docs < prev    next >
Text File  |  1994-11-17  |  8KB  |  182 lines
  1.                                     DEM
  2.  
  3.           Mandelbrot generator using the Distance Estimator Method.
  4.  
  5.                          (c) 1989 by Lars R. Clausen
  6.  
  7.  
  8.    Why another MandelBrot program?
  9.  
  10.  
  11.    Why now yet another Mandelbrot generator, you may ask. After all, we have
  12. about a dozen of them, with MandelVroom 2.0 ranking as  the  absolute  best.
  13. But this one is slightly different from all others seen so far in that it is
  14. suitable for making black-and-white pictures that does not end up fluffy and
  15. no way like the color versions.
  16.    The method used for this is one I gleaned from 'The  Science  Of  Fractal
  17. Images',  where  it  was called Distance Estimator Method, or for short DEM.
  18. This works by actually finding the distance to the  MandelBrot  set  itself,
  19. instead  of  just seeing how many iterations are used.  If then you make all
  20. pixels longer than half a pixel away from the MandelBrot set white, and  the
  21. rest  black,  you  will  be  quite  sure  that  you get all those small wiry
  22. branches on the picture, without making the inner parts a big  black  block.
  23. So  you  actually get a nice black-and-white picture, showing most precisely
  24. the MandelBrot set.
  25.    I will not get into theoretics here, those who want it may use the source
  26. code or read the book. Suffice to say that it takes  more  time  than  usual
  27. generators, and a 68881 has a greater effect on it than usual.  For those of
  28. you who do not feel familiar with the MandelBrot set,  I  suggest  that  you
  29. take a look at MandelVroom 2.0 before using this program, as you can get the
  30. look of it there.
  31.  
  32.  
  33.    How do I run it?
  34.  
  35.    There are two versions of this program, one that  uses  68881  processors
  36. directly  (DEMTurbo),  and  one  that  calls  the  MathIEEEDoubTrans.library
  37. (DEMNormal).  The program you can use will hereafter be called DEM,  as  the
  38. only difference is in the speed.
  39.  
  40.    To run this program, you may CD into the directory  and  just  run
  41.  
  42.    DEM
  43.  
  44. from  there, using the DataFile provided. You may also call the program
  45. directly by giving it a lot of arguments, like this:
  46.  
  47.    DEM XMin XMax YMin YMax MaxIt [L|W|H|G|F] SaveFileName
  48.  
  49.    The four coordinates are floating point numbers,  MaxIt  is  an  integer,
  50. maximum  2000,  the  single char is, well, a single char, giving the size of
  51. the picture, and SaveFileName is the name under which the  finished  picture
  52. will be saved. These options will be explained more clearly below.
  53.  
  54.    Workbench  icons  have  been  supplied for both versions, using IconX. It
  55. doesn't do any copying or checking, it just executes it.
  56.  
  57.    An example:
  58.  
  59.    DEM -0.0576 -0.0052 -0.99959 -0.97279 100 F Wriggly.ILBM
  60.  
  61.    If  you  have  made  your own datafile, and not stored it in your current
  62. directory, you may also call DEM thus:
  63.  
  64.    DEM DataFileName
  65.  
  66.    If it can't find that file, it will close  down  and  write  'Can't  open
  67. file'.
  68.  
  69.    Typing:
  70.  
  71.    DEM ?
  72.  
  73. will make DEM display a small usage text and then exit.
  74.  
  75.    To exit DEM, press the closeing gadget in the upper left corner.
  76.  
  77.    I  have  supplied  a  makefile  for  the  program  under Aztec C 3.6. For
  78. Lattice-users, recompiling should not be too difficult, though  I  have  not
  79. tried.
  80.  
  81.  
  82.    How does the datafile work?
  83.  
  84.  
  85.    The  datafile,  normally  called  DEMDataFile,  is a list of areas of the
  86. MandelBrot set that are to be made, how they are to be made, and  what  name
  87. they  shall  get when saved. The data are the same as used as arguments from
  88. the CLI, except that a ; (semicolon) is placed between them.   Each  set  of
  89. data  will  use one line. Spaces may be placed as you want it, except around
  90. the size parameter, which should have none between it  and  the  semicolons.
  91. Also  beware  that  the  SaveFileName  will be everything from the semicolon
  92. after size to end of line, including any spaces. I know this could have been
  93. made better, and if I get the time and energy, I will make a better version,
  94. maybe even with Intuition Interface. But for now, this works.
  95.  
  96.    The point in having a definefile at all  is  that  you  can  make  a  big
  97. definefile, and then go away on your holiday, or just let it work overnight,
  98. and have DEM make a lot of pictures without you intervening.
  99.  
  100.    The first four numbers are simply the coordinates for the  picture.  XMin
  101. and  XMax  will be used to ensure the aspect ratio of the picture, in effect
  102. by changing YMax so that the correct ratio will be  used,  thereby  avoiding
  103. streched  pictures.  This  means  that there is no point in changing YMax to
  104. correct a pictures size.
  105.  
  106.    MaxIt is fairly simple: it will maximum be 2000, and the  larger  it  is,
  107. the  more  time the generating will take, but a large MaxIt will ensure more
  108. details around the actual set, especially when you make  a  picture  with  a
  109. very small area. Look to MandelVroom to see the effects.
  110.  
  111.    The Size parameter can be one of five:
  112.  
  113.    L: LoRes - 320x255 (320x199 for NTSC). Very good for testing areasize.
  114.  
  115.    W: WorkBench  size - 640x255 (640x199 for NTSC).  If you'd like to have a
  116. picture of this kind as a background picture on the WorkBench (using  SimGen
  117. or something like that), this is the way. Because of the great difference in
  118. horizontal  and  vertical resolution, some pixels may disappear, so a better
  119. result would often be gotten by resizing a Full size picture  in  DPaint  or
  120. somesuch.
  121.  
  122.    H:  HiRes  -  640x511  (640x399 for NTSC). Simply fills the screen in the
  123. highest possible resolution.
  124.  
  125.    G: GPrint size - 960x1023 (also that for NTSC). A picture  of  this  size
  126. will  fill  a normal a4 paper when printed out using GPrint in High density,
  127. or one-quarter in Ultra high density.
  128.  
  129.    F: Full size - 1024x1023 (also that for NTSC). This is the biggest BitMap
  130. I have been able to make. It's pretty big, but I'd like one to  fill  an  A4
  131. paper in Ultra density.
  132.  
  133.    The picture, when finished, will be placed in the current directory under
  134. the stated as SaveFileName.
  135.  
  136.    To  abort  a  drawing  ithout exiting the program, press Esc. The picture
  137. will not be saved, and the next one will begin generating.
  138.  
  139.  
  140.    What do I do when another program crashes while DEM runs?
  141.  
  142.  
  143.    As I have been making some  fairly  dangerous  things  while  having  DEM
  144. generating  in  the  background, I found it necessary to make it possible to
  145. save the picture before having finished it. This is done  by  pressing  's',
  146. whereupon the picture will be saved under its name, whether or not that file
  147. already exists.  To make DEM continue generating after a  reboot,  just  try
  148. making  that  picture  again.  It will try to load it, and if it gets it, it
  149. will scan through the picture, resuming one line before  the  first  totally
  150. black  line  it finds, or at line 0 if the first line is black. So, to loose
  151. as little as possible of the CPU time used, you should press 's' just before
  152. making anything big and/or dangerous. Then it will resume where it had  come
  153. to  next  time  it  is  run.  This also gives a method of error recovery, if
  154. anything was damaged by transmission, GURU's or whatever.  Just  remove  the
  155. damaged  lines  all the way over, and DEM will make them OK the next time it
  156. makes that picture.
  157.  
  158.  
  159.    Who may I give this program to?
  160.  
  161.  
  162.    As this program is PD, you may copy it to anyone you  like,  as  long  as
  163. this  document  remains with it, and you don't take more money for it than a
  164. few dollars for disk and time usage.
  165.  
  166.    You may use the source code for your own programs if you want to.  If you
  167. make any changes in it, like bugfixes, improvements or the like, please send
  168. the changed version to me before you distribute it.
  169.  
  170.    I  will, as usual, not take the responsibility for anything this programs
  171. does, be it damage your disks, computer, mental health or anything else.
  172.  
  173.    If you like DEM, please send a note saying thanks, bugreports, ideas, $$$
  174. or whatnot to:
  175.  
  176.                                    Lars R. Clausen
  177.                                    Hougσrdsvej 29
  178.                                    8220 Brabrand
  179.                                    Denmark
  180.  
  181.                                    Fidonet nr: 2:230/22.34
  182.