gosu 0.15.2 → 1.0.0.pre1

Sign up to get free protection for your applications and to get access to all the features.
Files changed (234) hide show
  1. checksums.yaml +4 -4
  2. data/dependencies/SDL/include/SDL.h +138 -0
  3. data/dependencies/SDL/include/SDL_assert.h +293 -0
  4. data/dependencies/SDL/include/SDL_atomic.h +295 -0
  5. data/dependencies/SDL/include/SDL_audio.h +859 -0
  6. data/dependencies/SDL/include/SDL_bits.h +121 -0
  7. data/dependencies/SDL/include/SDL_blendmode.h +123 -0
  8. data/dependencies/SDL/include/SDL_clipboard.h +71 -0
  9. data/dependencies/SDL/include/SDL_config.h +55 -0
  10. data/dependencies/SDL/include/SDL_config_android.h +182 -0
  11. data/dependencies/SDL/include/SDL_config_iphoneos.h +207 -0
  12. data/dependencies/SDL/include/SDL_config_macosx.h +266 -0
  13. data/dependencies/SDL/include/SDL_config_minimal.h +85 -0
  14. data/dependencies/SDL/include/SDL_config_os2.h +188 -0
  15. data/dependencies/SDL/include/SDL_config_pandora.h +135 -0
  16. data/dependencies/SDL/include/SDL_config_psp.h +165 -0
  17. data/dependencies/SDL/include/SDL_config_windows.h +288 -0
  18. data/dependencies/SDL/include/SDL_config_winrt.h +243 -0
  19. data/dependencies/SDL/include/SDL_config_wiz.h +149 -0
  20. data/dependencies/SDL/include/SDL_copying.h +20 -0
  21. data/dependencies/SDL/include/SDL_cpuinfo.h +299 -0
  22. data/dependencies/SDL/include/SDL_egl.h +1676 -0
  23. data/dependencies/SDL/include/SDL_endian.h +263 -0
  24. data/dependencies/SDL/include/SDL_error.h +112 -0
  25. data/dependencies/SDL/include/SDL_events.h +827 -0
  26. data/dependencies/SDL/include/SDL_filesystem.h +136 -0
  27. data/dependencies/SDL/include/SDL_gamecontroller.h +541 -0
  28. data/dependencies/SDL/include/SDL_gesture.h +87 -0
  29. data/dependencies/SDL/include/SDL_haptic.h +1247 -0
  30. data/dependencies/SDL/include/SDL_hints.h +1578 -0
  31. data/dependencies/SDL/include/SDL_joystick.h +499 -0
  32. data/dependencies/SDL/include/SDL_keyboard.h +217 -0
  33. data/dependencies/SDL/include/SDL_keycode.h +351 -0
  34. data/dependencies/SDL/include/SDL_loadso.h +81 -0
  35. data/dependencies/SDL/include/SDL_locale.h +101 -0
  36. data/dependencies/SDL/include/SDL_log.h +211 -0
  37. data/dependencies/SDL/include/SDL_main.h +180 -0
  38. data/dependencies/SDL/include/SDL_messagebox.h +146 -0
  39. data/dependencies/SDL/include/SDL_metal.h +117 -0
  40. data/dependencies/SDL/include/SDL_misc.h +75 -0
  41. data/dependencies/SDL/include/SDL_mouse.h +302 -0
  42. data/dependencies/SDL/include/SDL_mutex.h +251 -0
  43. data/dependencies/SDL/include/SDL_name.h +33 -0
  44. data/dependencies/SDL/include/SDL_opengl.h +2183 -0
  45. data/dependencies/SDL/include/SDL_opengl_glext.h +11180 -0
  46. data/dependencies/SDL/include/SDL_opengles.h +39 -0
  47. data/dependencies/SDL/include/SDL_opengles2.h +52 -0
  48. data/dependencies/SDL/include/SDL_opengles2_gl2.h +621 -0
  49. data/dependencies/SDL/include/SDL_opengles2_gl2ext.h +2050 -0
  50. data/dependencies/SDL/include/SDL_opengles2_gl2platform.h +30 -0
  51. data/dependencies/SDL/include/SDL_opengles2_khrplatform.h +282 -0
  52. data/dependencies/SDL/include/SDL_pixels.h +479 -0
  53. data/dependencies/SDL/include/SDL_platform.h +198 -0
  54. data/dependencies/SDL/include/SDL_power.h +75 -0
  55. data/dependencies/SDL/include/SDL_quit.h +58 -0
  56. data/dependencies/SDL/include/SDL_rect.h +174 -0
  57. data/dependencies/SDL/include/SDL_render.h +1158 -0
  58. data/dependencies/SDL/include/SDL_revision.h +2 -0
  59. data/dependencies/SDL/include/SDL_rwops.h +283 -0
  60. data/dependencies/SDL/include/SDL_scancode.h +413 -0
  61. data/dependencies/SDL/include/SDL_sensor.h +267 -0
  62. data/dependencies/SDL/include/SDL_shape.h +144 -0
  63. data/dependencies/SDL/include/SDL_stdinc.h +647 -0
  64. data/dependencies/SDL/include/SDL_surface.h +563 -0
  65. data/dependencies/SDL/include/SDL_system.h +325 -0
  66. data/dependencies/SDL/include/SDL_syswm.h +354 -0
  67. data/dependencies/SDL/include/SDL_test.h +69 -0
  68. data/dependencies/SDL/include/SDL_test_assert.h +105 -0
  69. data/dependencies/SDL/include/SDL_test_common.h +218 -0
  70. data/dependencies/SDL/include/SDL_test_compare.h +69 -0
  71. data/dependencies/SDL/include/SDL_test_crc32.h +124 -0
  72. data/dependencies/SDL/include/SDL_test_font.h +81 -0
  73. data/dependencies/SDL/include/SDL_test_fuzzer.h +384 -0
  74. data/dependencies/SDL/include/SDL_test_harness.h +134 -0
  75. data/dependencies/SDL/include/SDL_test_images.h +78 -0
  76. data/dependencies/SDL/include/SDL_test_log.h +67 -0
  77. data/dependencies/SDL/include/SDL_test_md5.h +129 -0
  78. data/dependencies/SDL/include/SDL_test_memory.h +63 -0
  79. data/dependencies/SDL/include/SDL_test_random.h +115 -0
  80. data/dependencies/SDL/include/SDL_thread.h +366 -0
  81. data/dependencies/SDL/include/SDL_timer.h +115 -0
  82. data/dependencies/SDL/include/SDL_touch.h +102 -0
  83. data/dependencies/SDL/include/SDL_types.h +29 -0
  84. data/dependencies/SDL/include/SDL_version.h +162 -0
  85. data/dependencies/SDL/include/SDL_video.h +1282 -0
  86. data/dependencies/SDL/include/SDL_vulkan.h +276 -0
  87. data/dependencies/SDL/include/begin_code.h +166 -0
  88. data/dependencies/SDL/include/close_code.h +40 -0
  89. data/dependencies/SDL/lib/x64/libSDL2.dll.a +0 -0
  90. data/dependencies/SDL/lib/x86/libSDL2.dll.a +0 -0
  91. data/dependencies/SDL_sound/SDL_sound.c +795 -0
  92. data/dependencies/SDL_sound/SDL_sound.h +725 -0
  93. data/dependencies/SDL_sound/SDL_sound_aiff.c +537 -0
  94. data/dependencies/SDL_sound/SDL_sound_au.c +352 -0
  95. data/dependencies/SDL_sound/SDL_sound_coreaudio.c +747 -0
  96. data/dependencies/SDL_sound/SDL_sound_flac.c +182 -0
  97. data/dependencies/SDL_sound/SDL_sound_internal.h +304 -0
  98. data/dependencies/SDL_sound/SDL_sound_modplug.c +228 -0
  99. data/dependencies/SDL_sound/SDL_sound_mp3.c +184 -0
  100. data/dependencies/SDL_sound/SDL_sound_raw.c +164 -0
  101. data/dependencies/SDL_sound/SDL_sound_shn.c +1309 -0
  102. data/dependencies/SDL_sound/SDL_sound_voc.c +550 -0
  103. data/dependencies/SDL_sound/SDL_sound_vorbis.c +223 -0
  104. data/dependencies/SDL_sound/SDL_sound_wav.c +783 -0
  105. data/dependencies/SDL_sound/dr_flac.h +5906 -0
  106. data/dependencies/SDL_sound/dr_mp3.h +2832 -0
  107. data/dependencies/SDL_sound/libmodplug/fastmix.c +1748 -0
  108. data/dependencies/SDL_sound/libmodplug/libmodplug.h +1001 -0
  109. data/dependencies/SDL_sound/libmodplug/load_669.c +188 -0
  110. data/dependencies/SDL_sound/libmodplug/load_abc.c +4725 -0
  111. data/dependencies/SDL_sound/libmodplug/load_amf.c +403 -0
  112. data/dependencies/SDL_sound/libmodplug/load_ams.c +587 -0
  113. data/dependencies/SDL_sound/libmodplug/load_dbm.c +357 -0
  114. data/dependencies/SDL_sound/libmodplug/load_dmf.c +531 -0
  115. data/dependencies/SDL_sound/libmodplug/load_dsm.c +232 -0
  116. data/dependencies/SDL_sound/libmodplug/load_far.c +253 -0
  117. data/dependencies/SDL_sound/libmodplug/load_it.c +796 -0
  118. data/dependencies/SDL_sound/libmodplug/load_mdl.c +488 -0
  119. data/dependencies/SDL_sound/libmodplug/load_med.c +757 -0
  120. data/dependencies/SDL_sound/libmodplug/load_mid.c +1405 -0
  121. data/dependencies/SDL_sound/libmodplug/load_mod.c +269 -0
  122. data/dependencies/SDL_sound/libmodplug/load_mt2.c +546 -0
  123. data/dependencies/SDL_sound/libmodplug/load_mtm.c +142 -0
  124. data/dependencies/SDL_sound/libmodplug/load_okt.c +192 -0
  125. data/dependencies/SDL_sound/libmodplug/load_pat.c +1143 -0
  126. data/dependencies/SDL_sound/libmodplug/load_pat.h +25 -0
  127. data/dependencies/SDL_sound/libmodplug/load_psm.c +350 -0
  128. data/dependencies/SDL_sound/libmodplug/load_ptm.c +204 -0
  129. data/dependencies/SDL_sound/libmodplug/load_s3m.c +325 -0
  130. data/dependencies/SDL_sound/libmodplug/load_stm.c +180 -0
  131. data/dependencies/SDL_sound/libmodplug/load_ult.c +206 -0
  132. data/dependencies/SDL_sound/libmodplug/load_umx.c +51 -0
  133. data/dependencies/SDL_sound/libmodplug/load_xm.c +554 -0
  134. data/dependencies/SDL_sound/libmodplug/mmcmp.c +382 -0
  135. data/dependencies/SDL_sound/libmodplug/modplug.c +170 -0
  136. data/dependencies/SDL_sound/libmodplug/modplug.h +90 -0
  137. data/dependencies/SDL_sound/libmodplug/snd_dsp.c +301 -0
  138. data/dependencies/SDL_sound/libmodplug/snd_flt.c +63 -0
  139. data/dependencies/SDL_sound/libmodplug/snd_fx.c +2350 -0
  140. data/dependencies/SDL_sound/libmodplug/sndfile.c +1169 -0
  141. data/dependencies/SDL_sound/libmodplug/sndmix.c +1034 -0
  142. data/dependencies/SDL_sound/libmodplug/tables.h +371 -0
  143. data/{src/stb_vorbis.c → dependencies/SDL_sound/stb_vorbis.h} +143 -78
  144. data/dependencies/al_soft/AL/al.h +655 -0
  145. data/dependencies/al_soft/AL/alc.h +270 -0
  146. data/dependencies/al_soft/AL/alext.h +585 -0
  147. data/dependencies/al_soft/AL/efx-creative.h +3 -0
  148. data/dependencies/al_soft/AL/efx-presets.h +402 -0
  149. data/dependencies/al_soft/AL/efx.h +762 -0
  150. data/dependencies/al_soft/x64/libOpenAL32.dll.a +0 -0
  151. data/dependencies/al_soft/x86/libOpenAL32.dll.a +0 -0
  152. data/{src → dependencies/stb}/stb_image.h +330 -127
  153. data/{src → dependencies/stb}/stb_image_write.h +156 -85
  154. data/{src → dependencies/stb}/stb_truetype.h +192 -69
  155. data/{src → dependencies/utf8proc}/utf8proc.c +0 -0
  156. data/{src → dependencies/utf8proc}/utf8proc.h +0 -0
  157. data/{src → dependencies/utf8proc}/utf8proc_data.h +0 -0
  158. data/ext/gosu/extconf.rb +56 -22
  159. data/{Gosu → include/Gosu}/Audio.hpp +6 -8
  160. data/{Gosu → include/Gosu}/AutoLink.hpp +0 -0
  161. data/include/Gosu/Bitmap.hpp +100 -0
  162. data/{Gosu → include/Gosu}/Buttons.hpp +94 -35
  163. data/{Gosu → include/Gosu}/Channel.h +0 -0
  164. data/{Gosu → include/Gosu}/Color.h +0 -0
  165. data/{Gosu → include/Gosu}/Color.hpp +0 -0
  166. data/{Gosu → include/Gosu}/Directories.hpp +0 -0
  167. data/{Gosu → include/Gosu}/Font.h +0 -0
  168. data/{Gosu → include/Gosu}/Font.hpp +0 -0
  169. data/{Gosu → include/Gosu}/Fwd.hpp +0 -0
  170. data/{Gosu → include/Gosu}/Gosu.h +3 -0
  171. data/{Gosu → include/Gosu}/Gosu.hpp +0 -0
  172. data/{Gosu → include/Gosu}/Graphics.hpp +0 -0
  173. data/{Gosu → include/Gosu}/GraphicsBase.hpp +0 -0
  174. data/{Gosu → include/Gosu}/IO.hpp +0 -0
  175. data/{Gosu → include/Gosu}/Image.h +0 -0
  176. data/{Gosu → include/Gosu}/Image.hpp +7 -6
  177. data/{Gosu → include/Gosu}/ImageData.hpp +0 -0
  178. data/{Gosu → include/Gosu}/Input.hpp +30 -15
  179. data/{Gosu → include/Gosu}/Inspection.hpp +0 -0
  180. data/{Gosu → include/Gosu}/Math.hpp +0 -0
  181. data/{Gosu → include/Gosu}/Platform.hpp +0 -0
  182. data/{Gosu → include/Gosu}/Sample.h +0 -0
  183. data/{Gosu → include/Gosu}/Song.h +0 -0
  184. data/{Gosu → include/Gosu}/Text.hpp +0 -0
  185. data/{Gosu → include/Gosu}/TextInput.h +0 -0
  186. data/{Gosu → include/Gosu}/TextInput.hpp +0 -0
  187. data/{Gosu → include/Gosu}/Timing.hpp +0 -0
  188. data/{Gosu → include/Gosu}/Utility.hpp +1 -1
  189. data/{Gosu → include/Gosu}/Version.hpp +0 -0
  190. data/{Gosu → include/Gosu}/Window.h +2 -0
  191. data/{Gosu → include/Gosu}/Window.hpp +21 -13
  192. data/lib/OpenAL32.dll +0 -0
  193. data/lib/SDL2.dll +0 -0
  194. data/lib/gosu.rb +0 -3
  195. data/lib/gosu/patches.rb +0 -9
  196. data/lib/gosu/swig_patches.rb +3 -2
  197. data/lib/libmpg123.dll +0 -0
  198. data/lib/libsndfile.dll +0 -0
  199. data/lib64/OpenAL32.dll +0 -0
  200. data/lib64/SDL2.dll +0 -0
  201. data/lib64/libmpg123.dll +0 -0
  202. data/lib64/libsndfile.dll +0 -0
  203. data/rdoc/gosu.rb +95 -20
  204. data/src/Audio.cpp +50 -224
  205. data/src/AudioFile.hpp +17 -37
  206. data/src/AudioFileAudioToolbox.cpp +237 -0
  207. data/src/AudioFileSDLSound.cpp +147 -0
  208. data/src/AudioImpl.cpp +3 -12
  209. data/src/AudioImpl.hpp +3 -1
  210. data/src/Bitmap.cpp +85 -83
  211. data/src/BitmapIO.cpp +52 -58
  212. data/src/Constants.cpp +80 -33
  213. data/src/Font.cpp +3 -1
  214. data/src/GosuWrapper.cpp +19 -0
  215. data/src/Graphics.cpp +7 -4
  216. data/src/Image.cpp +13 -16
  217. data/src/Input.cpp +408 -159
  218. data/src/LargeImageData.cpp +1 -1
  219. data/src/MarkupParser.cpp +2 -1
  220. data/src/RubyGosu.cxx +349 -83
  221. data/src/RubyGosu.h +4 -2
  222. data/src/TexChunk.cpp +1 -1
  223. data/src/TextBuilder.cpp +3 -1
  224. data/src/Texture.cpp +1 -1
  225. data/src/TrueTypeFont.cpp +1 -1
  226. data/src/Utility.cpp +11 -7
  227. data/src/Window.cpp +30 -39
  228. data/src/WindowWrapper.cpp +28 -0
  229. metadata +207 -52
  230. data/Gosu/Bitmap.hpp +0 -113
  231. data/src/AudioToolboxFile.hpp +0 -210
  232. data/src/OggFile.hpp +0 -92
  233. data/src/SndFile.hpp +0 -174
  234. data/src/WinMain.cpp +0 -64
