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