Eventos

Introdução

Os eventos permitem executar funções em paralelo. Em vez de chamar funções sequencialmente, pode registar várias funções num evento e acioná-las simultaneamente. Cada função registada é executada no seu próprio thread, permitindo que o seu robô realize várias tarefas ao mesmo tempo — como exibir valores no ecrã enquanto se move.

Para criar e utilizar um evento, siga os seguintes passos pela ordem indicada:

1. Crie o evento com Event.

2. Registe uma função para ser acionada quando o Event for transmitido chamando o event com a função como argumento.

3. Broadcast an Event:

   • broadcast – Aciona todas as funções registadas num objeto de evento para serem executadas em simultâneo.

   • broadcast_and_wait – Aciona todas as funções registadas num objeto de evento e espera que terminem antes de continuar.

Criar um evento

Event cria um objeto de evento que gere a execução de funções em threads separados.

Usage:
Event()

Parâmetros	Descrição
	Este construtor não possui parâmetros.

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

def main():
    # Creating the move_event Event
    move_event = Event()
    move_event(move_square)
    move_event.broadcast()
    bumper.set_color(GREEN)

# Start threads — Do not delete
start_thread(main)

Registar funções num evento

Ao registar uma função para um evento, esta será executada num thread separado quando o evento for transmitido.

Usage:
event(callback, args)

Parâmetros	Descrição
event	O nome do objeto de evento criado anteriormente.
callback	Uma função previamente definida para ser executada quando o evento é transmitido.
args	Opcional. Uma tupla de argumentos para passar para a função de callback.

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

def main():
    move_event = Event()
    # Register the move_square function to the move_event Event
    move_event(move_square)
    move_event.broadcast()
    bumper.set_color(GREEN)

# Start threads — Do not delete
start_thread(main)

Transmita um evento

broadcast

O comando broadcast dispara um evento, iniciando todas as funções registadas em threads separados. Este método não interrompe a execução de qualquer código subsequente.

Usage:
event.broadcast()

Parâmetros	Descrição
event	O nome do objeto de evento criado anteriormente.

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

def main():
    move_event = Event()
    move_event(move_square)
    # Broadcasting the move_event Event
    move_event.broadcast()
    bumper.set_color(GREEN)

# Start threads — Do not delete
start_thread(main)

broadcast_and_wait

broadcast_and_wait inicia um evento, mas espera que todas as funções registadas terminem antes de continuar com as funções subsequentes.

Usage:
event.broadcast_and_wait()

Parâmetros	Descrição
event	O nome do objeto de evento criado anteriormente.

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

def main():
    # 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()
    bumper.set_color(GREEN)

# Start threads — Do not delete
start_thread(main)