@@ -0,0 +1,115 @@
1
+ /*
2
+ Simple DirectMedia Layer
3
+ Copyright (C) 1997-2020 Sam Lantinga <slouken@libsdl.org>
4
+
5
+ This software is provided 'as-is', without any express or implied
6
+ warranty. In no event will the authors be held liable for any damages
7
+ arising from the use of this software.
8
+
9
+ Permission is granted to anyone to use this software for any purpose,
10
+ including commercial applications, and to alter it and redistribute it
11
+ freely, subject to the following restrictions:
12
+
13
+ 1. The origin of this software must not be misrepresented; you must not
14
+ claim that you wrote the original software. If you use this software
15
+ in a product, an acknowledgment in the product documentation would be
16
+ appreciated but is not required.
17
+ 2. Altered source versions must be plainly marked as such, and must not be
18
+ misrepresented as being the original software.
19
+ 3. This notice may not be removed or altered from any source distribution.
20
+ */
21
+
22
+ /**
23
+ * \file SDL_test_random.h
24
+ *
25
+ * Include file for SDL test framework.
26
+ *
27
+ * This code is a part of the SDL2_test library, not the main SDL library.
28
+ */
29
+
30
+ /*
31
+
32
+ A "32-bit Multiply with carry random number generator. Very fast.
33
+ Includes a list of recommended multipliers.
34
+
35
+ multiply-with-carry generator: x(n) = a*x(n-1) + carry mod 2^32.
36
+ period: (a*2^31)-1
37
+
38
+ */
39
+
40
+ #ifndef SDL_test_random_h_
41
+ #define SDL_test_random_h_
42
+
43
+ #include "begin_code.h"
44
+ /* Set up for C function definitions, even when using C++ */
45
+ #ifdef __cplusplus
46
+ extern "C" {
47
+ #endif
48
+
49
+ /* --- Definitions */
50
+
51
+ /*
52
+ * Macros that return a random number in a specific format.
53
+ */
54
+ #define SDLTest_RandomInt(c) ((int)SDLTest_Random(c))
55
+
56
+ /*
57
+ * Context structure for the random number generator state.
58
+ */
59
+ typedef struct {
60
+ unsigned int a;
61
+ unsigned int x;
62
+ unsigned int c;
63
+ unsigned int ah;
64
+ unsigned int al;
65
+ } SDLTest_RandomContext;
66
+
67
+
68
+ /* --- Function prototypes */
69
+
70
+ /**
71
+ * \brief Initialize random number generator with two integers.
72
+ *
73
+ * Note: The random sequence of numbers returned by ...Random() is the
74
+ * same for the same two integers and has a period of 2^31.
75
+ *
76
+ * \param rndContext pointer to context structure
77
+ * \param xi integer that defines the random sequence
78
+ * \param ci integer that defines the random sequence
79
+ *
80
+ */
81
+ void SDLTest_RandomInit(SDLTest_RandomContext * rndContext, unsigned int xi,
82
+ unsigned int ci);
83
+
84
+ /**
85
+ * \brief Initialize random number generator based on current system time.
86
+ *
87
+ * \param rndContext pointer to context structure
88
+ *
89
+ */
90
+ void SDLTest_RandomInitTime(SDLTest_RandomContext *rndContext);
91
+
92
+
93
+ /**
94
+ * \brief Initialize random number generator based on current system time.
95
+ *
96
+ * Note: ...RandomInit() or ...RandomInitTime() must have been called
97
+ * before using this function.
98
+ *
99
+ * \param rndContext pointer to context structure
100
+ *
101
+ * \returns A random number (32bit unsigned integer)
102
+ *
103
+ */
104
+ unsigned int SDLTest_Random(SDLTest_RandomContext *rndContext);
105
+
106
+
107
+ /* Ends C function definitions when using C++ */
108
+ #ifdef __cplusplus
109
+ }
110
+ #endif
111
+ #include "close_code.h"
112
+
113
+ #endif /* SDL_test_random_h_ */
114
+
115
+ /* vi: set ts=4 sw=4 expandtab: */
@@ -0,0 +1,366 @@
1
+ /*
2
+ Simple DirectMedia Layer
3
+ Copyright (C) 1997-2020 Sam Lantinga <slouken@libsdl.org>
4
+
5
+ This software is provided 'as-is', without any express or implied
6
+ warranty. In no event will the authors be held liable for any damages
7
+ arising from the use of this software.
8
+
9
+ Permission is granted to anyone to use this software for any purpose,
10
+ including commercial applications, and to alter it and redistribute it
11
+ freely, subject to the following restrictions:
12
+
13
+ 1. The origin of this software must not be misrepresented; you must not
14
+ claim that you wrote the original software. If you use this software
15
+ in a product, an acknowledgment in the product documentation would be
16
+ appreciated but is not required.
17
+ 2. Altered source versions must be plainly marked as such, and must not be
18
+ misrepresented as being the original software.
19
+ 3. This notice may not be removed or altered from any source distribution.
20
+ */
21
+
22
+ #ifndef SDL_thread_h_
23
+ #define SDL_thread_h_
24
+
25
+ /**
26
+ * \file SDL_thread.h
27
+ *
28
+ * Header for the SDL thread management routines.
29
+ */
30
+
31
+ #include "SDL_stdinc.h"
32
+ #include "SDL_error.h"
33
+
34
+ /* Thread synchronization primitives */
35
+ #include "SDL_atomic.h"
36
+ #include "SDL_mutex.h"
37
+
38
+ #include "begin_code.h"
39
+ /* Set up for C function definitions, even when using C++ */
40
+ #ifdef __cplusplus
41
+ extern "C" {
42
+ #endif
43
+
44
+ /* The SDL thread structure, defined in SDL_thread.c */
45
+ struct SDL_Thread;
46
+ typedef struct SDL_Thread SDL_Thread;
47
+
48
+ /* The SDL thread ID */
49
+ typedef unsigned long SDL_threadID;
50
+
51
+ /* Thread local storage ID, 0 is the invalid ID */
52
+ typedef unsigned int SDL_TLSID;
53
+
54
+ /**
55
+ * The SDL thread priority.
56
+ *
57
+ * SDL will make system changes as necessary in order to apply the thread priority.
58
+ * Code which attempts to control thread state related to priority should be aware
59
+ * that calling SDL_SetThreadPriority may alter such state.
60
+ * SDL_HINT_THREAD_PRIORITY_POLICY can be used to control aspects of this behavior.
61
+ *
62
+ * \note On many systems you require special privileges to set high or time critical priority.
63
+ */
64
+ typedef enum {
65
+ SDL_THREAD_PRIORITY_LOW,
66
+ SDL_THREAD_PRIORITY_NORMAL,
67
+ SDL_THREAD_PRIORITY_HIGH,
68
+ SDL_THREAD_PRIORITY_TIME_CRITICAL
69
+ } SDL_ThreadPriority;
70
+
71
+ /**
72
+ * The function passed to SDL_CreateThread().
73
+ * It is passed a void* user context parameter and returns an int.
74
+ */
75
+ typedef int (SDLCALL * SDL_ThreadFunction) (void *data);
76
+
77
+ #if defined(__WIN32__)
78
+ /**
79
+ * \file SDL_thread.h
80
+ *
81
+ * We compile SDL into a DLL. This means, that it's the DLL which
82
+ * creates a new thread for the calling process with the SDL_CreateThread()
83
+ * API. There is a problem with this, that only the RTL of the SDL2.DLL will
84
+ * be initialized for those threads, and not the RTL of the calling
85
+ * application!
86
+ *
87
+ * To solve this, we make a little hack here.
88
+ *
89
+ * We'll always use the caller's _beginthread() and _endthread() APIs to
90
+ * start a new thread. This way, if it's the SDL2.DLL which uses this API,
91
+ * then the RTL of SDL2.DLL will be used to create the new thread, and if it's
92
+ * the application, then the RTL of the application will be used.
93
+ *
94
+ * So, in short:
95
+ * Always use the _beginthread() and _endthread() of the calling runtime
96
+ * library!
97
+ */
98
+ #define SDL_PASSED_BEGINTHREAD_ENDTHREAD
99
+ #include <process.h> /* _beginthreadex() and _endthreadex() */
100
+
101
+ typedef uintptr_t (__cdecl * pfnSDL_CurrentBeginThread)
102
+ (void *, unsigned, unsigned (__stdcall *func)(void *),
103
+ void * /*arg*/, unsigned, unsigned * /* threadID */);
104
+ typedef void (__cdecl * pfnSDL_CurrentEndThread) (unsigned code);
105
+
106
+ #ifndef SDL_beginthread
107
+ #define SDL_beginthread _beginthreadex
108
+ #endif
109
+ #ifndef SDL_endthread
110
+ #define SDL_endthread _endthreadex
111
+ #endif
112
+
113
+ /**
114
+ * Create a thread.
115
+ */
116
+ extern DECLSPEC SDL_Thread *SDLCALL
117
+ SDL_CreateThread(SDL_ThreadFunction fn, const char *name, void *data,
118
+ pfnSDL_CurrentBeginThread pfnBeginThread,
119
+ pfnSDL_CurrentEndThread pfnEndThread);
120
+
121
+ extern DECLSPEC SDL_Thread *SDLCALL
122
+ SDL_CreateThreadWithStackSize(int (SDLCALL * fn) (void *),
123
+ const char *name, const size_t stacksize, void *data,
124
+ pfnSDL_CurrentBeginThread pfnBeginThread,
125
+ pfnSDL_CurrentEndThread pfnEndThread);
126
+
127
+
128
+ /**
129
+ * Create a thread.
130
+ */
131
+ #if defined(SDL_CreateThread) && SDL_DYNAMIC_API
132
+ #undef SDL_CreateThread
133
+ #define SDL_CreateThread(fn, name, data) SDL_CreateThread_REAL(fn, name, data, (pfnSDL_CurrentBeginThread)SDL_beginthread, (pfnSDL_CurrentEndThread)SDL_endthread)
134
+ #undef SDL_CreateThreadWithStackSize
135
+ #define SDL_CreateThreadWithStackSize(fn, name, stacksize, data) SDL_CreateThreadWithStackSize_REAL(fn, name, stacksize, data, (pfnSDL_CurrentBeginThread)SDL_beginthread, (pfnSDL_CurrentEndThread)SDL_endthread)
136
+ #else
137
+ #define SDL_CreateThread(fn, name, data) SDL_CreateThread(fn, name, data, (pfnSDL_CurrentBeginThread)SDL_beginthread, (pfnSDL_CurrentEndThread)SDL_endthread)
138
+ #define SDL_CreateThreadWithStackSize(fn, name, stacksize, data) SDL_CreateThreadWithStackSize(fn, name, data, (pfnSDL_CurrentBeginThread)_beginthreadex, (pfnSDL_CurrentEndThread)SDL_endthread)
139
+ #endif
140
+
141
+ #elif defined(__OS2__)
142
+ /*
143
+ * just like the windows case above: We compile SDL2
144
+ * into a dll with Watcom's runtime statically linked.
145
+ */
146
+ #define SDL_PASSED_BEGINTHREAD_ENDTHREAD
147
+
148
+ #ifndef __EMX__
149
+ #include <process.h>
150
+ #else
151
+ #include <stdlib.h>
152
+ #endif
153
+
154
+ typedef int (*pfnSDL_CurrentBeginThread)(void (*func)(void *), void *, unsigned, void * /*arg*/);
155
+ typedef void (*pfnSDL_CurrentEndThread)(void);
156
+
157
+ #ifndef SDL_beginthread
158
+ #define SDL_beginthread _beginthread
159
+ #endif
160
+ #ifndef SDL_endthread
161
+ #define SDL_endthread _endthread
162
+ #endif
163
+
164
+ extern DECLSPEC SDL_Thread *SDLCALL
165
+ SDL_CreateThread(SDL_ThreadFunction fn, const char *name, void *data,
166
+ pfnSDL_CurrentBeginThread pfnBeginThread,
167
+ pfnSDL_CurrentEndThread pfnEndThread);
168
+ extern DECLSPEC SDL_Thread *SDLCALL
169
+ SDL_CreateThreadWithStackSize(SDL_ThreadFunction fn, const char *name, const size_t stacksize, void *data,
170
+ pfnSDL_CurrentBeginThread pfnBeginThread,
171
+ pfnSDL_CurrentEndThread pfnEndThread);
172
+
173
+ #if defined(SDL_CreateThread) && SDL_DYNAMIC_API
174
+ #undef SDL_CreateThread
175
+ #define SDL_CreateThread(fn, name, data) SDL_CreateThread_REAL(fn, name, data, (pfnSDL_CurrentBeginThread)SDL_beginthread, (pfnSDL_CurrentEndThread)SDL_endthread)
176
+ #undef SDL_CreateThreadWithStackSize
177
+ #define SDL_CreateThreadWithStackSize(fn, name, stacksize, data) SDL_CreateThreadWithStackSize_REAL(fn, name, data, (pfnSDL_CurrentBeginThread)SDL_beginthread, (pfnSDL_CurrentEndThread)SDL_endthread)
178
+ #else
179
+ #define SDL_CreateThread(fn, name, data) SDL_CreateThread(fn, name, data, (pfnSDL_CurrentBeginThread)SDL_beginthread, (pfnSDL_CurrentEndThread)SDL_endthread)
180
+ #define SDL_CreateThreadWithStackSize(fn, name, stacksize, data) SDL_CreateThreadWithStackSize(fn, name, stacksize, data, (pfnSDL_CurrentBeginThread)SDL_beginthread, (pfnSDL_CurrentEndThread)SDL_endthread)
181
+ #endif
182
+
183
+ #else
184
+
185
+ /**
186
+ * Create a thread with a default stack size.
187
+ *
188
+ * This is equivalent to calling:
189
+ * SDL_CreateThreadWithStackSize(fn, name, 0, data);
190
+ */
191
+ extern DECLSPEC SDL_Thread *SDLCALL
192
+ SDL_CreateThread(SDL_ThreadFunction fn, const char *name, void *data);
193
+
194
+ /**
195
+ * Create a thread.
196
+ *
197
+ * Thread naming is a little complicated: Most systems have very small
198
+ * limits for the string length (Haiku has 32 bytes, Linux currently has 16,
199
+ * Visual C++ 6.0 has nine!), and possibly other arbitrary rules. You'll
200
+ * have to see what happens with your system's debugger. The name should be
201
+ * UTF-8 (but using the naming limits of C identifiers is a better bet).
202
+ * There are no requirements for thread naming conventions, so long as the
203
+ * string is null-terminated UTF-8, but these guidelines are helpful in
204
+ * choosing a name:
205
+ *
206
+ * http://stackoverflow.com/questions/149932/naming-conventions-for-threads
207
+ *
208
+ * If a system imposes requirements, SDL will try to munge the string for
209
+ * it (truncate, etc), but the original string contents will be available
210
+ * from SDL_GetThreadName().
211
+ *
212
+ * The size (in bytes) of the new stack can be specified. Zero means "use
213
+ * the system default" which might be wildly different between platforms
214
+ * (x86 Linux generally defaults to eight megabytes, an embedded device
215
+ * might be a few kilobytes instead).
216
+ *
217
+ * In SDL 2.1, stacksize will be folded into the original SDL_CreateThread
218
+ * function.
219
+ */
220
+ extern DECLSPEC SDL_Thread *SDLCALL
221
+ SDL_CreateThreadWithStackSize(SDL_ThreadFunction fn, const char *name, const size_t stacksize, void *data);
222
+
223
+ #endif
224
+
225
+ /**
226
+ * Get the thread name, as it was specified in SDL_CreateThread().
227
+ * This function returns a pointer to a UTF-8 string that names the
228
+ * specified thread, or NULL if it doesn't have a name. This is internal
229
+ * memory, not to be free()'d by the caller, and remains valid until the
230
+ * specified thread is cleaned up by SDL_WaitThread().
231
+ */
232
+ extern DECLSPEC const char *SDLCALL SDL_GetThreadName(SDL_Thread *thread);
233
+
234
+ /**
235
+ * Get the thread identifier for the current thread.
236
+ */
237
+ extern DECLSPEC SDL_threadID SDLCALL SDL_ThreadID(void);
238
+
239
+ /**
240
+ * Get the thread identifier for the specified thread.
241
+ *
242
+ * Equivalent to SDL_ThreadID() if the specified thread is NULL.
243
+ */
244
+ extern DECLSPEC SDL_threadID SDLCALL SDL_GetThreadID(SDL_Thread * thread);
245
+
246
+ /**
247
+ * Set the priority for the current thread
248
+ */
249
+ extern DECLSPEC int SDLCALL SDL_SetThreadPriority(SDL_ThreadPriority priority);
250
+
251
+ /**
252
+ * Wait for a thread to finish. Threads that haven't been detached will
253
+ * remain (as a "zombie") until this function cleans them up. Not doing so
254
+ * is a resource leak.
255
+ *
256
+ * Once a thread has been cleaned up through this function, the SDL_Thread
257
+ * that references it becomes invalid and should not be referenced again.
258
+ * As such, only one thread may call SDL_WaitThread() on another.
259
+ *
260
+ * The return code for the thread function is placed in the area
261
+ * pointed to by \c status, if \c status is not NULL.
262
+ *
263
+ * You may not wait on a thread that has been used in a call to
264
+ * SDL_DetachThread(). Use either that function or this one, but not
265
+ * both, or behavior is undefined.
266
+ *
267
+ * It is safe to pass NULL to this function; it is a no-op.
268
+ */
269
+ extern DECLSPEC void SDLCALL SDL_WaitThread(SDL_Thread * thread, int *status);
270
+
271
+ /**
272
+ * A thread may be "detached" to signify that it should not remain until
273
+ * another thread has called SDL_WaitThread() on it. Detaching a thread
274
+ * is useful for long-running threads that nothing needs to synchronize
275
+ * with or further manage. When a detached thread is done, it simply
276
+ * goes away.
277
+ *
278
+ * There is no way to recover the return code of a detached thread. If you
279
+ * need this, don't detach the thread and instead use SDL_WaitThread().
280
+ *
281
+ * Once a thread is detached, you should usually assume the SDL_Thread isn't
282
+ * safe to reference again, as it will become invalid immediately upon
283
+ * the detached thread's exit, instead of remaining until someone has called
284
+ * SDL_WaitThread() to finally clean it up. As such, don't detach the same
285
+ * thread more than once.
286
+ *
287
+ * If a thread has already exited when passed to SDL_DetachThread(), it will
288
+ * stop waiting for a call to SDL_WaitThread() and clean up immediately.
289
+ * It is not safe to detach a thread that might be used with SDL_WaitThread().
290
+ *
291
+ * You may not call SDL_WaitThread() on a thread that has been detached.
292
+ * Use either that function or this one, but not both, or behavior is
293
+ * undefined.
294
+ *
295
+ * It is safe to pass NULL to this function; it is a no-op.
296
+ */
297
+ extern DECLSPEC void SDLCALL SDL_DetachThread(SDL_Thread * thread);
298
+
299
+ /**
300
+ * \brief Create an identifier that is globally visible to all threads but refers to data that is thread-specific.
301
+ *
302
+ * \return The newly created thread local storage identifier, or 0 on error
303
+ *
304
+ * \code
305
+ * static SDL_SpinLock tls_lock;
306
+ * static SDL_TLSID thread_local_storage;
307
+ *
308
+ * void SetMyThreadData(void *value)
309
+ * {
310
+ * if (!thread_local_storage) {
311
+ * SDL_AtomicLock(&tls_lock);
312
+ * if (!thread_local_storage) {
313
+ * thread_local_storage = SDL_TLSCreate();
314
+ * }
315
+ * SDL_AtomicUnlock(&tls_lock);
316
+ * }
317
+ * SDL_TLSSet(thread_local_storage, value, 0);
318
+ * }
319
+ *
320
+ * void *GetMyThreadData(void)
321
+ * {
322
+ * return SDL_TLSGet(thread_local_storage);
323
+ * }
324
+ * \endcode
325
+ *
326
+ * \sa SDL_TLSGet()
327
+ * \sa SDL_TLSSet()
328
+ */
329
+ extern DECLSPEC SDL_TLSID SDLCALL SDL_TLSCreate(void);
330
+
331
+ /**
332
+ * \brief Get the value associated with a thread local storage ID for the current thread.
333
+ *
334
+ * \param id The thread local storage ID
335
+ *
336
+ * \return The value associated with the ID for the current thread, or NULL if no value has been set.
337
+ *
338
+ * \sa SDL_TLSCreate()
339
+ * \sa SDL_TLSSet()
340
+ */
341
+ extern DECLSPEC void * SDLCALL SDL_TLSGet(SDL_TLSID id);
342
+
343
+ /**
344
+ * \brief Set the value associated with a thread local storage ID for the current thread.
345
+ *
346
+ * \param id The thread local storage ID
347
+ * \param value The value to associate with the ID for the current thread
348
+ * \param destructor A function called when the thread exits, to free the value.
349
+ *
350
+ * \return 0 on success, -1 on error
351
+ *
352
+ * \sa SDL_TLSCreate()
353
+ * \sa SDL_TLSGet()
354
+ */
355
+ extern DECLSPEC int SDLCALL SDL_TLSSet(SDL_TLSID id, const void *value, void (SDLCALL *destructor)(void*));
356
+
357
+
358
+ /* Ends C function definitions when using C++ */
359
+ #ifdef __cplusplus
360
+ }
361
+ #endif
362
+ #include "close_code.h"
363
+
364
+ #endif /* SDL_thread_h_ */
365
+
366
+ /* vi: set ts=4 sw=4 expandtab: */