home *** CD-ROM | disk | FTP | other *** search
/ Computer Club Elmshorn Atari PD / CCE_PD.iso / pc / 0400 / CCE_0499.ZIP / CCE_0499.PD / README < prev    next >
Text File  |  1993-04-10  |  11KB  |  270 lines
  1.   TeXDraw wurde mit TDI-Modula-2 und den Magic-Tools von Peter Hel-
  2.   linger entwickelt (dürfte ohne groβe Änderungen auf dem neuen Me-
  3.   gamax-M2-Compiler laufen), kann mit entsprechendem Aufwand aber
  4.   auch in C o.ä. konvertiert werden (haha, viel Spaβ). Der Quellcode
  5.   kann von registrierten Benutzern gegen Einsendung einer Diskette und
  6.   eines adressierten und (ausreichend) frankierten Rückumschlag sowie
  7.   eines (eher symbolisch zu verstehenden) Obulus von 20,-- DM bei mir
  8.   angefordert werden. Ich hätte dann nur gerne Nachricht über vorge-
  9.   nommene Änderungen am Programm; vielleicht sind diese ja so gut, daβ
  10.   man sie der Allgemeinheit zuteil werden lassen sollte.
  11.  
  12.   In meinem Programm wird ausgiebig Gebrauch von Routinen aus der
  13.   Magic-Lib und den Magic-Tools von Peter Hellinger gemacht. Diese
  14.   Routinen werden kommerziell vertrieben und dürfen deswegen nicht
  15.   weitergegeben werden. Wer also Interesse an diesen (wirklich
  16.   ausgezeichneten) Bibliotheken hat, wende sich an:
  17.  
  18.                           Peter Hellinger
  19.                           Brunnengasse 51
  20.                           8500 Nürnberg 1
  21.  
  22. Jetzt folgt eine kurze Beschreibung dieser Bibliotheken:
  23. (P.S.: Nein, ich kriege keine Provision (leider) )
  24.  
  25.                                                   \
  26.                                                    \ o
  27. ----------------------- cut here ------------------ x ------
  28.                                                    / o
  29.                                                   /
  30.  
  31.  
  32.   ---##-----##-----#######------#######-----##------#######----
  33.   ---###---###----##-----##----##-----##----##-----##-----##---
  34.   ---##-#-#-##----##-----##----##-----------##-----##----------
  35.   ---##--#--##----#########----##---####----##-----##----------
  36.   ---##-----##----##-----##----##-----##----##-----##----------
  37.   ---##-----##----##-----##----##-----##----##-----##-----##---
  38.   ---##-----##----##-----##-----#######-----##------#######----
  39.  
  40.        MAGIC   Modula's All purpose Gem Interface Cadre
  41.        ¯¯¯¯¯   ¯        ¯           ¯   ¯         ¯
  42. -----------------------------------------------------------------
  43.  Ein Vorschlag für eine systemübergreifende GEM-Schnittstelle in
  44.                               Modula-2
  45. -----------------------------------------------------------------
  46.      Version 2.01 vom 01.12.1990      (c) by Peter Hellinger
  47. -----------------------------------------------------------------
  48.  
  49. 1.    MAGIC - Was ist das?
  50.       ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  51.       MAGIC ist die Abkürzung für "Modula's All purpose Gem
  52.       Interface Cadre", was soviel wie "Von allen benutzter GEM-
  53.       Interface Stamm" bedeutet. Damit ist eigentlich schon klar,
  54.       um was es bei MAGIC geht: Um eine Modula-2-Bibliothek, die
  55.       einheitliche Systemaufrufe für das Betriebssystem der Atari
  56.       ST- und TT-Linie für möglichst alle Modula-2-Compiler die
  57.       im Handel sind bereitstellt.
  58.  
  59.       Mit MAGIC steht zwar nicht zum ersten Mal aber doch um-
  60.       fangreicher als bisher eine Bibliothek zur Verfügung, die
  61.       die Programmierung von GEM-Applikationen vereinheitlichen
  62.       und vereinfachen soll.  Durch die nahe Anlehnung an das
  63.       Profibuch, die hohe Flexibilität der Prozedur-Parameter
  64.       und der Verfügbarkeit für die meisten der auf dem ST
  65.       implementierten Modula-2-Compiler eignet sich MAGIC
  66.       hervorragend für die professionelle und semiprofessionelle
  67.       Programmentwicklung.
  68.  
  69. 2.    Compiler und Magie
  70.       ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  71.       MAGIC steht zur Zeit für folgende Modula-2 Compiler zur
  72.       Verfügung:
  73.  
  74.       - Megamax-Modula-2
  75.       - TDI-Modula-2/ST
  76.       - Hänisch Modula-2/ST     (Ab Januar 1991)
  77.       - SPC-Modula-2            (Mit Einschränkungen)
  78.       - LPR-Modula-2  PD-Modula der TU München  (Mit Einschr.)
  79.  
  80.       In Vorbereitung:
  81.  
  82.       - FTL Modula-2/ST
  83.       - ANA Modula-2/68  Shareware-Compiler aus USA
  84.  
  85.       Anpassungen an andere Compiler, Fehlerreports und Verbes-
  86.       serungsvorschläge bitte ich an untenstehende Adresse zu
  87.       senden. Siehe Anhang.
  88.  
  89. 3.    Jedem seinen Typ!
  90.       ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  91.       Um den Anwender möglichst freie Hand bei der Typgestaltung
  92.       zu lassen, wurde auf das Verfahren der OPEN ARRAY's in
  93.       Modula-2 zurückgegriffen. Die Bibliothek ist daher für
  94.       falsche Parameter relativ anfällig, da hier das strenge
  95.       Typkonzept Modula's umgangen wird. Dafür steht es dem
  96.       Benutzer aber frei, beliebige eigene Datenstrukturen zu
  97.       verwenden; Hauptsache ist, daß die geforderten Daten in
  98.       der von GEM erwarteten Form im Speicher stehen.
  99.  
  100. 4.    MagicSys
  101.       ¯¯¯¯¯¯¯¯
  102.       MagicSys ist der Versuch, compilerabhängige Dinge zu ver-
  103.       einheitlichen, bzw. vor den Klientmodulen zu verbergen.
  104.       Mit dem kommenden ISO-Standard werden auch Änderungen
  105.       betreffend der Größe der einzelnen Typen gültig werden. Um
  106.       diesen Umstand Rechung zu tragen, und vor allem weil die
  107.       verschiedenen Compiler auch unterschiedliche Typen - und
  108.       Größen - zur Verfügung stellen wurden für MAGIC einheit-
  109.       liche Typen festgelegt.
  110.  
  111. 5.    MagicTypes
  112.       ¯¯¯¯¯¯¯¯¯¯
  113.       Mit MagicTypes erhalten Sie ein Modul, in dem wichtige
  114.       Strukturen des Atari-ST Betriebssystems deklariert sind.
  115.       Die Bezeichner und Strukturen richten sich nach dem Profi-
  116.       buch, Anhang C.  Details entnehmen Sie bitte dort.
  117.  
  118. 6.    MagicStrings
  119.       ¯¯¯¯¯¯¯¯¯¯¯¯
  120.       Als großes Hemmnis für compilerunabhängige Klientmodule
  121.       erweisen sich immer wieder die String-Manipulationen, die
  122.       doch sehr oft benötigt, aber für fast jeden Compiler
  123.       anders implementiert sind.  MagicStrings stellt ein
  124.       langjährig (in einem Texteditor) erprobtes Modul zur
  125.       Stringmanipulation dar.
  126.  
  127. 7.    MagicConvert
  128.       ¯¯¯¯¯¯¯¯¯¯¯¯
  129.       Ebenso wie Stringmanipulationen werden oft Zahlenkonver-
  130.       sionen von Strings in Zahlen oder umgekehrt notwendig.
  131.       Auch hier weichen die einzelnen spezifischen Implementa-
  132.       tionen stark voneinander ab. MagicConvert schafft Abhilfe.
  133.  
  134. 8.    Die System-Module
  135.       ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  136.       Die System-Module implementieren den jeweiligen Abschnitt
  137.       des ST/TT-Betriebssystems:
  138.  
  139.         MagicBIOS       BIOS-Routinen
  140.         MagicXBIOS      XBIOS-Routinen
  141.         MagicDOS        GEMDOS-Routinen
  142.         MagicAES        AES-Routinen
  143.         MagicVDI        VDI-Routinen
  144.  
  145.       Details können Sie den jeweiligen DEFINITION MODULEs
  146.       entnehmen.
  147.  
  148. 9.    Aus der Werkzeugkiste
  149.       ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  150.       Was nützt der schnellste Compiler, was nützt die tollste
  151.       Programmiersprache, wenn man doch wieder das "Rad neu
  152.       erfinden" muß?  Aus diesem Grund stehen ausser den in
  153.       Teil 1 beschriebenen Grundmodulen gemäß der MAGIC-
  154.       Philosophie die sogenannten MAGIC-TOOLS zur Verfügung, die
  155.       oft benötigte Programmteile sowie einige nicht so ohne
  156.       weiteres mögliche GEM-Spielereien zur Verfügung stellen.
  157.       Diese Module basieren allesamt auf den zuvor beschriebenen
  158.       MAGIC-Modulen und enthalten (fast) keinerlei compiler-
  159.       spezifischen Code.
  160.  
  161. 10.   MagicApplikation
  162.       ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  163.       MagicApplikation erledigt viele grundsätzliche Prozeduren
  164.       einer GEM-Applikation, wie etwa Anmelden beim AES, Öffnen
  165.       von VDI-Workstations, laden von GDOS-Fonts, auslesen der
  166.       Kommandozeile usw.
  167.  
  168. 11.   MagicArea
  169.       ¯¯¯¯¯¯¯¯¯
  170.       MagicArea implementiert Routinen, die zum Sichern und
  171.       Restaurieren von Bildspeicher gedacht sind.
  172.  
  173. 12.   MagicDials
  174.       ¯¯¯¯¯¯¯¯¯¯
  175.       Sicherlich haben Sie schon einmal die Programme RUFUS oder
  176.       GEMINI und die dort eingesetzten FlyDials, die verschieb-
  177.       und tastaturbedienbaren Dialogboxen mit dem "MacIntosh-
  178.       Feeling" gesehen und bewundert. MagicDials sind eine Sammlung
  179.       von Routinen, mit denen Sie gleiche oder ähnliche Dialogboxen
  180.       wie das berühmte Vorbild hervorzaubern können - mit einem
  181.       Minimum an Aufwand.
  182.  
  183. 13.   MagicAlerts
  184.       ¯¯¯¯¯¯¯¯¯¯¯
  185.       MagicAlerts sind eine Anwendung der MagicDials. Das Modul
  186.       stellt Alertroutinen analog zu FormAlert des Original-AES
  187.       zur Verfügung.
  188.  
  189. 14.   MagicDir
  190.       ¯¯¯¯¯¯¯¯
  191.       MagicDir implementiert Funktionen zur Pfad- und Filenamen-
  192.       Manipulationen, sowie Zugriff auf Fileselectorboxen.
  193.  
  194. 15.   MagicPopups
  195.       ¯¯¯¯¯¯¯¯¯¯¯
  196.       MagicPopups stellen dem Programmierer Routinen zur
  197.       Verfügung, die aus normalen GEM-Menüzeilen Popupmenüs
  198.       generieren. ALLE Menus können auch über die Tastatur
  199.       bedient werden! Ab Version 2.01 können die Popups auch
  200.       - ähnlich den MagicDials - verschoben werden.
  201.  
  202. 16.   MagicMenus
  203.       ¯¯¯¯¯¯¯¯¯¯
  204.       MagicMenus stellt Routinen zur Verfügung, die eine GEM-
  205.       Menüzeile IN einem Fenster darstellen und verwalten. Die
  206.       Menüzeile ist in Erscheinungsbild und Handling getreu nach
  207.       der Original-AES-Menüzeile gearbeitet.
  208.  
  209. 17.   MagicResource
  210.       ¯¯¯¯¯¯¯¯¯¯¯¯¯
  211.       MagicResource implementiert Routinen, die es erlauben
  212.       mehrere Resource-Files in einer Applikation zu benutzen.
  213.  
  214. 18.   MagicTerminal
  215.       ¯¯¯¯¯¯¯¯¯¯¯¯¯
  216.       MagicTerminal ist als vollständiger VT52-Treiber für
  217.       Fensterausgabe konzipiert.  Die VT-52-Funktionen können
  218.       nicht nur mittels der exportierten Prozeduren aktiviert
  219.       werden, sondern auch über die bekannten Escape-Sequenzen,
  220.       die auch in einem String eingebettet sein können.
  221.       Zusätzlich werden die üblichen VDI-Effekte sowie hochge-
  222.       stellte und tiefgestellte Schrift unterstützt.
  223.  
  224. 19.   MagicWindows
  225.       ¯¯¯¯¯¯¯¯¯¯¯¯
  226.       Dieses Modul übernimmt viele Standardfunktionen einer
  227.       Fensterverwaltung.
  228.  
  229.  
  230. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  231.  
  232. A.1   Lieferumfang
  233.       ¯¯¯¯¯¯¯¯¯¯¯¯
  234.       Auf der gelieferten Diskette sind alle Magic-Module sowohl
  235.       der MAGIC-LIB als auch der MAGIC-TOOLS im Quelltext
  236.       enthalten.  Eine genaue Aufstellung entnehmen Sie bitte
  237.       der Datei INHALT.DOC auf der Lieferdiskette.
  238.  
  239.       Sollten Sie Bedarf an weiteren Compiler-Anpassungen von
  240.       Magic haben, senden Sie bitte eine doppelseitig im Stan-
  241.       dard-TOS-Format formatierte 3.5"-Diskette sowie einen als
  242.       Warensendung frankierten Umschlag mit Ihrer Adresse an:
  243.  
  244.                           Peter Hellinger
  245.                           Brunnengasse 51
  246.                           8500 Nürnberg 1
  247.  
  248.       Sie erhalten dann postwendend die neueste Version der
  249.       MAGIC-LIB und MAGIC-TOOLS, sowie alle vorliegenden
  250.       Implementationen für andere Modula-2-Compiler.
  251.  
  252. A.2   Service
  253.       ¯¯¯¯¯¯¯
  254.       Sollten Sie Probleme mit MAGIC haben, können Sie ruhig
  255.       Kontakt über die obige Adresse mit mir aufnehmen.  Wenn
  256.       Sie über ein Modem oder einen Akustikkoppler verfügen,
  257.       können Sie mich auch über folgende Mailboxen erreichen:
  258.  
  259.        Peter Hellinger @ STA
  260.        MAUS Pöcking/Starnberg    08157-7626  300-2400bd 8N1
  261.  
  262.        FIDO-Adresse:  Peter Hellinger  2:246/7  oder 2:246/8
  263.  
  264.        GENIE:  P.HELLINGER
  265.  
  266.       Über neue Versionen oder weitere Anpassungen von MAGIC
  267.       werden Sie in den obigen Medien bzw. von Application
  268.       Systems Heidelberg in deren Bekanntmachungen unterrichtet.
  269.  
  270.