˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙
     MAGIC 4.00   Shared Libray for ATARI ST/E/TT und Falcon
______________________________________________________________________

Dies ist die DEMO-Version von Magic.  Sie enth„lt ein vollst„ndiges
MAGIC.PRG, welches von jeder Magic-Applikation (zB. X4U oder STELLA)
benutzt werden kann.  Weiter finden sie einige Demo- und Hilfsprogramme 
zu Magic, um sich ein Bild von den M”glichkeiten des Pakets zu machen.
Eine guten šberblick k”nnen Sie sich auch durch die beigefgte Online-
Dokumentation (im Format des ST-GUIDE) verfschaffen.  Den ST-GUIDE 
finden Sie in gut sortierten M„usen, so zB. auch in der Maus Nrnberg.

Um selbst Magic-Applikationen schreiben zu k”nnen, ben”tigen Sie eine
spezielle Library fr ihren Compiler.  Libraries fr die g„ngigen
Programmiersprachen erhalten bei der unten genannten Bezugsquelle.

Libraries liegen fr folgende Compiler vor:

 - Pure C, ab Version 1.0
 - GNU-C (GCC)
 - Pure Pascal, ab Version 1.1
 - Megamax Modula-2, ab Compilerversion 4.2
 - H„nisch Modula-2

weitere Libraries (Sozobon-C, ST-Oberon) sind in Vorbereitung.


Preise:

Magic 4.00:  Grundpaket (alle Programme, Demos etc.)    120.00 DM
             gedrucktes Handbuch (ca. 200 Seiten), 
             Library fr eine Programmiersprache

Libraries:   Library fr eine Programmiersprache         20.00 DM
             (Besitz des Grundpakets ist Voraus-
             setzung fr den Erwerb einer Library!)

Upgrade:     Upgrade auf Version 4.00 fr 'Magic fr     50.00 DM
             Modula-2' Besitzer (Originaldiskette 
             einsenden!) 

Alle Preise zuzglich 15% Mehrwertsteuer, sowie 8.00 DM fr
Porto und Verpackung. Verkauf nur gegen Vorkasse. Studenten
erhalten bei Vorlage einer entsprechenden Nachweises 20% Rabatt.


Adresse:        Peter Hellinger Software
                Zerzabelshofstraže 41
                90480 Nrnberg
                Telefon  0911-4097864
                Telefax  0911-405167

Konto-Nummer:   975 12-851
Bankleitzahl:   760 100 85, Postgiroamt Nrnberg


Wenn Sie ber ein Modem oder einen Akustikkoppler verfgen, k”nnen
Sie die Autoren von MAGIC auch ber folgende Mailbox erreichen:

                MAUS Nrnberg  0911-405167

oder ber das Mausnet mit

                Peter Hellinger @ N (Kernel, Pascal, Modula)
                Thomas Knneth @ N (Kernel, Pure-C)
                Dirk Stadler @ N (GCC)



Allgemeine Installation
˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙˙
MAGIC h„ngt in keinen Betriebssystem-Vektoren oder -Variablen, ausge-
nommen dem Cookiejar.  Alle Kommunikation zwischen den Anwendungspro-
grammen und MAGIC.PRG erfolgt ber den Cookie MPRO. Ist dieser nicht
vorhanden, oder wird MAGIC.PRG nicht gefunden, terminieren MAGIC-
Programme mit einem Fehler.

Unter MultiTOS bzw. MiNT arbeitet MAGIC als D„monprozess, und entfernt
sich selbst wieder aus dem Speicher, sobald die letzte MAGIC-Anwendung
terminiert.  MAGIC.PRG muss immer das Flag GLOBAL im Programmheader
gesetzt haben, da sonst die MAGIC-Anwendungen nicht auf MAGIC
zugreifen k”nnen (Memory-Violation).

Bei Mag!X wird MAGIC als Parallelprogramm gestartet und bleibt solange
in einer Endlosschleife, bis die letzte MAGIC-Applikation beendet
wurde. Leider besitzt Mag!X nicht die ausgefeilte Prozesssteuerung von
MiNT, so dass hier eine gewisse Grundaktivit„t von MAGIC unabdingbar
ist. Dies macht sich jedoch nicht in nennenswerten Performanceverlusten
bemerkbar, wie neuerdings im Mausnet behauptet wird.


Um MAGIC zu installieren bedarf es nur weniger Massnahmen:

-  Kopieren sie MAGICOOK.PRG in den Autoordner.

   Dieses Programm installiert einen Cookie mit Kennung MPRO im Cookie-
   jar. šber diesen Cookie kommunizieren MAGIC und die jeweiligen
   Applikationen. Ausserdem enth„lt er die Konfigurationsdaten, die
   somit fr alle MAGIC-Programme gleich sind.

   Das Cookieprogramm ist nicht zwingend fr den Betrieb von MAGIC.
   Das Hauptprogramm sucht nach MAGIC in seinem Startverzeichnis. Ist
   beim Start von MAGIC kein Cookie installiert, wird dies fr die
   Laufzeit des Hauptprogramms nachgeholt.


-  Befindet sich die Datei MAGICOOK.INF im Autoordner, so wir diese
   vom Cookie-Programm eingelesen. MAGICCOOK.INF enth„lt diverse
   Konfigurationsdaten fr Magic in kompakter Form, so unter anderem
   Angaben ber die Farben, die Magic bei der Darstellung diverser
   Objekte verwendet, oder welche Tastencodes den internen Magic-
   Funktionen zugeordnet sind.

   Zum Erstellen oder Žndern eines solchen INF-Files kann das Programm
   MAGICONF.PRG benutzt werden, welches zum Lieferumfang von Magic geh”rt.

   Wurde kein Cookie installiert prft MAGIC.PRG ob sich ein
   MAGICOOK.INF im Startverzeichnis des Programmes befindet, und 
   liest dies ggf. ein.


-  Das Programm MAGIC.PRG in einen Pfad Ihrer Wahl kopieren. Der Pfad
   sollte mit Hilfe des CPX (auf der Seite 'Diverses') eingestellt
   werden.

   M”chten Sie weder das Cookieprogramm noch das CPX benutzen, muss
   Magic „hnlich wie Resource-Dateien im Verzeichnis des jeweiligen
   Programms liegen.


-  Das CPX in Ihren CPX-Ordner kopieren. Beim n„chsten Boot ist es
   dann automatisch installiert.  Zum CPX-Programm lesen Sie bitte
   den entsprechenden Abschnitt im Handbuch.


Das wars dann auch schon...