SDL_SetEventFilter man page on JazzOS

Man page or keyword search:  
man Server   2339 pages
apropos Keyword Search (all sections)
Output format
JazzOS logo
[printable version]

SDL_SetEventFilter(3)	       SDL API Reference	 SDL_SetEventFilter(3)

       SDL_SetEventFilter - Sets up a filter to process all events before they
       are posted to the event queue.

       #include "SDL.h"

       void SDL_SetEventFilter(SDL_EventFilter filter);

       This function sets up a filter to process all events  before  they  are
       posted  to  the	event queue. This is a very powerful and flexible fea‐
       ture. The filter is prototyped as:

       typedef int (*SDL_EventFilter)(const SDL_Event *event);

	If the filter returns 1, then the event will be added to the  internal
       queue.  If it returns 0, then the event will be dropped from the queue.
       This allows selective filtering of dynamically.

       There is one caveat when dealing with the SDL_QUITEVENT event type. The
       event  filter  is  only called when the window manager desires to close
       the application window. If the event filter returns 1, then the	window
       will  be	 closed, otherwise the window will remain open if possible. If
       the quit event is generated by an interrupt signal, it will bypass  the
       internal	 queue	and  be delivered to the application at the next event


	      Events pushed onto the queue  with  SDL_PushEvent	 or  SDL_Peep‐
	      Events do not get passed through the event filter.


	      Be  Careful!  The	 event	filter function may run in a different
	      thread so be careful what you do within it.

       SDL_Event, SDL_GetEventFilter, SDL_PushEvent

SDL			    Tue 11 Sep 2001, 22:59	 SDL_SetEventFilter(3)

List of man pages available for JazzOS

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
Vote for polarhome
Free Shell Accounts :: the biggest list on the net