include/SDL_thread.h
author Ryan C. Gordon <icculus@icculus.org>
Thu, 19 Jan 2006 08:43:00 +0000
changeset 1251 86d0d01290ea
parent 1190 173c063d4f55
child 1312 c9b51268668f
permissions -rw-r--r--
Updated Windows CE/PocketPC support...adds GAPI driver, landscape mode,
updated project files, VS2005 support, VGA mode, more device support, etc,
etc, etc.

Fixes Bugzilla #47 and #28.

--ryan.
slouken@0
     1
/*
slouken@0
     2
    SDL - Simple DirectMedia Layer
slouken@769
     3
    Copyright (C) 1997-2004 Sam Lantinga
slouken@0
     4
slouken@0
     5
    This library is free software; you can redistribute it and/or
slouken@0
     6
    modify it under the terms of the GNU Library General Public
slouken@0
     7
    License as published by the Free Software Foundation; either
slouken@0
     8
    version 2 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@0
    13
    Library General Public License for more details.
slouken@0
    14
slouken@0
    15
    You should have received a copy of the GNU Library General Public
slouken@0
    16
    License along with this library; if not, write to the Free
slouken@0
    17
    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
slouken@0
    18
slouken@0
    19
    Sam Lantinga
slouken@251
    20
    slouken@libsdl.org
slouken@0
    21
*/
slouken@0
    22
slouken@0
    23
#ifdef SAVE_RCSID
slouken@0
    24
static char rcsid =
slouken@0
    25
 "@(#) $Id$";
slouken@0
    26
#endif
slouken@0
    27
slouken@0
    28
#ifndef _SDL_thread_h
slouken@0
    29
#define _SDL_thread_h
slouken@0
    30
slouken@0
    31
/* Header for the SDL thread management routines 
slouken@0
    32
slouken@0
    33
	These are independent of the other SDL routines.
slouken@0
    34
*/
slouken@0
    35
slouken@0
    36
#include "SDL_main.h"
slouken@0
    37
#include "SDL_types.h"
slouken@0
    38
slouken@0
    39
/* Thread synchronization primitives */
slouken@0
    40
#include "SDL_mutex.h"
slouken@0
    41
slouken@0
    42
#include "begin_code.h"
slouken@0
    43
/* Set up for C function definitions, even when using C++ */
slouken@0
    44
#ifdef __cplusplus
slouken@0
    45
extern "C" {
slouken@0
    46
#endif
slouken@0
    47
slouken@0
    48
/* The SDL thread structure, defined in SDL_thread.c */
slouken@0
    49
struct SDL_Thread;
slouken@0
    50
typedef struct SDL_Thread SDL_Thread;
slouken@0
    51
slouken@0
    52
/* Create a thread */
icculus@1190
    53
#ifdef __OS2__
icculus@1190
    54
/*
icculus@1190
    55
   We compile SDL into a DLL on OS/2. This means, that it's the DLL which
icculus@1190
    56
   creates a new thread for the calling process with the SDL_CreateThread()
icculus@1190
    57
   API. There is a problem with this, that only the RTL of the SDL.DLL will
icculus@1190
    58
   be initialized for those threads, and not the RTL of the calling application!
icculus@1190
    59
   To solve this, we make a little hack here.
icculus@1190
    60
   We'll always use the caller's _beginthread() and _endthread() APIs to
icculus@1190
    61
   start a new thread. This way, it it's the SDL.DLL which uses this API,
icculus@1190
    62
   then the RTL of SDL.DLL will be used to create the new thread, and if it's
icculus@1190
    63
   the application, then the RTL of the application will be used.
icculus@1190
    64
   So, in short:
icculus@1190
    65
   Always use the _beginthread() and _endthread() of the calling runtime library!
icculus@1190
    66
*/
icculus@1190
    67
icculus@1190
    68
#ifdef __WATCOMC__
icculus@1190
    69
#include <process.h> // This has _beginthread() and _endthread() defined!
icculus@1190
    70
#endif
icculus@1190
    71
#ifdef __EMX__
icculus@1190
    72
#include <stdlib.h> // This has _beginthread() and _endthread() defined, if -Zmt flag is used!
icculus@1190
    73
#endif
icculus@1190
    74
icculus@1190
    75
typedef Uint32 SDLCALL (*pfnSDL_CurrentBeginThread)(void (*pfnThreadFn)(void *), Uint32 uiStackSize, void *pParam);
icculus@1190
    76
typedef void   SDLCALL (*pfnSDL_CurrentEndThread)(void);
icculus@1190
    77
icculus@1190
    78
extern DECLSPEC SDL_Thread * SDLCALL SDL_CreateThread_Core(int (*fn)(void *), void *data, pfnSDL_CurrentBeginThread pfnBeginThread, pfnSDL_CurrentEndThread pfnEndThread);
icculus@1190
    79
icculus@1190
    80
// Disable warnings about unreferenced symbol!
icculus@1190
    81
#pragma disable_message (202)
icculus@1190
    82
static Uint32 SDLCALL SDL_CurrentBeginThread(void (*pfnThreadFn)(void *), Uint32 uiStackSize, void *pParam)
icculus@1190
    83
{
icculus@1190
    84
  return _beginthread(pfnThreadFn, NULL, uiStackSize, pParam);
icculus@1190
    85
}
icculus@1190
    86
icculus@1190
    87
static void   SDLCALL SDL_CurrentEndThread(void)
icculus@1190
    88
{
icculus@1190
    89
  _endthread();
icculus@1190
    90
}
icculus@1190
    91
icculus@1190
    92
#define SDL_CreateThread(fn, data) SDL_CreateThread_Core(fn, data, SDL_CurrentBeginThread, SDL_CurrentEndThread)
icculus@1190
    93
icculus@1190
    94
#else
slouken@930
    95
extern DECLSPEC SDL_Thread * SDLCALL SDL_CreateThread(int (SDLCALL *fn)(void *), void *data);
icculus@1190
    96
#endif
slouken@0
    97
slouken@0
    98
/* Get the 32-bit thread identifier for the current thread */
slouken@337
    99
extern DECLSPEC Uint32 SDLCALL SDL_ThreadID(void);
slouken@0
   100
slouken@0
   101
/* Get the 32-bit thread identifier for the specified thread,
slouken@0
   102
   equivalent to SDL_ThreadID() if the specified thread is NULL.
slouken@0
   103
 */
slouken@337
   104
extern DECLSPEC Uint32 SDLCALL SDL_GetThreadID(SDL_Thread *thread);
slouken@0
   105
slouken@0
   106
/* Wait for a thread to finish.
slouken@0
   107
   The return code for the thread function is placed in the area
slouken@0
   108
   pointed to by 'status', if 'status' is not NULL.
slouken@0
   109
 */
slouken@337
   110
extern DECLSPEC void SDLCALL SDL_WaitThread(SDL_Thread *thread, int *status);
slouken@0
   111
slouken@0
   112
/* Forcefully kill a thread without worrying about its state */
slouken@337
   113
extern DECLSPEC void SDLCALL SDL_KillThread(SDL_Thread *thread);
slouken@0
   114
slouken@0
   115
slouken@0
   116
/* Ends C function definitions when using C++ */
slouken@0
   117
#ifdef __cplusplus
slouken@0
   118
}
slouken@0
   119
#endif
slouken@0
   120
#include "close_code.h"
slouken@0
   121
slouken@0
   122
#endif /* _SDL_thread_h */