
 p                  ANOTHER CHAOS-PLOTTER Version 6/91                     q
 p             Ein Public Domain-Programm von  post_industrial             q

 Letzte nderung: 29.5.91

                             Dokumentation
----------------------------------------------------------------------------

1. Allgemeines

 1.1. Das Prinzip
 1.2. Merkmale des Programms
 1.3. Files

2. Bedienung

 2.1. Die Bedienungsleiste

  2.1.1. Der p post_industrial q-Button
  2.1.2. Der Parameter-Button
  2.1.3. Der Graphikmodus-Button
  2.1.4. Der Invert-Button
  2.1.5. Der Start-Button
  2.1.6. Der Save-Button
  2.1.7. Der Exit-Button

3. Rechtliches

4. Nachtrag
   
----------------------------------------------------------------------------

1. Allgemeines zu p ANOTHER CHAOS... q

   Programm fr die hohe Auflsung zur Bildschirmdarstellung von mathe-
   matischen Iterationen nach Barry Martin (Universitt Birmingham). Je
   nach Parametern entstehen zell-, pflanzen- oder tierhnliche Graphiken,
   netz- oder wabenhnliche Strukturen oder geometrische Muster.
   
 1.1. Das Prinzip:
   
      Auf das Ergebnis einer bestimmten Funktion wird dieselbe Funktion wieder
      angewandt ("Rckkopplung" mit Wiederholungen = Iteration). In der Regel
      konvergieren die Ergebnisse gegen 0 oder Unendlich, bei manchen Funktionen
      jedoch schwanken sie zwischen mehreren Punkten hin und her und ergeben
      eigenartige Graphiken. Ein solches Verfahren wird etwa auch zur Erzeugung
      von Apfelmnnchen angewandt.
   
 1.2. Merkmale:
   
      - Graphische Benutzeroberflche
      - Steuerung mit der Maus
      - 3 Darstellungsarten ("Querschnitt", entlang der x-, entlang der 
        y-Achse)
      - Speichern der Bilder (Screen-Format) und der Parameter
      - Freie Parameter-Eingabe
      - Inverse Darstellung
   
 1.3. Auf der Diskette sollten sich folgende Files befinden:
   
      ANOTHER.PRG...............das ausfhrbare Programm (Version 6/91)
      ANOTHER.TXT...............Dokumentation
      ANOTHER.DAT...............Datei fr die graphischen Bedienungselemente
      DEMO.PIC..................Demobild im Screen-Format
      ANOTHER.BSP\*.LST.........Ordner mit Beispielparameterdateien (ASCII)

      Zum Programmablauf unbedingt bentigt werden nur das Programm selbst
      und ANOTHER.DAT.
      
      Die Version 6/91:
   
      Im Unterschied zur Vorgngerversion (Version 0, erste Verffentlichung)
      ist die Berechnung und Darstellung um ein vielfaches schneller, be-
      sonders bei Integer-Zahlen.
      Einige kleinere Bugs wurden beseitigt. Die Eingabebox fr die Parameter
      funktioniert nun einwandfrei.
      Alle Bildausgaberoutinen wurden neu geschrieben.
      Das Programm sollte nun theoretisch unter allen TOS-Versionen und auch
      auf den neuen Atari-Rechnern laufen. Mangels Hardware waren aber keine
      Tests mglich. Schreiben Sie bitte Ihre Erfahrungen an
      
                          p post_industrial q
                     
                          Postfach 98
                          A-1071  WIEN

   Die Parameter, die mit der alten Version erstellt und gespeichert wurden,
   knnen mit dieser Version problemlos geladen werden (und umgekehrt).
   Die Speicher- und Laderoutinen wurden nicht verndert.
   Allerdings entstehen etwas andere Bilder, die aber nicht weniger schn
   und interessant sind. Diese Einschrnkung mute zugunsten der Geschwindig-
   keitssteigerung in Kauf genommen werden.
    
