LinITG4Win.txt zu LinITG4Win.exe, Version 1.1.0

Dieses Windows-Konsolen-Programm gehoert zum ATARI-KaosFilm-Paket,
laesst sich natuerlich aber auch eigenstaendig gebrauchen.

Das Programm ist FREIE SOFTWARE nach der GNU-GPL.
THIS PROGRAM COMES WITH ABSOLUTELY NO WARRANTY.

Es ist dazu gedacht, Mandelbrot- und JuliaMengen zu berechnen und das
Iterationsergebnis (Zaehlerstand) als 2Byte-Wert oder als 4Byte-Wert abzuspeichern.
Das Format ist das *.ITG-Format des ATARI-Kaosmul.Prg, mit dem die Fraktale zu
graphischen Bildern verarbeitet und z.B. als Bitmap abgespeichert werden koennen.
Es kann auch direkt als Bitmap mit 8Bit Aufloesung gespeichert
werden.
Parametereingaben sind manuell moeglich, oder durch mit dem Kaosmul.Prg
erstellte *.KDT-, *.KAO- oder *.ITG-Dateien.
Es koennen nach manueller Eingabe auch *.KDT-Dateien abgespeichert
werden. Die Farbtabellen sind im Programm eingebaut.

Der Vorteil der ITG-Dateien liegt darin, dass damit noch keine Farbverteilung
verbunden ist. Erst die graphische Umsetzung, beeinflusst durch die Farbanzahl
und Modulotiefe, entscheiden ber das tatsaechliche Aussehen des Bildes. Die
ITG-Dateien koennen so beliebig oft verschieden graphisch umgesetzt werden,
ohne dass jedesmal neu berechnet werden mu. Das macht trotz der heutigen schnellen
Rechner bei groen Bildern einen wesentlichen Unterschied.


Bedienungsanleitung:

Das Programm startet auf der Konsole. Es ist am besten, das Programm in den Ordner mit den
Bilddateien zu kopieren. 


Wenn bei Aufruf des Programms ein (Pfad+)Dateiname als Parameter uebergeben
wird, wird die Datei behandelt wie bei der manuellen Dateieingabe mit
Iteration = 0 (siehe unten).
Dabei ist zu beachten, da das Programm 'case sensetive' arbeitet, d.h. Gro-
und Klein-Buchstaben beachtet werden mssen.
Als zweiter Parameter kann der (Pfad+)Dateiname der Farbtabelle (s.u.) fuer
das Speichern als Bitmap bergeben werden.
Bei manueller Parameter-Eingabe koennen diese als *.KDT-Datei gespeichert
werden. (Extension .kdt nicht vergessen.) Danach wird das Programm beendet,
ohne dass berechnet wird. Im 2. Schritt kann diese neue Datei dann zur
Berechnung gestartet werden.
Die Farbtabellen sind mit eingebaut, es koennen aber eigene verwendet
werden, die dann als Datei eingeladen werden muessen.

Bei Aufruf des Programms ohne Parameter wird nach dem Pfad gefragt, wo die
eventuell zu ladende Datei liegt, bzw wo spaeter gespeichert wird. Wenn der
Directory-Zeiger schon im entsprechenden Verzeichnis steht, genuegt
ein ".".

Danach wird nach dem Namen der evtl zu ladenden Datei gefragt, bzw der
Speicherdatei (mit Extension).

Als naechstes wird nach der Iterationstiefe gefragt.
- Wenn an dieser Stelle eine Null eingegeben wird, wird nach der unter
  PFAD+NAME angegeben Datei gesucht.
  - Wenn dies eine *.KDT- oder *.KAO-Datei ist, werden die
    Parameter zur Bildberechnung verwendet.
  - Wenn dies eine nicht-fertige *.ITG-Datei ist, wird fertiggerechnet.
  - Wenn dies eine fertige *.ITG-Datei ist, wird nach einer hoeheren
    Iterationstiefe gefragt. Damit werden nur die stabilen Punkte neu
    berechnet. Die Obergrenze fuer die hoehere Iterationstiefe ergibt
    sich aus dem 2- bzw 4Byte-Format der Datei, also 2^15 bzw 2^31.
    - An dieser Stelle kann das fertige ITG-Bild direkt
      als Bitmap abgespeichert werden.

- Wenn an dieser Stelle ein Wert groesser Null angegeben wird, ist dies der
  gueltige Iterationswert und der Rest der Parameter muss manuell
  angegeben werden.
  Die anzugebenden Parameter sind:
  - Menge                (1 = Julia, <>1 = Mandelbrot)
    - wenn Julia:
      Julia X   (-2  -  2)
      Julia Y   (-2  -  2)
  - Breite des Bildes in Pixeln.
  - Hoehe des Bildes in Pixeln.
  - RealMin     (-2  -  2)
  - RealMax     (-2  -  2)
  - ImagMin     (-2  -  2)
  - ImagMax     (-2  -  2)
