

   SmartIcon 1.0
   ~~~~~~~~~~~~~~


   Copyright © 1988 Gauthier H. Groult
   Programmiert von Gauthier H. Groult im Januar 1988

   Anschrift:           Gauthier H. Groult
                        33, Boulevard Saint Denis
                        92400 Courbevoie, France, Europe
   Email:               seismo!mcvax!inria!geocub!itecom!groult

   Hiermit wird jedermann erlaubt, das Programm für NICHT-KOMMERZIELLE
   Zwecke zu verbreiten, so lange diese Erläuterung mitgeliefert wird.

   Dieses Programm ist "SHAREWARE". Bitte lies den Abschnitt
   "Registrierung", bevor Du das Programm in Deine Startup-Sequence
   einbindest.



   INHALT
   ------

   Diese Erläuterung ist in 4 Abschnitte unterteilt:

            1. Merkmale und Installation
            2. Programmfehler
            3. Registrierung
            4. Vorschau auf Folgeversionen



   1. MERKMALE UND INSTALLATION
   ----------------------------

   SmartIcon 1.0 ist ein "Intuition-Objekte-Iconifizierer". Version 1.0
   ist auf Windows beschränkt.
   Das Hauptmerkmal dieses Programmes ist die Möglichkeit, ein Window
   in ein Icon umzuwandeln, indem dem Window ein Gadget zugeordnet wird,
   das lediglich angeklickt werden muß, um das Window umzuwandeln.
   Das so erstellte Icon ist ein richtiges Workbench-Icon, das in der
   RAM-Disk abgelegt wird. Das Icon bietet nun die üblichen Vor- und
   Nachteile regulärer Workbench-Icons.
   SmartIcon läuft im Hintergrund. Das Programm, das im umgewandelten
   Window abläuft, merkt nicht einmal, daß sein Window nicht mehr
   auf dem Bildschirm ist. Das funktioniert deshalb, weil (fast) alle
   dem Window zugänglichen Ressourcen geöffnet und zugriffsbereit bleiben,
   nachdem das Window umgewandelt wurde.

   SmartIcon wandelt selbst Windows mit "kniffligen" Grafiken wie
   das Box-Demo-  oder Dots-Demo-Window um.

   Um das Programm aufzurufen, brauchst Du es nur anzuklicken. Anschließend
   klickst Du das erscheinende Window an.
   Sofort werden alle offenen (und auch die später erscheinenden) Windows
   mit Gadgets versehen.

   Um ein Window nun umzuwandeln, mußt Du nur dieses Gadget anklicken, und
   in der RAM-Disk wird ein Icon angelegt, während das Window verschwindet.
   Klicke nun einfach dieses Icon in der RAM-Disk zweimal an, und Dein
   Window taucht wieder auf, während das Icon gelöscht wird.

   SmartIcon kann sowohl von der Workbench als auch vom CLI gestartet
   werden. Wenn Du es vom CLI aus startest, kannst Du ein Argument mit
   angeben:

         SmartIcon -f

   lädt das Programm, ohne das Startup-Window darzustellen. Das ist dann
   nützlich, wenn Du das Programm in Deine Startup-Sequence einbindest
   (nachdem Du registriert bist!).

   Einmal geladen, kann SmartIcon mittels CTRL-C oder BREAK-C wieder
   entfernt werden. Das bedeutet, daß Du es nicht entfernen kannst,
   wenn Du es von der Workbench aus aufgerufen hast!
   Du kannst SmartIcon sogar dann entfernen, wenn Du noch einige umgewandelte
   Windows in der RAM-Disk hast. Auch in diesem Falle hast Du die
   Möglichkeit, die Windows wieder zu öffnen.

   SmartIcon arbeitet auch mit DropCloth und Dropshadow gut zusammen.

   Für Entwicklungszwecke: Dein Task erhält eine GADGETUP-Nachricht
   mit der Codenummer 11.366, wenn sein Window umgewandelt wurde.

   Was Du NICHT tun solltest:
   --------------------------

      1. Wandele nicht das RAM-Disk Window um, denn in diesem Falle wärest
         Du nicht mehr in der Lage, auf die dort enthaltenen Icons zurück-
         zugreifen, und die Dateien würden nicht mehr vom CLI aus laufen.

      2. Rufe bei umgewandelten Windows (= Icons) nicht die Workbench-
         Funktion DISCARD auf: Du könntest das Window nicht wiederher-
         stellen.



   2. Programmfehler
   -----------------

   Version 1.0 von SmartIcon weist einige Eigenheiten auf, die als Programm-
   fehler bezeichnet werden können.

   Das erste Problem stellt ein Systemfehler dar: Die Workbench aktualisiert
   die Icons nicht, wenn eine Datei entfernt oder hinzugefügt wird, solange
   man nicht das Window geschlossen und wiedergeöffnet hat. Deshalb sieht
   man auch das in ein Icon umgewandelte Window nicht, wenn es umgewandelt
   wurde und gleichzeitig das RAM-Disk-Window geöffnet war. Das ist auch
   der Grund dafür, daß das Icon des umgewandelten Windows auch dann noch
   in der RAM-Disk sichtbar bleibt, wenn man das Window wiederherstellt.

   SmartIcon wandelt nur Windows mit Vorder-/Hintergrund-Gadgets um. Es
   hat keinen Einfluß auf Windows ohne diese Gadgets wie z.B. DropCloth.

   Das Window der RAM-Disk kann auch umgewandelt werden: Dies zu tun, kann
   peinlich werden.

   Manche Windows mit Vorder-/Hintergrund-Gadgets werden nicht korrekt
   mit dem Umwandlungs-Gadget versehen. Das geschieht zum Beispiel beim
   Window "System Request" (da schau her!). Der Grund dafür ist mir bis
   jetzt noch unbekannt. Es sieht so aus, als würden diese Windows nicht
   mit einem regulären Intuition-Aufruf geöffnet, sondern durch einen
   direkten Sprung an eine absolute Adresse.

   Einige wenige Windows verursachen beim Umwandeln einen Systemabsturz.
   Das kommt sehr selten vor, und der Grund dafür ist ebenfalls unbekannt.
   Ein gutes Beispiel ist das NewZap Window.
   Auch das Umwandeln von Programmen, die regen Gebrauch von Intuition
   oder Layern machen, kann das System oder SmartIcon zum Absturz bringen.
   Obwohl ich weiß, daß das möglich ist, ist es mir aber noch nicht
   vorgekommen. Es scheint so, daß die meisten AMIGA-Programme "sauber"
   sind, was ich großartig finde.

   Das Programm untersucht momentan noch nicht den Inhalt der RAM-Disk.
   Deshalb können Windows mit gleichem Namen auch Dateien in der RAM-
   Disk überschreiben. Das ist ebenfalls unerfreulich.

   Ein kleiner Fehler führt zur Überschreibung des Umwandlungs-Gadget, wenn
   ein Window sehr klein gemacht wird und der Titel länger ist als die
   Titelzeile. Dabei handelt es sich lediglich um einen Darstellungs-
   fehler, der keinen Einfluß auf den Programmablauf hat. Bei erneuter
   Vergrößerung des Windows wird das Umwandlungs-Gadget automatisch wieder
   hinzugefügt.




   3. REGISTRIERUNG
   ----------------

   SmartIcon ist KEIN Gratisprogramm. Es handelt sich um SHAREWARE, und
   wird zu einem Preis von 15 bis 20 Dollar bzw. 100 bis 120 Französischen
   Franc angeboten (oder auch beliebig mehr !).
   Wenn Du beabsichtigst, dieses Programm zu BENUTZEN oder zu BEHALTEN,
   dann überweise bitte Deinen Registrierungsbeitrag an die am Anfang der
   Erläuterungen genannte Adresse.

   Sofern Du das tust, wirst Du:

      1. Zugriff auf den Quellcode und technische Informationen erhalten.
         Die detaillierten und ausführlich kommentierten Quelldateien
         beinhalten Überschriften wie z.B.
               a) Intuition list browsing
               b) Layers
               c) Intuition and Exec libraries traps
               d) Icon library
               e) Workbench and CLI arguments
               f) Coding binary files in C
               g) Lists management
               und mehr...
         Alle Quelldateien sind für den Lattice C Compiler und MC68000
         ausgelegt.
         Die Quelldateien werden Dir UNMITTELBAR bei erhalt Deiner
         Registrierung zugesendet.

      2. eingetragen für kostenlose zukünftige Folgeversionen von SmartIcon.
         Lese den nächsten Abschnitt, um eine Beschreibung der zu erwar-
         tendemn Folgeversionen zu erhalten.

      3. die Entwicklung von (guter) AMIGA-Software unterstützen.

      4. die nächsten, ähnlichen Programme als Gratisprogramme erhalten.

   Möglicherweise denkst Du dir, daß der Beitrag höher ist als bei
   gewöhnlichen Shareware-Programmen. Bedenke dabei aber bitte, daß
   die Benutzerunterstützung in den meisten Fällen auch mindestens zwei
   Postsendungen nach Übersee beinhaltet.


   4. VORSCHAU AUF FOLGEVERSIONEN
   ------------------------------

   Ich beabsichtige, in die nächsten Versionen viele Zusatzmöglichkeiten
   einzubauen. Version 2.0 wird beinhalten:

      1. Eine Fehlerkorrektur bei den Windows, die von Version 1.0
         noch nicht umgewandelt werden können (ich WILL, daß auch
         diese Windows umgewandelt werden können!!), sowie zusätzlich
         einige andere Fehlerkorrekturen.

      2. Die vom Benutzer wählbare Möglichkeit, auch an die Windows
         Vorder-/Hintergrund-Gadgets anzufügen, die diese Gadgets
         normalerweise nicht besitzen (ich WILL, daß auch dieses
         DropCloth umgewandelt werden kann!!).

      3. Die Möglichkeit, auch komplette Intuition-Screens umzuwandeln.

      4. Die Möglichkeit, einen vom Benutzer definierten Pfad anzugeben,
         in dem dann die umgewandelten Windows und Screens abgelegt werden
         können.

      5. Eine frei wählbare Länge der Windownamen.

      6. Vielleicht etwas Programmcode, um einen Workbench-Update durch-
         zuführen, falls das unter Betriebssystem 1.3 möglichg sein
         sollte (kannst Du das lesen, Dale?).

      7. Kürzeren und schnelleren Programmcode.

      8. Bessere Speicherausnutzung.

      9. Hübschere Benutzerführung.

Alle Vorschläge, Kommentare und Spenden sind willkommen. Bitte tu Dir keinen
Zwang an und schreib mir!

Besonderen Dank an jeden Programmierer, der PublicDomain-Software schreibt.
Ich fühle, daß das, was auf dem AMIGA in Sachen PublicDomain vor sich geht,
einfach wunderbar ist. Und darüber hinaus war es sehr nützlich für mich.
