logo
Free, unlimited AI code reviews that run on commit
git-lrc git-lrc GitHub Install Now We'd appreciate a star git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt

SDL_SetEventFilter - Set up a filter to process all events before they are added to the internal event

Availability

       This function is available since SDL 3.2.0.

Description

       If you just want to see events without modifying them or preventing them from being  queued,  you  should
       use SDL_AddEventWatch () instead.

       If  the  filter function returns true when called, then the event will be added to the internal queue. If
       it returns false, then the event will be dropped from the queue, but the internal  state  will  still  be
       updated.  This  allows  selective filtering of dynamically arriving events.  WARNING : Be very careful of
       what you do in the event filter function, as it may run in a different thread!

       On platforms that support it, if the quit event is generated by an interrupt signal (e.g. pressing  Ctrl-
       C), it will be delivered to the application at the next event poll.

       Note: Disabled events never make it to the event filter function; see

       SDL_SetEventEnabled ().

       Note:  Events pushed onto the queue with SDL_PushEvent () get passed through the event filter, but events
       pushed onto the queue with

       SDL_PeepEvents () do not.

Function Parameters

filter an SDL_EventFilter
               function to call when an event happens.

       userdata
              a pointer that is passed to filter .

Header File

       Defined in SDL3/SDL_events.h

Name

       SDL_SetEventFilter  -  Set  up a filter to process all events before they are added to the internal event
       queue.

See Also

(3),   SDL_AddEventWatch(3),   (3),   SDL_SetEventEnabled(3),   (3),   SDL_GetEventFilter(3),    (3),
       SDL_PeepEvents(3), (3), SDL_PushEvent(3)

Simple Directmedia Layer                           SDL 3.2.10                              SDL_SetEventFilter(3)

Synopsis

#include"SDL3/SDL.h"voidSDL_SetEventFilter(SDL_EventFilterfilter,void*userdata);

Thread Safety

       It is safe to call this function from any thread.

See Also