TST - TheScreenTool Deutsche Dokumentation zu TST Version 1.22 vom 10.2.1993 von Kai Rode KAI_RODE@AWORLD.ZER (Z-Netz) kai_rode@aworld.aworld.de (Usenet) TST-TheScreenTool ist Copyright ©1992,1993 bei Kai Rode Dieses Programm ist, wie der Name schon impliziert, ein Tool-Programm für Screens. Es ermöglicht das Verändern der Palette eines Screens, das Schließen des Screens, wenn das betreffende Programm abgestürzt ist, das Ausdrucken eines Screenausschnittes, sowie das Abspeichern eines Ausschnittes als IFF-ILBM-File. Dabei wird auf Wunsch das XPK-Kompressionsverfahren ange- wendet. Dabei handelt es sich um ein modulares Kompressionsverfahren, das mit verschiedenen Kompressionsbibliotheken arbeitet, die durch eine Kennung be- stehend aus vier Buchstaben gekennzeichnet sind. Beispiele: NONE - kein Algorithmus, Daten werden ungepackt gespeichert RLEN - RunLength wie im ILBM-Standard, schnell aber uneffizient NUKE - ein schneller, dabei effizienter Packalgorithmus SHRI - ein extrem langsamer, aber noch effizienterer Algorithmus Wenn XPK-Kompression gewählt wird, wird automatisch die standardmäßige RLEN- Kompression des IFF-Standards abgeschaltet. So werden bessere Resultate er- zielt, als wenn ein bereits vorgepacktes Bild (zum Beispiel abgespeichert durch ein anderes Programm) mit XPK nachbearbeitet wird. TST unterstützt die 24-Bit-Farbpaletten von OS3.0, dies konnte jedoch noch nicht getestet werden. Bitte bei Problemen eine kleine Meldung an den Autor. I. Copyright und Distribution Der Autor behält sich sämtliche Rechte an diesem Programm vor. Es wird die Er- laubnis erteilt, dieses Programm kostenfrei entweder persönlich, oder über Datenfernübertragung (auch über Datennetze) weiterzugeben. Das Programm darf in sogenannte "Public-Domain-Reihen" aufgenommen werden, dabei darf die Dis- kette, auf der sich TST befindet, nicht für mehr als DM 5.-- verkauft werden. Ausgenommen von dieser Regelung ist ausschließlich Fred Fish und seine Amiga- LibDisks. Das Programm darf nur im unveränderten Zustand und komplett mit den folgenden Dateien weitergegeben werden: TheScreenTool - Das Programm TheScreenTool.info - Das ICON TheScreenTool.dok - Die deutsche Anleitung TheScreenTool.doc - Die englische Anleitung deutsch/TST.catalog - Das deutsche Catalog-file TSTLOC.h - Das C-Headerfile mit den verschiedensprachigen Texten Dieses Programm ist GIFTWARE. Der Autor erwartet von jedem, der dieses Programm mehr oder weniger regelmäßig nutzt, ein angemessenes Geschenk. Was angemessen ist, darf jeder selbst entscheiden. Am liebsten wäre mir natürlich Geld, aber auch Sachspenden (nicht explosiv!!! :-)) werden gerne angenommen. Ich wäre auch schon über einen kleinen Brief (EMAIL bevorzugt) zufrieden. II. DISCLAIMER DER AUTOR ÜBERNIMMT FÜR DIESES PROGRAMM KEINERLEI EXPLIZITE ODER IMPLIZITE GARANTIE. EINE HAFTUNG FÜR DIREKTE, INDIREKTE ODER FOLGESCHÄDEN WIRD AUS- DRÜCKLICH ABGELEHNT. III. Hinweise Falls jemand in der Lage ist, das Programm oder seine Dokumentation in andere Sprachen zu übersetzen, so soll er das bitte tun und mir die entsprechenden Files zusenden. Die Programmtexte stehen in der Datei TSTLOC.h. Die Übersetz- ung gehört in die Kommentarzeilen, wie ich es mit den deutschen Texten vor- gemacht habe. VOR die übersetzung gehört das Länderkürzel. Verbesserungsvorschläge und Fehlerberichte werden natürlich auch gerne ent- gegengenommen. IV. Bedienung Das Programm installiert sich als Commodity. AmigaOS 2.04+ wird vorausgesetzt. Beim Aufruf werden folgende Schlüsselworte entgegengenommen: CX_HOTKEY: gibt die Tastenkombination an, mit der das Programm aufgerufen werden soll. Voreinstellung ist 'lcommand s' COMPRESSION: Wird dieses Schlüsselwort angegeben, so wird die XPK-Kompression eingeschaltet. Voreinstellung: aus COMPRESSOR: nach diesem Schlüsselwort ist das vierbuchstabige Kürzel des zu verwendenden Kompressors einzugeben. Voreinstellung: NUKE Die entsprechenden Schlüsselworte sind auch bei den Workbenchmerkmalen (Tool-Types) beim Aufruf über Workbench gültig. Bildschirm(ausschnitt) drucken: 1. TST aufrufen 2. In der Liste den Bildschirm anwählen Nur bei Markierung eines Ausschnitts: 3. 'Auswahl' betätigen 4. Linke obere Ecke des Bildschirmausschnitts anfahren, Maustaste drücken und halten 5. Rechte untere Ecke anfahren, Taste loslassen 6. Modus 'Drucken' auswählen 7. OK anwählen 8. Mit 'Verbergen' TST in den Hintergrund legen Bildschirm(ausschnitt) sichern: 1. TST aufrufen 2. In der Liste den Bildschirm anwählen Nur bei Markierung eines Ausschnitts: 3. 'Auswahl' betätigen 4. Linke obere Ecke des Bildschirmausschnitts anfahren, Maustaste drücken und halten 5. Rechte untere Ecke anfahren, Taste loslassen 6. Modus 'Sichern' anwählen 7. Ok anwählen 8. Namen und Pfad des zu sichernden Bildes auswählen 9. Filerequester mit 'OK' verlassen 10. Mit 'Verbergen' TST in den Hintergrund legen Bildschirm entfernen: 1. TST aufrufen 2. In der Liste den Bildschirm anwählen 3. Modus 'Entfernen' wählen 4. OK betätigen 5. Zur Sicherheit erscheint eine Abfrage. Beantworten sie diese positiv, wird der Schirm entfernt. ABSTURZGEFAHR!!! 6. Mit 'Verbergen' TST in den Hintergrund legen. Palette ändern 1. TST aufrufen 2. In der Liste den Bildschirm wählen 3. Modus 'Palette' wählen 4. OK betätigen 5. Farbe verändern 6. Mit Verbergen TST in den Hintergrund legen Weitere Gadgets: Neue Liste: Liste der Bildschirme aktualisieren Information: Informationen über den gewählten Bildschirm ausgeben. (Tiefe, Größe, Modus etc.) Menüs: Projekt/ Über... Informationen über das Programm Verbergen Programm in den Hintergrund legen Beenden... schaltet die Kaffemaschine an :-) XPK/ Verfahren wählen Verwendeten XPK-Packer auswählen bzw. Packen abschalten REMEMBER: A PROGRAM WORTH USING IS A PROGRAM WORTH SPREADING. V. History V1.22 10.2.1993 Bugfixes : Vorhergehende Reparaturen wurden nur benutzt, wenn nicht XPK-gepackt wurde. AUA! V1.21 27.1.1993 Bugfixes : Tippfehler in der ILBM-Erkennung beseitigt (& <-> &&) V1.2 17.1.1993 Bugfixes : Benutzung von PublicScreens klappt jetzt (gemeldet von Ch.Teuber) Läuft korrekt mit Interleaved Screens (OS3.0) (gemeldet von Ch.Teuber und M.Schulze) Erweiterungen: korrekte Übernahme von 24-Bit-Farbregistern Wenn gewünscht, wird das TST-Fenster bei der Bereichsauswahl geschlossen (zufrieden, Christoph?) V1.1 9.1.1993 Bugfixes: Übernahme von 24-Bit-Farben klappt jetzt teil- weise Speicherpfad wurde bisher ignoriert Bildschirm mit dem TST-Fenster wurde nach der Ausschnittsauswahl nicht wieder nach vorne ge- holt Erweiterungen: Wenn kein Ausschnitt gewählt wurde, wird jetzt der ganze Schirm bearbeitet (Vor- schlag von Ch.Teuber) TST öffnet sich jetzt auch auf öffentlichen Schirmen (Ch.Teuber) Das TST-Fenster geht beim Abspeichern in den Hintergrund, damit es nicht aufs Bild kommt (Ch.Teuber) V1.01 7.1.1993 Bugfixes: NumColors in IFF-File Schleifenvariabe für Farben von UBYTE auf UWORD Zwischenfile wurde gelöscht, auch wenn Packen nicht möglich war V1.0 6.1.1993 Erste veröffentlichte Version VI. Inkompatiblitäten TST ist nicht kompatibel mit dem bekannten FD-Programm 'TurboLayers'. Dies ist nict meine Schuld, da TurboLayers verbotenerweise das Feld BitMap->BytesPerRow verdoppelt, wodurch die Speicherroutine nur noch Müll speichert. VII. Credits Danke an Ch.Teuber, M.Balzer und M.Schulze für ihre Unterstützung. Addresse des Autors: Kai Rode | KAI_RODE@AWORLD.ZER (Z-Netz) Schwarzbach 118 | kai_rode@aworld.aworld.de (Usenet) 5600 Wuppertal 2 | Germany |