home *** CD-ROM | disk | FTP | other *** search
/ Graphics 16,000 / graphics-16000.iso / amiga / fractal / apfelkis / apfelks3 / doc / apfelkis.grm < prev    next >
Encoding:
Text File  |  1991-11-21  |  7.3 KB  |  170 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:     arp.library          mind. Version 39.1             *
  26.    *               iff.library               -"-      18.5             *
  27.    *               color.library             -"-       1.0             *
  28.    * zum re-compilieren:   Lattice-C5.10                               *
  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  ist  die letzte, die noch unter KS 1.3 lΣuft.  Ich habe sie
  38. nur  der VollstΣndigkeit halber beigelegt.  Also:  BugReports bitte nur zur
  39. 2.0 Version!
  40.  
  41. Das Programm startet von Worbench oder Shell, ganz wie beliebt und lΣd dann
  42. die  Files  "Apfelkiste.config"  und "Apfel0.IFF" nach.  Diesen entnimmt es
  43. die Voreinstellungen fⁿr das ApfelmΣnnchen und die Grafik.
  44.  
  45. "Apfelkiste.config"  ist  ein  editierbares  ASCII  File,  das im aktuellen
  46. Verzeichnis,  in DEVS:  und in S:  gesucht wird (an KiTe:  ist's so recht?)
  47. und  zwar  in  dieser  Reihenfolge.   Die Datei ist ziemlich selbstdokumen-
  48. tierend, die Reihenfolge der EintrΣge sollte nicht geΣndert werden und fⁿgt
  49. bitte keine ▄berflⁿssigen "White Spaces" ein.
  50.  
  51. In  einem  kleinen  Requester  kann man jetzt die Grenzen der zu Rechnenden
  52. FlΣche  auf  der  komplexen  Zahlenebene angeben (ⁿber Maussteuerung spΣter
  53. mehr), die maximale Iterationstiefe, eine Divergenzschranke, die gewⁿnschte
  54. Gr÷▀e und der Grafik in Pixeln und die Farbaufl÷sung in Bitplanes.
  55.  
  56. Das  Programm  wΣhlt  automatisch die gⁿnstigste Grafikaufl÷sung, inclusive
  57. EXTRA_HALFBRITE  mit  64  Farben in der niedrigen Aufl÷sung.  Grafiken, die
  58. nicht  mehr auf den Bildschirm passen, k÷nnen auch berechnet (1024x1024 mit
  59. 2  Bitplanes  ist  kein  Problem)  und  dann spΣter mit "mostra" angeschaut
  60. werden.
  61.  
  62. SelbstverstΣndlich  wird  auch  Overscan  sowohl  auf PAL als auch auf NTSC
  63. Rechnern  unterstⁿtzt (hoffe ich).  Leider hab' ich keinen NTSC Rechner zum
  64. probieren.   Bis zu 736x564 sind mit entsprechend eingestelltem Monitor und
  65. Preferences machbar.  Ich empfehle PPrefs von Jonathan Potter (auf Fish).
  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  Lattice IEEE,  statt  meiner
  78.     Festpunkt-Arithmetik.  Nur zum Vergleich.
  79.  
  80. VIEW
  81.     Stellt  den  Requester  ab  und  zeigt  den  Apfel in seiner ganzen
  82.     Pracht.  Ist "Colorcycling" angeschaltet bewegt sich auch noch was.
  83.     [Schau  mir  tief in meine Augen, deine Glieder werden schwerer und
  84.     schwerer...].
  85.     Zurⁿck zum Requester mit Mausklick.
  86.  
  87. MOUSE
  88.     Mit der linken Maustaste kann man ein Gummiband-Rechteck aufziehen,
  89.     mit dem eine Ausschnittsvergr÷▀erung gewΣhlt werden kann. 
  90.  
  91. LOAD
  92.     LΣd  ein  IFF-Bild ein, leider (noch?) keine Mandelbrot-Daten.  Zum
  93.     Anschauen und (falls Daten bekannt) zum Reinzoomen.
  94.  
  95. SAVE
  96.     Abspeichern des fertigen Bildes.
  97.  
  98. PRINT
  99.     Ausgabe des aktuellen Bildes auf Drucker.
  100.  
  101. DEFLT
  102.     Stellt  Ausgangswerte  wieder ein.
  103.  
  104. COLOR
  105.     Ruft einen Farbrequester auf, mit dem man die Palette des Bildes
  106.     Σndern kann (aus color.library).
  107.  
  108. QUIT
  109.     Ende. Aus. Fini.
  110.  
  111.  
  112. Fehlermeldungen (roter Balken am oberen Bildschirmende):
  113. =======================================================
  114.  
  115. No memory for filerequester
  116. Can't open printer port
  117. Can't open IORequest for printer
  118.     Programm  konnte  einige  Strukturen fⁿr den Filerequester oder den
  119.     Drucker nicht bereitstellen (Das ist ernst!  Mit deinem Rechner ist
  120.     einiges durcheinander, am besten ausschalten, neu booten!)
  121.  
  122. IFF file not found
  123.     Es wurde versucht eine Datei zu ÷ffnen, die es entweder nicht gibt,
  124.     oder  nicht  dem IFF Standard entspricht.  Falls dieser Fehler beim
  125.     Start  des  Programms  auftritt,  wurde  vermutlich die Datei nicht
  126.     gefunden,  deren  Name ganz oben in "Apfelkiste.config" eingetragen
  127.     ist.  Voreingestellt ist hier "Apfel0.IFF".
  128.  
  129. Not an IFF/ILBM file
  130.     Es  wurde  versucht eine Datei zu ÷ffnen, die kein ILBM (interlaced
  131.     bitmap) Bild ist.
  132.  
  133. Scrambled IFF file
  134.     Es  wurde  versucht eine Bild zu laden, dessen Bilddaten sich nicht
  135.     auspacken  lassen.   Dies  k÷nnte  durch einen Fehler beim kopieren
  136.     entstehen.
  137.  
  138. Can't find configuration file
  139.     Die  Datei  mit  den Voreinstellungen konnte nicht gefunden werden.
  140.     Das  Program  verwendet dann eingebaute Einstellungen.  Diese Datei
  141.     ist  ein  editierbares ASCII File, das im aktuellen Verzeichnis, in
  142.     DEVS:  und in S:  gesucht wird (an KiTe:  ist's so recht?) und zwar
  143.     in   dieser   Reihenfolge.   Die  Datei  ist  ziemlich  selbstdoku-
  144.     mentierend,  die  Reihenfolge  der  EintrΣge  sollte nicht geΣndert
  145.     werden und fⁿgt bitte keine ▄berflⁿssigen "White Spaces" ein.
  146.  
  147. ***************************************************************************
  148.  
  149. Fehler im Programmcode:
  150.  
  151.     keine.
  152.  
  153. ***************************************************************************
  154.  
  155. Special Features:
  156.  
  157.     - Sehr starke Vergr÷▀erungen bekommen Rundungsfehler, da Aufl÷sung
  158.       der Fixpunkt-Arithmetik auf 2^-24 begrenzt
  159.  
  160. ***************************************************************************
  161. Das  Programm  gebe  ich  in die PD, macht damit was ihr wollt, solange ihr
  162. meinen  Namen  im  Programm  und  diese  Dokumentation  unverΣndert  lasst.
  163. ─nderungswⁿnsche,  VorschlΣge, Kritik (konstruktiv!!!), Kommentare an meine
  164. EMail-Adresse in der Uni:
  165.  
  166.                              billy@uni-paderborn.de
  167.  
  168. Oder zur Diskussion in unserem Mail-Verteiler.
  169. ***************************************************************************
  170.