Événements

Introduction

Les événements permettent d’exécuter des fonctions en parallèle. Au lieu d’appeler les fonctions séquentiellement, vous pouvez associer plusieurs fonctions à un événement et les déclencher simultanément. Chaque fonction associée s’exécute dans son propre thread, ce qui permet à votre robot d’effectuer plusieurs tâches en même temps, comme afficher des valeurs à l’écran tout en se déplaçant.

Pour créer puis utiliser un événement, suivez ces étapes dans l’ordre :

1. Créez l’événement avec Event.

2. Enregistrez une fonction à déclencher lorsque l’événement Event est diffusé en appelant l’objet event avec la fonction comme argument.

3. Broadcast an Event:

   • broadcast – Déclenche l’exécution simultanée de toutes les fonctions enregistrées dans un objet événement.

   • broadcast_and_wait – Déclenche toutes les fonctions enregistrées dans un objet événement et attend qu’elles se terminent avant de continuer.

Créer un événement

L’événement Event crée un objet événement qui gère l’exécution des fonctions dans des threads séparés.

Usage:
Event()

Paramètre	Description
	Ce constructeur n’a pas de paramètres.

def move_square():
    for index in range(4):
        drivetrain.drive_for(FORWARD, 150)
        drivetrain.turn_for(RIGHT, 90)

# *** Creating the move_event Event ***
move_event = Event()

# Register move_square to move_event
move_event(move_square)

# Call all functions registered to move_event
move_event.broadcast()

Inscrire des fonctions à un événement

Lorsque vous enregistrez une fonction pour un événement, elle s’exécutera dans un thread séparé lorsque l’événement sera diffusé.

Usage:
event(callback, args)

Paramètre	Description
event	Le nom de l’objet événement précédemment créé.
callback	Une fonction préalablement définie à exécuter lorsque l’événement est diffusé.
args	Facultatif. Un tuple d’arguments à passer à la fonction de rappel.

def move_square():
    for index in range(4):
        drivetrain.drive_for(FORWARD, 150)
        drivetrain.turn_for(RIGHT, 90)

# Creating the move_event Event
move_event = Event()

# *** Register move_square to move_event ***
move_event(move_square)

# Call all functions registered to move_event
move_event.broadcast()

Diffuser un événement

broadcast

La diffusion broadcast déclenche un événement, lançant toutes les fonctions enregistrées dans des threads séparés. Cette méthode n’interrompt pas l’exécution des fonctions suivantes.

Usage:
event.broadcast()

Paramètre	Description
event	Le nom de l’objet événement précédemment créé.

# Build Used: Super Code Base 2.0
def move_square():
    for index in range(4):
        drivetrain.drive_for(FORWARD, 150)
        drivetrain.turn_for(RIGHT, 90)

move_event = Event()
move_event(move_square)
# Broadcasting the move_event Event
move_event.broadcast()
optical_sensor.set_light_power(100, PERCENT)

broadcast_and_wait

broadcast_and_wait lance un événement mais attend que toutes les fonctions enregistrées se terminent avant de poursuivre avec les fonctions suivantes.

Usage:
event.broadcast_and_wait()

Paramètre	Description
event	Le nom de l’objet événement précédemment créé.

def move_square():
    for index in range(4):
        drivetrain.drive_for(FORWARD, 150)
        drivetrain.turn_for(RIGHT, 90)

# Set up and call the move_square event
move_event = Event()
move_event(move_square)
# Broadcast the move_event Event and wait
move_event.broadcast_and_wait()
optical_sensor.set_light_power(100, PERCENT)