Midmouse

MidMouse 1.2
14.02.2013

Coding: Thomas Rapp (version 1.0), Wolfgang Hosemann (version 1.1, 1.2)
Icons: Thomas Blatt

-----------------------------------
English readers, please read below!
-----------------------------------

Deutsch
-------

Wie bei den anderen kleinen Utilities, welche aus Anfragen in Foren entstehen, 
hat Thomas die grundlegende Arbeit geleistet und Wolfgang gewünschte weitere 
Features implementiert ;)

MidMouse ist ein kleines Utility, mit dem man den Mauszeiger per Kommando auf
jede gewünschte Position setzen kann.

Schablone:
XPOS/N/A,YPOS/N/A

Tooltypes:
XPOS 
YPOS

Voreinstellung ist
    XPOS=-1
    YPOS=-1

Die Voreinstellung setzt den Mauszeiger genau auf die Mitte des aktiven Screens,
andere Koordinaten werden wie angegeben gesetzt. 

Niels Bache stellte die Frage, was passieren mag, wenn man einen "scrollenden
Screen" (der Screen ist größer als die sichtbare Fläche) verwendet und die
Position des Mauszeigers außerhalb der sichtbaren Fläche gesetzt wird. Nun,
Intuition ist so clever den Screen zu scrollen, so daß der Mauszeiger immer im
sichtbaren Bereich ist. Wird eine Position angegeben, die größer als die
tatsächliche Fläche des Screens ist, so setzt Intuition den Mauszeiger an den
Rand des Screens.

MidMouse kann per Shell oder per Workbench gestartet werden. Für den Start per
Workbench werden die Tooltypes des Icons ausgewertet, beim Start per Shell die
angegebenen Parameter.

Die Auswertung der Shell-Parameter wurde nun geändert, um Problemen bei der 
Angabe von mehr als 2 Parametern aus dem Weg zu gehen. Die Parameter für XPOS
und YPOS müssen nun zwingend angegeben werden (Schlüsselworte sind jedoch nicht
zwingend nötig). Wird für eine Achse -1 angegeben, so wird der Mauszeiger auf
die Mitte der jeweiligen Bildschirmachse gesetzt.

Version 1.2

- Auswertung der Shell-Parameter verändert. Es wird ausschließlich ReadArgs()
  mit passendem Template verwendet. Beide möglichen Parameter müssen nun
  angegeben werden (/N/A).

- potentielle Ursache für Abstürze beseitigt (rdargs = NULL).

Version 1.1 

- wertet Tooltypes und Shell-Parameter aus
- Verhalten von Intuition für übergroße Screens getestet

Version 1.0

- Ursprungsversion

English
-------

Like some other little utilities that evolved from discussions in several 
forums, Thomas made the initial version and Wolfgang implemented new features
demanded by users ;)

MidMouse is a small utility that sets the mousepointer to a given position on
the active screen.

Template:
XPOS/N/A,YPOS/N/A

Tooltypes:
XPOS
YPOS

The default values are
    XPOS=-1
    YPOS=-1

The default values set the mousepointer to the middle of the screen.

Niels Bache asked about the result, if you use a screen larger than the visible
area ("scrollable") and give a position outside the visible area, but still 
inside the area of the screen. Well, Intuition is clever enough to scroll the
screen, so that the mouspointer is always within the visible area. If a position
is given that is outside the screen area, Intuition sets the mousepointer to
the limits of the screen.

MidMouse could be started by Shell or Workbench. If it is started by Workbench,
the Tooltype values of the MidMouse Icon are used to set the position. If it is
started by Shell, the command line parameters are used.

Shell parameter checking was changed to avoid problems with more than two 
parameters. XPOS and YPOS values are both required now (keywords are not
mandatory). If one of the parameters is -1, the mousepointer is set to the 
center of the respective axis of the screen.

Version 1.2
- checking of shell parameters changed. ReadArgs() with appropriate template is
  used now. Both Parameters must be specified (/N/A).
- potential crash condition eliminated (rdargs = NULL).

Version 1.1
- Tooltypes and shell parameter evaluation implemented.
- Behaviour of Intuition regarding scrollable screens tested.

Version 1.0
- initial version.