📦 Events

Overview of the Events module in JarEngine.

🔹 Overview

Events provides the classes and utilities related to event handling and input monitoring.

It includes:

• Event watchers and dispatcher
• Keyboard and mouse input codes
• Runtime event management

🔹 Contents

🔹 Usage

from jarengine import JEGame, JEEvtQuit, JEKey_Space, JETrue
from jarengine.events import Event, EventKeyboard

game = JEGame(use_input=JETrue)

# Create event callbacks
def on_quit(game, event):
    game.close()

def on_space(game, event):
    print("Space pressed")

# Register event watchers
game.event.add(
    Event.JEEventWatcher(
        JEEvtQuit,
        on_quit
    )
)

game.event.add(
    EventKeyboard.JEKeyWatcher(
        JEKey_Space,
        on_space
    )
)

while game.is_open:
    game.update()

Events are registered as watchers and automatically processed by the game’s event manager.

🔹 Notes

Useful information:

• Event, keyboard and mouse codes can be combined into groups.
• Runtime events are automatically generated from PyGame events.
• Avoid creating custom runtime events manually.