home *** CD-ROM | disk | FTP | other *** search
/ Whiteline: Alpha / Whiteline Alpha.iso / progtool / c / egem / doku / e_gem.txt next >
Encoding:
Text File  |  1994-09-22  |  8.0 KB  |  186 lines
  1.  
  2.                       EnhancedGEM-Library  Version 1.45
  3.                      -----------------------------------
  4.                      (inkl. Sourcen in C und Assembler)
  5.  
  6.  
  7.                          Eine Dialog-Library von ...
  8.  
  9.                             Christian Grunenberg
  10.                                Traminerweg  5
  11.                               D-71717 Beilstein
  12.  
  13.                             Tel.: 07062 - 5287
  14.  
  15.                  E-Mail: Christian Grunenberg @ S2 (Mausnet)
  16.                          Christian_Grunenberg@S2.maus.de (Usenet)
  17.  
  18.  
  19. EnhancedGEM ist eine Dialoglibrary, welche nach dem Freeware-Prinzip verteilt
  20. wird. Dies bedeutet, daß jeder die Library inkl. der Sourcen kopieren, be-
  21. nutzen und weitergeben darf, außer es handelt sich um PD-Versender, denn diese
  22. müssen sich bei mir eine schriftliche Genehmigung einholen. Eine kommerzielle
  23. Verwendung der Library ist allerdings untersagt bzw. muss mit mir abgesprochen
  24. werden. Ebenso ist es verboten, veränderte Versionen der Sourcen bzw. unvoll-
  25. ständige Archive zu verbreiten. Bei vorhandenen Fehlern sollte man sich statt-
  26. dessen immer mit genauen Fehlermeldungen an mich wenden.
  27.  
  28. Für das einwandfreie Funktionieren der Library oder eventuell entstehender
  29. Schäden übernehme ich keinerlei Garantie bzw. Verantwortung.
  30.  
  31. Sollte Ihnen die Library dennoch gefallen oder Sie wollen die neueste
  32. Version, so senden Sie mir einfach eine beliebige PD-Diskette (als
  33. Anerkennung) und einen frankierten Rückumschlag (für die neueste Version)
  34. zu.
  35.  
  36. In der Maus Stuttgart 2 (@S2) liegt immer die neueste Version der Library.
  37.  
  38. Fähigkeiten der EnhancedGEM-Dialog-Library:
  39. -------------------------------------------
  40.     - läßt sich mit GNU-C, Pure C und Lattice C einsetzen
  41.     - an MultiTOS, Mag!X 2.0 sowie Winx >= 2.1 angepaßt
  42.     - beliebig viele Fenster-/fliegende Dialoge gleichzeitig
  43.     - fliegende Dialoge springen zur Mausposition bei Mausklick außerhalb
  44.       des Dialogs
  45.     - Rechtsklick auf Objekt im Vordergrund-Dialog simuliert Doppelklick
  46.     - Fensterdialoge optional auch (!) vor MTOS/Falcon-TOS ohne zusätzlich
  47.       gedrückte rechte Maustaste im Hintergrund bedienbar (funktioniert
  48.       teilweise nicht einwandfrei bei aktivem ArrowFix von Martin Osieka)
  49.     - unmodale/modale Fensterdialoge
  50.     - Tastaturbedienung der Dialoge, wobei in Dialogen mit Edit-Feldern
  51.       zusätzlich die Alternate-Taste gedrückt werden muß (Doppelklick durch
  52.       zusätzlich gedrückte Shift-Taste)
  53.     - erweiterte Alert-Funktion:
  54.         - 18 vordefinierten Icons
  55.         - benutzerdefinierte Icons beliebiger Größe
  56.         - beliebig langen Zeilen und Buttons
  57.         - maximal 10 Zeilen sowie 5 Buttons
  58.         - Buttons über Hotkey anwählbar (auch ohne Alternate-Teste)
  59.     - erweiterte Eingabemöglichkeiten in EDIT-Feldern
  60.         - exakte Cursorpositionierung per Maus
  61.         - Mauscursor wird über Eingabefeldern zum Textcursor
  62.         - erstes/letzes Eingabefeld (Home/Shift-Home)
  63.         - Wort vor/zurück (Ctrl-Left/Right)
  64.         - Anfang/Ende des Eingabesfeldes (Shift-Left/Right)
  65.         - nächstes Eingabefeld (Tab/(Shift-) Enter/Shift-Return/opt. Return)
  66.         - Eingabefeld löschen (Esc)
  67.         - Eingabefeld nach Cursor löschen (Shift-Del)
  68.         - Eingabebox für alle Ascii-Zeichen (Shift-Insert)
  69.         - Undo, sofern kein Undo-Button definiert ist
  70.         - History ((Shift-) Ctrl-Up/Down)
  71.         - Clipboardunterstützung ((Shift-) Ctrl-X/C/V)
  72.         |
  73.         -> s.a. Let' em fly 1.20
  74.     - Cookie-/Scrap-/Rsrc- u. Environment-Library
  75.     - erweiterte Rectangle- & Object-Library von PC-GEM 2.0
  76.     - viele erweiterte Objekte:
  77.         - Radio-Buttons
  78.         - Check-Buttons
  79.         - Cycle-Buttons für Popups
  80.         - Help-Button
  81.         - Undo-Button
  82.         - Text mit Attributen
  83.             - unterstrichen,kursiv,umrandet,schattiert,fett,hell,klein/groß
  84.         - Rahmen mit Titel
  85.         - Titel (=unterstrichener Text)
  86.             - beliebige Strichdicke, optional doppelt unterstrichen
  87.         - Flugecke
  88.         - Slider-Arrows
  89.         - Niceline
  90.         - opt. von EDIT-Eingaben abhängiges DEFAULT-Objekt
  91.         - modale Objekte, d.h. das Objekt kommt nur in modalen Dialogen vor
  92.         - usw.
  93.     - Echtzeitgummiband/-schieber mit automatischer Verwaltung bzw.
  94.       Ereignisauswertung
  95.     - variable Popup-Menüs (vollständig tastaturbedienbar (Hotkeys),
  96.       frei positionierbar)
  97.     - Dialogoptik in weiten Grenzen variierbar:
  98.         - Hintergrundbox (Muster,Farbe,Rahmen)
  99.         - Flugecke wird an Hintergrundbox angepaßt
  100.         - Rahmen (Titel umrandet,Titelgröße,doppelter Rahmen)
  101.         - Titel-Unterstrich (Länge,Dicke,doppelt unterstrichen)
  102.         - Farben der erweiterten Objekte
  103.         - viele Varianten der Radio-/Check/Cycle-Buttons sowie Sliderpfeile
  104.         - usw.
  105.     - sauber programmiert, d.h. unabhängig von
  106.         - Computer (ST/TT/Falcon/Emulator)
  107.         - Auflösung und Anzahl der Farben
  108.         - (Multi) TOS-Version
  109.         - VDI/GDOS-Treiber
  110.         - Größe des System-Fonts
  111.     - usw.
  112.  
  113.  
  114. Einsatz unter Pure C, GNU-C und Lattice C:
  115. ------------------------------------------
  116.  
  117. Allgemeiner Hinweis:
  118. Bei der Übersetzung der Library darf keine Stack-Überprüfung aktiviert sein,
  119. da einige Library-Funktionen (z.B. benutzerdefinierte Objekte) vom AES
  120. aufgerufen werden und somit den AES-Stack verwenden.
  121.  
  122. 1. Pure C
  123.  
  124. EnhancedGEM läßt sich sowohl mit den Pure-C-Libraries als auch mit den MiNT-
  125. Libraries ab Patchlevel 30 compilieren.
  126. Hierzu muß jedoch im Header-File AESBIND.H der MiNT-Libraries die Zeile
  127.  
  128. __EXTERN int    evnt_timer __PROTO((unsigned long Interval));
  129.  
  130. in
  131.  
  132. __EXTERN int    evnt_timer __PROTO((int Int_locount,int Int_hicount));
  133.  
  134. geändert werden.
  135.  
  136. Weiterhin muß das Makro __MINT_LIB__ definiert werden (s. E_GEMMNT.PRJ)
  137.  
  138. 2. GNU-C/Lattice C
  139.  
  140. Ebenfalls läßt sich EnhancedGEM mit GNU-C und Lattice C verwenden, wobei
  141. allerdings die MiNT-Library sowie die entsprechenden Makefiles (Makefile.GCC
  142. bzw. Makefile.LCC) benutzt werden müssen. Eventuell auftretende Warnungen bei
  143. der Übersetzung sind (hoffentlich) bedeutungslos.
  144.  
  145. WICHTIG:
  146. --------
  147. Wurde EnhancedGEM mit Hilfe der MiNT-Libraries übersetzt, so MÜSSEN die
  148. MiNT-Libraries und die dazugehörigen Header-Dateien auch benutzt werden.
  149. Ansonsten sind die Reaktionen nicht vorhersehbar, aber höchstwahrscheinlich
  150. resultieren daraus Fehlfunktionen (außer evtl. bei GNU-C).
  151.  
  152.  
  153. Durch das beiliegende kommentierte Beispielprogramm, das einen Teil der Fähig-
  154. keiten demonstriert, sowie die veröffentlichten Quelltexte der WinLupe sollte
  155. die Programierung unter Verwendung der Library kein größeres Problem dar-
  156. stellen.
  157.  
  158. Weiterhin sollte die Verwendung der einzelnen Funktionen aus den Quelltexten
  159. bzw. dem Namen oder ähnlichen Libraries ersichtlich sein. Sollte jemand den-
  160. noch nicht damit zurechtkommen, so kann er sich an mich wenden.
  161.  
  162. Verbesserungen an den Quelltexten sollten immer an mich eingesandt werden,
  163. damit die Library einheitlich bleibt und nicht verschiedene Versionen im
  164. Umlauf sind. Für den privaten Gebrauch kann die Library natürlich nach
  165. Belieben verändert werden, wobei ich mich natürlich über jede Verbesserung
  166. bzw. Vorschlag freue.
  167.  
  168. Bisherige EnhancedGEM-Applikationen:
  169. ------------------------------------
  170.  - Example (kommentiertes Beispielprogramm,PD)
  171.  - WinLupe (saubere Bildschirmlupe,PD)
  172.  - LZH-Shell (Shell zu LHarc,Fairware)
  173.  
  174.  - ESS-Code (GEM-UUencoder/-decoder,Shareware) von Michel Forget
  175.  - Before Dawn (Bildschirmschoner,Shareware) von Arne Rudolph
  176.  - PLZ (Postleitzahlenkonvertierer,PD) von Andreas Schrell
  177.  - DB-Log (Loginstatistik-Programm zur D-Box,PD) von Arne Konopinski
  178.  - PassThru (Desktoperweiterung,PostCardWare) von Florian Erhard
  179.  - 800XL Deejay (800XL-Laufwerksemulator,PD) von Kolja Koischwitz
  180.  - ACP (Another Crude Player,Freeware) von Carsten Tolkmit
  181.  - Thor (GEM-Variante des Spiels Thor,Shareware) von Jean-Jaques Michel
  182.  
  183. in Arbeit:
  184.  - Simpl (Texteditor mit Highlighting,PD) von Frank Laus
  185.  - Laborant professionell (Chemie-Analyseprogramm,PD) von Jens Schulz
  186.