Aller au contenu principal

Simuler le contact d’un doigt avec l’écran (touch.on)

Déclaration

evenement_tactile = touch.on(coord_x, coord_y)

Paramètres

  • coord_x, coord_y
    type entier, coordonnées du point de contact dans le système de coordonnées actuellement orienté

Valeur renvoyée

  • evenement_tactile
    objet d’événement tactile

Description

Simule le contact d’un doigt avec la position indiquée de l’écran et renvoie un objet d’événement tactile permettant de contrôler ce contact.
Les coordonnées de cette fonction dépendent du système de coordonnées initialisé par la fonction screen.init.
Remarque : cette fonction alloue et occupe automatiquement un identifiant de doigt. Le nombre d’identifiants est limité (environ 30) ; au-delà de cette limite, un nouvel appel à touch.on ou touch.tap lève l’erreur finger pool overflow. Veillez à ne pas occuper simultanément trop d’identifiants et appelez rapidement la méthode :off pour libérer les doigts.
Cette fonction peut également être appelée de la manière suivante (l’ID du doigt doit être un nombre compris entre 1 et 29 ; cette forme nécessite de gérer soi-même l’ID du doigt) :

touch.on(id_doigt, coord_x, coord_y)

Exemple

-- Mettre un doigt en contact avec le point 100, 100, glisser à vitesse constante jusqu’au point 200, 200, puis relever le doigt
touch.on(100, 100):move(200, 200):off()

touch.on(1, 100, 100) -- Mettre en contact le doigt numéro 1 avec le point 100, 100
touch.off(1) -- Relever le doigt numéro 1