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())