          'A la Card'                                     V1.3 vom 20.7.95
          ----------------------------------------------------------------

                                   'A la Card'
                         Patchprogramm fr GFA-Basic V3.6TT


          1. Sinn und Zweck
          -----------------
             Obwohl GFA-Basic sich  unter den  Atari-Benutzern noch groer
             Beliebtheit  erfreut,  wird es vom  Hersteller seit  lngerem
             nicht mehr aktiv supportet.  Das wre eigentlich nicht weiter
             schlimm, luft doch die letzte verffentlichte Version (V3.6)
             weitestgehend  fehlerfrei  und  stabil.  Leider  wurde  diese
             Version aber  in zwei  Punkten durch die  Entwicklung auf dem
             Atari-Sektor fr viele Benutzer unbrauchbar:

             - Der  Interpreter  luft nicht  auf  Farbgrafikkarten  unter
               nicht-monochromen Auflsungen sowie auf dem Falcon mit mehr
               als 16 Farben.
             - Der Interpreter luft auerdem nicht unter dem alternativen
               Betriebssystem 'MagicMac' auf dem Apple Macintosh

             'A la Card' behebt nun genau diese beiden rgernisse.


          2. Wirkungsweise
          ----------------
             'A la Card' patcht den Interpreter zur Laufzeit, indem es ihn
             in den Speicher ldt, die notwendigen nderungen anbringt und
             den genderten Programmcode dann ausfhren lt.
             Die verwendeten Ausgaberoutinen sind auf verschiedene, in der
             Praxis  anzutreffende  Bildschirmspeicherorganisationen opti-
             miert.
             Untersttzt werden,  soweit dies mglich ist,  Farbtiefen von
             16, 256, 32768, 65536 und 16 Millionen Farben.


          3. Einschrnkungen
          ------------------
             Die neuen  Ausgaberoutinen  sind  zugeschnitten auf die Bild-
             speicherorganisation,  wie sie bei den gngigen ET4000-Karten
             vorzufinden  ist.  Zur Zeit sind 11  verschiedene Bildschirm-
             formate implementiert.

             Der  Bildspeicher  der zum Einsatz kommenden Karte mu linear
             in den  Adressraum des  ST/TT  eingeblendet sein.  Karten mit
             segmentiertem Speicher lassen sich nicht verwenden.

             Die Lauffhigkeit  ist nur mit dem Interpreter in der Version
             3.6 gegeben.  ltere Versionen funktionieren mit  'A la Card'
             zusammen mit groer Wahrscheinlichkeit nicht.

             Es gibt verschiedene Ausfhrungen  der Version 3.6 des Inter-
             preters.  Die jngste (und verbreitetste Version) ist die mit
             der  Dateilnge  von  104770 Bytes.  Sollten Sie  eine andere
             Version besitzen, dann sollten Sie sich mit mir in Verbindung
             setzen (Adresse siehe unten) oder ein Update auf die genannte
             Version bei GFA-Systemtechnik anfordern.

             Die 16-Farbdarstellung auf  ET4000-Karten  wird nicht  unter-
             sttzt, weil diese nur  mit  groem  Aufwand  zu  realisieren
             gewesen wre.  Der 16-Farbmodus  auf einigen Grafikkarten der
             Firma 'Matrix' sowie auf dem Apple Macintosh unter 'MagicMac'
             wird dagegen untersttzt.

             In den Auflsungen  mit  direkter  Farbzuordnung  (High-  und
             TrueColor)  reicht der vom Basic angeforderte Speicher nicht,
             um einen  vollen  Bildschirm zu puffern.  Beim Umschalten vom
             Editor auf den Ausgabeschirm wird deshalb nur die Hlfte bzw.
             ein Drittel  des Bildschirms  angezeigt.  Die  Darstellung im
             Editor ist dagegen korrekt.

             Der Interpreter  hat  einen Fehler,  der erst  unter MagicMac
             aufgefallen ist  (weil die  ntigen Umstnde auf ST,  TT u..
             hardwaremig  nicht hergestellt werden knnen):  sobald mehr
             als ca. 14 MB Speicher frei sind, strzt er beim Start sofort
             ab.  Man sollte  den max.  fr MagicMac zugewiesenen Speicher
             deshalb im MagicMac-Setup entsprechend beschrnken.


          4. Getestete Hardware
          ---------------------
             'A la Card'  wurde  auf  folgenden  Rechnern und Grafikkarten
             erfolgreich getestet:

                Rechner              Grafikkarten         Auflsungen
                ----------------------------------------------------------
                ST                   Nova, Volksfarben    256, HC, TC

                ST                   Matrix               16, 256

                Mega STE, TT         Spektrum, Crazy Dots,
                                     Nova, Sang           256, HC, TC

                Falcon               -                    256, HC

                Apple Macintosh P475 -                    2, 16, 256, HC

                Apple Powerbook 150                       2


                HC=High-Color (32768 und 65536 Farben), TC=16 Mio. Farben

             Hinweis: ich kann nicht alle Grafikkarten,  Rechner und Hard-
                      warekombinationen kennen oder gar selbst testen.
                      ber (positive oder negative) Rckmeldungen zu nicht
                      aufgefhrten  Kombinationen  freue ich  mich deshalb
                      besonders!


          5. Installation
          ---------------
             Kopieren Sie die  Dateien ALA_CARD.PRG  und SETUP.PRG  an die
             Stelle,  an  der  sich  auch  der  Interpreter   GFABASIC.PRG
             befindet.  Starten Sie  nun zuerst das Programm SETUP.PRG und
             nehmen  Sie  die  gewnschten  Farbeinstellungen  vor.  Diese
             werden beim Verlassen des Programmes automatisch gespeichert.
             Anschlieend  starten  Sie ALA_CARD.PRG,  worauf nach einigen
             Sekunden  die gewohnte Oberflche des Interpreters erscheinen
             sollte.
             Ab der  Version 1.3  kann der Pfad,  in dem  der  Interpreter
             gesucht wird,  auch frei  eingestellt werden. Dazu ist in der
             letzten Zeile der INF-Datei  der komplette Pfad mit Dateiname
             einzutragen.

             Wichtig fr  die Benutzer  von MagiC und  Multi-TOS: Der GFA-
             Basic-Interpreter  ist  nicht  multitaskingfest.  Unter MagiC
             meldet man  ihn (bzw.  'A la Card')  deshalb  im  Desktop als
             Single-Mode-Applikation an,  selbiges gilt natrlich auch fr
             MagicMac.  Unter Multi-TOS  gibt es diese  Mglichkeit nicht,
             hier empfiehlt es sich auf jeden Fall,  alle  offenen Fenster
             zu  schlieen  und  dem  Interpreter  die  hchste  Prioritt
             zuzuweisen.


          6. Status
          ---------
             'A la Card'  ist  Shareware!  Das  bedeutet,  da Sie es frei
             kopieren und  in  jeder  nichtkommerziellen  Form  verbreiten
             drfen und  es Ihnen  erlaubt ist,  es eine  gewisse Zeit auf
             Ihrem Rechner  unentgeltlich  zu benutzen.  Nach  einer Test-
             periode von 2-3  Wochen sind Sie  verpflichtet,  das Programm
             zu lschen oder den Sharewarebeitrag  beim Autor zu bezahlen,
             falls Sie es weiter benutzen wollen.


          7. Sharewarebetrag und -einschrnkung
          -------------------------------------
             Der Registrierbetrag fr 'A la Card'  betrgt 40.- DM. Leider
             hat die Erfahrung gezeigt,  da die  Zahlungsmoral  nur  dann
             einen  gewissen  Grad  berschreitet,  wenn  die  ffentliche
             Version  mit  einer mglichst nervigen Einschrnkung versehen
             ist.  In  'A la Card' besteht die Beschrnkung darin, da nur
             die  obere  Hlfte  des  Bildschirmes  benutzt  wird.   Unter
             MagicMac in  monochromer Auflsung  luft die  eingeschrnkte
             Version nur bei Bildschirmgren bis 640*480.
             Nach der Zahlung des Sharewarebetrages erhalten Sie einen auf
             Ihren   Namen  passenden  Schlssel.  Sobald  Sie  diesen  im
             Registrierdialog   des    Setup-Programmes   eingeben,   wird
             'A la Card' zur uneingeschrnkten Vollversion.


          8. Autor und (c)
          ----------------
             Dieses Programm stammt von

                      Rosin Datentechnik
                      Reiner Rosin
                      Peter-Spahn-Str. 4
                      D-65375 Oestrich-Winkel
                      Telefon 06723 4978  Fax 7190

                      Bankverbindung: Konto 1211-04-601,
                      Postbank Frankfurt, BLZ 500 100 60

                      email Reiner Rosin @ WI2 (MausNet)
                            Reiner_Rosin@wi2.maus.de

          9.Disclaimer
          ------------
             Fr die Lauffhigkeit  auf  bestimmten  Hardwarekombinationen
             kann  keine  Garantie  bernommen  werden.  Jede  Haftung fr
             eventuelle  unmittelbar  oder  mittelbar  durch  'A la  Card'
             verursachten Schden oder  Datenverluste wird  abgelehnt.  Im
             Zweifelsfall empfiehlt sich, die Lauffhigkeit vorher mit der
             sharewareeingeschrnkten Version zu testen.

             Wenn irgendwelche  Probleme auftreten,  knnen Sie sich gerne
             mit  mir in  Verbindung setzen  (Rckporto  bitte  nicht ver-
             gessen).


          10. Sonstige Patches
          --------------------
             Von  verschiedenen  Seiten   gibt  es  mittlerweile   diverse
             Patches,  die in  der Regel  unmittelbar die Interpreterdatei
             manipulieren.  Es  liegt  in  der  Natur der Sache,  da sich
             solche Patches  nicht  unbedingt untereinander  und/oder  mit
             'A la Card'  vertragen.  Im Fehlerfall  probieren  Sie  bitte
             zunchst eine ungepatchte Version des Interpreters.

             Ein weiteres rgernis im Zusammenhang mit GFA-Basic ist,  da
             der  Compiler  unter  Magic  und  MagicMac abstrzt,  weil er
             Speicherbereiche berschreibt, die vom System benutzt werden.
             Dafr gibt  es den sehr  empfehlenswerten  (und  kostenlosen)
             GFA-Patch von Christoph Conrad und  Gregor Duchalski.  Dieser
             ist ebenfalls  bei mir  erhltlich (Diskette und Rckporto an
             o.g. Adresse) oder direkt beim Autor:

               Christoph Conrad, Adalbertsteinweg 113, D-52070 Aachen

             GFA-Patch  enthlt  auch  einige sinnvolle Verbesserungen fr
             den Interpreter.

          ----------------------------------------------------------------
                                                                     -eof-
