Mausweg (Commodity) von Stefan Sticht Dieses Programm, Quellcode und Dokumentation sind PUBLIC DOMAIN. Sie können damit machen, was Sie wollen! Der Zweck dieses Commodities: ----------------------------- Mausweg ist ein Commodity, das den Mauspfeil verschwinden läßt, wenn die Maus eine bestimmte Zeit nicht mehr bewegt wurde oder wenn eine bestimmte Anzahl von Tasten der Tastatur gedrückt wurde. Der Pfeil erscheint wieder, sobald Sie die Maus bewegen. Damit soll verhindert werden, daß der Mauspfeil Informationen verdeckt. Bei Mausweg koennen Sie folgendes Einstellen: - die Zeitspanne, nach der der Mauspfeil verschwinden soll - eine Anzahl von Tastendrücken, nach denen der Mauspfeil verschwin- den soll - eine Zeit, nach der der Mauspfeil wieder verschwinden soll - eine Tastenkombination, mit der das Fenster von Mausweg geöffnet wird - die Priorität von Mausweg innerhalb der Liste der Commodities - ob beim Start von Mausweg sofort das Fenster geöffnet werden soll Eine genaue Erläuterung finden Sie weiter unten. Systemanforderungen: -------------------- Dieses Commodity erfordert mindestens Kickstart 37.* und Workbench 37.*, sowie die commodities.library ab Version 37.*. Bitte überprüfen Sie dies: Rufen Sie im Menü der Workbench unter "Workbench" den Menüpunkt "About" auf. Sie bekommen eine Meldung folgender Art: Kickstart Version ww.xxx Workbench Version yy.zzz Wenn Sie dieses Menü und den Menüpunkt nicht finden, dann haben Sie ein Betriebssystem vor Version 2.0. Unter diesen Versionen ist es nicht möglich, Mausweg zu benutzen. Bekommen Sie eine Meldung der obigen Art, so vergewissern Sie sich bitte, daß dort für ww und yy 37 oder höher steht. Und so startet man ein Commodity: --------------------------------- Es gibt grundsätzlich zwei verschiedene Arten, ein Commodity zu starten: von der Workbench oder von der Shell aus. Das Starten von der Workbench aus ist äußerst einfach: Machen Sie einen Doppelklick auf dessen Icon und das Commodity wird gestartet. Eventuell wollen Sie verschiedene Parameter eines Commoditys ändern. Dazu benutzen Sie Tool-Types. Tool-Types ändern Sie, indem Sie das Commodity Icon einmal anklicken und im Menü der Workbench Information aufrufen. In dem Fenster, daß sich öffnet, sehen Sie die Liste der Tool-Types. Wie Sie die Tool-Types ändern, lesen Sie bitte in Ihrer Workbench-Dokumentation nach. Welche Parameter Sie für dieses Commodity ändern können, wird später beschrieben. Bitte beachten Sie, daß ein weiterer Doppelklick auf das Icon des Commoditys, während es bereits läuft, bewirkt, daß das Commodity sein Fenster öffnet. Da es nicht sinnvoll wäre Mausweg zweimal zur gleichen Zeit laufen zu lassen, ist dies auch nicht möglich. Wenn Sie die Tool-Types in irgendeiner Weise verändern, nachdem Mausweg gestartet wurde, wird ihm diese Veränderung nicht mitgeteilt. Sie müssen ein bereits laufendes Mausweg verlassen und neu starten. Um ein Commodity in der Shell zu starten, geben Sie dessen Namen ein. Sollten Sie die Fehlermeldung "Unknown command ???" erhalten, haben Sie sich beim Commodity-Namen vertippt oder das Commodity befindet sich nicht in ihrem aktuellen Verzeichnis bzw. dem aktuellen Suchpfad. Am einfachsten ist es, das aktuelle Verzeichnis mit dem Befehl "CD" dorthin zu ändern, wo das Commodity sich befindet. Sie können die Parameter eines Commodity mit Befehlsoptionen ändern. Die verfügbaren Optionen können Sie sich anzeigen lassen, indem Sie ein ? als ersten Parameter angeben: Mausweg ? gibt Ihnen eine Liste der Befehlsoptionen. Die Erklärung jeder Option erfolgt später. Startet man das Commodity, während es bereits läuft, erreicht man wiederum, daß es sein Fenster öffnet. Dabei wird keine der angegebenen Befehlsoptionen berücksichtigt. Wenn Sie wünschen, daß das Commodity bei jedem Boot-Vorgang gestartet wird, sollten Sie folgende Zeile in Ihre User-Startup Datei einfügen: Mausweg Vergessen Sie bitte nicht für den tatsächlichen Pfad zum Commodity und für die gewünschten Befehlsoptionen anzugeben. Folgendes Beispiel startet Mausweg, wenn es sich im Schubladen Tools der Boot-Diskette befindet, so daß der der Mauspfeil nach fünf Minuten verschwindet: Tools/Mausweg SEKUNDEN=5 Eine andere Möglichkeit, um das Commodity bei jedem Booten zu starten, ist, das Icon von Mausweg in den Schubladen WBStartup der Boot-Diskette (Workbench) zu verschieben. Das Commodity wird dann bei jedem Boot-Vorgang gestartet, als hätten Sie einen Doppelklick auf das Icon durchgeführt. Allerdings müssen Sie im Icon das Tool-Type DONOTWAIT ergänzen. Benutzung von Exchange: ----------------------- Exchange ist das Programm, mit dem Commodities verwaltet werden. Starten Sie Exchange, das sich für gewöhnlich im Utilities Schubladen Ihrer Boot-Diskette befindet, mit einem Doppelklick auf dessen Icon. Es wird Ihnen nun eine Liste aller verfügbaren Commodities angezeigt, aus der Sie das entsprechende Commodity auswählen können. Unter dieser Liste wird nach Auswahl eines Commodities automatisch desen Titel, Beschreibung und Status angezeigt. Sie können nun Commodities völlig beenden mit "Kill", vorübergehend ausschalten mit "Disable" und wieder einschalten mit "Enable". Wenn das Commodity ein Fenster öffnen kann, indem für gewöhnlich Parameter eingestellt werden, können Sie dieses Fenster mit "Show" öffnen lassen und mit "Hide" schließen lassen. Veränderbare Parameter: ----------------------- CX_Priority: ------------ Mit dem Tool-Type oder der Befehlsoption CX_PRIORITY= können Sie die Priorität des Commodities innerhalb der Liste der Commodities bestimmen. Setzen Sie für bitte einen dezimalen Wert ein. Die voreingestellte Priorität ist 0. Es sollte nicht notwendig sein, diese Option zu benutzen. Sekunden: --------- Mit der Befehlsoption bzw. dem Tool-Type Sekunden= können Sie die Sekunden einstellen, die seit der letzten Mausbewegung verstreichen müssen, damit der Mauspfeil verschwindet. ersetzen Sie bitte durch einen positiven dezimalen Wert. Sekunden=0 schaltet diese Option aus. Voreingestellt sind 3 Sekunden. Wenn Sie Mausweg bereits gestartet haben, so können Sie die Anzahl der Sekunden auch in einem Fenster einstellen, das Sie mit Exchange öffnen können. Starten Sie Exchange, wählen Sie aus der Liste der Commodities Mausweg, und drücken Sie den "Show" Schalter. Jetzt hat sich das Fenster von Mausweg geöffnet. Hier können Sie die Sekunden ändern, das Fenster wieder verschwinden lassen mit "Verstecken" oder Mausweg beenden mit "Beenden". Tastendruecke: -------------- Mit der Befehlsoption bzw. dem Tool-Type TASTENDRUECKE= können Sie einstellen, nach wieviel Tastendrücken der Mauspfeil verschwinden soll. Wählen Sie hierfür z.B. 5, so verschwindet der Mauspfeil, nachdem sie fünf mal eine Taste losgelassen haben. Die Betonung liegt hierbei auf Losgelassen, nur dieses zählt. TASTEBDRUECKE=0 schaltet diese Option aus. Voreingestellt ist 5. Diese Option können Sie auch im Fenster von Mausweg ändern. Wiederholung: ------------- Mit der Befehlsoption bzw. dem Tool-Type WIEDERHOLUNG= können Sie einstellen, nach wie vielen Sekunden der Mauspfeil wieder verschwinden soll. Wurde der Mauspfeil von Mausweg weggemacht, so kann er wieder erscheinen, indem ein anderes Fenster aktiviert wird, ohne dazu die Maus zu bewegen, oder ein anderer Mauspfeil installiert wird. Mausweg kann dieses leider nicht feststellen und befindet sich in dem Irrtum, der Mauspfeil wäre versteckt. Als Lösung für dieses Problem wird einfach der Mauspfeil, wenn er einmal von Mausweg weggenommen wurde, nach einer bestimmten Zeit wieder weggenommen, egal ob er inzwischen wieder sichtbar war oder nicht. Für diese Zeitspanne sind 2 Sekunden voreingestellt. Da dieser Mechanismus natürlich Rechenzeit kostet, können Sie mit WIEDERHOLUNG=0 diese Option ausschalten, wenn es Sie nicht stört, ab und zu mal die Maus zu bewegen, um den Mauspfeil dann wieder verschwinden zu lassen. Eine Erhöhung dieser Zeitspanne spart natürlich auch Rechenzeit ein. Diese Option können Sie derzeit nur beim Start von Mausweg per Tool-Type oder Befehlszeilenoption bestimmen. CX_Popkey: ---------- Mit CX_Popkey= können Sie ein Tastaturkürzel bestimmen, mit dem Sie das Fenster von Mausweg öffnen können. Bitte ersetzen Sie durch eine Eingabebeschreibung, wie sie unten erklärt wird. Wenn Sie diese Option weglassen, wird kein Tastaturkürzel installiert. Voreingestellt ist "kein Kürzel". Beispiele: CX_POPKEY=f1 (F1 öffnet das Fenster) "CX_POPKEY=lshift f1" (linke Shift-Taste und F1) "CX_POPKEY=alt m" (eine Alt-Taste und die Taste M) CX_Popup: --------- Mit CX_POPUP=JA|NEIN können Sie bestimmen, ob beim Start von Mausweg dessen Fenster geöffnet werden soll. JA|NEIN heißt, Sie können entweder JA oder NEIN einsetzen, aber nichts anderes. Voreingestellt ist NEIN. Eingabebeschreibungen --------------------- (input description strings) Mit Eingabebeschreibungen können Sie jede Tastenkombination der Tastatur und der Maus beschreiben, z.B. das Drücken der Taste F1, Shift-F1 oder Alt-F1 oder das Drücken der linken Maustaste zusammen mit Alt etc. Darueberhinaus sind einige andere Ereignisse abfragbar. Eingabebeschreibungen haben folgendes Muster: [class] (([-]qual)|syn)* [[-]upstroke] [highmap|ANSIcode] (* bedeutet keine oder mehrere Vorkommen des Ausdrucks in Klammern) class ("Klasse") ist einer der folgenden Ausdrücke: rawkey, rawmouse, event, pointerpos, timer, newprefs, diskremoved, diskinserted. Wenn die Klasse nicht bestimmt wird, wird rawkey angenommen. qual ("Qualifizierer") ist einer der folgenden Ausdrücke: lshift, rshift, capslock, control, lalt, ralt, lcommand, rcommand, numericpad, repeat, midbutton, rbutton, leftbutton, relativemouse Ein vorangestelltes "-" bedeutet, daß der folgende Qualifier als irrelevant angenommen werden soll. syn ("Synonym") ist einer dieser Ausdrücke: shift, caps, alt shift bedeutet linke oder rechte Shift-Taste caps bedeutet Shift oder Caps-Lock alt bedeutet linke oder rechte Alt-Taste upstroke (wörtlich "upstroke") Wenn dieser Ausdruck fehlt, zählt das Drücken einer Taste für die Klassen rawmouse und rawkey. Wenn der Audruck vorhanden ist, zählt das Loslassen einer Taste. Stellt man ein "-" voran, so zählt beides. highmap ist einer der folgenden Ausdrücke: comma, space, backspace, tab, enter, return, esc, del, up, down, right, left, help, f1, f2, f3, f4, f5, f6, f7, f8, f9, f10, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, (, ), /, *, -, + ansicode ein einzelnes Zeichen steht genau für die entsprechende Taste Noch einige Beispiele: ---------------------- Mausweg sekunden=10 Mausweg sekunden=5 "cx_popkey=ctrl 1" cx_popup=ja Mausweg sekunden=15 "cx_popkey=help" Mausweg sekunden=15 tastendruecke=20 "cx_popkey=lalt m" Mausweg sekunden=5 tastendruecke=2 wiederholung=1 Versionengeschichte: -------------------- V1.20 kleiner Fehler wurde behoben V1.19 ein paar kleine Veränderungen, um das Programm kleiner zu machen V1.18 Fenster wird nun auf dem vordersten Screen geöffnet, sofern dieser öffentlich ist. Ist er dies nicht, wird das Fenster wie gehabt auf dem default public screen geöffnet. Enforcer-Hit bei Speichermangel wurde entfernt. V1.17 interne Änderungen V1.16 interne Änderungen V1.15 "Maus-Blanking"-Methode wurde gewechselt; leider habe ich immer noch nicht DIE "saubere" Methode gefunden; Blanken nach einer Anzahl von Tastendücken wurde hinzugefügt; viele kleinere Änderungen V1.14 SAS/Cs cback.o wurde für 68040-Kompatibilität von mir nach Instruktionen von Michael Sinz geändert; Mausweg wurde mit diesem cback.o neu gebunden Schicken Sie Fehlerreports, Erweiterungswünsche, Fragen und ----------------------------------------------------------- Geschenke an: ------------ Stefan Sticht Bibereckerweg 40a D-8390 Passau 18 FRG oder (besser) an eine der folgenden EMail-Adressen: cbmvax.commodore.com!cbmehq!cbmger!edith!sticht oder IWSTICHT@ibm.rz.uni-passau.de Fido-Netz: Stefan Sticht (2:242/77:4) Bitte nennen Sie bei einem Fehlerreport auch die Versionsnummer. Diese erhalten Sie z.B. mit dem Befehl "Version": Version []