include/begin_code.h
author Ryan C. Gordon <icculus@icculus.org>
Wed, 06 Jan 2010 20:58:03 +0000
changeset 3618 276a6474a449
parent 3407 d3baf5ac4e37
child 3620 838fcbc09c68
permissions -rw-r--r--
Merged r4717:4718 from branches/SDL-1.2: minor OS/2 DECLSPEC/SDLCALL fixes.

I reworked this a little. The 1.2 branch isn't really very elegant about this.
     1 /*
     2     SDL - Simple DirectMedia Layer
     3     Copyright (C) 1997-2009 Sam Lantinga
     4 
     5     This library is free software; you can redistribute it and/or
     6     modify it under the terms of the GNU Library General Public
     7     License as published by the Free Software Foundation; either
     8     version 2 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     Library General Public License for more details.
    14 
    15     You should have received a copy of the GNU Library General Public
    16     License along with this library; if not, write to the Free
    17     Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
    18 
    19     Sam Lantinga
    20     slouken@libsdl.org
    21 */
    22 
    23 /**
    24  *  \file begin_code.h
    25  *
    26  *  This file sets things up for C dynamic library function definitions,
    27  *  static inlined functions, and structures aligned at 4-byte alignment.
    28  *  If you don't like ugly C preprocessor code, don't look at this file. :)
    29  */
    30 
    31 /* This shouldn't be nested -- included it around code only. */
    32 #ifdef _begin_code_h
    33 #error Nested inclusion of begin_code.h
    34 #endif
    35 #define _begin_code_h
    36 
    37 /* Some compilers use a special export keyword */
    38 #ifndef DECLSPEC
    39 # if defined(__BEOS__) || defined(__HAIKU__)
    40 #  if defined(__GNUC__)
    41 #   define DECLSPEC	__declspec(dllexport)
    42 #  else
    43 #   define DECLSPEC	__declspec(export)
    44 #  endif
    45 # elif defined(__WIN32__)
    46 #  ifdef __BORLANDC__
    47 #   ifdef BUILD_SDL
    48 #    define DECLSPEC
    49 #   else
    50 #    define DECLSPEC	__declspec(dllimport)
    51 #   endif
    52 #  else
    53 #   define DECLSPEC	__declspec(dllexport)
    54 #  endif
    55 # elif defined(__OS2__)
    56 #   ifdef BUILD_SDL
    57 #    define DECLSPEC    __declspec(dllexport)
    58 #   else
    59 #    define DECLSPEC
    60 #   endif
    61 # else
    62 #  if defined(__GNUC__) && __GNUC__ >= 4
    63 #   define DECLSPEC	__attribute__ ((visibility("default")))
    64 #  else
    65 #   define DECLSPEC
    66 #  endif
    67 # endif
    68 #endif
    69 
    70 /* By default SDL uses the C calling convention */
    71 #ifndef SDLCALL
    72 # if defined(__WIN32__) && !defined(__GNUC__)
    73 #  define SDLCALL __cdecl
    74 # elif defined(__OS2__)
    75    /* Use the _System calling convention to be compatible with every OS/2
    76       compiler. (Please note that this used to be _cdecl for GCC, but that
    77       was a bug. Someone should go examine and fix the XFree86 integration
    78       instead. We shouldn't be passing SDLCALL function pointers between SDL
    79       and XFree86!) */
    80 #  define SDLCALL _System
    81 # else
    82 #  define SDLCALL
    83 # endif
    84 #endif /* SDLCALL */
    85 
    86 /* Removed DECLSPEC on Symbian OS because SDL cannot be a DLL in EPOC */
    87 #ifdef __SYMBIAN32__
    88 #undef DECLSPEC
    89 #define DECLSPEC
    90 #endif /* __SYMBIAN32__ */
    91 
    92 /* Force structure packing at 4 byte alignment.
    93    This is necessary if the header is included in code which has structure
    94    packing set to an alternate value, say for loading structures from disk.
    95    The packing is reset to the previous value in close_code.h
    96  */
    97 #if defined(_MSC_VER) || defined(__MWERKS__) || defined(__BORLANDC__)
    98 #ifdef _MSC_VER
    99 #pragma warning(disable: 4103)
   100 #endif
   101 #ifdef __BORLANDC__
   102 #pragma nopackwarning
   103 #endif
   104 #pragma pack(push,4)
   105 #endif /* Compiler needs structure packing set */
   106 
   107 /* Set up compiler-specific options for inlining functions */
   108 #ifndef SDL_INLINE_OKAY
   109 #ifdef __GNUC__
   110 #define SDL_INLINE_OKAY
   111 #else
   112 /* Add any special compiler-specific cases here */
   113 #if defined(_MSC_VER) || defined(__BORLANDC__) || \
   114     defined(__DMC__) || defined(__SC__) || \
   115     defined(__WATCOMC__) || defined(__LCC__) || \
   116     defined(__DECC)
   117 #ifndef __inline__
   118 #define __inline__	__inline
   119 #endif
   120 #define SDL_INLINE_OKAY
   121 #else
   122 #if !defined(__MRC__) && !defined(_SGI_SOURCE)
   123 #ifndef __inline__
   124 #define __inline__ inline
   125 #endif
   126 #define SDL_INLINE_OKAY
   127 #endif /* Not a funky compiler */
   128 #endif /* Visual C++ */
   129 #endif /* GNU C */
   130 #endif /* SDL_INLINE_OKAY */
   131 
   132 /* If inlining isn't supported, remove "__inline__", turning static
   133    inlined functions into static functions (resulting in code bloat
   134    in all files which include the offending header files)
   135 */
   136 #ifndef SDL_INLINE_OKAY
   137 #define __inline__
   138 #endif
   139 
   140 /* Apparently this is needed by several Windows compilers */
   141 #if !defined(__MACH__)
   142 #ifndef NULL
   143 #ifdef __cplusplus
   144 #define NULL 0
   145 #else
   146 #define NULL ((void *)0)
   147 #endif
   148 #endif /* NULL */
   149 #endif /* ! Mac OS X - breaks precompiled headers */