home *** CD-ROM | disk | FTP | other *** search
/ Crawly Crypt Collection 1 / crawlyvol1.bin / crm_demo / magic / read.me
Text File  |  1994-06-03  |  5KB  |  141 lines
  1.  
  2. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  3.      MAGIC 4.00   Shared Libray for ATARI ST/E/TT und Falcon
  4. ______________________________________________________________________
  5.  
  6. Dies ist die DEMO-Version von Magic.  Sie enthält ein vollständiges
  7. MAGIC.PRG, welches von jeder Magic-Applikation (zB. X4U oder STELLA)
  8. benutzt werden kann.  Weiter finden sie einige Demo- und Hilfsprogramme 
  9. zu Magic, um sich ein Bild von den Möglichkeiten des Pakets zu machen.
  10. Eine guten Überblick können Sie sich auch durch die beigefügte Online-
  11. Dokumentation (im Format des ST-GUIDE) verfschaffen.  Den ST-GUIDE 
  12. finden Sie in gut sortierten Mäusen, so zB. auch in der Maus Nürnberg.
  13.  
  14. Um selbst Magic-Applikationen schreiben zu können, benötigen Sie eine
  15. spezielle Library für ihren Compiler.  Libraries für die gängigen
  16. Programmiersprachen erhalten bei der unten genannten Bezugsquelle.
  17.  
  18. Libraries liegen für folgende Compiler vor:
  19.  
  20.  - Pure C, ab Version 1.0
  21.  - GNU-C (GCC)
  22.  - Pure Pascal, ab Version 1.1
  23.  - Megamax Modula-2, ab Compilerversion 4.2
  24.  - Hänisch Modula-2
  25.  
  26. weitere Libraries (Sozobon-C, ST-Oberon) sind in Vorbereitung.
  27.  
  28.  
  29. Preise:
  30.  
  31. Magic 4.00:  Grundpaket (alle Programme, Demos etc.)    120.00 DM
  32.              gedrucktes Handbuch (ca. 200 Seiten), 
  33.              Library für eine Programmiersprache
  34.  
  35. Libraries:   Library für eine Programmiersprache         20.00 DM
  36.              (Besitz des Grundpakets ist Voraus-
  37.              setzung für den Erwerb einer Library!)
  38.  
  39. Upgrade:     Upgrade auf Version 4.00 für 'Magic für     50.00 DM
  40.              Modula-2' Besitzer (Originaldiskette 
  41.              einsenden!) 
  42.  
  43. Alle Preise zuzüglich 15% Mehrwertsteuer, sowie 8.00 DM für
  44. Porto und Verpackung. Verkauf nur gegen Vorkasse. Studenten
  45. erhalten bei Vorlage einer entsprechenden Nachweises 20% Rabatt.
  46.  
  47.  
  48. Adresse:        Peter Hellinger Software
  49.                 Zerzabelshofstraße 41
  50.                 90480 Nürnberg
  51.                 Telefon  0911-4097864
  52.                 Telefax  0911-405167
  53.  
  54. Konto-Nummer:   975 12-851
  55. Bankleitzahl:   760 100 85, Postgiroamt Nürnberg
  56.  
  57.  
  58. Wenn Sie über ein Modem oder einen Akustikkoppler verfügen, können
  59. Sie die Autoren von MAGIC auch über folgende Mailbox erreichen:
  60.  
  61.                 MAUS Nürnberg  0911-405167
  62.  
  63. oder über das Mausnet mit
  64.  
  65.                 Peter Hellinger @ N (Kernel, Pascal, Modula)
  66.                 Thomas Künneth @ N (Kernel, Pure-C)
  67.                 Dirk Stadler @ N (GCC)
  68.  
  69.  
  70.  
  71. Allgemeine Installation
  72. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  73. MAGIC hängt in keinen Betriebssystem-Vektoren oder -Variablen, ausge-
  74. nommen dem Cookiejar.  Alle Kommunikation zwischen den Anwendungspro-
  75. grammen und MAGIC.PRG erfolgt über den Cookie MPRO. Ist dieser nicht
  76. vorhanden, oder wird MAGIC.PRG nicht gefunden, terminieren MAGIC-
  77. Programme mit einem Fehler.
  78.  
  79. Unter MultiTOS bzw. MiNT arbeitet MAGIC als Dämonprozess, und entfernt
  80. sich selbst wieder aus dem Speicher, sobald die letzte MAGIC-Anwendung
  81. terminiert.  MAGIC.PRG muss immer das Flag GLOBAL im Programmheader
  82. gesetzt haben, da sonst die MAGIC-Anwendungen nicht auf MAGIC
  83. zugreifen können (Memory-Violation).
  84.  
  85. Bei Mag!X wird MAGIC als Parallelprogramm gestartet und bleibt solange
  86. in einer Endlosschleife, bis die letzte MAGIC-Applikation beendet
  87. wurde. Leider besitzt Mag!X nicht die ausgefeilte Prozesssteuerung von
  88. MiNT, so dass hier eine gewisse Grundaktivität von MAGIC unabdingbar
  89. ist. Dies macht sich jedoch nicht in nennenswerten Performanceverlusten
  90. bemerkbar, wie neuerdings im Mausnet behauptet wird.
  91.  
  92.  
  93. Um MAGIC zu installieren bedarf es nur weniger Massnahmen:
  94.  
  95. -  Kopieren sie MAGICOOK.PRG in den Autoordner.
  96.  
  97.    Dieses Programm installiert einen Cookie mit Kennung MPRO im Cookie-
  98.    jar. Über diesen Cookie kommunizieren MAGIC und die jeweiligen
  99.    Applikationen. Ausserdem enthält er die Konfigurationsdaten, die
  100.    somit für alle MAGIC-Programme gleich sind.
  101.  
  102.    Das Cookieprogramm ist nicht zwingend für den Betrieb von MAGIC.
  103.    Das Hauptprogramm sucht nach MAGIC in seinem Startverzeichnis. Ist
  104.    beim Start von MAGIC kein Cookie installiert, wird dies für die
  105.    Laufzeit des Hauptprogramms nachgeholt.
  106.  
  107.  
  108. -  Befindet sich die Datei MAGICOOK.INF im Autoordner, so wir diese
  109.    vom Cookie-Programm eingelesen. MAGICCOOK.INF enthält diverse
  110.    Konfigurationsdaten für Magic in kompakter Form, so unter anderem
  111.    Angaben über die Farben, die Magic bei der Darstellung diverser
  112.    Objekte verwendet, oder welche Tastencodes den internen Magic-
  113.    Funktionen zugeordnet sind.
  114.  
  115.    Zum Erstellen oder Ändern eines solchen INF-Files kann das Programm
  116.    MAGICONF.PRG benutzt werden, welches zum Lieferumfang von Magic gehört.
  117.  
  118.    Wurde kein Cookie installiert prüft MAGIC.PRG ob sich ein
  119.    MAGICOOK.INF im Startverzeichnis des Programmes befindet, und 
  120.    liest dies ggf. ein.
  121.  
  122.  
  123. -  Das Programm MAGIC.PRG in einen Pfad Ihrer Wahl kopieren. Der Pfad
  124.    sollte mit Hilfe des CPX (auf der Seite 'Diverses') eingestellt
  125.    werden.
  126.  
  127.    Möchten Sie weder das Cookieprogramm noch das CPX benutzen, muss
  128.    Magic ähnlich wie Resource-Dateien im Verzeichnis des jeweiligen
  129.    Programms liegen.
  130.  
  131.  
  132. -  Das CPX in Ihren CPX-Ordner kopieren. Beim nächsten Boot ist es
  133.    dann automatisch installiert.  Zum CPX-Programm lesen Sie bitte
  134.    den entsprechenden Abschnitt im Handbuch.
  135.  
  136.  
  137. Das wars dann auch schon...
  138.  
  139.  
  140.  
  141.