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