SDL.c
1
2
/*
SDL - Simple DirectMedia Layer
3
Copyright (C) 1997-2012 Sam Lantinga
4
5
This library is free software; you can redistribute it and/or
6
modify it under the terms of the GNU Lesser General Public
7
License as published by the Free Software Foundation; either
8
version 2.1 of the License, or (at your option) any later version.
9
10
11
12
This library is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13
Lesser General Public License for more details.
15
16
17
You should have received a copy of the GNU Lesser General Public
License along with this library; if not, write to the Free Software
Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
18
19
Sam Lantinga
20
slouken@libsdl.org
21
*/
22
#include "SDL_config.h"
23
24
25
26
27
/* Initialization code for SDL */
#include "SDL.h"
#include "SDL_fatal.h"
28
29
30
31
32
33
#if !SDL_VIDEO_DISABLED
#include "video/SDL_leaks.h"
#endif
#if SDL_THREAD_PTH
#include <pth.h>
34
35
36
#endif
/* Initialization/Cleanup routines */
37
#if !SDL_JOYSTICK_DISABLED
38
39
40
extern int SDL_JoystickInit(void);
extern void SDL_JoystickQuit(void);
#endif
41
#if !SDL_CDROM_DISABLED
42
43
44
extern int SDL_CDROMInit(void);
extern void SDL_CDROMQuit(void);
#endif
45
#if !SDL_TIMERS_DISABLED
46
47
48
49
50
51
52
53
54
55
56
extern void SDL_StartTicks(void);
extern int SDL_TimerInit(void);
extern void SDL_TimerQuit(void);
#endif
/* The current SDL version */
static SDL_version version =
{ SDL_MAJOR_VERSION, SDL_MINOR_VERSION, SDL_PATCHLEVEL };
/* The initialized subsystems */
static Uint32 SDL_initialized = 0;
57
#if !SDL_TIMERS_DISABLED
58
static Uint32 ticks_started = 0;
60
61
62
63
64
65
66
#ifdef CHECK_LEAKS
int surfaces_allocated = 0;
#endif
int SDL_InitSubSystem(Uint32 flags)
{
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
#if !SDL_TIMERS_DISABLED
/* Initialize the timer subsystem */
if ( ! ticks_started ) {
SDL_StartTicks();
ticks_started = 1;
}
if ( (flags & SDL_INIT_TIMER) && !(SDL_initialized & SDL_INIT_TIMER) ) {
if ( SDL_TimerInit() < 0 ) {
return(-1);
}
SDL_initialized |= SDL_INIT_TIMER;
}
#else
if ( flags & SDL_INIT_TIMER ) {
SDL_SetError("SDL not built with timer support");
return(-1);
}
#endif
86
#if !SDL_VIDEO_DISABLED
87
88
/* Initialize the video/event subsystem */
if ( (flags & SDL_INIT_VIDEO) && !(SDL_initialized & SDL_INIT_VIDEO) ) {
89
if ( SDL_VideoInit(SDL_getenv("SDL_VIDEODRIVER"),
90
91
92
93
94
95
96
97
98
99
100
101
(flags&SDL_INIT_EVENTTHREAD)) < 0 ) {
return(-1);
}
SDL_initialized |= SDL_INIT_VIDEO;
}
#else
if ( flags & SDL_INIT_VIDEO ) {
SDL_SetError("SDL not built with video support");
return(-1);
}
#endif
102
#if !SDL_AUDIO_DISABLED
103
104
/* Initialize the audio subsystem */
if ( (flags & SDL_INIT_AUDIO) && !(SDL_initialized & SDL_INIT_AUDIO) ) {
105
if ( SDL_AudioInit(SDL_getenv("SDL_AUDIODRIVER")) < 0 ) {
106
107
108
109
110
111
112
113
114
115
116
return(-1);
}
SDL_initialized |= SDL_INIT_AUDIO;
}
#else
if ( flags & SDL_INIT_AUDIO ) {
SDL_SetError("SDL not built with audio support");
return(-1);
}
#endif
117
#if !SDL_JOYSTICK_DISABLED
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
/* Initialize the joystick subsystem */
if ( (flags & SDL_INIT_JOYSTICK) &&
!(SDL_initialized & SDL_INIT_JOYSTICK) ) {
if ( SDL_JoystickInit() < 0 ) {
return(-1);
}
SDL_initialized |= SDL_INIT_JOYSTICK;
}
#else
if ( flags & SDL_INIT_JOYSTICK ) {
SDL_SetError("SDL not built with joystick support");
return(-1);
}
#endif
133
#if !SDL_CDROM_DISABLED
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
/* Initialize the CD-ROM subsystem */
if ( (flags & SDL_INIT_CDROM) && !(SDL_initialized & SDL_INIT_CDROM) ) {
if ( SDL_CDROMInit() < 0 ) {
return(-1);
}
SDL_initialized |= SDL_INIT_CDROM;
}
#else
if ( flags & SDL_INIT_CDROM ) {
SDL_SetError("SDL not built with cdrom support");
return(-1);
}
#endif
return(0);
}
int SDL_Init(Uint32 flags)
{
152
#if !SDL_THREADS_DISABLED && SDL_THREAD_PTH
153
154
155
156
157
if (!pth_init()) {
return -1;
}
#endif
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
/* Clear the error message */
SDL_ClearError();
/* Initialize the desired subsystems */
if ( SDL_InitSubSystem(flags) < 0 ) {
return(-1);
}
/* Everything is initialized */
if ( !(flags & SDL_INIT_NOPARACHUTE) ) {
SDL_InstallParachute();
}
return(0);
}
void SDL_QuitSubSystem(Uint32 flags)
{
/* Shut down requested initialized subsystems */
176
#if !SDL_CDROM_DISABLED
177
178
179
180
181
if ( (flags & SDL_initialized & SDL_INIT_CDROM) ) {
SDL_CDROMQuit();
SDL_initialized &= ~SDL_INIT_CDROM;
}
#endif
182
#if !SDL_JOYSTICK_DISABLED
183
184
185
186
187
if ( (flags & SDL_initialized & SDL_INIT_JOYSTICK) ) {
SDL_JoystickQuit();
SDL_initialized &= ~SDL_INIT_JOYSTICK;
}
#endif
188
#if !SDL_AUDIO_DISABLED
189
190
191
192
193
if ( (flags & SDL_initialized & SDL_INIT_AUDIO) ) {
SDL_AudioQuit();
SDL_initialized &= ~SDL_INIT_AUDIO;
}
#endif
194
#if !SDL_VIDEO_DISABLED
195
196
197
198
199
if ( (flags & SDL_initialized & SDL_INIT_VIDEO) ) {
SDL_VideoQuit();
SDL_initialized &= ~SDL_INIT_VIDEO;
}
#endif
200
201
202
203
204
205
#if !SDL_TIMERS_DISABLED
if ( (flags & SDL_initialized & SDL_INIT_TIMER) ) {
SDL_TimerQuit();
SDL_initialized &= ~SDL_INIT_TIMER;
}
#endif
206
207
208
209
210
211
212
213
214
215
216
217
218
}
Uint32 SDL_WasInit(Uint32 flags)
{
if ( ! flags ) {
flags = SDL_INIT_EVERYTHING;
}
return (SDL_initialized&flags);
}
void SDL_Quit(void)
{
/* Quit all subsystems */
219
220
221
#ifdef DEBUG_BUILD
printf("[SDL_Quit] : Enter! Calling QuitSubSystem()\n"); fflush(stdout);
#endif
222
223
224
SDL_QuitSubSystem(SDL_INIT_EVERYTHING);
#ifdef CHECK_LEAKS
225
226
227
228
#ifdef DEBUG_BUILD
printf("[SDL_Quit] : CHECK_LEAKS\n"); fflush(stdout);
#endif
229
230
231
232
233
234
/* Print the number of surfaces not freed */
if ( surfaces_allocated != 0 ) {
fprintf(stderr, "SDL Warning: %d SDL surfaces extant\n",
surfaces_allocated);
}
#endif
235
236
237
#ifdef DEBUG_BUILD
printf("[SDL_Quit] : SDL_UninstallParachute()\n"); fflush(stdout);
#endif
238
239
240
/* Uninstall any parachute signal handlers */
SDL_UninstallParachute();
242
#if !SDL_THREADS_DISABLED && SDL_THREAD_PTH
243
244
pth_kill();
#endif
245
246
247
248
#ifdef DEBUG_BUILD
printf("[SDL_Quit] : Returning!\n"); fflush(stdout);
#endif
249
250
251
252
253
254
255
256
}
/* Return the library version number */
const SDL_version * SDL_Linked_Version(void)
{
return(&version);
}
257
#if defined(__OS2__)
258
/* Building for OS/2 */
259
260
261
262
263
264
#ifdef __WATCOMC__
#define INCL_DOSERRORS
#define INCL_DOSEXCEPTIONS
#include <os2.h>
265
/* Exception handler to prevent the Audio thread hanging, making a zombie process! */
266
267
268
269
270
271
272
273
274
275
276
277
ULONG _System SDL_Main_ExceptionHandler(PEXCEPTIONREPORTRECORD pERepRec,
PEXCEPTIONREGISTRATIONRECORD pERegRec,
PCONTEXTRECORD pCtxRec,
PVOID p)
{
if (pERepRec->fHandlerFlags & EH_EXIT_UNWIND)
return XCPT_CONTINUE_SEARCH;
if (pERepRec->fHandlerFlags & EH_UNWINDING)
return XCPT_CONTINUE_SEARCH;
if (pERepRec->fHandlerFlags & EH_NESTED_CALL)
return XCPT_CONTINUE_SEARCH;
278
/* Do cleanup at every fatal exception! */
279
280
281
282
283
284
285
if (((pERepRec->ExceptionNum & XCPT_SEVERITY_CODE) == XCPT_FATAL_EXCEPTION) &&
(pERepRec->ExceptionNum != XCPT_BREAKPOINT) &&
(pERepRec->ExceptionNum != XCPT_SINGLE_STEP)
)
{
if (SDL_initialized & SDL_INIT_AUDIO)
{
286
/* This removes the zombie audio thread in case of emergency. */
287
288
289
290
291
292
293
294
295
296
297
298
#ifdef DEBUG_BUILD
printf("[SDL_Main_ExceptionHandler] : Calling SDL_CloseAudio()!\n");
#endif
SDL_CloseAudio();
}
}
return (XCPT_CONTINUE_SEARCH);
}
EXCEPTIONREGISTRATIONRECORD SDL_Main_xcpthand = {0, SDL_Main_ExceptionHandler};
299
/* The main DLL entry for DLL Initialization and Uninitialization: */
300
301
302
303
304
unsigned _System LibMain(unsigned hmod, unsigned termination)
{
if (termination)
{
#ifdef DEBUG_BUILD
305
/* printf("[SDL DLL Unintialization] : Removing exception handler\n"); */
306
307
308
309
310
311
#endif
DosUnsetExceptionHandler(&SDL_Main_xcpthand);
return 1;
} else
{
#ifdef DEBUG_BUILD
312
/* Make stdout and stderr unbuffered! */
313
314
315
setbuf(stdout, NULL);
setbuf(stderr, NULL);
#endif
316
/* Fire up exception handler */
317
#ifdef DEBUG_BUILD
318
/* printf("[SDL DLL Initialization] : Setting exception handler\n"); */
319
#endif
320
/* Set exception handler */
321
322
323
324
325
DosSetExceptionHandler(&SDL_Main_xcpthand);
return 1;
}
}
326
#endif /* __WATCOMC__ */
327
328
#elif defined(__WIN32__) && !defined(__SYMBIAN32__)
330
331
#if !defined(HAVE_LIBC) || (defined(__WATCOMC__) && defined(BUILD_DLL))
/* Need to include DllMain() on Watcom C for some reason.. */
332
333
#define WIN32_LEAN_AND_MEAN
#include <windows.h>
334
335
336
337
338
339
340
341
342
343
344
345
346
347
BOOL APIENTRY _DllMainCRTStartup( HANDLE hModule,
DWORD ul_reason_for_call,
LPVOID lpReserved )
{
switch (ul_reason_for_call) {
case DLL_PROCESS_ATTACH:
case DLL_THREAD_ATTACH:
case DLL_THREAD_DETACH:
case DLL_PROCESS_DETACH:
break;
}
return TRUE;
}
348
#endif /* building DLL with Watcom C */
350
#endif /* OS/2 elif __WIN32__ */