Mercurial > sdl-ios-xcode
annotate include/SDL_events.h @ 4216:5b99971a27b4 SDL-1.2
Fixed bug #698
Hans de Goede 2009-02-13 01:10:52 PST
Since the new "glitch free" version of pulseaudio (used in Fedora 10 amongst
others), the sound of SDL using apps (like a simple playmus call) has been
crackling.
While looking in to fixing this I noticed that the current pulseaudio code in
SDL uses pa_simple. However pa_simple uses a thread to pump pulseaudio events
and ipc, given that SDL already has its own thread for audio handling this is
clearly suboptimal, leading to unnecessary context switching IPC, etc. Also
pa_simple does not allow one to implement the WaitAudio() callback for SDL
audiodrivers properly.
Given that my work is mostly a rewrite (although some original pieces remain)
I'm attaching the new .c and .h file, as that is easier to review then the huge
diff.
Let me know if you also want the diff.
This new version has the following features:
-no longer use an additional thread next to the SDL sound thread
-do not crackle with glitch free audio
-when used with a newer pulse, which does glitch free audio, the total latency
is
the same as with the alsa driver
-proper WaitAudio() implementation, saving another mixlen worth of latency
-adds a WaitDone() implementation
This patch has been written in consultancy with Lennart Poetering (the
pulseaudio author) and has been reviewed by him for correct use of the pa API.
| author | Sam Lantinga <slouken@libsdl.org> |
|---|---|
| date | Mon, 21 Sep 2009 09:27:08 +0000 |
| parents | a1b03ba2fcd0 |
| children | 4c4113c2162c |
| rev | line source |
|---|---|
| 0 | 1 /* |
| 2 SDL - Simple DirectMedia Layer | |
| 4159 | 3 Copyright (C) 1997-2009 Sam Lantinga |
| 0 | 4 |
| 5 This library is free software; you can redistribute it and/or | |
|
1312
c9b51268668f
Updated copyright information and removed rcs id lines (problematic in branch merges)
Sam Lantinga <slouken@libsdl.org>
parents:
1301
diff
changeset
|
6 modify it under the terms of the GNU Lesser General Public |
| 0 | 7 License as published by the Free Software Foundation; either |
|
1312
c9b51268668f
Updated copyright information and removed rcs id lines (problematic in branch merges)
Sam Lantinga <slouken@libsdl.org>
parents:
1301
diff
changeset
|
8 version 2.1 of the License, or (at your option) any later version. |
| 0 | 9 |
| 10 This library is distributed in the hope that it will be useful, | |
| 11 but WITHOUT ANY WARRANTY; without even the implied warranty of | |
| 12 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU | |
|
1312
c9b51268668f
Updated copyright information and removed rcs id lines (problematic in branch merges)
Sam Lantinga <slouken@libsdl.org>
parents:
1301
diff
changeset
|
13 Lesser General Public License for more details. |
| 0 | 14 |
|
1312
c9b51268668f
Updated copyright information and removed rcs id lines (problematic in branch merges)
Sam Lantinga <slouken@libsdl.org>
parents:
1301
diff
changeset
|
15 You should have received a copy of the GNU Lesser General Public |
|
c9b51268668f
Updated copyright information and removed rcs id lines (problematic in branch merges)
Sam Lantinga <slouken@libsdl.org>
parents:
1301
diff
changeset
|
16 License along with this library; if not, write to the Free Software |
|
c9b51268668f
Updated copyright information and removed rcs id lines (problematic in branch merges)
Sam Lantinga <slouken@libsdl.org>
parents:
1301
diff
changeset
|
17 Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA |
| 0 | 18 |
| 19 Sam Lantinga | |
|
251
b8688cfdc232
Updated the headers with the correct e-mail address
Sam Lantinga <slouken@libsdl.org>
parents:
0
diff
changeset
|
20 slouken@libsdl.org |
| 0 | 21 */ |
| 22 | |
| 23 /* Include file for SDL event handling */ | |
| 24 | |
| 25 #ifndef _SDL_events_h | |
| 26 #define _SDL_events_h | |
| 27 | |
|
1356
67114343400d
*** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents:
1330
diff
changeset
|
28 #include "SDL_stdinc.h" |
|
1358
c71e05b4dc2e
More header massaging... works great on Windows. ;-)
Sam Lantinga <slouken@libsdl.org>
parents:
1356
diff
changeset
|
29 #include "SDL_error.h" |
| 0 | 30 #include "SDL_active.h" |
| 31 #include "SDL_keyboard.h" | |
| 32 #include "SDL_mouse.h" | |
| 33 #include "SDL_joystick.h" | |
| 34 #include "SDL_quit.h" | |
| 35 | |
| 36 #include "begin_code.h" | |
| 37 /* Set up for C function definitions, even when using C++ */ | |
| 38 #ifdef __cplusplus | |
| 39 extern "C" { | |
| 40 #endif | |
| 41 | |
|
1330
450721ad5436
It's now possible to build SDL without any C runtime at all on Windows,
Sam Lantinga <slouken@libsdl.org>
parents:
1312
diff
changeset
|
42 /* General keyboard/mouse state definitions */ |
|
450721ad5436
It's now possible to build SDL without any C runtime at all on Windows,
Sam Lantinga <slouken@libsdl.org>
parents:
1312
diff
changeset
|
43 #define SDL_RELEASED 0 |
|
450721ad5436
It's now possible to build SDL without any C runtime at all on Windows,
Sam Lantinga <slouken@libsdl.org>
parents:
1312
diff
changeset
|
44 #define SDL_PRESSED 1 |
|
450721ad5436
It's now possible to build SDL without any C runtime at all on Windows,
Sam Lantinga <slouken@libsdl.org>
parents:
1312
diff
changeset
|
45 |
| 0 | 46 /* Event enumerations */ |
|
1294
1760ceb23bc6
Date: Fri, 18 Feb 2005 20:49:35 +0200 (EET)
Sam Lantinga <slouken@libsdl.org>
parents:
1258
diff
changeset
|
47 typedef enum { |
|
1760ceb23bc6
Date: Fri, 18 Feb 2005 20:49:35 +0200 (EET)
Sam Lantinga <slouken@libsdl.org>
parents:
1258
diff
changeset
|
48 SDL_NOEVENT = 0, /* Unused (do not remove) */ |
| 0 | 49 SDL_ACTIVEEVENT, /* Application loses/gains visibility */ |
| 50 SDL_KEYDOWN, /* Keys pressed */ | |
| 51 SDL_KEYUP, /* Keys released */ | |
| 52 SDL_MOUSEMOTION, /* Mouse moved */ | |
| 53 SDL_MOUSEBUTTONDOWN, /* Mouse button pressed */ | |
| 54 SDL_MOUSEBUTTONUP, /* Mouse button released */ | |
| 55 SDL_JOYAXISMOTION, /* Joystick axis motion */ | |
| 56 SDL_JOYBALLMOTION, /* Joystick trackball motion */ | |
| 57 SDL_JOYHATMOTION, /* Joystick hat position change */ | |
| 58 SDL_JOYBUTTONDOWN, /* Joystick button pressed */ | |
| 59 SDL_JOYBUTTONUP, /* Joystick button released */ | |
| 60 SDL_QUIT, /* User-requested quit */ | |
| 61 SDL_SYSWMEVENT, /* System specific event */ | |
| 62 SDL_EVENT_RESERVEDA, /* Reserved for future use.. */ | |
| 63 SDL_EVENT_RESERVEDB, /* Reserved for future use.. */ | |
| 64 SDL_VIDEORESIZE, /* User resized video mode */ | |
| 65 SDL_VIDEOEXPOSE, /* Screen needs to be redrawn */ | |
| 66 SDL_EVENT_RESERVED2, /* Reserved for future use.. */ | |
| 67 SDL_EVENT_RESERVED3, /* Reserved for future use.. */ | |
| 68 SDL_EVENT_RESERVED4, /* Reserved for future use.. */ | |
| 69 SDL_EVENT_RESERVED5, /* Reserved for future use.. */ | |
| 70 SDL_EVENT_RESERVED6, /* Reserved for future use.. */ | |
| 71 SDL_EVENT_RESERVED7, /* Reserved for future use.. */ | |
| 72 /* Events SDL_USEREVENT through SDL_MAXEVENTS-1 are for your use */ | |
| 73 SDL_USEREVENT = 24, | |
| 74 /* This last event is only for bounding internal arrays | |
| 75 It is the number of bits in the event mask datatype -- Uint32 | |
| 76 */ | |
| 77 SDL_NUMEVENTS = 32 | |
|
1294
1760ceb23bc6
Date: Fri, 18 Feb 2005 20:49:35 +0200 (EET)
Sam Lantinga <slouken@libsdl.org>
parents:
1258
diff
changeset
|
78 } SDL_EventType; |
| 0 | 79 |
| 80 /* Predefined event masks */ | |
| 81 #define SDL_EVENTMASK(X) (1<<(X)) | |
|
1294
1760ceb23bc6
Date: Fri, 18 Feb 2005 20:49:35 +0200 (EET)
Sam Lantinga <slouken@libsdl.org>
parents:
1258
diff
changeset
|
82 typedef enum { |
| 0 | 83 SDL_ACTIVEEVENTMASK = SDL_EVENTMASK(SDL_ACTIVEEVENT), |
| 84 SDL_KEYDOWNMASK = SDL_EVENTMASK(SDL_KEYDOWN), | |
| 85 SDL_KEYUPMASK = SDL_EVENTMASK(SDL_KEYUP), | |
|
1297
7b32c7a586c9
*** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents:
1294
diff
changeset
|
86 SDL_KEYEVENTMASK = SDL_EVENTMASK(SDL_KEYDOWN)| |
| 1301 | 87 SDL_EVENTMASK(SDL_KEYUP), |
| 0 | 88 SDL_MOUSEMOTIONMASK = SDL_EVENTMASK(SDL_MOUSEMOTION), |
| 89 SDL_MOUSEBUTTONDOWNMASK = SDL_EVENTMASK(SDL_MOUSEBUTTONDOWN), | |
| 90 SDL_MOUSEBUTTONUPMASK = SDL_EVENTMASK(SDL_MOUSEBUTTONUP), | |
| 91 SDL_MOUSEEVENTMASK = SDL_EVENTMASK(SDL_MOUSEMOTION)| | |
| 92 SDL_EVENTMASK(SDL_MOUSEBUTTONDOWN)| | |
| 93 SDL_EVENTMASK(SDL_MOUSEBUTTONUP), | |
| 94 SDL_JOYAXISMOTIONMASK = SDL_EVENTMASK(SDL_JOYAXISMOTION), | |
| 95 SDL_JOYBALLMOTIONMASK = SDL_EVENTMASK(SDL_JOYBALLMOTION), | |
| 96 SDL_JOYHATMOTIONMASK = SDL_EVENTMASK(SDL_JOYHATMOTION), | |
| 97 SDL_JOYBUTTONDOWNMASK = SDL_EVENTMASK(SDL_JOYBUTTONDOWN), | |
| 98 SDL_JOYBUTTONUPMASK = SDL_EVENTMASK(SDL_JOYBUTTONUP), | |
| 99 SDL_JOYEVENTMASK = SDL_EVENTMASK(SDL_JOYAXISMOTION)| | |
| 100 SDL_EVENTMASK(SDL_JOYBALLMOTION)| | |
| 101 SDL_EVENTMASK(SDL_JOYHATMOTION)| | |
| 102 SDL_EVENTMASK(SDL_JOYBUTTONDOWN)| | |
| 103 SDL_EVENTMASK(SDL_JOYBUTTONUP), | |
| 104 SDL_VIDEORESIZEMASK = SDL_EVENTMASK(SDL_VIDEORESIZE), | |
| 105 SDL_VIDEOEXPOSEMASK = SDL_EVENTMASK(SDL_VIDEOEXPOSE), | |
| 106 SDL_QUITMASK = SDL_EVENTMASK(SDL_QUIT), | |
| 107 SDL_SYSWMEVENTMASK = SDL_EVENTMASK(SDL_SYSWMEVENT) | |
|
1294
1760ceb23bc6
Date: Fri, 18 Feb 2005 20:49:35 +0200 (EET)
Sam Lantinga <slouken@libsdl.org>
parents:
1258
diff
changeset
|
108 } SDL_EventMask ; |
| 0 | 109 #define SDL_ALLEVENTS 0xFFFFFFFF |
| 110 | |
| 111 /* Application visibility event structure */ | |
|
911
04a403e4ccf5
Date: Mon, 3 May 2004 03:15:01 +0100
Sam Lantinga <slouken@libsdl.org>
parents:
844
diff
changeset
|
112 typedef struct SDL_ActiveEvent { |
| 0 | 113 Uint8 type; /* SDL_ACTIVEEVENT */ |
| 114 Uint8 gain; /* Whether given states were gained or lost (1/0) */ | |
| 115 Uint8 state; /* A mask of the focus states */ | |
| 116 } SDL_ActiveEvent; | |
| 117 | |
| 118 /* Keyboard event structure */ | |
|
911
04a403e4ccf5
Date: Mon, 3 May 2004 03:15:01 +0100
Sam Lantinga <slouken@libsdl.org>
parents:
844
diff
changeset
|
119 typedef struct SDL_KeyboardEvent { |
| 0 | 120 Uint8 type; /* SDL_KEYDOWN or SDL_KEYUP */ |
| 121 Uint8 which; /* The keyboard device index */ | |
| 122 Uint8 state; /* SDL_PRESSED or SDL_RELEASED */ | |
| 123 SDL_keysym keysym; | |
| 124 } SDL_KeyboardEvent; | |
| 125 | |
| 126 /* Mouse motion event structure */ | |
|
911
04a403e4ccf5
Date: Mon, 3 May 2004 03:15:01 +0100
Sam Lantinga <slouken@libsdl.org>
parents:
844
diff
changeset
|
127 typedef struct SDL_MouseMotionEvent { |
| 0 | 128 Uint8 type; /* SDL_MOUSEMOTION */ |
| 129 Uint8 which; /* The mouse device index */ | |
| 130 Uint8 state; /* The current button state */ | |
| 131 Uint16 x, y; /* The X/Y coordinates of the mouse */ | |
| 132 Sint16 xrel; /* The relative motion in the X direction */ | |
| 133 Sint16 yrel; /* The relative motion in the Y direction */ | |
| 134 } SDL_MouseMotionEvent; | |
| 135 | |
| 136 /* Mouse button event structure */ | |
|
911
04a403e4ccf5
Date: Mon, 3 May 2004 03:15:01 +0100
Sam Lantinga <slouken@libsdl.org>
parents:
844
diff
changeset
|
137 typedef struct SDL_MouseButtonEvent { |
| 0 | 138 Uint8 type; /* SDL_MOUSEBUTTONDOWN or SDL_MOUSEBUTTONUP */ |
| 139 Uint8 which; /* The mouse device index */ | |
| 140 Uint8 button; /* The mouse button index */ | |
| 141 Uint8 state; /* SDL_PRESSED or SDL_RELEASED */ | |
| 142 Uint16 x, y; /* The X/Y coordinates of the mouse at press time */ | |
| 143 } SDL_MouseButtonEvent; | |
| 144 | |
| 145 /* Joystick axis motion event structure */ | |
|
911
04a403e4ccf5
Date: Mon, 3 May 2004 03:15:01 +0100
Sam Lantinga <slouken@libsdl.org>
parents:
844
diff
changeset
|
146 typedef struct SDL_JoyAxisEvent { |
| 0 | 147 Uint8 type; /* SDL_JOYAXISMOTION */ |
| 148 Uint8 which; /* The joystick device index */ | |
| 149 Uint8 axis; /* The joystick axis index */ | |
| 150 Sint16 value; /* The axis value (range: -32768 to 32767) */ | |
| 151 } SDL_JoyAxisEvent; | |
| 152 | |
| 153 /* Joystick trackball motion event structure */ | |
|
911
04a403e4ccf5
Date: Mon, 3 May 2004 03:15:01 +0100
Sam Lantinga <slouken@libsdl.org>
parents:
844
diff
changeset
|
154 typedef struct SDL_JoyBallEvent { |
| 0 | 155 Uint8 type; /* SDL_JOYBALLMOTION */ |
| 156 Uint8 which; /* The joystick device index */ | |
| 157 Uint8 ball; /* The joystick trackball index */ | |
| 158 Sint16 xrel; /* The relative motion in the X direction */ | |
| 159 Sint16 yrel; /* The relative motion in the Y direction */ | |
| 160 } SDL_JoyBallEvent; | |
| 161 | |
| 162 /* Joystick hat position change event structure */ | |
|
911
04a403e4ccf5
Date: Mon, 3 May 2004 03:15:01 +0100
Sam Lantinga <slouken@libsdl.org>
parents:
844
diff
changeset
|
163 typedef struct SDL_JoyHatEvent { |
| 0 | 164 Uint8 type; /* SDL_JOYHATMOTION */ |
| 165 Uint8 which; /* The joystick device index */ | |
| 166 Uint8 hat; /* The joystick hat index */ | |
| 167 Uint8 value; /* The hat position value: | |
|
577
f7596a8a3b8b
Fixed header docs for the joystick hat position
Sam Lantinga <slouken@libsdl.org>
parents:
337
diff
changeset
|
168 SDL_HAT_LEFTUP SDL_HAT_UP SDL_HAT_RIGHTUP |
|
f7596a8a3b8b
Fixed header docs for the joystick hat position
Sam Lantinga <slouken@libsdl.org>
parents:
337
diff
changeset
|
169 SDL_HAT_LEFT SDL_HAT_CENTERED SDL_HAT_RIGHT |
|
f7596a8a3b8b
Fixed header docs for the joystick hat position
Sam Lantinga <slouken@libsdl.org>
parents:
337
diff
changeset
|
170 SDL_HAT_LEFTDOWN SDL_HAT_DOWN SDL_HAT_RIGHTDOWN |
| 0 | 171 Note that zero means the POV is centered. |
| 172 */ | |
| 173 } SDL_JoyHatEvent; | |
| 174 | |
| 175 /* Joystick button event structure */ | |
|
911
04a403e4ccf5
Date: Mon, 3 May 2004 03:15:01 +0100
Sam Lantinga <slouken@libsdl.org>
parents:
844
diff
changeset
|
176 typedef struct SDL_JoyButtonEvent { |
| 0 | 177 Uint8 type; /* SDL_JOYBUTTONDOWN or SDL_JOYBUTTONUP */ |
| 178 Uint8 which; /* The joystick device index */ | |
| 179 Uint8 button; /* The joystick button index */ | |
| 180 Uint8 state; /* SDL_PRESSED or SDL_RELEASED */ | |
| 181 } SDL_JoyButtonEvent; | |
| 182 | |
| 183 /* The "window resized" event | |
| 184 When you get this event, you are responsible for setting a new video | |
| 185 mode with the new width and height. | |
| 186 */ | |
|
911
04a403e4ccf5
Date: Mon, 3 May 2004 03:15:01 +0100
Sam Lantinga <slouken@libsdl.org>
parents:
844
diff
changeset
|
187 typedef struct SDL_ResizeEvent { |
| 0 | 188 Uint8 type; /* SDL_VIDEORESIZE */ |
| 189 int w; /* New width */ | |
| 190 int h; /* New height */ | |
| 191 } SDL_ResizeEvent; | |
| 192 | |
| 193 /* The "screen redraw" event */ | |
|
911
04a403e4ccf5
Date: Mon, 3 May 2004 03:15:01 +0100
Sam Lantinga <slouken@libsdl.org>
parents:
844
diff
changeset
|
194 typedef struct SDL_ExposeEvent { |
| 0 | 195 Uint8 type; /* SDL_VIDEOEXPOSE */ |
| 196 } SDL_ExposeEvent; | |
| 197 | |
| 198 /* The "quit requested" event */ | |
|
911
04a403e4ccf5
Date: Mon, 3 May 2004 03:15:01 +0100
Sam Lantinga <slouken@libsdl.org>
parents:
844
diff
changeset
|
199 typedef struct SDL_QuitEvent { |
| 0 | 200 Uint8 type; /* SDL_QUIT */ |
| 201 } SDL_QuitEvent; | |
| 202 | |
| 203 /* A user-defined event type */ | |
|
911
04a403e4ccf5
Date: Mon, 3 May 2004 03:15:01 +0100
Sam Lantinga <slouken@libsdl.org>
parents:
844
diff
changeset
|
204 typedef struct SDL_UserEvent { |
| 0 | 205 Uint8 type; /* SDL_USEREVENT through SDL_NUMEVENTS-1 */ |
| 206 int code; /* User defined event code */ | |
| 207 void *data1; /* User defined data pointer */ | |
| 208 void *data2; /* User defined data pointer */ | |
| 209 } SDL_UserEvent; | |
| 210 | |
| 211 /* If you want to use this event, you should include SDL_syswm.h */ | |
| 212 struct SDL_SysWMmsg; | |
| 213 typedef struct SDL_SysWMmsg SDL_SysWMmsg; | |
|
911
04a403e4ccf5
Date: Mon, 3 May 2004 03:15:01 +0100
Sam Lantinga <slouken@libsdl.org>
parents:
844
diff
changeset
|
214 typedef struct SDL_SysWMEvent { |
| 0 | 215 Uint8 type; |
| 216 SDL_SysWMmsg *msg; | |
| 217 } SDL_SysWMEvent; | |
| 218 | |
| 219 /* General event structure */ | |
|
1258
b2283b0ded26
Date: Thu, 19 Jan 2006 20:02:29 +0200
Sam Lantinga <slouken@libsdl.org>
parents:
930
diff
changeset
|
220 typedef union SDL_Event { |
| 0 | 221 Uint8 type; |
| 222 SDL_ActiveEvent active; | |
| 223 SDL_KeyboardEvent key; | |
| 224 SDL_MouseMotionEvent motion; | |
| 225 SDL_MouseButtonEvent button; | |
| 226 SDL_JoyAxisEvent jaxis; | |
| 227 SDL_JoyBallEvent jball; | |
| 228 SDL_JoyHatEvent jhat; | |
| 229 SDL_JoyButtonEvent jbutton; | |
| 230 SDL_ResizeEvent resize; | |
| 231 SDL_ExposeEvent expose; | |
| 232 SDL_QuitEvent quit; | |
| 233 SDL_UserEvent user; | |
| 234 SDL_SysWMEvent syswm; | |
| 235 } SDL_Event; | |
| 236 | |
| 237 | |
| 238 /* Function prototypes */ | |
| 239 | |
| 240 /* Pumps the event loop, gathering events from the input devices. | |
| 241 This function updates the event queue and internal input device state. | |
| 242 This should only be run in the thread that sets the video mode. | |
| 243 */ | |
|
337
9154ec9ca3d2
Explicitly specify the SDL API calling convention (C by default)
Sam Lantinga <slouken@libsdl.org>
parents:
297
diff
changeset
|
244 extern DECLSPEC void SDLCALL SDL_PumpEvents(void); |
| 0 | 245 |
| 246 /* Checks the event queue for messages and optionally returns them. | |
| 247 If 'action' is SDL_ADDEVENT, up to 'numevents' events will be added to | |
| 248 the back of the event queue. | |
| 249 If 'action' is SDL_PEEKEVENT, up to 'numevents' events at the front | |
| 250 of the event queue, matching 'mask', will be returned and will not | |
| 251 be removed from the queue. | |
| 252 If 'action' is SDL_GETEVENT, up to 'numevents' events at the front | |
| 253 of the event queue, matching 'mask', will be returned and will be | |
| 254 removed from the queue. | |
| 255 This function returns the number of events actually stored, or -1 | |
| 256 if there was an error. This function is thread-safe. | |
| 257 */ | |
| 258 typedef enum { | |
| 259 SDL_ADDEVENT, | |
| 260 SDL_PEEKEVENT, | |
| 261 SDL_GETEVENT | |
| 262 } SDL_eventaction; | |
| 263 /* */ | |
|
337
9154ec9ca3d2
Explicitly specify the SDL API calling convention (C by default)
Sam Lantinga <slouken@libsdl.org>
parents:
297
diff
changeset
|
264 extern DECLSPEC int SDLCALL SDL_PeepEvents(SDL_Event *events, int numevents, |
| 0 | 265 SDL_eventaction action, Uint32 mask); |
| 266 | |
| 267 /* Polls for currently pending events, and returns 1 if there are any pending | |
| 268 events, or 0 if there are none available. If 'event' is not NULL, the next | |
| 269 event is removed from the queue and stored in that area. | |
| 270 */ | |
|
337
9154ec9ca3d2
Explicitly specify the SDL API calling convention (C by default)
Sam Lantinga <slouken@libsdl.org>
parents:
297
diff
changeset
|
271 extern DECLSPEC int SDLCALL SDL_PollEvent(SDL_Event *event); |
| 0 | 272 |
| 273 /* Waits indefinitely for the next available event, returning 1, or 0 if there | |
| 274 was an error while waiting for events. If 'event' is not NULL, the next | |
| 275 event is removed from the queue and stored in that area. | |
| 276 */ | |
|
337
9154ec9ca3d2
Explicitly specify the SDL API calling convention (C by default)
Sam Lantinga <slouken@libsdl.org>
parents:
297
diff
changeset
|
277 extern DECLSPEC int SDLCALL SDL_WaitEvent(SDL_Event *event); |
| 0 | 278 |
| 279 /* Add an event to the event queue. | |
|
844
cd0c77df70a4
*** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents:
769
diff
changeset
|
280 This function returns 0 on success, or -1 if the event queue was full |
|
cd0c77df70a4
*** empty log message ***
Sam Lantinga <slouken@libsdl.org>
parents:
769
diff
changeset
|
281 or there was some other error. |
| 0 | 282 */ |
|
337
9154ec9ca3d2
Explicitly specify the SDL API calling convention (C by default)
Sam Lantinga <slouken@libsdl.org>
parents:
297
diff
changeset
|
283 extern DECLSPEC int SDLCALL SDL_PushEvent(SDL_Event *event); |
| 0 | 284 |
| 285 /* | |
| 286 This function sets up a filter to process all events before they | |
| 287 change internal state and are posted to the internal event queue. | |
| 288 | |
| 289 The filter is protypted as: | |
| 290 */ | |
|
930
02759105b989
Date: Fri, 20 Aug 2004 08:31:20 +0200
Sam Lantinga <slouken@libsdl.org>
parents:
911
diff
changeset
|
291 typedef int (SDLCALL *SDL_EventFilter)(const SDL_Event *event); |
| 0 | 292 /* |
| 293 If the filter returns 1, then the event will be added to the internal queue. | |
| 294 If it returns 0, then the event will be dropped from the queue, but the | |
| 295 internal state will still be updated. This allows selective filtering of | |
| 296 dynamically arriving events. | |
| 297 | |
| 298 WARNING: Be very careful of what you do in the event filter function, as | |
| 299 it may run in a different thread! | |
| 300 | |
| 301 There is one caveat when dealing with the SDL_QUITEVENT event type. The | |
| 302 event filter is only called when the window manager desires to close the | |
| 303 application window. If the event filter returns 1, then the window will | |
| 304 be closed, otherwise the window will remain open if possible. | |
| 305 If the quit event is generated by an interrupt signal, it will bypass the | |
| 306 internal queue and be delivered to the application at the next event poll. | |
| 307 */ | |
|
337
9154ec9ca3d2
Explicitly specify the SDL API calling convention (C by default)
Sam Lantinga <slouken@libsdl.org>
parents:
297
diff
changeset
|
308 extern DECLSPEC void SDLCALL SDL_SetEventFilter(SDL_EventFilter filter); |
| 0 | 309 |
| 310 /* | |
| 311 Return the current event filter - can be used to "chain" filters. | |
| 312 If there is no event filter set, this function returns NULL. | |
| 313 */ | |
|
337
9154ec9ca3d2
Explicitly specify the SDL API calling convention (C by default)
Sam Lantinga <slouken@libsdl.org>
parents:
297
diff
changeset
|
314 extern DECLSPEC SDL_EventFilter SDLCALL SDL_GetEventFilter(void); |
| 0 | 315 |
| 316 /* | |
| 317 This function allows you to set the state of processing certain events. | |
| 318 If 'state' is set to SDL_IGNORE, that event will be automatically dropped | |
| 319 from the event queue and will not event be filtered. | |
| 320 If 'state' is set to SDL_ENABLE, that event will be processed normally. | |
| 321 If 'state' is set to SDL_QUERY, SDL_EventState() will return the | |
| 322 current processing state of the specified event. | |
| 323 */ | |
| 324 #define SDL_QUERY -1 | |
| 325 #define SDL_IGNORE 0 | |
| 326 #define SDL_DISABLE 0 | |
| 327 #define SDL_ENABLE 1 | |
|
337
9154ec9ca3d2
Explicitly specify the SDL API calling convention (C by default)
Sam Lantinga <slouken@libsdl.org>
parents:
297
diff
changeset
|
328 extern DECLSPEC Uint8 SDLCALL SDL_EventState(Uint8 type, int state); |
| 0 | 329 |
| 330 | |
| 331 /* Ends C function definitions when using C++ */ | |
| 332 #ifdef __cplusplus | |
| 333 } | |
| 334 #endif | |
| 335 #include "close_code.h" | |
| 336 | |
| 337 #endif /* _SDL_events_h */ |