home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 524.lha / MouseAccel_v1.01 / Mausbeschleuniger.dok.pp / Mausbeschleuniger.dok
Text File  |  1991-07-01  |  11KB  |  241 lines

  1.  
  2.                           Mausbeschleuniger
  3.  
  4.                              (Commodity)
  5.  
  6.                                  von
  7.  
  8.                             Stefan Sticht
  9.  
  10.           Dieses Programm, Quellcode und Dokumentation sind
  11.  
  12.                             PUBLIC DOMAIN.
  13.  
  14.  
  15.                Sie können damit machen, was Sie wollen!
  16.  
  17.  
  18. Der Zweck dieses Commodities:
  19. ---------------------------
  20. Mausbeschleuniger  ist  ein Commodity, das den Mauspfeil beschleunigt.
  21. Ein  Mausbeschleuniger ist zwar in AmigaOS 2.0 bereits eingebaut, wenn
  22. Ihnen  dieser  aber  zu  langsam  ist,  wird  Ihnen  dieses  Commodity
  23. gefallen.     Sie    können   eine   Beschleunigungsfaktor   und   ein
  24. Beschleinigungsminimum  (Pixel/Event)  einstellen.   Wenn Sie die Maus
  25. schneller  als  das  Beschleunigungsminimum  in  Pixel  pro Inputevent
  26. bewegen,   wird  sie  Bewegung  um  den  Faktor  Beschleunigungsfaktor
  27. beschleunigt.    Bewegen   Sie   die   Maus   langsamer,   wird  nicht
  28. beschleunigt, um besondere Aufgaben zu erleichtern.
  29.  
  30. Systemanforderungen:
  31. --------------------
  32. Dieses  Commodity  erfordert  mindestens  Kickstart 37.* und Workbench
  33. 37.*.   Bitte prüfen Sie dies, indem Sie in der Shell Version eingeben
  34. oder  im  Workbench  Menü  About  aufrufen.   Außerdem  muß  sich  die
  35. commodities.library  in Ihrem Verzeichnis libs:  befinden.  Überprüfen
  36. Sie  dies  bitte,  indem  Sie  in  der  Shell  den  Befehl "dir libs:"
  37. eingeben.
  38.  
  39. Und so startet man ein Commodity:
  40. ---------------------------------
  41. Es  gibt  grundsätzlich  zwei  verschiedene  Arten,  ein  Commodity zu
  42. starten:  von der Workbench oder von der Shell aus.
  43.     Das Starten von der Workbench aus ist äußerst einfach:  Machen Sie
  44. einen  Doppelklick  auf  dessen Icon und das Commodity wird gestartet.
  45. Eventuell  wollen  Sie verschiedene Parameter eines Commoditys ändern.
  46. Dazu  benutzen  Sie  Tool-Types.  Tool-Types ändern Sie, indem Sie das
  47. Commodity  Icon einmal anklicken und im Menü der Workbench Information
  48. aufrufen.   In  dem  Fenster, daß sich öffnet, sehen Sie die Liste der
  49. Tool-Types.   Wie  Sie die Tool-Types ändern, lesen Sie bitte in Ihrer
  50. Workbench-Dokumentation   nach.    Welche  Parameter  Sie  für  dieses
  51. Commodity ändern können, wird später beschrieben.
  52.     Bitte  beachten Sie, daß ein weiterer Doppelklick auf das Icon des
  53. Commoditys,  während es bereits läuft, bewirkt, daß das Commodity sein
  54. Fenster  öffnet.   Da es nicht sinnvoll wäre Mausbeschleuniger zweimal
  55. zur gleichen Zeit laufen zu lassen, ist dies auch nicht möglich.  Wenn
  56. Sie   die   Tool-Types   in   irgendeiner   Weise  verändern,  nachdem
  57. Mausbeschleuniger  gestartet  wurde,  wird ihm diese Veränderung nicht
  58. mitgeteilt.    Sie  müssen  ein  bereits  laufendes  Mausbeschleuniger
  59. verlassen und neu starten.
  60.     Um  ein  Commodity in der Shell zu starten, geben Sie dessen Namen
  61. ein.   Sollten  Sie  die Fehlermeldung "Unknown command ???" erhalten,
  62. haben  Sie  sich  beim  Commodity-Namen  vertippt  oder  das Commodity
  63. befindet sich nicht in ihrem aktuellen Verzeichnis bzw.  dem aktuellen
  64. Suchpfad.   Am  einfachsten  ist  es, das aktuelle Verzeichnis mit dem
  65. Befehl  "CD"  dorthin  zu ändern, wo das Commodity sich befindet.  Sie
  66. können  die Parameter eines Commodity mit Befehlsoptionen ändern.  Die
  67. verfügbaren  Optionen können Sie sich anzeigen lassen, indem Sie ein ?
  68. als ersten Parameter angeben:
  69.  
  70.                          Mausbeschleuniger ?
  71.  
  72. gibt Ihnen eine Liste der Befehlsoptionen.  Die Erklärung jeder Option
  73. erfolgt  später.  Startet man das Commodity, während es bereits läuft,
  74. erreicht  man  wiederum, daß es sein Fenster öffnet.  Dabei wird keine
  75. der angegebenen Befehlsoptionen berücksichtigt.
  76.  
  77.     Wenn  Sie  wünschen,  daß  das  Commodity  bei  jedem Boot-Vorgang
  78. gestartet  wird, sollten Sie folgende Zeile in Ihre User-Startup Datei
  79. einfügen:
  80.  
  81.                   <Pfad>Mausbeschleuniger <Optionen>
  82.  
  83. Vergessen  Sie  bitte  nicht  für  <Pfad>  den  tatsächlichen Pfad zum
  84. Commodity   und   für   <Optionen>   die  gewünschten  Befehlsoptionen
  85. anzugeben.  Folgendes Beispiel startet Mausbeschleuniger, wenn es sich
  86. im  Schubladen  Tools  der  Boot-Diskette  befindet,  so  daß  der der
  87. Mauspfeil um den Faktor 5 beschleunigt wird:
  88.  
  89.                    Tools/Mausbeschleuniger FAKTOR=5
  90.  
  91.     Eine  andere  Möglichkeit,  um  das  Commodity bei jedem Booten zu
  92. starten,  ist,  das  Icon  von  Mausbeschleuniger  in  den  Schubladen
  93. WBStartup der Boot-Diskette (Workbench) zu verschieben.  Das Commodity
  94. wird  dann  bei  jedem  Boot-Vorgang  gestartet,  als hätten Sie einen
  95. Doppelklick  auf das Icon durchgeführt.  Allerdings müssen Sie im Icon
  96. das Tool-Type DONOTWAIT ergänzen.
  97.  
  98. Benutzung von Exchange:
  99. -----------------------
  100. Exchange  ist  das  Programm,  mit  dem  Commodities verwaltet werden.
  101. Starten  Sie Exchange, das sich für gewöhnlich im Utilities Schubladen
  102. Ihrer  Boot-Diskette  befindet, mit einem Doppelklick auf dessen Icon.
  103. Es  wird Ihnen nun eine Liste aller verfügbaren Commodities angezeigt,
  104. aus  der  Sie  das  entsprechende  Commodity  auswählen können.  Unter
  105. dieser  Liste  wird  nach  Auswahl eines Commodities automatisch desen
  106. Titel, Beschreibung und Status angezeigt.
  107.     Sie   können   nun   Commodities   völlig   beenden   mit  "Kill",
  108. vorübergehend  ausschalten  mit  "Disable"  und wieder einschalten mit
  109. "Enable".   Wenn  das  Commodity  ein  Fenster  öffnen kann, indem für
  110. gewöhnlich Parameter eingestellt werden, können Sie dieses Fenster mit
  111. "Show" öffnen lassen und mit "Hide" schließen lassen.
  112.  
  113.  
  114.                        Veränderbare Parameter:
  115.                        -----------------------
  116.  
  117. CX_Priority:
  118. ------------
  119. Mit  dem  Tool-Type  oder der Befehlsoption CX_PRIORITY=<p> können Sie
  120. die  Priorität  des  Commodities  innerhalb  der Liste der Commodities
  121. bestimmen.   Setzen  Sie  für <p> bitte einen positiven dezimalen Wert
  122. ein. Die voreingestellte Priorität ist 0.
  123.  
  124. FAKTOR:
  125. -------
  126. Mit  der  Befehlsoption  bzw.  dem Tool-Type FAKTOR=<n> können Sie den
  127. Beschleunigungsfaktor einstellen.
  128.     Wenn  Sie Mausbeschleuniger bereits gestartet haben, so können Sie
  129. den  Faktor  auch  in  einem  Fenster einstellen, das Sie mit Exchange
  130. öffnen  können.   Starten  Sie  Exchange, wählen Sie aus der Liste der
  131. Commodities  Mausbeschleuniger,  und  drücken Sie den Schalter "Show".
  132. Jetzt  hat  sich  das  Fenster  von  Mausbeschleuniger geöffnet.  Hier
  133. können  Sie  den  Beschleunigungsfaktor und das Beschleunigungsminimum
  134. einstellen,  das  Fenster  wieder verschwinden lassen mit "Verstecken"
  135. oder den Mausbeschleuniger beenden mit "Beenden".
  136.  
  137. MINIMUM:
  138. --------
  139. Mit  der  Befehlsoption bzw.  dem Tool-Type MINIMUM=<n> können Sie das
  140. Minimum  in  Pixel  pro  Inputevent einstellen, um das die Maus bewegt
  141. werden  muß,  damit eine Beschleunigung eintritt.  Diese Option können
  142. Sie auch im Fenster von Mausbeschleuniger ändern.
  143.  
  144. CX_Popkey:
  145. ----------
  146. Mit CX_Popkey=<Taste> können Sie ein Tastaturkürzel bestimmen, mit dem
  147. Sie  das  Fenster von Mausbeschleuniger öffnen können.  Bitte ersetzen
  148. Sie  <Taste>  durch  eine Eingabebeschreibung, die unten erklärt wird.
  149. Wenn  Sie diese Option weglassen, wird kein Tastaturkürzel installiert
  150. und der Speicherverbrauch wird etwas reduziert.
  151.  
  152. Beispiele:
  153.  
  154.     CX_POPKEY=f1                (F1 öffnet das Fenster)
  155.     "CX_POPKEY=lshift f1"       (linke Shift-Taste und F1)
  156.     "CX_POPKEY=alt m"           (eine Alt-Taste und die Taste M)
  157.  
  158. CX_Popup:
  159. ---------
  160. Mit   CX_POPUP=JA|NEIN   können  Sie  bestimmen,  ob  beim  Start  von
  161. Mausbeschleuniger dessen Fenster geöffnet werden soll.  JA|NEIN heißt,
  162. Sie  können  entweder  JA  oder  NEIN  einsetzen, aber nichts anderes.
  163. Voreingestellt ist NEIN.
  164.  
  165.                         Eingabebeschreibungen
  166.                         ---------------------
  167.                      (input description strings)
  168.  
  169. Mit   Eingabebeschreibungen   können   Sie   fast  jede  Eingabeaktion
  170. beschreiben,  z.B.   die Aktion lshift f1.  Dies heißt, daß die Aktion
  171. das drücken der Taste F1 zusammen mit der linken Shift-Taste ist.  Bei
  172. diesem Commodity öffnet die Aktion das Fenster des Commoditys.
  173.  
  174. Eingabebeschreibungen haben folgendes Muster:
  175.       [class] (([-]qual)|syn)* [[-]upstroke] [highmap|ANSIcode]
  176.  
  177. (* bedeutet keine oder mehrere Vorkommen des Ausdrucks in Klammern)
  178.  
  179. class   ("Klasse") ist einer der folgenden Ausdrücke:
  180.         rawkey, rawmouse, event, pointerpos, timer, newprefs,
  181.         diskremoved, diskinserted.
  182.         Wenn die Klasse nicht bestimmt wird, wird rawkey angenommen.
  183.  
  184. qual    (qualifier, "Qualifizierer") ist einer der folgenden Ausdrücke:
  185.         lshift, rshift, capslock, control, lalt, ralt, lcommand,
  186.         rcommand, numericpad, repeat, midbutton, rbutton, leftbutton,
  187.         relativemouse
  188.         Ein vorangestelltes "-" bedeutet, daß der folgende Qualifier
  189.         als irrelevant angenommen werden soll.
  190.  
  191. syn     ("Synonym") ist einer dieser Ausdrücke: shift, caps, alt
  192.         shift bedeutet linke oder rechte Shift-Taste
  193.         caps bedeutet Shift oder Caps-Lock
  194.         alt bedeutet linke oder rechte Alt-Taste
  195.  
  196. upstroke (wörtlich "upstroke")
  197.         Wenn dieser Ausdruck fehlt, zählt das Drücken einer Taste für
  198.         die Klassen rawmouse und rawkey. Wenn der Audruck vorhanden
  199.         ist, zählt das Loslassen einer Taste. Stellt man ein "-"
  200.         voran, so zählt beides.
  201.  
  202. highmap ist einer der folgenden Ausdrücke:
  203.         comma, space, backspace, tab, enter, return, esc, del, up, down,
  204.         right, left, help, f1, f2, f3, f4, f5, f6, f7, f8, f9, f10,
  205.         0, 1, 2, 3, 4, 5, 6, 7, 8, 9, (, ), /, *, -, +
  206.  
  207. ansicode ein einzelnes Zeichen steht genau für die entsprechende
  208.         Taste
  209.  
  210. Some full examples:
  211. -------------------
  212.  
  213.     Mausbeschleuniger faktor=10
  214.     Mausbeschleuniger Faktor=5 "cx_popkey=ctrl 1" cx_popup=ja
  215.     Mausbeschleuniger Faktor=3 Minimum=4 "cx_popkey=help"
  216.  
  217.  
  218. Besonderen Dank
  219. ---------------
  220. an Matt Dillon für den Code zur Beschleunigung.
  221.  
  222.  
  223.      Schicken Sie Fehlerreports, Erweiterungswünsche, Fragen und
  224.      -----------------------------------------------------------
  225.                            Geschenke(!) an:
  226.                            ----------------
  227.  
  228.                             Stefan Sticht
  229.                           Bibereckerweg 40a
  230.                            D-8390 Passau 18
  231.                                  FRG
  232.  
  233. oder (besser) an eine der folgenden EMail-Adressen:
  234. Internet: cbmvax.commodore.com!cbmehq!cbmger!edith!sticht@rutgers.EDU
  235.       or: IWSTICHT@ibm.rz.uni-passau.de
  236. Fido-Net: Stefan Sticht (2:242/16:4)
  237.  
  238. Bitte nennen Sie bei einem Fehlerreport auch die Versionsnummer.
  239. Diese erhalten Sie z.B. mit dem Befehl "Version":
  240.                      Version [<path>]<commodity>
  241.