17 Bit Software 2: Collection B

home *** CD-ROM | disk | FTP | other *** search

/ 17 Bit Software 2: Collection B / 17Bit_Collection_B.iso / files / 2254.dms / in.adf / docs / SMaus.doc.pp / SMaus.doc

Wrap

Text File | 1990-09-13 | 22.9 KB | 463 lines

Dokumentation zu SMaus Copyright © 1991 Stefan Sticht Nutzungs- und Vertriebsbestimmungen SMaus ist nicht Public Domain, sondern Shareware. Wenn Sie SMaus benutzen, bitte ich Sie, Ihre Kopie von SMaus für derzeit DM 5.- registrieren zu lassen. Für weitere DM 5.- können Sie jederzeit bei mir eine Diskette mit der neuesten Version von SMaus und vielen anderen Programmen von mir bestellen. Zum Registrieren drucken Sie bitte die Datei Registrierung aus. Sie können dies tun, indem Sie das Piktogramm des Programmes Printfiles im Schubladen Tools Ihrer Extras2.0-Diskette einmal anklicken, die Shift-Taste gedrückt halten und einen Doppelklick auf das Piktogramm Registrierung machen. Schicken Sie mir bitte dieses Formular ausgefüllt und mit einem Scheck, Bargeld oder einer separaten Postanweisung zu. Vielen Dank. Die Nutzung von SMaus erfolgt auf eigene Gefahr. Weder der Autor noch irgendein Distributor haftet für irgendwelche Schäden, die durch dieses Programm verursacht werden. Sie dürfen SMaus so oft kopieren und weitergeben, wie Sie wollen, solange Sie immer alle Dateien zu SMaus weitergeben und diese unverändert lassen und solange dies unentgeltlich oder nur gegen eine geringe Auwandsentschädigung geschieht. SMaus darf über Mailboxen oder elektronische Datennetze vertrieben werden, solange dies ebenfalls unentgeltlich geschieht. SMaus darf als Beigabe zu kommerziellen Produkten nur mit der schriftlichen Genehmigung des Autors vertrieben werden. Diese Genehmigung erhalten Sie in der Regel durch ein vollwertiges Exemplar des Produktes für den Autor und einen Hinweis auf den Shareware-Status von SMaus in der Dokumentation des Produktes. Eine Vertrieb von SMaus als eigenständiges kommerzeilles Produkt ist ausnahmslos untersagt. Beschreibung von SMaus SMaus soll das Programm Autopoint, welches im Rahmen von AmigaOS 2.0 ausgeliefert wird, ersetzen. Das primäre Ziel ist wie bei Autopoint, das Fenster unter dem Mauspfeil zu aktivieren. Es gibt mehrere Aktionen, die eine Aktivierung veranlassen: Mausbewegung: Nach oder bei einer Mausbewegung wird das Fenster unter dem Mauspfeil aktiviert. Sie können Einstellen, bis zu welcher Geschwindigkeit der Mausbewegung Fenster sofort aktiviert werden sollen. Im Extremfall wird das Fenster unter dem Mauspfeil erst nach dem Stillstand der Maus aktiviert, um das lästige "Hüpfen" des Mauspfeiles beim Bewegen über Fenstergrenzen hinweg zu verhindern. Dieses Hüpfen wird durch das Einfärben des Fensterrahmens verursacht. Hat man einen schnelleren Rechner, z.B. Amiga 3000, so kann man das Fenster auch sofort aktivieren lassen, da sich hier das "Hüpfen" kaum bemerkbar macht, zumindest nicht bei langsamen Mausbewegungen. Zeit: Leider kann sich SMaus, wie auch Autopoint, nicht vom Betriebssystem informieren lassen, ob ein neues Fenster geöffnet wurde oder ob der Bildschirm gewechselt wurde. Deswegen müssen SMaus und Autopoint in regelmäßigen Abständen prüfen, ob dies der Fall ist. Diese Technik nennt man "pollen" und ist auf einem Multitaskingsystemen wie dem Amiga unerwünscht, da sie unnötige Rechenzeit verbraucht. Da aber immer das Fenster unter dem Mauspfeil aktiv bleiben soll, muß geprüft werden, ob vielleicht ein anderes Fenster geöffnet und aktiviert wurde, welches nicht unter dem Mauspfeil ist, ebenso ob der Bildschirm gewechselt wurde. Bei SMaus können Sie zumindest die Zeitabstände, nach denen geprüft wird, einstellen. Sie können die Überprüfung ganz ausschalten oder die Zeitintervalle vergrößern, um den Rechenzeitverbrauch zu senken. Mit einem annehmbaren Zeitintervall benötigt SMaus deutlich weniger Rechenzeit als Autopoint. Durch die Option "Aktivieren auf Tastendruck" ist dieses Zeitintervall auch ohne größere Einschränkung sehr groß wählbar. Tastendruck: Auf Wunsch aktiviert SMaus bei einem beliebigen Tastendruck das Fenster unter dem Mauspfeil. Mausbewegung über Tastatur: SMaus erkennt auch Mausbewegungen, die über einer der beiden Amiga-Tasten zusammen mit einer Cursortaste vorgenommen werden. SMaus aktiviert in diesem Fall das Fenster nach dem Stillstand des Mauspfeiles. Sehr oft ist es aber auch unerwünscht, daß das Fenster unter dem Mauspfeil aktiviert wird. Folgende Optionen verhindern, daß SMaus ein Fenster aktiviert: Fenstertitel: Sie können Titel von Fenstern angeben, die nicht deaktiviert werden sollen. Titel können dabei mit Jokern (Wildcards) versehen werden. Sie können z.B. bestimmen, daß Fenster, deren Titel mit den Buchstaben "Arq" beginnen, nicht deaktiviert werden sollen, da es sich dabei um Requester handelt, die Sie gerne sofort mit der Tastatur beantworten möchten. Bildschirmtitel: Sie können Titel von Bildschirmen angeben, auf denen SMaus generell funktionslos bleiben soll. Auch hier können Sie wieder Joker einsetzen. Aktives Texteingabefeld: Fenster mit einem aktiven Texteingabe- feld werden auf Wunsch nicht deaktiviert. Systemrequester: werden nicht deaktiviert, solange Sie nicht ein Programm wie Arq benutzen, welches Systemrequester ver- ändert. Wollen Sie, daß Fenster zwar bei einem Tastendruck nicht deaktiviert werden sollen, aber bei Mausbewegungen schon, so können Sie auch dies einstellen. Bereits aktive Fenster werden natürlich nicht noch einmal aktiviert. SMaus hat ein Fenster, in dem alle Einstellungen verändert werden können. SMaus ist systemkonform programmiert. Es werden keine Betriebs- systemroutinen verändert. SMaus wurde auf einem Amiga 3000 mit SAS/C entwickelt und unter Benutzung von Enforcer und Mungwall getestet. Systemanforderungen SMaus benötigt AmigaOS 2.0, mindestens Kickstart V37.175. Diese Version wird auch als AmigaOS 2.04 bezeichnet. Machen Sie einfach folgendes: Rufen Sie den Menüpunkt About der Workbench auf. Es öffnet sich ein Requester, der Ihnen die Version Ihrer Kickstart und Workbench verrät. Steht bei Kickstart eine Versionsnummer kleiner als 37.175, so sollten Sie sich unbedingt die neueste Kickstart besorgen, und nicht nur, um SMaus testen zu können. Kickstart und Workbench 2.04 sind im Fachhandel (zumindest demnächst) erhältlich. So starten Sie SMaus Bevor Sie SMaus testen, vergewissern Sie sich bitte, daß Sie das Programm Autopoint nicht auch benutzen. Starten Sie das Programm Exchange, das Sie üblicherweise im Schubladen Utilities Ihrer Systemdiskette finden. In dem Fenster, das Exchange öffnet -- eventuell müssen Sie erst das von Ihnen eingestellte Tastaturkürzel für Exchange drücken, im Zweifelsfalle starten Sie Exchange ein zweites Mal, dann sollte sich das Fenster auf alle Fälle öffnen -- durchsuchen Sie die Liste der Commodities nach einem Programm namens Autopoint. Finden Sie dieses Programm, so wählen Sie es aus und drücken den Schalter "Disable", um es vorübergehend auszuschalten. SMaus starten Sie einfach durch einen Doppelklick auf sein Piktogramm. Wenn Sie die Optionen von SMaus noch nicht geändert haben, so öffnet sich nach dem Start sofort dessen Fenster. Sie können das Fenster auch mit Hilfe von Exchange oder durch nochmaliges Starten von SMaus jederzeit öffnen. Starten Sie SMaus ein zweites Mal, so informiert SMaus die erste Kopie im Speicher, es solle sein Fenster öffnen und endet wieder. Sie können SMaus natürlich auch über die Shell starten, am besten mit Run >NIL: <Pfad>SMaus wobei Sie für <Pfad> den Pfad zu SMaus, z.B. dh0:Tools/ ein- setzen. Nun eine Beschreibung der Optionen von SMaus. Am besten testen Sie die Wirkung der Optionen sofort: Die verschiedenen Optionen Aktivierungsschwelle: Im Fenster von SMaus finden Sie ganz oben einen Schieberegler für die Aktivierungsschwelle. Sie gibt an, unter welcher Geschwindigkeit der Mausbewegung das Fenster unter der Maus aktiviert werden soll. Die Geschwindigkeit wird in Pixel/Event angegeben, da SMaus nur feststellen kann, daß sich der Mauspfeil um so und soviel Punkte horizontal und/oder vertikal bewegt hat. Bewegen Sie die Maus schnell, ist die horizontale/vertikale Bewegung dementsprechend groß und der von SMaus festgestellte Wert Pixel/Event ebenso. Stellen Sie 0 Pixel/Event ein, so wird erst nach dem Stillstand der Maus das Fenster unter dem Mauspfeil aktiviert. Dieser Wert ist voreingestellt. Stellen Sie diesen Wert nun auf 5 Pixel/Event. Bewegen Sie nun die Maus über mehrere Fenster hinweg. Nun werden die Fenster unter dem Mauspfeil sofort aktiviert, auch wenn Sie die Maus nicht loslassen. Haben Sie einen Amiga mit 68000-Prozessor, wird Ihnen dies mißfallen, da der Mauspfeil aus schon genannten Gründen "hängenbleibt", wenn ein Fenster aktiviert wird. Benutzer von Amigas mit 68030 Prozessor werden aber vielleicht mit dieser Einstellung arbeiten. Verringern Sie jetzt einmal den Wert auf 3 Pixel/Event und bewegen Sie die Maus sehr schnell über ein Fenster hinweg: das Fenster wurde nicht aktiviert. Wenn Sie die Maus langsam genug bewegen, wird es aktiviert. Meine bevorzugte Einstellung auf einem 25MHz Amiga 3000 ist 3 Pixel/Event. Sie können übrigens den Schieberegler auch mit der Tastatur bewegen: Mit "w" vergrößern Sie den Wert, mit "W" verkleinern Sie ihn. Das W in Aktivierungs- schwelle ist deshalb auch unterstrichen. Reaktivierungszeit: Mit dem zweitem Schieberegler können Sie den Zeitintervall angeben, nach dem SMaus prüft, ob das Fenster unter dem Mauspfeil noch das aktive ist. Ist es dies nicht, wird es reaktiviert. Sie können diese Zeit in einer Genauigkeit von einer zehntel Sekunde bestimmen. 0/10 schaltet diese Funktion aus. Voreingestellt ist 5/10 Sekunden, also wird jede halbe Sekunde geprüft. Meine bevorzugte Einstellung ist 10/10 Sekunden, also eine Sekunde. Dies ist jedoch deutlich langsamer, als Autopoint reaktivieren wuerde, dafuer ist die Rechnerauslastung wesentlich geringer. Testen können Sie diese Option folgendermaßen: Öffnen Sie eine Shell. In der Shell tippen Sie "NewShell". Es öffnet sich ein neues Fenster, ohne daß Sie die Maus bewegt haben. Wenn das neue Fenster nicht gerade unter dem Mauspfeil geöffnet wurde, so wurde es bereits wieder deaktiviert und das alte Shell-Fenster reaktiviert. Wurde das neue Fenster unter dem Mauspfeil geöffnet, verschieben Sie die Maus bzw. die Shell so, daß nach dem Kommando NewShell das Fenster der neuen Shell nicht unter dem Mauspfeil ist. Mit "r" können Sie den Wert mit der Tastatur vergrößern, mit "R" verkleinern. Wenn Sie gleichzeitig die Option "auf Tastendruck aktivieren" einschalten, können Sie dieses Intervall ohne Nachteile sehr groß wählen, da eine Reaktivierung vor allem für Tastatureingaben notwendig ist. "Auf Tastendruck aktivieren" aktiviert aber sowieso das Fenster unter dem Mauspfeil bei einem Tastendruck. Diese Fenster nicht deaktivieren: In diesem Texteingabefeld können Sie Titel von Fenstern angeben, die nicht deaktiviert werden sollen. Wollen Sie z.B. Fenster, deren Titel mit den drei Buchstaben Arq beginnen, nicht von SMaus deaktivieren lassen, dann tragen Sie in das Texteingabefeld "Arq#?" ein. #? dient hier als Joker, der beliebige Zeichen be- liebig oft zuläßt. Sie können hier die ganze Palette der Amiga- DOS-Joker verwenden, wie sie auch bei DOS-Befehlen wie Dir oder List Verwendung finden. Eine Beschreibung der Joker finden Sie in Ihrer AmigaDOS 2.0 Beschreibung. Bitte Beachten Sie, daß zwischen Groß- und Kleinschreibung unterschieden wird. Hier einige Beispiele: (Arq#?|#?frage#?) - alle Fenstertitel, die mit den Buchstaben "Arq" beginnen oder in ihrem Titel die Folge "frage" aufweisen. (#?[Rr]equest|Arq#?|#?[Mm]essage|Choose #?) - alle Titel, die auf "Request" oder "request" enden -- [Rr] paßt auf alle Zeichen, die in den eckigen Klammern vorkommen -- oder mit "Arq" beginnen oder auf "Message" oder "message" enden oder mit "Choose " beginnen. Meldet AmigaDOS einen Fehler, meist ist er syntaktischer Art, etwa eine vergessene Klammer, so informiert Sie SMaus darüber. Auf diesen Schirmen funktionslos: In diesem Texteingabefeld können Sie Titel von Bildschirmen angeben, auf denen SMaus absolut funktionslos bleiben soll. Auch hier können Sie, wie oben, alle AmigaDOS-Joker benutzen. Dieses Fenster öffnen mit: Dieses Texteingabefeld bestimmt die Tastenkombination, die das Fenster von SMaus öffnen läßt. Das Fenster von SMaus wird übrigens auf dem vordersten Bildschirm geöffnet, sofern dieser ein öffentlicher Bildschirm ist. Wenn nicht, wird das Fenster auf dem voreingestellten öffentlichen Bildschirm geöffnet, welcher normalerweise der Workbench Bildschirm ist. Jede erdenkliche Tastenkombination kann auf folgende Weise beschrieben werden: Qualifizierer Taste wobei Qualifizierer und Taste folgendes repräsentieren: Qualifizierer: keines, eines oder mehrere der folgenden Schlüs- selwörter: lshift - linke Shift-Taste rshift - rechte Shift-Taste shift - eine der beiden Shift-Tasten capslock - die CapsLock-Taste caps - die CapsLock-Taste oder eine der Shift-Tasten control - die Ctrl-Taste lalt - die linke Alt-Taste ralt - die rechte Alt-Taste alt - eine der beiden Alt-Tasten lcommand - die linke Amigataste rcommand - die rechte Amiga-Taste numericpad - eine Taste des Zehnertastenblockes repeat - eine Taste, die gerade wiederholt wird upstroke - nur das Loslassen der Taste zählt -upstroke - das Drücken und das Loslassen einer Taste zählt Ein "-" vor einem Qualifizierer bedeutet, wenn nicht anderes angegeben, daß dieser nicht beachtet werden soll. Taste: eines der folgenden Schlüsselwörter: comma, space, backspace, tab, enter, return, esc, del, up, down, right, left, help, f1, f2, f3, f4, f5, f6, f7, f8, f9, f10 oder ein Zeichen wie z.B. A, 1, Ü, | Beispiele: lalt f1 - linke Alt-Taste und F1 control alt shift help - Ctrl, linke oder rechte Alt-Taste, linke oder rechte Shift-Taste und Help-Taste lcommand s - linke Amiga-Taste und s Bestimmen Sie keine Tastenkombination, können Sie das SMaus-Fenster immer noch mit Hilfe von Exchange oder durch nochmaliges Starten von SMaus öffnen. Mausbewegung aktiviert immer Mit diesem Schalter können Sie einstellen, ob Mausbewegungen immer das Fenster unter dem Mauspfeil aktivieren sollen, auch wenn das gerade aktuelle Fenster aufgrund einer der oben genannten Gründe nicht deaktiviert werden soll. Nur Tastendrücke deaktivieren diese Fenster dann nicht. Auf Tastendruck aktivieren Schalten Sie diese Option ein, wird bei jedem Druck einer Taste der Tastatur das Fenster unter dem Mauspfeil aktiviert, falls es dies nicht schon ist. Fenster mit aktivem Texteingabefeld nicht deaktivieren Durch diesen Schalter können Sie verhindern, das ein Fenster mit aktivem Texteingabefeld deaktiviert wird. Dies ist z.B. sehr nützlich, wenn Sie den Texteditor CygnusEd Professional 2 benutzen. Öffnen Sie beim CygnusEd den Suchrequester per Tastatur, so wird ein Fenster mit aktiven Texteingabefeld aktiviert. Benutzen Sie ein Hilfsprogramm wie Autopoint, so wird dieses Fenster sofort wieder daktiviert und Sie müssen erst den Mauspfeil in dieses Fenster bewegen. SMaus erkennt, daß das aktive Fenster ein aktives Texteingabefeld hat und deaktiviert dieses Fenster nicht, wenn diese Option eingeschaltet ist. So können Sie sofort den zu suchenden Text in das Texteingabefeld tippen und die Suche starten. Sonstige Funktionen des Konfigurationsfensters Verstecken Der Schalter Verstecken oder das Schließssymbol des Fensters schließen das Fenster, ohne SMaus zu beenden. Diese Funktion ist auch über die Tasten V oder ESC zu erreichen. Information Der Schalter Information öffnet eine Dialogbox, in der Informationen über SMaus gezeigt werden. Während die Dialogbox offen ist, sind die Funktionen von SMaus nicht verfügbar. Beenden Mit dem Schalter Beenden oder der Taste B beenden Sie SMaus. Installation, Angabe der Optionen beim Start Wollen Sie SMaus bei jedem Bootvorgang starten, so ziehen Sie einfach das Piktogramm von SMaus in den Schubladen WBStartup Ihrer Workbench. SMaus wird dann automatisch gestartet. Damit Sie nicht jedesmal die Einstellungen verändern müssen, können Sie diese im Piktogramm von SMaus angeben. Klicken Sie das SMaus-Piktogramm einmal mit der linken Maustaste an und wählen Sie den Menüpunkt Information des Icons Menü der Workbench. In dem sich öffnenden Fenster sehen Sie die Liste der Tool Types. Mit Hilfe dieser Tool Types übergeben Sie SMaus die gewünschten Einstellungen. Folgende Tool Types kennt SMaus: CX_Priority=<Zahl> für <Zahl> tragen Sie die gewümschte Priorität von SMaus in der Liste der Commodities ein CX_Popkey=<Zeichenkette> <Zeichenkette> ersetzen Sie bitte mit der Beschreibung der Tastenkombina- tion, die das SMaus-Fenster öffnen soll CX_Popup Ist dieses Tool Type vorhanden, so öffnet SMaus nach dem Start sein Fenster Reaktivierungszeit=<Zahl> für <Zahl> bitte die Anzahl der zehn- tel Sekunden eintragen Aktivierungsschwelle=<Zahl> <Zahl> ersetzen Sie durch die Anzahl von Pixel/Event, ab denen SMaus ein Fenster bei Mausbewegung nicht mehr aktiviert Priorität=<Zahl> für <Zahl> setzen Sie die Prozess- priorität von SMaus ein (voreingestel- lt ist 19, bei Verwendung der Option Tastendruck wird die Priorität auto- matisch auf 21 erhöht) Fensternicht=<Zeichenkette> <Zeichenkette> ist die Liste der Ti- tel von Fenstern, die nicht deakti- viert werden Schirmnicht=<Zeichenkette> als <Zeichenkette> geben Sie die Ti- tel von Bildschirmen an, auf denen SMaus funktionslos ist Tastendruck geben Sie diesen Tool Type an, so wird bei einem Tastendruck das Fenster unter dem Mauspfeil aktiviert Mausimmer dieser Tool Type schaltet die Option "Mausbewegung aktiviert immer" ein Texteingabenicht mit Angabe dieses Schlüsselwortes wer- den Fenster mit aktivem Texteingabe- feld nicht deaktiviert Wollen Sie SMaus aus der Shell starten, können Sie ebenfalls Ihre gewünschten Einstellungen mit angeben. Hier das Befehlsformat: SMaus [CX_Priority <Zahl>] [CX_Popkey <Zeichenkette>] [CX_Popup] [Reaktivierungszeit <Zahl>] [Aktivierungsschwelle <Zahl>] [Priorität <Zahl>] [Schirmnicht <Zeichenkette>] [Fensternicht <Zeichenkette>] [Tastendruck] [Mausimmer] [Texteingabenicht] Hier noch die Befehlsschablone: CX_Priority/K/N,CX_Popkey/K,CX_Popup/S,Reaktivierungszeit/K/N, Aktivierungsschwelle/K/N,Priorität/K/N,Schirmnicht/K, Fensternicht/K,Tastendruck/S,Mausimmer/S,Texteingabenicht/S Wie Sie sehen, entsprechen diese Optionen den Tool Types. Bitte beachten Sie, daß Optionen mit Leerzeichen von Anführungszeichen eingeschlossen werden müssen, z.B.: SMaus CX_Popkey "alt f1" Wollen Sie die Shell nach dem Start schliessen können, so müssen Sie SMaus mit Run >NIL SMaus starten. Wollen Sie SMaus in der Datei S:User-Startup installieren, so tragen Sie dort ebenfalls Run >NIL SMaus ein. Eventuell müssen Sie noch den Pfad zu SMaus angeben, z.B. Run >NIL: Utilities/SMaus, wenn Sie SMaus in den Schubladen Utilities Ihrer Workbench kopiert haben. Geschichte der Versionen V1.09 erste veröffentlichte Version Danksagung, Adresse des Autors Vielen Dank an Michael Wolfgang Hohmann für die Idee zu diesem Programm und für das Testen. Ebenso an Georg Heßmann für neue Ideen und Testen. Stefan Sticht Biberecker Weg 40a D-8390 Passau 18 Federal Republic of Germany Meine EMail Adressen: [{uunet|rutgers}!]cbmvax.commodore.com!cbmehq!cbmger!edith!sticht oder IWSTICHT@ibm.rz.uni-passau.de Fido-Netz: Stefan Sticht (2:242/77:4)