home *** CD-ROM | disk | FTP | other *** search
/ Magazyn Exec 4 / CD_Magazyn_EXEC_nr_4.iso / Recent / dev / c / Emperor_V3.1.readme < prev    next >
Encoding:
Text File  |  2000-11-16  |  13.5 KB  |  278 lines
  1. Short:    Object-oriented programming language
  2. Author:   Matthias Gietzelt
  3. Uploader: Andreas Gietzelt <endee@t-online.de>
  4. Version:  3.1
  5. Type:     dev/c
  6. Email:    <joachim.gietzelt@klinikum-sn.de>
  7. Requires: OS 3.5, well-equipped Amiga, some knowledge,
  8.  
  9.           Amiga Developer CD 2.1 (see below)
  10.  
  11.  
  12.  
  13.           _______   __   __            ___        _______   ___      ___            ___
  14.          /******/  /**| /**|          /***\      /******/  /***\    /***\          /***\
  15.         /**____/  /***|/***|         /*__**\    /**____/  /*__**\  /*___*\        /*__**\
  16.        /**/      /*/|***/|*|        /*/  |*|   /**/      /*/  |*| /*/   \*\      /*/  |*|
  17.       /**/___   /*/ |**/ |*|       /*/__/**/  /**/___   /*/__/**/ |*|   |*|     /*/__/**/
  18.      /******/  /*/  |_/  |*|      /*******/  /******/  /*******/  |*|   |*|    /*******/
  19.     /**____/  /*/        |*|     /*______/  /**____/  /*__**__/   |*|   |*|   /*__**__/
  20.    /**/      /*/         |*|    /*/        /**/      /*/  \*\     |*|   |*|  /*/  \*\
  21.   /**/___   /*/          |*|   /*/        /**/___   /*/    \*\    \*\___/*/ /*/    \*\
  22.  /******/  /*/           |*|  /*/        /******/  /*/      \*\    \*****/ /*/      \*\
  23. /______/  /_/            |_| /_/        /______/  /_/        \_\    \___/ /_/        \_\
  24.  
  25.  
  26.                             The object-oriented programming language
  27.  
  28.                           Available at www.aminet.de ! (Drawer: dev/c)
  29.  
  30.  
  31.  
  32. Für die deutsche Version, bitte weiter unten lesen....
  33.  
  34.  
  35. ENGLISH:
  36.  
  37.  
  38. History
  39.  
  40. 2.0  - Initial release
  41. ---
  42. 2.1  - GadTools gadgets support !!
  43.      - reached to shrink programsize by coding the window-stuff by myself
  44.        instead of making it by ReActor
  45. ---
  46. 2.2  - Oops..The program crashed, when a clicktab was in a test-window.
  47.      - speed optimizations (e.g. at startup, shutdown etc.)
  48.      - defined catalog-creation
  49.      - C++-Code support
  50.      - added the macro "Preferences-Menu" for Prefs-Programs
  51.      - better & easier generated C-sourcecode
  52.      - minor bugfixes
  53. ---
  54. 2.3  - prefs-editor rewritten
  55.      - chooseable processortype for generated StormC-project
  56.      - modified programming-help
  57.      - some functionmacros rewritten
  58.      - minor bugfixes
  59. ---
  60. 3.0  - gadgets-test routine rewritten
  61.      - fixed bugs by showing tapedeck & colorwheel gadgets
  62.      - fixed problems with clicktabs & page gadgets (see "clicktabsexample")
  63.      - added function "Shutdown()" (called, when program quits)
  64.      - added progress-bar while saving
  65.      - added macrofunctions "Emperor_Set/GetGadgetAttrComplex()"
  66.        (see guide for details)
  67. ---
  68. 3.1  - fixed a bug when generating source for window with colorwheel
  69.      - source is now *more* SAS/C friendly
  70.      - fixed a silly bug when copy a function from programming help into texteditor
  71.      - added online help for macrofunctions (see chapter Programming Help for details)
  72.      - added ARexx-connection to StormC (Scripts - Dir)
  73.      - added arguments by starting StormC (e.g. GoldED support for StormC)
  74.      - added loading picture
  75.  
  76.  
  77. Introduction
  78.  
  79. Thanks for decrunching and the will to testing the program-packet.
  80. This program is for "revolutioning" the software-development on Amiga.
  81.  
  82. Object-oriented programminglanguage (OOP) is maybe a bit too high for that
  83. program, because there are "real" C/C++-sourcecodes generated and
  84. an external C/C++-Compiler must translate it into machine-code. In the Amiga-sphere
  85. there are only less applications like CanDo, Storm-Wizard and so on, but one day
  86. I have sawn the program "Delphi" on the PC :( ! This OOP is exclusive controlable
  87. in Pascal (that set's me up) and it has millions of configuration-possibilities.
  88. I didn't knew such things on Amiga, and so I made it by myself.
  89.  
  90. I want to make parameting of the Graphical User Interface (GUI) and its macro-elements as easy as
  91. possible. Following standard-GUI-elements are implemented:
  92.  * Windows
  93.  * OS2.0 Gadgets (GadTools)
  94.  * OS3.5 Gadgets (Reaction)
  95.  * Requests      (EasyRequest)
  96.  * Menus         (NewMenu)
  97.  * ASL-Requests  (File, Font, Screenmode)
  98.  * Locale        (Translations)
  99.  * Function-macros, which makes programming under OS3.5 more easily
  100.  
  101. With Emperor you are generating a complete C/C++-sourcecode, which only must be
  102. compiled by an external compiler (e.g. StormC from the developer CD2.1).
  103.  
  104. Aim of this program is to assure software developer to create their programs (its sourcecode)
  105. by Emperor, because the making of software (opening of windows, file- and fontrequests,
  106. menus etc.) is often equal and is no longer copied by programmers from other sourcecodes.
  107. Emperor decrees about one or more macros for every GUI-element. Like the menus:
  108. here you must, for creating the complete Project-menu (open, close, save, print etc.) and its
  109. translation, (in Locale-".catalog"-file) only select the corresponding entry in the list.
  110. This is also possible at requests e.g. by making a QuitRequest. These are called in
  111. the own sourcecode as function "REQUESTNAME();".
  112.  
  113. But the programm should also be for user, who never programmed before,
  114. and bade an easy way in the programming of AmigaOS-GUIs.
  115.  
  116.  
  117. Systemrequirements
  118.  
  119.   - an Amiga ;-)
  120.   - Memory at least 24 MByte !!; recommended 64 MByte or more
  121.   - Workbench version 3.5 or higher
  122.   - Processor at least 68020; recommended 68060
  123.   - Amiga Developer CD 2.1 of the HAAGE & Partner GmbH
  124.   - C/C++-Compiler (from the developer CD "ADCD_2.1:Contributions/Haage_&_Partner/StormC/")
  125.   - CatComp (from the developer CD "ADCD_2.1:NDK/NDK_3.5/Tools/CatComp")
  126.   - xen.font in size 8 installed in "Fonts:"-directory of the Bootdevice, :-)
  127.  
  128.  
  129. DEUTSCH:
  130.  
  131.  
  132. Die Geschichte
  133.  
  134. 2.0  - Erste Veröffentlichung
  135. ---
  136. 2.1  - AmigaOS 2.0 Gadgets hinzugefügt !!
  137.        (GadTools-Gadgets sind nun verfügbar !)
  138.      - Programm ist durch Code-Umsetzung von ReActor nach eigenem Code geschrumpft.
  139. ---
  140. 2.2  - Programmabsturz, wenn Clicktab-Gadgets in einem Test-Fenster waren.
  141.      - Geschwindigkeitsoptimierungen (z.B. beim Start, Ende etc.)
  142.      - definierte Catalog-Erstellung
  143.      - Makro "Preferences-Menü" für Einstellungs-Programme
  144.      - C++-Quelltext Unterstützung
  145.      - besserer & einfacherer generierter C-Quelltext
  146.      - minimale Fehler behoben
  147. ---
  148. 2.3  - Prefs-Editor überarbeitet
  149.      - wählbarer Prozessortyp für generierten StormC-Projekt
  150.      - modifizierte Programmierhilfe
  151.      - diverse Funktionsmakros überarbeitet
  152.      - minimale Fehler behoben
  153. ---
  154. 3.0  - Gadget-Test Routine überarbeitet
  155.      - Fehler beim Anzeigen von Tapedeck & Colorwheel Gadgets behoben
  156.      - Probleme mit Clicktabs & Page Gadgets behoben (siehe "clicktabsexample")
  157.      - Funktion "Shutdown()" hinzugefügt (Aufruf, bei Programmende)
  158.      - Fortschrittsanzeige während des Speicherns
  159.      - Makrofunktion "Emperor_Set/GetGadgetAttrComplex()" hinzugefügt
  160.        (siehe Emperor.guide)
  161. ---
  162. 3.1  - Fehler beim Quelltextgenerieren mit ColorWheels behoben
  163.      - Quelltext ist nun SAS/C freundlich*er*
  164.      - Fehler beim Kopieren einer Funktion von der Programmierhilfe in den Texteditor behoben
  165.      - Online Hilfe für Makrofunktionen hinzugefügt (siehe Kapitel Programmierhilfe)
  166.      - ARexx-Verbindung zu StormC (Scripts - Verzeichnis)
  167.      - Argumente beim Starten von StormC hinzugefügt (z.B. GoldED support für StormC)
  168.      - Ladebild hinzugefügt
  169.  
  170.  
  171. Die Einführung
  172.  
  173. Vielen Dank, daß Sie dieses Programm entpackt haben und ausprobieren möchten !
  174. Dieses Programm soll die Software-Entwicklung auf dem Amiga "revolutionieren".
  175.  
  176. Objekt-orientierte Programmiersprache (OOP) ist vielleicht ein wenig
  177. zu hoch gegriffen, da weiterhin "echte" C/C++-Quelltexte generiert und
  178. durch einen externen C/C++-Compiler übersetzt werden müssen. Im Amiga-Bereich
  179. gibt's nur wenige Ausnahmen wie CanDo, Storm-Wizard u.a., aber irgendwann habe
  180. ich das Programm "Delphi" auf dem PC :( kennengelernt ! Diese OOP ist
  181. ausschließlich in Pascal gehalten (was mich arg störte) und erschlägt einen
  182. mit den Millionen Konfigurations-möglichkeiten. Ich kannte soetwas in der Art
  183. bisher auf dem Amiga nicht, und kurzentschlossen setzte ich mich selbst daran.
  184.  
  185. Ich wollte die Parametrierung der Oberfläche und der Makro-Elemente so einfach wie
  186. möglich machen. Folgende Standard-Oberflächenelemente sind implementiert:
  187.  * Fenster
  188.  * OS2.0 Gadgets (GadTools)
  189.  * OS3.5 Gadgets (Reaction)
  190.  * Requester     (EasyRequest)
  191.  * Menüs         (NewMenu)
  192.  * ASL-Requester (File, Font, Screenmode)
  193.  * Locale        (Übersetzungen)
  194.  * vorgefertigte Funktionsmakros, die das Programmieren unter OS3.5 wesentlich erleichtern.
  195.  
  196. Man generiert mit Emperor einen komplett fertigen C/C++-Quelltext, der nur noch
  197. durch einen externen Compiler (z.B. StormC auf der Developer CD2.1) übersetzt werden muß.
  198.  
  199. Ziel dieses Programms soll sein, Softwareentwickler zu überzeugen mit Emperor ihre
  200. Programme (deren Quelltext) zu erstellen, da die Verfahrensweise bei der Erstellung
  201. von Software (Öffnen von Fenstern, Datei- und Schriftauswahlrequestern, Menüs etc.)
  202. oft gleich ist und nicht weiter durch den Programmierer selbst mühsam aus anderen
  203. Quelltexten herausgefischt werden muß. Emperor verfügt für jedes Element schon
  204. ein oder mehrere vorgefertigte, aber veränderbare, Makros. So z.B. bei den Menüs:
  205. hier muß für das Projekt-Menü (Öffnen, Speichern, Drucken etc.) und dessen
  206. Übersetzung (für Locale - ".catalog"-Datei) nur der entsprechende Eintrag
  207. gewählt werden. Dies gilt auch für Requester z.B. für das QuitRequest. Diese müssen
  208. nur noch im eigenen Quelltext als Funktion "REQUESTERNAME();" aufgerufen werden.
  209.  
  210. Das Programm soll aber auch für Amigianer sein, die noch nie programmiert haben,
  211. und so einen einfachen Einstieg in die Programmierung der AmigaOS-Oberfläche bieten.
  212.  
  213.  
  214. Die Systemanforderungen
  215.  
  216.   - einen Amiga ;-)
  217.   - Speicher mindestens 24 MByte !!; empfohlen 64 MByte oder mehr
  218.   - Workbench Version 3.5 oder höher
  219.   - Prozessor mindestens 68020; empfohlen 68060
  220.   - Amiga Developer CD 2.1 von der HAAGE & Partner GmbH
  221.   - C/C++-Compiler (von der Developer CD "ADCD_2.1:Contributions/Haage_&_Partner/StormC/")
  222.   - CatComp (von der Developer CD "ADCD_2.1:NDK/NDK_3.5/Tools/CatComp")
  223.   - xen.font in der Größe 8 im "Fonts:"-Verzeichnis des Bootlaufwerks, :-)
  224.  
  225.  
  226. ============================= Archive contents =============================
  227.  
  228. Original  Packed Ratio    Date     Time    Name
  229. -------- ------- ----- --------- --------  -------------
  230.    40992   15696 61.7% 05-Nov-00 14:26:10  Emperor/Projects/AminetSearcher
  231.   143466   12513 91.2% 05-Nov-00 14:26:10  Emperor/Projects/AminetSearcher.c
  232.     2578     856 66.7% 05-Nov-00 14:26:10  Emperor/Projects/AminetSearcher.cd
  233.    21440    2953 86.2% 05-Nov-00 14:26:10  Emperor/Projects/AminetSearcher.h
  234.     1428     842 41.0% 05-Nov-00 14:26:10  Emperor/Projects/AminetSearcher.info
  235.     1686     826 51.0% 05-Nov-00 14:26:08  Emperor/Projects/Catalogs/deutsch/AminetSearcher.catalog
  236.      606     342 43.5% 05-Nov-00 14:26:08  Emperor/Projects/Catalogs/deutsch/ClicktabExample.catalog
  237.     1006     552 45.1% 05-Nov-00 14:26:08  Emperor/Projects/Catalogs/deutsch/DevsManager.catalog
  238.      801     372 53.5% 05-Nov-00 14:24:48  Emperor/Scripts/stormc.rexx
  239.    11057    2133 80.7% 05-Nov-00 14:26:10  Emperor/Projects/AminetSearcher.project
  240.     1160     491 57.6% 05-Nov-00 14:26:10  Emperor/Projects/AminetSearcher.¶
  241.     3596    1328 63.0% 05-Nov-00 14:26:10  Emperor/Projects/AminetSearcher_deutsch.ct
  242.     3585     968 72.9% 05-Nov-00 14:26:10  Emperor/Projects/AminetSearcher_lowlevel.h
  243.    20356    8524 58.1% 05-Nov-00 14:26:10  Emperor/Projects/ClicktabExample
  244.    83964    8616 89.7% 05-Nov-00 14:26:10  Emperor/Projects/ClicktabExample.c
  245.       69      69  0.0% 05-Nov-00 14:26:10  Emperor/Projects/ClicktabExample.h
  246.     1074     718 33.1% 05-Nov-00 14:26:10  Emperor/Projects/ClicktabExample.info
  247.     2225     416 81.3% 05-Nov-00 14:26:10  Emperor/Projects/ClicktabExample.project
  248.     1558     840 46.0% 05-Nov-00 00:01:36  Emperor/Projects.info
  249.      913     409 55.2% 05-Nov-00 14:26:10  Emperor/Projects/ClicktabExample.README!
  250.     1163     492 57.6% 05-Nov-00 14:26:10  Emperor/Projects/ClicktabExample.¶
  251.    28536   11790 58.6% 05-Nov-00 14:26:10  Emperor/Projects/DevsManager
  252.    93504   10082 89.2% 05-Nov-00 14:26:10  Emperor/Projects/DevsManager.c
  253.     1602     585 63.4% 05-Nov-00 14:26:10  Emperor/Projects/DevsManager.cd
  254.     7903    1410 82.1% 05-Nov-00 14:26:10  Emperor/Projects/DevsManager.h
  255.     1593     889 44.1% 05-Nov-00 14:26:10  Emperor/Projects/DevsManager.info
  256.     4936    1075 78.2% 05-Nov-00 14:26:10  Emperor/Projects/DevsManager.project
  257.     1151     489 57.5% 05-Nov-00 14:26:10  Emperor/Projects/DevsManager.¶
  258.     2231     899 59.7% 05-Nov-00 14:26:10  Emperor/Projects/DevsManager_deutsch.ct
  259.    26732    7558 71.7% 05-Nov-00 19:52:08  Emperor/Catalogs/deutsch/Emperor.catalog
  260.    35074    7635 78.2% 05-Nov-00 19:52:02  Emperor/Catalogs/Emperor.cd
  261.      913     409 55.2% 05-Nov-00 19:52:34  Emperor/ClicktabExample.README!
  262.   814052  214591 73.6% 05-Nov-00 20:13:30  Emperor/Emperor
  263.    86600   71871 17.0% 05-Nov-00 00:07:08  Emperor/Emperor.pic
  264.       75      62 17.3% 05-Nov-00 14:24:12  Emperor/Emperor.prefs
  265.     1892    1031 45.5% 05-Nov-00 00:02:04  Emperor/Emperor.prefs.info
  266.    10100    4186 58.5% 05-Nov-00 19:52:36  Emperor/Emperor.readme
  267.     1497    1039 30.5% 05-Nov-00 19:52:36  Emperor/Emperor.readme.info
  268.    72793   19039 73.8% 05-Nov-00 20:13:00  Emperor/Emperor_deutsch.guide
  269.     1497    1039 30.5% 05-Nov-00 19:52:36  Emperor/Emperor_deutsch.guide.info
  270.    62924   15408 75.5% 05-Nov-00 20:13:00  Emperor/Emperor_english.guide
  271.     1497    1036 30.7% 05-Nov-00 19:52:38  Emperor/Emperor_english.guide.info
  272.     1643    1167 28.9% 05-Nov-00 00:07:32  Emperor.info
  273.    13746    3276 76.1% 05-Nov-00 19:51:22  Emperor.install
  274.     1245     973 21.8% 05-Nov-00 19:51:38  Emperor.install.info
  275.     2692    1456 45.9% 05-Nov-00 20:13:30  Emperor/Emperor.info
  276. -------- ------- ----- --------- --------
  277.  1621151  438951 72.9% 05-Nov-100 20:15:34   46 files
  278.