begin_code.h 4.7 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170
  1. /*
  2. Simple DirectMedia Layer
  3. Copyright (C) 1997-2018 Sam Lantinga <[email protected]>
  4. This software is provided 'as-is', without any express or implied
  5. warranty. In no event will the authors be held liable for any damages
  6. arising from the use of this software.
  7. Permission is granted to anyone to use this software for any purpose,
  8. including commercial applications, and to alter it and redistribute it
  9. freely, subject to the following restrictions:
  10. 1. The origin of this software must not be misrepresented; you must not
  11. claim that you wrote the original software. If you use this software
  12. in a product, an acknowledgment in the product documentation would be
  13. appreciated but is not required.
  14. 2. Altered source versions must be plainly marked as such, and must not be
  15. misrepresented as being the original software.
  16. 3. This notice may not be removed or altered from any source distribution.
  17. */
  18. /**
  19. * \file begin_code.h
  20. *
  21. * This file sets things up for C dynamic library function definitions,
  22. * static inlined functions, and structures aligned at 4-byte alignment.
  23. * If you don't like ugly C preprocessor code, don't look at this file. :)
  24. */
  25. /* This shouldn't be nested -- included it around code only. */
  26. #ifdef _begin_code_h
  27. #error Nested inclusion of begin_code.h
  28. #endif
  29. #define _begin_code_h
  30. //!\\ Mark was here! Prevents SDL generating dll funcs.
  31. #define DECLSPEC
  32. #ifndef SDL_DEPRECATED
  33. # if (__GNUC__ >= 4) /* technically, this arrived in gcc 3.1, but oh well. */
  34. # define SDL_DEPRECATED __attribute__((deprecated))
  35. # else
  36. # define SDL_DEPRECATED
  37. # endif
  38. #endif
  39. #ifndef SDL_UNUSED
  40. # ifdef __GNUC__
  41. # define SDL_UNUSED __attribute__((unused))
  42. # else
  43. # define SDL_UNUSED
  44. # endif
  45. #endif
  46. /* Some compilers use a special export keyword */
  47. #ifndef DECLSPEC
  48. # if defined(__WIN32__) || defined(__WINRT__)
  49. # ifdef __BORLANDC__
  50. # ifdef BUILD_SDL
  51. # define DECLSPEC
  52. # else
  53. # define DECLSPEC __declspec(dllimport)
  54. # endif
  55. # else
  56. # define DECLSPEC __declspec(dllexport)
  57. # endif
  58. # elif defined(__OS2__)
  59. # ifdef BUILD_SDL
  60. # define DECLSPEC __declspec(dllexport)
  61. # else
  62. # define DECLSPEC
  63. # endif
  64. # else
  65. # if defined(__GNUC__) && __GNUC__ >= 4
  66. # define DECLSPEC __attribute__ ((visibility("default")))
  67. # else
  68. # define DECLSPEC
  69. # endif
  70. # endif
  71. #endif
  72. /* By default SDL uses the C calling convention */
  73. #ifndef SDLCALL
  74. #if (defined(__WIN32__) || defined(__WINRT__)) && !defined(__GNUC__)
  75. #define SDLCALL __cdecl
  76. #elif defined(__OS2__) || defined(__EMX__)
  77. #define SDLCALL _System
  78. # if defined (__GNUC__) && !defined(_System)
  79. # define _System /* for old EMX/GCC compat. */
  80. # endif
  81. #else
  82. #define SDLCALL
  83. #endif
  84. #endif /* SDLCALL */
  85. /* Removed DECLSPEC on Symbian OS because SDL cannot be a DLL in EPOC */
  86. #ifdef __SYMBIAN32__
  87. #undef DECLSPEC
  88. #define DECLSPEC
  89. #endif /* __SYMBIAN32__ */
  90. /* Force structure packing at 4 byte alignment.
  91. This is necessary if the header is included in code which has structure
  92. packing set to an alternate value, say for loading structures from disk.
  93. The packing is reset to the previous value in close_code.h
  94. */
  95. #if defined(_MSC_VER) || defined(__MWERKS__) || defined(__BORLANDC__)
  96. #ifdef _MSC_VER
  97. #pragma warning(disable: 4103)
  98. #endif
  99. #ifdef __BORLANDC__
  100. #pragma nopackwarning
  101. #endif
  102. #ifdef _M_X64
  103. /* Use 8-byte alignment on 64-bit architectures, so pointers are aligned */
  104. #pragma pack(push,8)
  105. #else
  106. #pragma pack(push,4)
  107. #endif
  108. #endif /* Compiler needs structure packing set */
  109. #ifndef SDL_INLINE
  110. #if defined(__GNUC__)
  111. #define SDL_INLINE __inline__
  112. #elif defined(_MSC_VER) || defined(__BORLANDC__) || \
  113. defined(__DMC__) || defined(__SC__) || \
  114. defined(__WATCOMC__) || defined(__LCC__) || \
  115. defined(__DECC) || defined(__CC_ARM)
  116. #define SDL_INLINE __inline
  117. #ifndef __inline__
  118. #define __inline__ __inline
  119. #endif
  120. #else
  121. #define SDL_INLINE inline
  122. #ifndef __inline__
  123. #define __inline__ inline
  124. #endif
  125. #endif
  126. #endif /* SDL_INLINE not defined */
  127. #ifndef SDL_FORCE_INLINE
  128. #if defined(_MSC_VER)
  129. #define SDL_FORCE_INLINE __forceinline
  130. #elif ( (defined(__GNUC__) && (__GNUC__ >= 4)) || defined(__clang__) )
  131. #define SDL_FORCE_INLINE __attribute__((always_inline)) static __inline__
  132. #else
  133. #define SDL_FORCE_INLINE static SDL_INLINE
  134. #endif
  135. #endif /* SDL_FORCE_INLINE not defined */
  136. #ifndef SDL_NORETURN
  137. #if defined(__GNUC__)
  138. #define SDL_NORETURN __attribute__((noreturn))
  139. #elif defined(_MSC_VER)
  140. #define SDL_NORETURN __declspec(noreturn)
  141. #else
  142. #define SDL_NORETURN
  143. #endif
  144. #endif /* SDL_NORETURN not defined */
  145. /* Apparently this is needed by several Windows compilers */
  146. #if !defined(__MACH__)
  147. #ifndef NULL
  148. #ifdef __cplusplus
  149. #define NULL 0
  150. #else
  151. #define NULL ((void *)0)
  152. #endif
  153. #endif /* NULL */
  154. #endif /* ! Mac OS X - breaks precompiled headers */