Zum Hauptinhalt springen

Status des Gamepad-Steuerkreuzes festlegen (:set_dpad)

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

Deklaration​

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

Parameter​

  • x
    Ganzzahl, darf nur -1, 0 oder 1 sein; 1 bedeutet rechts, -1 links
  • y
    Ganzzahl, darf nur -1, 0 oder 1 sein; 1 bedeutet oben, -1 unten

Rückgabewert​

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

Beschreibung​

  • Wenn x und y gleichzeitig ungleich null sind, wird eine diagonale Richtung dargestellt.
  • 0, 0 bedeutet, dass das Steuerkreuz losgelassen wird.
  • Typfehler und Werte außerhalb des gültigen Bereichs werden als Lua-Parameterfehler ausgelöst.

Beispiel​

local pad = assert(gamepad.connect())

assert(pad:set_dpad(1, 0))   -- rechts
assert(pad:set_dpad(-1, 1))  -- links oben
assert(pad:set_dpad(0, 0))   -- loslassen
assert(pad:disconnect())