home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / alib / d5xx / d566 / apfelkiste.lha / Apfelkiste / Apfelkiste1.3 / Doc / Apfelkiste.english next >
Text File  |  1991-11-21  |  8KB  |  198 lines
  1.    *********************************************************************
  2.    *                                                                   *
  3.    *                         _________________________                 *
  4.    *                        /          ///          / \                *
  5.    *                       +-----------------------+   \               *
  6.    *                        \   |                   \   |              *
  7.    *                         \ /                  ,  \ /               *
  8.    *                          +-OOOOOOOOOOOOOOOOOO----+                *
  9.    *                         /|OOOOO§OOOOOOOOOOOOOO  /|                *
  10.    *                        / OOOOOOOOOOOOOOOOOOOOOO/ |                *
  11.    *                       +-----------------------+  |                *
  12.    *                       |          |o|          |  |                *
  13.    *                       |          |A|          |  |                *
  14.    *                       |          +-+          |  +                *
  15.    *                       |                       | /                 *
  16.    *                       |       APFELKISTE      |/                  *
  17.    *                       +-----------------------+                   *
  18.    *                                                                   *
  19.    *                                                                   *
  20.    *********************************************************************
  21.    *   Author: Michael Böhnisch,                                       *
  22.    *           Löher Str. 2,                                           *
  23.    *           4790 Paderborn (Germany)                                *
  24.    *********************************************************************
  25.    * Requirements: arp.library            Version  39.1 (or later)     *
  26.    *               iff.library              -"-    18.5     -"-        *
  27.    *               color.library            -"-     1.0     -"-        *
  28.    * To re-build the program: Lattice/SAS C 5.10                       *
  29.    *********************************************************************
  30.  
  31. The program is rated PD with the following restriction:
  32.     If  you change the source, please leave my name in it.  I need that
  33.     for my self-confidence.
  34.  
  35. Comments, flames, flattery via E-Mail to:
  36.  
  37.     billy@uni-paderborn.de
  38.  
  39. Please  forgive  me  for  my  awkward  english.  Feel free to correct wrong
  40. spellings or grammatical catastrophes by yourself.
  41.  
  42. *********************************************************************
  43.  
  44.  
  45.                               Documentation:
  46.  
  47. "Apfelkiste"  is  yet-another-mandelbrot  program.   It's  not  as  fast as
  48. MandFXP (about 10% slower, in fact), but DAMNED fast anyway.
  49.  
  50. This version is the last one runnable with KS 1.3.  I have included it only
  51. for  completness.   Please send bug-reports for the 2.0 version only, since
  52. this is the only one I will work on int the future!
  53.  
  54. The  program can be run from Workbench or Shell just as you like.  The only
  55. thing you should look for is the file "Apfel0.IFF".  This should be located
  56. in  the  active directory and is loaded at start-up to get default settings
  57. of   the   graphics.    Later  on  you  can  edit  the  configuration  file
  58. "Apfelkiste.config", where you can choose another name for the picture file
  59. and  change most of the program parameters.  The configuration file will be
  60. searched  in  the  active directory, in DEVS:  and in S:  (this order).  Do
  61. NOT  change  the  order  or general format of "Apfelkiste.config" and don't
  62. insert white spaces, or this will most likely lead to malfunctions.
  63.  
  64. A  little requester appears where you can change the borders of the area to
  65. calculate. You can set these values by mouse as described later.
  66.  
  67. Other  settings  that  can  be  manipulated  here  are the maximal depth of
  68. iteration, a border of divergence, the size of your picture in dots and the
  69. color-resolution counted in bitplanes.
  70.  
  71. The  program  chooses a "best match" of resolution and viewmodes, including
  72. EXTRA_HALFBRITE  with 64 colors in Lo-Res.  You also can calculate pictures
  73. that  are  too  big  to  display  on  a  normal  screen (e.g.  1024x1024, 2
  74. bitplanes).   These  can  be  looked at later with "Mostra" (to be found on
  75. another AmigaLibDisk).
  76.  
  77. This should work with NTSC Amigas, but I was not able to test it.
  78.  
  79. Beyond the text-gadgets you can see a panel with smaller switches:
  80.  
  81. ABOUT
  82.     Tells you who's done it and allows me to send some greetings.
  83.  
  84. FXP
  85.     Start of the generator in high speed mode.  Fasten your seatbelts!
  86.  
  87. FLOAT
  88.     Same as FXP, but using Lattice IEEE Routines instead of mine.  Just
  89.     to show the difference.
  90.  
  91. VIEW
  92.     Make  the  request  window invisible and show the set in it's whole
  93.     beauty.   If  "Colorcycling"  is  turned  on,  there  will  be some
  94.     additional  action  on  the  screen.  [Look deep in my eyes, you're
  95.     feeling sleepy more and more...]
  96.     Return to the requester by pressing the left mouse button.
  97.  
  98. MOUSE
  99.     With  left mouse button held down you can choose a rectangular area
  100.     for magnification. (Zoom in)
  101.  
  102. QUIT
  103.     Just as it says...
  104.  
  105. LOAD
  106.     Load an IFF picture from disk.  At the moment no data referring the
  107.     Mandelbrot set are saved along with pictures.
  108.  
  109. SAVE
  110.     Save  the  newly  calculated  pictures to disk.
  111.  
  112. PRINT
  113.     Dump the picture to the printer.
  114.  
  115. DEFLT
  116.     Restore the default settings.
  117.  
  118. COLOR
  119.     A  color requester is popped up where you can change the palette of
  120.     the screen.
  121.  
  122. MULTITASKING
  123.     Switch it on or off.  Off results in a speed-up of the calculations
  124.     of about 15%, depending how busy your Amiga is with other tasks.
  125.  
  126. COLORCYCLING
  127.     Color animation while VIEWing on or off.
  128.  
  129. ***************************************************************************
  130.  
  131. Warnings  are  given  as  RECOVERY_ALERTS  (red blinking rectangular at the
  132. upper end of your monitor, just like a GURU).
  133.  
  134. These  may  result  in abortion of the program, if the error was too severe
  135. too be corrected. (After freeing all used memory, of course)
  136.  
  137. In detail:
  138.  
  139. Can't open xxxxx.library Vxx.x+
  140.     One  of  the  shared libraries was not available.  Possibly you ran
  141.     out of memory, or you're not up-to-date with your LIBS:  directory.
  142.     Copy  the  missing  library  to your LIBS:  directory and try again
  143.     after rebooting.
  144.  
  145. Can't open screen
  146. Can't open window
  147.     A  screen  or  window  can  not be opened.  You may have run out of
  148.     chip-memory  or  intuition  was  not able to find enough continuous
  149.     memory.   The  program  tries  to  pop  up  the input window on the
  150.     Workbench.
  151.  
  152. No memory for filerequester
  153. Can't open printer port
  154. Can't open IORequest for printer
  155.     The  program  was  not  able  to allocate some internal structures.
  156.     These  errors  should  *NOT* occur!  Nevertheless, if they DO occur
  157.     you  really  should  switch off your computer and reboot.  There is
  158.     probably more than one thing going wrong.
  159.  
  160. IFF file not found
  161.     The  program  tried  to open a file that was not an IFF file or did
  162.     not exist at all.  If this warning comes up just after the start of
  163.     the program, you probably did not copy the file "Apfel0.IFF" to the
  164.     directory  where  you  started "Apfelkiste", or you have edited the
  165.     configuration  file  "Apfelkiste.config"  and  did  a  typo  in the
  166.     default name.
  167.  
  168. Not an IFF/ILBM file
  169.     The  program  tried  to  load  a  file  that  did  not fit into the
  170.     requirements of the standard IFF picture format (ILBM).
  171.  
  172. Scrambled IFF file
  173.     It was tried to load a picture file containing corrupted data.
  174.  
  175. Can't find configuration file
  176.     Apfelkiste  was not able to lock on the configuration file and will
  177.     use builtin default parameters.  "Apfelkiste.config" is searched in
  178.     the  current  directory,  DEVS:   and  S:   (this order).  It is an
  179.     editable  ASCII  file  and is fairly self-documenting.  Adapting it
  180.     you  should  avoid  changing the exact order of the entries and you
  181.     should not insert white spaces or blank lines.
  182.  
  183. ***************************************************************************
  184.  
  185. BUGS
  186.     none.
  187.  
  188. ***************************************************************************
  189.  
  190. SPECIAL FEATURES
  191.  
  192.     - Using  FXP  mode  with  VERY  small  areas  of the plane lead  to
  193.       calculation  errors  because  fixpoint  resolution  is limited to
  194.       2**(-24).   Use  FLOAT  instead  if you insist on going such deep
  195.       into the set.
  196.  
  197. ***************************************************************************
  198.