Aller au contenu principal

Définir la position d’un joystick de la manette (:set_stick)

Cette méthode est disponible à partir des versions postérieures au 20260805

Déclaration​

etat, message_erreur = objet_manette:set_stick(joystick, x, y)

Paramètres​

  • joystick
    type texte, peut être "left" ou "right" ; les chaînes ne distinguent pas les majuscules et minuscules
  • x
    valeur numérique finie comprise entre [-1, 1] ; une valeur positive va vers la droite et une valeur négative vers la gauche
  • y
    valeur numérique finie comprise entre [-1, 1] ; une valeur positive va vers le haut et une valeur négative vers le bas

Valeur renvoyée​

  • etat
    type booléen, renvoie true si la position du joystick est définie avec succès ; renvoie false si l’appareil est déconnecté, occupé ou si l’envoi de l’entrée échoue
  • message_erreur
    type texte, message d’erreur lorsque l’opération échoue

Description​

  • 0, 0 signifie ramener le joystick au centre
  • La position du joystick devient directement (x, y) ; aucun déplacement progressif n’est généré automatiquement
  • Une erreur de type de paramètre, un nom de joystick inconnu, une valeur non finie ou une valeur hors limites est levé comme erreur de paramètre Lua

Exemple​

local pad = assert(gamepad.connect())

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