home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: Science / Science.zip / MANDL.ZIP / MAND1PM.DOC next >
Text File  |  1989-07-31  |  5KB  |  127 lines
  1.          MAND1PM  - Display Mandelbrot Set under OS/2 PM
  2.          Version 0.02a - July 28th 1989
  3.          Author:  Edward Lee Swarthout    SWARTHOU at PKSMRVM
  4.  
  5. --------------------------------------------
  6. Changes to 0.02a version:  July 27th, 1989
  7.  
  8. First OS2TOOLS release.
  9.  
  10. a.  Added an option (Ctrl+O) to draw an "enlargment-outline" of
  11.     the current image on other windows (created in same session).
  12.  
  13. b.  Added a re-paint command (Ctrl+R)
  14.  
  15. --------------------------------------------
  16. Changes to 0.01c version:  July 20th, 1989
  17.  
  18. a.  Fixed end-of-row alignment to match IMGSUPP's.
  19.  
  20.     Use MANDCONV to read and save any 0.01a bitmaps which appear scrambled with
  21.     the new version.  MANDCONV available by request.
  22.  
  23. b.  Added a Stay-Behind-All-Window feature which keeps MAND1PM in the background.
  24.     Select from Options menu. A single mouse click on image will
  25.     restore normal window behavior.  Since this option is currently implemented
  26.     by capturing paint requests, only one window in the system can use it.
  27.     PMLOGO uses this same method, so DO NOT select this option while running it!
  28.  
  29. c.  Added a Option which displays the value of 'c' at a given point.
  30.     Select "Single Click to Show Point" under options then Click the mouse at
  31.     desired point.  Any window refresh will remove coordinates.
  32.  
  33. --------------------------------------------
  34.  
  35. Original alpha-test version 0.01a - July 14th 1989
  36.  
  37. --------------------------------------------
  38.  
  39. Displays the Mandelbrot Set under OS/2 PM windows with user controlled
  40. multiple zoom windows at various resolutions.  Computation is done in
  41. the background so normal user activity can continue.
  42.  
  43. Since OS/2 PM only supports 16 colors in VGA mode the 8514/A in BGA
  44. mode is strongly recommended as is a 80387/80287 math co-processor.
  45. Computation is 20 times slower without it!
  46.  
  47. Installation:
  48.  
  49. 1.  For I/O file specification, I use Juerg von Kaenel's FILEDLG PACKAGE
  50.     so you must put FILEDLG.DLL in your LIBPATH.  My libpath has a ".;"
  51.     so I keep FILEDLG.DLL in the same subdir as MAND1PM.EXE.
  52.  
  53. 2.  syntax:    Start MAND1PM <filename>
  54.  
  55.     Where filename is an optional first BMP to display.
  56.     If not specified, MAND1PM.BMP will be displayed.
  57.     If it is not found, a new image will be built at Box-Low resolution.
  58.  
  59.     Note: If you are using VGA mode, you might want to copy MAND350.BMP
  60.     as MAND1PM.BMP to get a better screen fit...
  61.  
  62. Operation:
  63.  
  64.   1. Set the number of pixels to calculate using the Resolution Menu:
  65.  
  66.            Box Low - up to    4900 calculations
  67.            Low     -        30,276
  68.            Medium  -       122,500
  69.            High    -       490,000
  70.            Extra High -    810,000
  71.  
  72.   2. Use mouse to outline area to zoom into:
  73.            a.  move mouse to lower left corner & double click
  74.            b.  drag top right corner and release
  75.  
  76.   3. Use Show Parameters under Options (Ctrl-P) to display image details
  77.  
  78.  
  79. Future direction:
  80.  
  81.   1. Move the computation off the main OS/2 processor.
  82.      The program is designed to allow other sources for the computation.
  83.  
  84.      I only have a DFT card to VM, so I suppose my only vehicle is SRPI.
  85.      If anyone has any other ideas send me a note.  (I really would like
  86.      to try Sun's RPC for this...)
  87.  
  88.   2. Allow more than one palette for zooms.  Currently the palette is
  89.      loaded from the 1st BMP file or the DISPLAY.DLL if no BMP file.
  90.  
  91.   3. Do something with dialogs to enter coordinates.
  92.  
  93.   4. Apply some rendering techniques.
  94.  
  95.   5. Allow user created iteration equations.
  96.      Maybe via someone else's parser?
  97.  
  98.   6. Allow saving partially created images to be completed later.
  99.  
  100.  
  101. OS/2 PM Restrictions:
  102.  
  103.   1. Currently only a predefined 256 colors are available in BGA mode
  104.      (16 in VGA)
  105.  
  106.   2. The Zoom-in mouse rectangle can only be size from one corner.  I
  107.      randomly picked the top-right corner...
  108.  
  109.   3. The are no system compression routines for the BMP files.
  110.      PCTERSE takes the 493,000 FULL700.BMP down to 39,500 bytes!
  111.  
  112.  
  113. Acknowledgements/Thanks:
  114.  
  115. * Steve Hetzler and his MAND8 DOS program for demonstrating
  116.   the beauty of a 256 color high resolution Mandelbrot-Set image.
  117.  
  118. * Peitgen, H.-O. and Richter, P.H.: The Beauty of Fractals.
  119.   Source for the algorithm used in MAND1PM and good reading for
  120.   a layman.
  121.  
  122. * Keith Bernstein's (THABOSS at BETVTVM1) BITMAP Package which
  123.   provided a road map into OS/2's bitmap functions.
  124.  
  125. * Juerg von Kaenel's (JVK at ZURLVM1) FILEDLG PACKAGE
  126.  
  127.