home *** CD-ROM | disk | FTP | other *** search
/ Graphics 16,000 / graphics-16000.iso / amiga / fractal / apfelkis / apfelks0 / doc / apfelkis.grm < prev    next >
Encoding:
Text File  |  1991-11-21  |  7.5 KB  |  173 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.    *   Autor:  Michael B÷hnisch,                                       *
  22.    *           L÷her Str. 2,                                           *
  23.    *           4790 Paderborn                                          *
  24.    *********************************************************************
  25.    * Ben÷tigt:     iff.library          mind. Version 18.5             *
  26.    *               color.library             -"-       1.0             *
  27.    *               Kickstart                 -"-      37.175           *
  28.    * zum re-compilieren:   Lattice-C5.10b                              *
  29.    *********************************************************************
  30.  
  31.                             Zur Dokumentation:
  32.  
  33. Apfelkiste  ist  (noch ein) Programm zu Berechnung der Mandelbrotmenge.  Es
  34. ist nicht ganz so schnell wie MandFXP (ca.  10% langsamer), aber immer noch
  35. VERDAMMT schnell.
  36.  
  37. Diese Version ben÷tigt KS 2.0 (mindestens 37.175).
  38.  
  39. Das Programm startet von Worbench oder Shell, ganz wie beliebt und lΣd dann
  40. die  Files  "Apfelkiste.config"  und "Apfel0.IFF" nach.  Diesen entnimmt es
  41. die Voreinstellungen fⁿr das ApfelmΣnnchen und die Grafik.
  42.  
  43. "Apfelkiste.config"  ist  ein  editierbares  ASCII  File,  das im aktuellen
  44. Verzeichnis,  in DEVS:  und in S:  gesucht wird (an KiTe:  ist's so recht?)
  45. und  zwar  in  dieser  Reihenfolge.   Die Datei ist ziemlich selbstdokumen-
  46. tierend, die Reihenfolge der EintrΣge sollte nicht geΣndert werden und fⁿgt
  47. bitte keine ▄berflⁿssigen "White Spaces" ein.
  48.  
  49. In  einem  kleinen  Requester  kann man jetzt die Grenzen der zu Rechnenden
  50. FlΣche  auf  der  komplexen  Zahlenebene angeben (ⁿber Maussteuerung spΣter
  51. mehr), die maximale Iterationstiefe, eine Divergenzschranke, die gewⁿnschte
  52. Gr÷▀e und der Grafik in Pixeln und die Farbaufl÷sung in Bitplanes.
  53.  
  54. Das  Programm  wΣhlt  automatisch die gⁿnstigste Grafikaufl÷sung, inclusive
  55. EXTRA_HALFBRITE  mit  64  Farben in der niedrigen Aufl÷sung.  Grafiken, die
  56. nicht  mehr auf den Bildschirm passen, k÷nnen auch berechnet (1024x1024 mit
  57. 2  Bitplanes  ist  kein  Problem)  und  dann spΣter mit "mostra" angeschaut
  58. werden.   Ab  Version  28  habe ich das "Autoscrolling" der neuen intuition
  59. Bibliothek   eingebaut.    Im   "VIEW"  -  Modus  und  bei  eingeschaltetem
  60. Multitasking wΣhrend des Zeichnens kann man mit der Maus auf dem Bildschirm
  61. herumscrollen.
  62.  
  63. SelbstverstΣndlich  wird  auch  Overscan  sowohl  auf PAL als auch auf NTSC
  64. Rechnern  unterstⁿtzt (hoffe ich).  Leider hab' ich keinen NTSC Rechner zum
  65. probieren.
  66.  
  67. Unter den String-Gadgets befindet sich eine Leiste mit kleineren Schaltern:
  68.  
  69. ABOUT
  70.     Autorenvermerk + Grⁿ▀e.
  71.  
  72. FXP
  73.     Startet   die   Apfelpresse  im  Wahnsinnige-Geschwindigkeit-Modus.
  74.     Anschnallen und das Rauchen einstellen!
  75.  
  76. FLOAT
  77.     Der gleiche Algorithmus, aber mit Flie▀komma Routinen, statt meiner
  78.     Festpunkt-Arithmetik.   Nur zum Vergleich und falls Berechnungen in
  79.     hoher  Genauigkeit  und starken Vergr÷sserungen durchgefⁿhrt werden
  80.     sollen.
  81.  
  82. VIEW
  83.     Stellt  den  Requester  ab  und  zeigt  den  Apfel in seiner ganzen
  84.     Pracht.  Ist "Colorcycling" angeschaltet bewegt sich auch noch was.
  85.     [Schau  mir  tief in meine Augen, deine Glieder werden schwerer und
  86.     schwerer...  Du fⁿhlst den Zawng, dem Autor des Programms eine '040
  87.     Karte zu schenken...].  Zurⁿck zum Requester mit Mausklick.
  88.  
  89. MOUSE
  90.     Mit der linken Maustaste kann man ein Gummiband-Rechteck aufziehen,
  91.     mit dem eine Ausschnittsvergr÷▀erung gewΣhlt werden kann. 
  92.  
  93. LOAD
  94.     LΣd  ein  IFF-Bild ein, leider (noch?) keine Mandelbrot-Daten.  Zum
  95.     Anschauen und (falls Daten bekannt) zum Reinzoomen.
  96.  
  97. SAVE
  98.     Abspeichern des fertigen Bildes.
  99.  
  100. PRINT
  101.     Ausgabe des aktuellen Bildes auf Drucker.
  102.  
  103. DEFLT
  104.     Stellt  Ausgangswerte  wieder ein.
  105.  
  106. COLOR
  107.     Ruft einen Farbrequester auf, mit dem man die Palette des Bildes
  108.     Σndern kann (aus color.library).
  109.  
  110. QUIT
  111.     Ende. Aus. Fini.
  112.  
  113.  
  114. Fehlermeldungen (roter Balken am oberen Bildschirmende):
  115. =======================================================
  116.  
  117. No memory for filerequester
  118. Can't open printer port
  119. Can't open IORequest for printer
  120.     Programm  konnte  einige  Strukturen fⁿr den Filerequester oder den
  121.     Drucker nicht bereitstellen (Das ist ernst!  Mit deinem Rechner ist
  122.     einiges durcheinander, am besten ausschalten, neu booten!)
  123.  
  124. IFF file not found
  125.     Es wurde versucht eine Datei zu ÷ffnen, die es entweder nicht gibt,
  126.     oder  nicht  dem IFF Standard entspricht.  Falls dieser Fehler beim
  127.     Start  des  Programms  auftritt,  wurde  vermutlich die Datei nicht
  128.     gefunden,  deren  Name ganz oben in "Apfelkiste.config" eingetragen
  129.     ist.  Voreingestellt ist hier "Apfel0.IFF".
  130.  
  131. Not an IFF/ILBM file
  132.     Es  wurde  versucht eine Datei zu ÷ffnen, die kein ILBM (interlaced
  133.     bitmap) Bild ist.
  134.  
  135. Scrambled IFF file
  136.     Es  wurde  versucht eine Bild zu laden, dessen Bilddaten sich nicht
  137.     auspacken  lassen.   Dies  k÷nnte  durch einen Fehler beim kopieren
  138.     entstehen.
  139.  
  140. Can't find configuration file
  141.     Die  Datei  mit  den Voreinstellungen konnte nicht gefunden werden.
  142.     Das  Program  verwendet dann eingebaute Einstellungen.  Diese Datei
  143.     ist  ein  editierbares ASCII File, das im aktuellen Verzeichnis, in
  144.     DEVS:  und in S:  gesucht wird (an KiTe:  ist's so recht?) und zwar
  145.     in   dieser   Reihenfolge.   Die  Datei  ist  ziemlich  selbstdoku-
  146.     mentierend,  die  Reihenfolge  der  EintrΣge  sollte nicht geΣndert
  147.     werden und fⁿgt bitte keine ▄berflⁿssigen "White Spaces" ein.
  148.  
  149. ***************************************************************************
  150.  
  151. Fehler im Programmcode:
  152.  
  153.     keine.
  154.  
  155. ***************************************************************************
  156.  
  157. Special Features:
  158.  
  159.     -  Sehr starke Vergr÷▀erungen bekommen Rundungsfehler, da Aufl÷sung
  160.        der   Fixpunkt-Arithmetik  auf  2^-24  begrenzt;  Abhilfe  durch
  161.        Verwendung der (langsameren) Festpunkt Routinen mit "FLOAT".
  162.  
  163. ***************************************************************************
  164. Das  Programm  gebe  ich  in die PD, macht damit was ihr wollt, solange ihr
  165. meinen  Namen  im  Programm  und  diese  Dokumentation  unverΣndert  lasst.
  166. ─nderungswⁿnsche,  VorschlΣge, Kritik (konstruktiv!!!), Kommentare an meine
  167. EMail-Adresse in der Uni:
  168.  
  169.                              billy@uni-paderborn.de
  170.  
  171. Oder zur Diskussion in unserem Mail-Verteiler.
  172. ***************************************************************************
  173.