Events#
Introduction#
Events allow you to run functions in parallel by using event objects. Instead of calling functions or threads one after another, events let you register functions and then trigger them all at once. Each registered function runs in its own thread, so your robot can do multiple things—like blinking TouchLEDs and driving—at the same time.
Below is a list of available methods and constructors:
Event
– Creates a new event object.broadcast
– Triggers all registered functions in an event object to run in parallel.broadcast_and_wait
– Triggers all registered functions in an event object and waits for them to finish before continuing.event
– Registers a function to the event object, optionally with arguments.
Create an Event Object#
The Event
constructor is used to create an event object that manages function execution in separate threads.
Usage:
Event()
Parameter |
Description |
---|---|
This constructor has no parameters. |
# 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)
Broadcast#
broadcast
triggers an event, starting all registered functions in separate threads. This method does not pause execution of any subsequent functions.
Usage:
event.broadcast()
Parameter |
Description |
---|---|
|
The name of the previously created event object. |
# 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
starts an event but waits for all registered functions to finish before continuing with subsequent functions.
Usage:
event.broadcast_and_wait()
Parameter |
Description |
---|---|
|
The name of the previously created event object. |
# 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)
Register Functions to an Event#
When you register a function to an event, it will execute in a separate thread when the event is broadcasted.
Usage:
event(callback, args)
Parameter |
Description |
---|---|
|
The name of the previously created event object. |
|
A function that is previously defined to execute when the event is broadcasted. |
|
Optional. A tuple containing arguments to pass to the callback function. See Using Functions with Parameters for more information. |
# 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)