Verwendung der Achsen¶

Dem Programm müssen einige Argumente übergeben werden:

• -X Um die Signale des Joysticks an ein Fenster mit grafischer Oberfläche zu übergeben (sollte bei einem Spiel der Normalfall sein)

• -dev /dev/input/js0 Legt das Gerät fest welches verwendet werden soll (je nach Ubuntuversion normalerweise /dev/js0 oder /dev/input/js0)

• -axis Left Right Up Down Welche Tasten den Bewegungen des Joysticks zugeordnet werden sollen (in folgender Reihenfolge: links, rechts, oben, unten)

Man startet also joy2key mit folgendem Befehl:

joy2key -X -dev /dev/input/js0 -axis Left Right Up Down 

Dann wird man nach dem Fenster gefragt welches verwendet werden soll, man klickt also einfach auf das Fenster des Spiels.

Anschließend wird der Joystick kalibriert. In der Konsole wird folgendes angezeigt:

Calibrating axis 0
Please center the axis and press a button.
?

Nun sollte man nicht sofort eine Taste drücken sondern zuerst den Joystick etwas bewegen, und dann wieder in die mittlere Stellung bringen, so dass in der Konsole eine Zahl angezeigt wird:

Calibrating axis 0
Please center the axis and press a button.
value: 512

Erst jetzt kann man eine Taste drücken. Dann den Joystick einmal ganz nach links bewegen und eine Taste drücken, und schließlich noch einmal ganz nach rechts und wieder eine Taste drücken. Danach wird das Gleiche nochmal mit der Achse 1 gemacht. Hier den Joystick zuerst in die Mitte, dann nach oben und schlussendlich nach unten bewegen. Die Reihenfolge links, rechts, oben, unten ist wichtig! Wenn die Kalibrierung abgeschlossen ist dann sollte man das Spiel mit dem Joystick steuern können.

Verwendung der Tasten¶

Zusätzlich zu den Achsen können natürlich auch die Tasten verwendet werden. Dazu gibt es folgendes Argument:

• -buttons Taste für Button0 Taste für Button1 usw.

Will man beispielsweise dem Button0 die Taste          zuordnen ruft man das Programm so auf:

joy2key -X -dev /dev/input/js0 -buttons space 

Auswahl des Fensters¶

Wenn man das Fenster des Spiels nicht mit der Maus auswählen will, dann kann man auch den Namen des Fensters festlegen. Um das Spiel GNOMEtris mit einem Joystick zu steuern würde man z.B. folgenden Befehl verwenden:

joy2key "GNOMEtris" -X -dev /dev/input/js0 -axis Left Right Up Down -buttons space 

Kalibrierung¶

Normalerweise wird bei jedem Start von joy2key eine Kalibrierung durchgeführt. Um sich dies zu ersparen kann man die Werte die verwendet werden sollen auch direkt angeben. Nach dem Kalibrieren zeigt joy2key fogende Ausgabe in der Konsole:

Calibrating axis 0
Please center the axis and press a button.
value: 512   
Locked at 512
Please move the axis to its lowest position and press a button.
value: 4   
Please move the axis to its highest position and press a button.
value: 1021   
Using deadzone of 50%
Calibrations set at:
Axis 0 low threshold set at 258
Axis 0 high threshold set at 766
(you can put these in your .joy2keyrc to avoid calibrating in the future)

Calibrating axis 1
Please center the axis and press a button.
value: 512   
Locked at 512
Please move the axis to its lowest position and press a button.
value: 4   
Please move the axis to its highest position and press a button.
value: 1021   
Using deadzone of 50%
Calibrations set at:
Axis 1 low threshold set at 258
Axis 1 high threshold set at 766
(you can put these in your .joy2keyrc to avoid calibrating in the future)
Initialization complete, entering main loop, ^C to exit...

Wichtig sind die vier Zeilen in denen ein threshold Wert angezeigt wird (also z.B. Axis 0 low threshold set at 258). Diese Werte können mit dem Argument

• -thresh Wert1 Wert2 Wert3 Wert4

direkt eingestellt werden ohne dass immer wieder Kalibriert werden muss. In diesem Beispiel würde man folgenden Befehl verwenden:

joy2key "GNOMEtris" -X -dev /dev/input/js0 -axis Left Right Up Down -buttons space -thresh 258 766 258 766 

COMMON¶

Dieser Abschnitt gilt immer, wenn die Datei .joy2keyrc verwendet wird (unabhängig vom Profil). Im unten folgenden Beispiel wurden die Threshholds (Wertebereiche) der Steuerachsen (Steuerkreuz) definiert. Der Option -thresh folgen nacheinander die Werte "Achse-0-Low" "Achse-0-High" "Achse-1-Low" "Achse-1-High".

Die Wertebereiche lassen sich mit

joy2key "Fenstertitel" -X -dev /dev/input/js0 -axis Left Right Up Down 

ermitteln.

START¶

Das Schlüsselwort "START" leitet ein Profil ein, gefolgt von dem Profilnamen (im unten folgenden Beispiel gnometris).

-buttons leitet die Zuordnung der Gamepad-Tasten ein. Die Tasten werden in der Reihenfolge definiert, wie sie erkannt werden (0-x). Ist diese Reihenfolge nicht bekannt, kann diese mit folgendem Befehl ausprobiert werden:

jstest /dev/input/js0 

Für Sondertasten werden die Werte aus der Datei keysymdef.h verwendet. Mit dem folgenden Befehl kann man die Datei anzeigen:

nano $(locate keysymdef.h) 

Im Beipiel wird dem Button0 also die Leertaste zugewiesen.

-axis leitet die Zuordnung der Steuerachsen ein. Auch hier gefolgt von den Tastaturtasten in der o.g. Reihenfolge (links, rechts, oben, unten).

Beispieldatei¶

Eine Konfigurationsdatei für den Befehl aus dem vorherigen Beispiel würde z.B. so aussehen:

COMMON
-dev /dev/input/js0
-thresh 258 766 258 766

START gnometris
-X
-axis Left Right Up Down
-buttons space

Zum Starten genügt dann der Befehl:

joy2key -config gnometris 

Der Fenstertitel des Spiels kann leider nicht in der Konfigurationsdatei gespeichert werden. Das Fenster muss also entweder jedesmal mit der Maus gewählt werden, oder man kann den Fenstertitel wieder zum Befehl hinzufügen:

joy2key "GNOMEtris" -config gnometris