Jetzt wird gefragt, ob berechnet oder als *.kdt-Datei
gespeichert werden soll. Bei Letzterem muessen dann noch Werte fuer
Modulo und Farben eingegeben werden.


Nach Beendigung der Berechnung kann das Speicherformat ausgewaehlt werden:
"i" fuer nur ITG speichern
"b" fuer nur Bitmap speichern
"d" fuer ITG und Bitmap speichern
Beim Speichern als Bitmap:
Wenn als Parameter keine Farbtabelle bergeben wurde, wird jetzt nach der
  Farbtabelle gefragt. Die Werte 1 - 16 rufen die einbauten Farbtabellen auf,
  der Wert 0 heisst, eine Datei zu laden. Dann wird nach dem Namen
  der Farbtabellen-Datei gefragt. Die Angabe des Dateinamens erfolg ohne
  die Extension ".kco".
  Die Farbtabellen (Extension .kco) sind Ascii-Dateien von 256 mit Komma
  abgeschlossenen Werten (32 Zeilen a 8 Werte) im Format:
  blau * 256 + gruen * 16 + rot (jeweils im Bereich 0 - 15).
Danach koennen die Einstellungen 'Modulo' 'Farben' und die Hintergrundfarbe
  veraendert werden. Diese Einstellungen beeinflussen die Farbverteilung der
  Bitmap erheblich, je nach Einstellung kann das Bild voellig anders aussehen.

Abbruch jederzeit mit Ctrl-C, Abbruch mit Speichern geht nicht.

Erste Version geschrieben von Claas Lichtenberg (Walsrode/Hannover) und mir.
Seit Version 1.0.1 von mir alleine.

Der Quellcode sollte in der Datei LinITG4win.C dabei sein.
Die GNU GPL lizenz ist nicht mit enthalten, sollte hier zu finden sein:
http://www.gnu.org/licenses/
Dieses Programm bentigt die 'cygwin1.dll', die im gleichen Ordner wie das
Programm oder im Windows System-Ordner (C:\Windows\System oder C:\WinNT\System32
oder so) zu finden sein mu.
Diese DLL ist im Paket mit enthalten.
Fr diese DLL habe ich bisher leider keinen Quellcode finden knnen.
Die Cygwin-Programmierer mgen es mir verzeihen.


Much fun, KALLISTI
Zwyrd


(C)Copyleft  5/7  by Zwyrd


Kontakt:
Karsten Schmidt
email: zwyrd@gmx.de
http://www.zwyrd.de

-------------------

ANHANG 1

Aufbau der KDT-Dateien/KAO-Header und ITG Header:

KAO/KDT        ITG 
Offset  Wert   Offset

+0      2$     +0      (Bei ITG-Dateien, die KAOSMUL.PRG ab 4.1.5 oder
                       LINITG.X ab Version 1.0.1 oder Linitg4win erstellt wurden:)
                       "I2" oder "I4"
                         Wenn hier "I4" steht, ist die
                         Iteration (offset +18) > 32767.
+2      L      +2      0-19 Menge (in diesem Programm nur 0 oder 1)
+6      L      +6      Breite in Pixeln
+10     L      +10     Hoehe in Pixeln
+14     L      +14     Zaehler
+18     L      +18     Iteration
+22     L      +22     Modulo
+26     L      +26     Farben
+30     L              Bitplanen
+34     L              Breite in ganzen 16 Pixeln
+38     L              0
+42     L              0
+50     20$    +30     Real Min
+70     20$    +50     Real Max
+90     20$    +70     Imag Min
+110    20$    +90     Imag Max
+130    20$    +110    Julia X
+150    20$    +130    Julia Y
+170    20$            Ab iter
+190    20$            Test
+210    20$            0
+230    20$            0
+250    20$            0
+270    20$            Groesse des Bilddatenbereichs
+312    8$             Name

=320           =150    Bytes

--------------

ANHANG 2

Nummer der Farbtabellen (werden auch im Programm angezeigt):

Tabelle:              bisherige Datei:     tatsaechliche Farben (ohne 0/1):

Kreis        -  1     itg_circ.kco         127
Pastel 1     -  2     itg_pas1.kco         127
Pastel 2     -  3     itg_pas2.kco         127
Rasta 1      -  4     itg_rast.kco         127
Rasta 2      -  5     itg_ras2.kco         254
Rasta 3      -  6     itg_ras3.kco         127
Bunt         -  7     itg_bunt.kco         254
Grau/Gruen   -  8     itg_grgr.kco         64
Rot          -  9     itg_red.kco          32
Gelb         - 10     itg_yell.kco         32
Gruen        - 11     itg_gree.kco         32
Blau         - 12     itg_blue.kco         32
Lila         - 13     itg_lila.kco         32
Grau         - 14     itg_grey.kco         32
Schwarz/Gelb - 15     itg_blye.kco         32
Gelb/Schwarz - 16     itg_yebl.kco         32
