Position des Gamepad-Sticks festlegen (:set_stick)

Diese Methode ist erst in Versionen nach 20260805 verfügbar.

Deklaration

Status, Fehlermeldung = Gamepad-Objekt:set_stick(Stick, x, y)

Parameter

• Stick Textwert; es kann "left" oder "right" übergeben werden. Bei Zeichenfolgen wird die Groß-/Kleinschreibung nicht beachtet.
• x Zahlenwert, endliche Zahl im Bereich [-1, 1]; positive Werte bewegen nach rechts, negative nach links
• y Zahlenwert, endliche Zahl im Bereich [-1, 1]; positive Werte bewegen nach oben, negative nach unten

Rückgabewert

• Status Boolescher Wert; bei erfolgreicher Einstellung der Stickposition true, bei getrennter oder ausgelasteter Verbindung oder fehlgeschlagenem Senden der Eingabe false
• Fehlermeldung Textwert; Fehlermeldung bei fehlgeschlagener Operation

Beschreibung

• 0, 0 bedeutet, dass der Stick zentriert wird.
• Die Stickposition wechselt direkt zu (x, y); ein geglätteter Bewegungsvorgang wird nicht automatisch erzeugt.
• Typfehler, unbekannte Sticknamen, nicht endliche Zahlen und Werte außerhalb des gültigen Bereichs werden als Lua-Parameterfehler ausgelöst.

Beispiel

local pad = assert(gamepad.connect())

assert(pad:set_stick("left", 0.5, 1))
assert(pad:set_stick("left", 0, 0))
assert(pad:disconnect())