Events - JakeTurner616/pygame-lua-bindings GitHub Wiki
register_event_handler(event_name, handler)
Register a handler function for a specific event.
#Parameters::
event_name
: Name of the event to handle (e.g., 'on_key_down').handler
: The function to call when the event occurs.
set_event_handling_active(active)
Set the flag to enable or disable event handling.
#Parameters::
active
: True to enable event handling, False to disable it.
handle_events()
Handle Pygame events by calling registered Lua event handlers. This function should be called regularly to process events and keep the UI responsive.
get_event()
Get a single event from the event queue. Equivalent to pygame.event.get()
but returns a single event.
get_events(eventtype=None, pump=True, exclude=None)
Get events from the event queue. Equivalent to pygame.event.get(eventtype, pump, exclude)
.
#Parameters::
eventtype
: The type of events to get.pump
: Whether to pump the event queue.exclude
: Events to exclude from the returned list.
pump_events()
Pump the event queue to keep the UI responsive. Equivalent to pygame.event.pump()
.
poll_event()
Poll for a single event from the event queue. Equivalent to pygame.event.poll()
.
wait_event()
Wait for a single event from the event queue. Equivalent to pygame.event.wait()
.
peek_event(eventtype=None)
Check if there are events of a certain type in the event queue. Equivalent to pygame.event.peek(eventtype)
.
#Parameters::
eventtype
: The type of events to check for.
clear_events(eventtype=None)
Clear events from the event queue. Equivalent to pygame.event.clear(eventtype)
.
#Parameters::
eventtype
: The type of events to clear.
event_name(event_id)
Get the name of an event given its ID. Equivalent to pygame.event.event_name(event_id)
.
#Parameters::
event_id
: The ID of the event.
set_blocked(eventtype)
Block a certain type of event. Equivalent to pygame.event.set_blocked(eventtype)
.
#Parameters::
eventtype
: The type of event to block.
set_allowed(eventtype)
Allow a certain type of event. Equivalent to pygame.event.set_allowed(eventtype)
.
#Parameters::
eventtype
: The type of event to allow.
get_blocked(eventtype)
Check if a certain type of event is blocked. Equivalent to pygame.event.get_blocked(eventtype)
.
#Parameters::
eventtype
: The type of event to check.
set_grab(grab)
Set the input grab mode. Equivalent to pygame.event.set_grab(grab)
.
#Parameters::
grab
: Boolean flag to enable or disable input grab.
get_grab()
Get the current input grab mode. Equivalent to pygame.event.get_grab()
.
set_keyboard_grab(grab)
Set the keyboard input grab mode. Equivalent to pygame.event.set_keyboard_grab(grab)
.
#Parameters::
grab
: Boolean flag to enable or disable keyboard input grab.
get_keyboard_grab()
Get the current keyboard input grab mode. Equivalent to pygame.event.get_keyboard_grab()
.
post_event(event)
Post a new event to the event queue. Equivalent to pygame.event.post(event)
.
#Parameters::
event
: The event to post.
custom_event_type()
Create a new custom event type. Equivalent to pygame.event.custom_type()
.
Event(eventtype, dict=None)
Create a new event object. Equivalent to pygame.event.Event(eventtype, dict)
.
#Parameters::
eventtype
: The type of event to create.dict
: Dictionary of attributes for the event.
Event constants
MOUSEBUTTONDOWN
: Mouse button down eventMOUSEBUTTONUP
: Mouse button up eventMOUSEMOTION
: Mouse motion eventQUIT
: Quit eventVIDEORESIZE
: Video resize eventKEYDOWN
: Key down eventKEYUP
: Key up event