2. Bedienung und Funktionen von p ANOTHER CHAOS... q:

   Grundstzlich erfolgt die Steuerung, auer die Eingabe von Rechengren
   und File-Namen, durch die Maus. Die Funktionen knnen mit der linken
   Taste aufgerufen und mit der rechten verlassen werden, auer es gibt
   einen OK-Button.
   
 2.1. Die Bedienungsleiste am rechten Bildschirmrand:
 
      Nach den Laden des Programms erscheint ein Test-Bild und am rechten
      Bildschirmrand die Bedienungsleiste mit den Buttons.
      
  2.1.1. Der p post_industrial q-Button: 
  
         Nach dem Anklicken mit der linken Maustaste erscheint eine Info-
         box, in der die Funktionen der Buttons kurz beschrieben werden.
         Durch Klicken mit der rechten Taste verschwindet sie wieder.
         
  2.1.2. Der Parameter-Button [?]:
  
         Nach dem Anklicken mit der linken Maustaste erscheint eine Ein-
         gabe-Box, wo die Rechenparameter eingegeben, geladen, gespeichert
         oder mittels RANDOM zufllig bestimmt werden knnen. Die Eingabe
         erfolgt, wie vom GEM gewohnt: <Esc> lscht die Zeile, <Backspace>
         die Ziffer vor dem Cursor, <Delete> die Ziffer nach dem Cursor, der
         mit dem Mauspfeil positioniert werden kann. Mit <Return> oder
         <Enter> (nach jeder Eingabe oder nderung !) werden die Parameter
         "abgeschickt".
    
         Die Parameter im Einzelnen (i: Integerzahl, f: Fliekommazahl):
         
         Anzahl:   Anzahl der Wiederholungen (i)
         x-Offset: Abstand des Mittelpunkts des zu zeichnenden Objekts
                   vom Koordinatenursprung (in der linken oberen Bild-
                   schirmecke) nach rechts in Pixel (i)
         y-Offset: Abstand nach unten (i)
         I,J,K:    Operatoren der Rechenfunktion (f)
         Faktor:   Vergrerungs- bzw. Verkleinerungsfaktor (f). Sollten
                   bei bestimmten Parametern nur vereinzelt Punkte am Schirm
                   erscheinen, knnen Sie damit das Objekt verkleinern.     
         x:        Startwert x der Iteration (Default 0, f)
         y:        Startwert y der Iteration (Default 0, f)

         Anmerkung: Bei manueller Eingabe der Rechengren wird nicht ge-
                    prft, ob die Zahlen Nachkommastellen haben oder nicht.
                    Das ist aber nicht weiter problematisch. Bei Integer-
                    Gren wird eben nur der Wert vor dem Punkt verarbeitet.
                    Sonstige Fehleingaben, etwa Buchstaben, werden abge-
                    fangen.
                    Schon eine nderung in den letzen Nachkommastellen kann
                    zu einer vllig neuen Graphik fhren !
                        
  2.1.3. Der Graphik-Modus-Button [1-2-3]:
  
         Durch Anklicken mit der linken Maustaste auf 1, 2 oder 3 wird
         die Darstellungsart der Graphik ausgewhlt. Die schnsten Bilder
         erhlt man mit <1>.

         1: Darstellung im "Querschnitt"
         2:    -"-      entlang der x-Achse (rechts beginnend)
         3:    -"-      entlang der y-Achse (oben beginnend)

         Beispiel: Parameter "ROUND", inverse Darstellung, Modus 2

  2.1.4. Der Invert-Button:
  
         Anklicken mit der linken Maustaste invertiert den Bildschirm.
         
  2.1.5. Der Start-Button:
  
         Startet den Graphikplot mit den eingegebenen, geladenen oder
         zufllig ermittelten Rechengren.
         Abbruch mit der rechten Maustaste. Durch erneutes Anklicken des
         Buttons kann die Graphik weitergezeichnet oder neu begonnen
         werden. Davor kann der Darstellungsmodus gendert werden.

  2.1.6. Der Save-Button:
  
         Nach Anklicken mit der linken Maustaste erscheint eine Fileselect-
         Box zum Abspeichern des aktuellen Bildes im Screen- (auch Doodle-)
         Format (32000 Bytes).
                  
  2.1.7. Der Exit-Button:
  
         Nach dem Anklicken mit der linken Maustaste kann man das Programm
         verlassen.

3. Rechtliches:

   Das Programm ist frei von Rechten Dritter.
   Die verwendeten Routinen wurden eigens geschrieben.

   Das Programm ist Public Domain. Das bedeutet, da es jedermann kosten-
   los erwerben, jederzeit frei kopieren und weitergeben kann und soll.
   Bei Einzahlung von 70,- S oder 10,- DM auf untenstehendes Konto erhlt
   der Benutzer einen vollstndig kommentierten Source-Code (GfA-Basic 3.5)
   auf Diskette und kann das Listing fr eigene Arbeiten verwenden.
   Alle Rechte fr Logo und Namen von p post_industrial q vorbehalten.
   Eine andere, besonders gewerbliche, Nutzung ist nicht gestattet und
   auch von p post_industrial q nicht angestrebt.
   
   Wenngleich das Programm ausgiebig getestet wurde und Fehler soweit wie
   mglich behoben wurden, bernimmt p post_industrial q keine Gewhr-
   leistung fr das Funktionieren des Programms und keine Haftung fr
   etwaige durch die Anwendung entstehende Schden.
   
   Das Programm luft nur in der hohen Auflsung.
   
4. Nachtrag:

   Kontonummer:
   
   p post_industrial q
   z.H. Klaus Richter
   PSK 24 84 026
   Blz. 60.000
 
   p post_industrial q ist fr Anregungen und Kritik dankbar.

   Postanschrift:
   
   p post_industrial q
   z.H. Klaus Richter
   Postfach 98
   A-1071  WIEN
   sterreich

