gosu 1.4.6 → 1.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (320) hide show
  1. checksums.yaml +4 -4
  2. data/COPYING +2 -1
  3. data/dependencies/SDL/include/SDL3/SDL.h +91 -0
  4. data/dependencies/SDL/include/SDL3/SDL_assert.h +710 -0
  5. data/dependencies/SDL/include/SDL3/SDL_asyncio.h +550 -0
  6. data/dependencies/SDL/include/SDL3/SDL_atomic.h +692 -0
  7. data/dependencies/SDL/include/SDL3/SDL_audio.h +2382 -0
  8. data/dependencies/SDL/include/SDL3/SDL_begin_code.h +553 -0
  9. data/dependencies/SDL/include/{SDL_bits.h → SDL3/SDL_bits.h} +47 -27
  10. data/dependencies/SDL/include/{SDL_blendmode.h → SDL3/SDL_blendmode.h} +59 -55
  11. data/dependencies/SDL/include/SDL3/SDL_camera.h +535 -0
  12. data/dependencies/SDL/include/SDL3/SDL_clipboard.h +331 -0
  13. data/dependencies/SDL/include/{close_code.h → SDL3/SDL_close_code.h} +9 -8
  14. data/dependencies/SDL/include/{SDL_types.h → SDL3/SDL_copying.h} +2 -9
  15. data/dependencies/SDL/include/SDL3/SDL_cpuinfo.h +374 -0
  16. data/dependencies/SDL/include/SDL3/SDL_dialog.h +343 -0
  17. data/dependencies/SDL/include/SDL3/SDL_dlopennote.h +234 -0
  18. data/dependencies/SDL/include/{SDL_egl.h → SDL3/SDL_egl.h} +11 -8
  19. data/dependencies/SDL/include/SDL3/SDL_endian.h +645 -0
  20. data/dependencies/SDL/include/SDL3/SDL_error.h +226 -0
  21. data/dependencies/SDL/include/SDL3/SDL_events.h +1651 -0
  22. data/dependencies/SDL/include/SDL3/SDL_filesystem.h +537 -0
  23. data/dependencies/SDL/include/SDL3/SDL_gamepad.h +1657 -0
  24. data/dependencies/SDL/include/SDL3/SDL_gpu.h +4637 -0
  25. data/dependencies/SDL/include/SDL3/SDL_guid.h +106 -0
  26. data/dependencies/SDL/include/SDL3/SDL_haptic.h +1461 -0
  27. data/dependencies/SDL/include/SDL3/SDL_hidapi.h +571 -0
  28. data/dependencies/SDL/include/SDL3/SDL_hints.h +5041 -0
  29. data/dependencies/SDL/include/SDL3/SDL_init.h +508 -0
  30. data/dependencies/SDL/include/SDL3/SDL_intrin.h +410 -0
  31. data/dependencies/SDL/include/SDL3/SDL_iostream.h +1379 -0
  32. data/dependencies/SDL/include/SDL3/SDL_joystick.h +1385 -0
  33. data/dependencies/SDL/include/SDL3/SDL_keyboard.h +615 -0
  34. data/dependencies/SDL/include/SDL3/SDL_keycode.h +348 -0
  35. data/dependencies/SDL/include/SDL3/SDL_loadso.h +145 -0
  36. data/dependencies/SDL/include/{SDL_locale.h → SDL3/SDL_locale.h} +40 -24
  37. data/dependencies/SDL/include/SDL3/SDL_log.h +541 -0
  38. data/dependencies/SDL/include/SDL3/SDL_main.h +704 -0
  39. data/dependencies/SDL/include/SDL3/SDL_main_impl.h +149 -0
  40. data/dependencies/SDL/include/{SDL_messagebox.h → SDL3/SDL_messagebox.h} +85 -48
  41. data/dependencies/SDL/include/{SDL_metal.h → SDL3/SDL_metal.h} +29 -29
  42. data/dependencies/SDL/include/{SDL_misc.h → SDL3/SDL_misc.h} +13 -12
  43. data/dependencies/SDL/include/SDL3/SDL_mouse.h +813 -0
  44. data/dependencies/SDL/include/SDL3/SDL_mutex.h +1117 -0
  45. data/dependencies/SDL/include/SDL3/SDL_oldnames.h +1339 -0
  46. data/dependencies/SDL/include/{SDL_opengl.h → SDL3/SDL_opengl.h} +1247 -278
  47. data/dependencies/SDL/include/{SDL_opengl_glext.h → SDL3/SDL_opengl_glext.h} +5 -1
  48. data/dependencies/SDL/include/{SDL_opengles.h → SDL3/SDL_opengles.h} +6 -7
  49. data/dependencies/SDL/include/{SDL_opengles2.h → SDL3/SDL_opengles2.h} +10 -11
  50. data/dependencies/SDL/include/SDL3/SDL_pen.h +198 -0
  51. data/dependencies/SDL/include/SDL3/SDL_pixels.h +1441 -0
  52. data/dependencies/SDL/include/{SDL_test_log.h → SDL3/SDL_platform.h} +25 -26
  53. data/dependencies/SDL/include/SDL3/SDL_platform_defines.h +497 -0
  54. data/dependencies/SDL/include/{SDL_power.h → SDL3/SDL_power.h} +40 -20
  55. data/dependencies/SDL/include/SDL3/SDL_process.h +441 -0
  56. data/dependencies/SDL/include/SDL3/SDL_properties.h +572 -0
  57. data/dependencies/SDL/include/SDL3/SDL_rect.h +528 -0
  58. data/dependencies/SDL/include/SDL3/SDL_render.h +3034 -0
  59. data/dependencies/SDL/include/SDL3/SDL_revision.h +56 -0
  60. data/dependencies/SDL/include/{SDL_scancode.h → SDL3/SDL_scancode.h} +60 -68
  61. data/dependencies/SDL/include/SDL3/SDL_sensor.h +321 -0
  62. data/dependencies/SDL/include/SDL3/SDL_stdinc.h +6186 -0
  63. data/dependencies/SDL/include/SDL3/SDL_storage.h +686 -0
  64. data/dependencies/SDL/include/SDL3/SDL_surface.h +1769 -0
  65. data/dependencies/SDL/include/SDL3/SDL_system.h +840 -0
  66. data/dependencies/SDL/include/{SDL_test.h → SDL3/SDL_test.h} +16 -22
  67. data/dependencies/SDL/include/{SDL_test_assert.h → SDL3/SDL_test_assert.h} +27 -34
  68. data/dependencies/SDL/include/{SDL_test_common.h → SDL3/SDL_test_common.h} +109 -52
  69. data/dependencies/SDL/include/{SDL_test_compare.h → SDL3/SDL_test_compare.h} +22 -14
  70. data/dependencies/SDL/include/{SDL_test_crc32.h → SDL3/SDL_test_crc32.h} +27 -30
  71. data/dependencies/SDL/include/{SDL_test_font.h → SDL3/SDL_test_font.h} +50 -49
  72. data/dependencies/SDL/include/{SDL_test_fuzzer.h → SDL3/SDL_test_fuzzer.h} +64 -79
  73. data/dependencies/SDL/include/{SDL_test_harness.h → SDL3/SDL_test_harness.h} +47 -30
  74. data/dependencies/SDL/include/SDL3/SDL_test_log.h +83 -0
  75. data/dependencies/SDL/include/{SDL_test_md5.h → SDL3/SDL_test_md5.h} +21 -28
  76. data/dependencies/SDL/include/{SDL_test_memory.h → SDL3/SDL_test_memory.h} +19 -16
  77. data/dependencies/SDL/include/SDL3/SDL_thread.h +602 -0
  78. data/dependencies/SDL/include/SDL3/SDL_time.h +249 -0
  79. data/dependencies/SDL/include/SDL3/SDL_timer.h +454 -0
  80. data/dependencies/SDL/include/SDL3/SDL_touch.h +184 -0
  81. data/dependencies/SDL/include/SDL3/SDL_tray.h +544 -0
  82. data/dependencies/SDL/include/SDL3/SDL_version.h +198 -0
  83. data/dependencies/SDL/include/SDL3/SDL_video.h +3497 -0
  84. data/dependencies/SDL/include/SDL3/SDL_vulkan.h +287 -0
  85. data/dependencies/SDL/lib/x64/libSDL3.dll.a +0 -0
  86. data/dependencies/SDL/lib/x86/libSDL3.dll.a +0 -0
  87. data/dependencies/SDL_sound/SDL3_sound/SDL_sound.h +755 -0
  88. data/dependencies/SDL_sound/SDL_sound.c +136 -215
  89. data/dependencies/SDL_sound/SDL_sound_aiff.c +55 -54
  90. data/dependencies/SDL_sound/SDL_sound_au.c +32 -32
  91. data/dependencies/SDL_sound/SDL_sound_coreaudio.c +24 -41
  92. data/dependencies/SDL_sound/SDL_sound_flac.c +32 -12
  93. data/dependencies/SDL_sound/SDL_sound_internal.h +33 -48
  94. data/dependencies/SDL_sound/SDL_sound_modplug.c +21 -29
  95. data/dependencies/SDL_sound/SDL_sound_mp3.c +35 -13
  96. data/dependencies/SDL_sound/SDL_sound_raw.c +14 -15
  97. data/dependencies/SDL_sound/SDL_sound_shn.c +82 -82
  98. data/dependencies/SDL_sound/SDL_sound_voc.c +30 -30
  99. data/dependencies/SDL_sound/SDL_sound_vorbis.c +34 -25
  100. data/dependencies/SDL_sound/SDL_sound_wav.c +86 -82
  101. data/dependencies/SDL_sound/dr_flac.h +1890 -1301
  102. data/dependencies/SDL_sound/dr_mp3.h +1098 -660
  103. data/dependencies/SDL_sound/libmodplug/fastmix.c +1 -1
  104. data/dependencies/SDL_sound/libmodplug/libmodplug.h +5 -4
  105. data/dependencies/SDL_sound/libmodplug/load_ams.c +6 -3
  106. data/dependencies/SDL_sound/libmodplug/load_dsm.c +2 -1
  107. data/dependencies/SDL_sound/libmodplug/load_mt2.c +2 -2
  108. data/dependencies/SDL_sound/libmodplug/modplug.h +2 -1
  109. data/dependencies/SDL_sound/libmodplug/snd_fx.c +3 -3
  110. data/dependencies/SDL_sound/libmodplug/sndfile.c +3 -0
  111. data/dependencies/SDL_sound/libmodplug/sndmix.c +7 -3
  112. data/dependencies/SDL_sound/stb_vorbis.h +397 -342
  113. data/dependencies/mojoAL/AL/alc.h +2 -2
  114. data/dependencies/mojoAL/mojoal.c +2120 -1885
  115. data/dependencies/stb/stb_image.h +1190 -1379
  116. data/dependencies/stb/stb_image_write.h +329 -129
  117. data/dependencies/stb/stb_truetype.h +304 -60
  118. data/dependencies/utf8proc/utf8proc.c +133 -75
  119. data/dependencies/utf8proc/utf8proc.h +131 -50
  120. data/dependencies/utf8proc/utf8proc_data.h +16213 -15658
  121. data/ext/gosu-ffi/extconf.rb +103 -0
  122. data/ext/gosu-ffi/gosu-ffi.def +467 -0
  123. data/ffi/Gosu.cpp +330 -0
  124. data/ffi/Gosu.h +84 -0
  125. data/ffi/Gosu_Channel.cpp +62 -0
  126. data/ffi/Gosu_Channel.h +17 -0
  127. data/ffi/Gosu_Color.cpp +176 -0
  128. data/ffi/Gosu_Color.h +31 -0
  129. data/ffi/Gosu_Constants.cpp +334 -0
  130. data/ffi/Gosu_FFI.h +34 -0
  131. data/ffi/Gosu_FFI_internal.h +160 -0
  132. data/ffi/Gosu_Font.cpp +97 -0
  133. data/ffi/Gosu_Font.h +32 -0
  134. data/ffi/Gosu_Image.cpp +239 -0
  135. data/ffi/Gosu_Image.h +71 -0
  136. data/ffi/Gosu_Sample.cpp +29 -0
  137. data/ffi/Gosu_Sample.h +14 -0
  138. data/ffi/Gosu_Song.cpp +69 -0
  139. data/ffi/Gosu_Song.h +18 -0
  140. data/ffi/Gosu_TextInput.cpp +94 -0
  141. data/ffi/Gosu_TextInput.h +25 -0
  142. data/ffi/Gosu_Window.cpp +314 -0
  143. data/ffi/Gosu_Window.h +78 -0
  144. data/include/Gosu/Audio.hpp +6 -11
  145. data/include/Gosu/Bitmap.hpp +38 -53
  146. data/include/Gosu/Buffer.hpp +54 -0
  147. data/include/Gosu/Color.hpp +29 -36
  148. data/include/Gosu/Directories.hpp +25 -28
  149. data/include/Gosu/Drawable.hpp +58 -0
  150. data/include/Gosu/Font.hpp +6 -5
  151. data/include/Gosu/Fwd.hpp +4 -6
  152. data/include/Gosu/Gosu.hpp +5 -5
  153. data/include/Gosu/Graphics.hpp +53 -61
  154. data/include/Gosu/GraphicsBase.hpp +1 -11
  155. data/include/Gosu/Image.hpp +12 -15
  156. data/include/Gosu/Math.hpp +50 -72
  157. data/include/Gosu/Transform.hpp +32 -0
  158. data/include/Gosu/Utility.hpp +77 -1
  159. data/include/Gosu/Version.hpp +2 -2
  160. data/include/Gosu/Window.hpp +15 -9
  161. data/lib/SDL3.dll +0 -0
  162. data/lib/gosu/channel.rb +50 -0
  163. data/lib/gosu/color.rb +173 -0
  164. data/lib/gosu/compat.rb +130 -17
  165. data/lib/gosu/constants.rb +386 -0
  166. data/lib/gosu/ffi.rb +269 -0
  167. data/lib/gosu/font.rb +62 -0
  168. data/lib/gosu/gl_tex_info.rb +33 -0
  169. data/lib/gosu/gosu.rb +250 -0
  170. data/lib/gosu/image.rb +179 -0
  171. data/lib/gosu/numeric.rb +17 -0
  172. data/lib/gosu/preview.rb +6 -6
  173. data/lib/gosu/sample.rb +25 -0
  174. data/lib/gosu/song.rb +57 -0
  175. data/lib/gosu/text_input.rb +83 -0
  176. data/lib/gosu/window.rb +249 -0
  177. data/lib/gosu.rb +29 -8
  178. data/lib64/SDL3.dll +0 -0
  179. data/rdoc/gosu.rb +2 -2
  180. data/src/Audio.cpp +30 -24
  181. data/src/AudioFile.hpp +5 -4
  182. data/src/AudioFileAudioToolbox.cpp +8 -8
  183. data/src/AudioFileSDLSound.cpp +12 -15
  184. data/src/BinPacker.cpp +188 -0
  185. data/src/BinPacker.hpp +55 -0
  186. data/src/Bitmap.cpp +172 -143
  187. data/src/BitmapIO.cpp +60 -86
  188. data/src/Buffer.cpp +150 -0
  189. data/src/ClipRectStack.cpp +38 -0
  190. data/src/ClipRectStack.hpp +17 -83
  191. data/src/Color.cpp +75 -80
  192. data/src/Directories.cpp +47 -0
  193. data/src/DirectoriesUIKit.cpp +50 -0
  194. data/src/DrawOp.hpp +20 -18
  195. data/src/DrawOpQueue.hpp +27 -33
  196. data/src/Drawable.cpp +95 -0
  197. data/src/EmptyDrawable.hpp +38 -0
  198. data/src/FPS.cpp +31 -0
  199. data/src/Font.cpp +104 -74
  200. data/src/GosuGLView.cpp +13 -11
  201. data/src/GosuViewController.cpp +2 -10
  202. data/src/Graphics.cpp +86 -145
  203. data/src/GraphicsImpl.hpp +14 -68
  204. data/src/Image.cpp +41 -35
  205. data/src/Input.cpp +73 -78
  206. data/src/Macro.cpp +46 -29
  207. data/src/Macro.hpp +23 -17
  208. data/src/MarkupParser.cpp +5 -5
  209. data/src/Math.cpp +48 -22
  210. data/src/OffScreenTarget.cpp +47 -50
  211. data/src/OffScreenTarget.hpp +13 -11
  212. data/src/OpenGLContext.cpp +116 -0
  213. data/src/OpenGLContext.hpp +41 -0
  214. data/src/RenderState.hpp +49 -71
  215. data/src/Resolution.cpp +65 -53
  216. data/src/TexChunk.cpp +35 -80
  217. data/src/TexChunk.hpp +44 -35
  218. data/src/Text.cpp +1 -1
  219. data/src/TextBuilder.cpp +35 -21
  220. data/src/TextBuilder.hpp +6 -9
  221. data/src/TextInput.cpp +9 -9
  222. data/src/Texture.cpp +62 -80
  223. data/src/Texture.hpp +25 -23
  224. data/src/TiledDrawable.cpp +149 -0
  225. data/src/TiledDrawable.hpp +47 -0
  226. data/src/TimingApple.cpp +1 -1
  227. data/src/Transform.cpp +45 -50
  228. data/src/TransformStack.hpp +16 -16
  229. data/src/TrueTypeFont.cpp +59 -51
  230. data/src/TrueTypeFont.hpp +6 -7
  231. data/src/TrueTypeFontApple.cpp +28 -19
  232. data/src/TrueTypeFontUnix.cpp +39 -32
  233. data/src/TrueTypeFontWin.cpp +30 -30
  234. data/src/Utility.cpp +113 -37
  235. data/src/UtilityWin.cpp +49 -0
  236. data/src/Window.cpp +121 -151
  237. data/src/WindowUIKit.cpp +14 -14
  238. metadata +165 -118
  239. data/dependencies/SDL/include/SDL.h +0 -233
  240. data/dependencies/SDL/include/SDL_assert.h +0 -320
  241. data/dependencies/SDL/include/SDL_atomic.h +0 -415
  242. data/dependencies/SDL/include/SDL_audio.h +0 -1500
  243. data/dependencies/SDL/include/SDL_clipboard.h +0 -141
  244. data/dependencies/SDL/include/SDL_config.h +0 -331
  245. data/dependencies/SDL/include/SDL_cpuinfo.h +0 -594
  246. data/dependencies/SDL/include/SDL_endian.h +0 -348
  247. data/dependencies/SDL/include/SDL_error.h +0 -163
  248. data/dependencies/SDL/include/SDL_events.h +0 -1166
  249. data/dependencies/SDL/include/SDL_filesystem.h +0 -149
  250. data/dependencies/SDL/include/SDL_gamecontroller.h +0 -1074
  251. data/dependencies/SDL/include/SDL_gesture.h +0 -117
  252. data/dependencies/SDL/include/SDL_guid.h +0 -100
  253. data/dependencies/SDL/include/SDL_haptic.h +0 -1341
  254. data/dependencies/SDL/include/SDL_hidapi.h +0 -451
  255. data/dependencies/SDL/include/SDL_hints.h +0 -2569
  256. data/dependencies/SDL/include/SDL_joystick.h +0 -1066
  257. data/dependencies/SDL/include/SDL_keyboard.h +0 -353
  258. data/dependencies/SDL/include/SDL_keycode.h +0 -358
  259. data/dependencies/SDL/include/SDL_loadso.h +0 -115
  260. data/dependencies/SDL/include/SDL_log.h +0 -404
  261. data/dependencies/SDL/include/SDL_main.h +0 -275
  262. data/dependencies/SDL/include/SDL_mouse.h +0 -465
  263. data/dependencies/SDL/include/SDL_mutex.h +0 -471
  264. data/dependencies/SDL/include/SDL_name.h +0 -33
  265. data/dependencies/SDL/include/SDL_pixels.h +0 -644
  266. data/dependencies/SDL/include/SDL_platform.h +0 -261
  267. data/dependencies/SDL/include/SDL_quit.h +0 -58
  268. data/dependencies/SDL/include/SDL_rect.h +0 -376
  269. data/dependencies/SDL/include/SDL_render.h +0 -1919
  270. data/dependencies/SDL/include/SDL_revision.h +0 -7
  271. data/dependencies/SDL/include/SDL_rwops.h +0 -841
  272. data/dependencies/SDL/include/SDL_sensor.h +0 -322
  273. data/dependencies/SDL/include/SDL_shape.h +0 -155
  274. data/dependencies/SDL/include/SDL_stdinc.h +0 -830
  275. data/dependencies/SDL/include/SDL_surface.h +0 -997
  276. data/dependencies/SDL/include/SDL_system.h +0 -623
  277. data/dependencies/SDL/include/SDL_syswm.h +0 -386
  278. data/dependencies/SDL/include/SDL_test_images.h +0 -78
  279. data/dependencies/SDL/include/SDL_test_random.h +0 -115
  280. data/dependencies/SDL/include/SDL_thread.h +0 -464
  281. data/dependencies/SDL/include/SDL_timer.h +0 -222
  282. data/dependencies/SDL/include/SDL_touch.h +0 -150
  283. data/dependencies/SDL/include/SDL_version.h +0 -204
  284. data/dependencies/SDL/include/SDL_video.h +0 -2150
  285. data/dependencies/SDL/include/SDL_vulkan.h +0 -215
  286. data/dependencies/SDL/include/begin_code.h +0 -187
  287. data/dependencies/SDL/lib/x64/libSDL2.dll.a +0 -0
  288. data/dependencies/SDL/lib/x86/libSDL2.dll.a +0 -0
  289. data/dependencies/SDL_sound/SDL_sound.h +0 -725
  290. data/ext/gosu/extconf.rb +0 -119
  291. data/include/Gosu/IO.hpp +0 -254
  292. data/include/Gosu/ImageData.hpp +0 -53
  293. data/include/Gosu/Inspection.hpp +0 -7
  294. data/lib/SDL2.dll +0 -0
  295. data/lib/gosu/patches.rb +0 -66
  296. data/lib/gosu/run.rb +0 -20
  297. data/lib/gosu/swig_patches.rb +0 -110
  298. data/lib64/SDL2.dll +0 -0
  299. data/src/BlockAllocator.cpp +0 -131
  300. data/src/BlockAllocator.hpp +0 -32
  301. data/src/DirectoriesApple.cpp +0 -69
  302. data/src/DirectoriesUnix.cpp +0 -46
  303. data/src/DirectoriesWin.cpp +0 -65
  304. data/src/EmptyImageData.hpp +0 -52
  305. data/src/FileUnix.cpp +0 -99
  306. data/src/FileWin.cpp +0 -88
  307. data/src/IO.cpp +0 -60
  308. data/src/Iconv.hpp +0 -51
  309. data/src/Inspection.cpp +0 -27
  310. data/src/LargeImageData.cpp +0 -215
  311. data/src/LargeImageData.hpp +0 -39
  312. data/src/Log.hpp +0 -19
  313. data/src/RubyGosu.cxx +0 -13100
  314. data/src/RubyGosu.h +0 -49
  315. data/src/WinUtility.cpp +0 -61
  316. data/src/WinUtility.hpp +0 -27
  317. /data/dependencies/SDL/include/{SDL_opengles2_gl2.h → SDL3/SDL_opengles2_gl2.h} +0 -0
  318. /data/dependencies/SDL/include/{SDL_opengles2_gl2ext.h → SDL3/SDL_opengles2_gl2ext.h} +0 -0
  319. /data/dependencies/SDL/include/{SDL_opengles2_gl2platform.h → SDL3/SDL_opengles2_gl2platform.h} +0 -0
  320. /data/dependencies/SDL/include/{SDL_opengles2_khrplatform.h → SDL3/SDL_opengles2_khrplatform.h} +0 -0
@@ -0,0 +1,410 @@
1
+ /*
2
+ Simple DirectMedia Layer
3
+ Copyright (C) 1997-2026 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
+ /* WIKI CATEGORY: Intrinsics */
23
+
24
+ /**
25
+ * # CategoryIntrinsics
26
+ *
27
+ * SDL does some preprocessor gymnastics to determine if any CPU-specific
28
+ * compiler intrinsics are available, as this is not necessarily an easy thing
29
+ * to calculate, and sometimes depends on quirks of a system, versions of
30
+ * build tools, and other external forces.
31
+ *
32
+ * Apps including SDL's headers will be able to check consistent preprocessor
33
+ * definitions to decide if it's safe to use compiler intrinsics for a
34
+ * specific CPU architecture. This check only tells you that the compiler is
35
+ * capable of using those intrinsics; at runtime, you should still check if
36
+ * they are available on the current system with the
37
+ * [CPU info functions](https://wiki.libsdl.org/SDL3/CategoryCPUInfo)
38
+ * , such as SDL_HasSSE() or SDL_HasNEON(). Otherwise, the process might crash
39
+ * for using an unsupported CPU instruction.
40
+ *
41
+ * SDL only sets preprocessor defines for CPU intrinsics if they are
42
+ * supported, so apps should check with `#ifdef` and not `#if`.
43
+ *
44
+ * SDL will also include the appropriate instruction-set-specific support
45
+ * headers, so if SDL decides to define SDL_SSE2_INTRINSICS, it will also
46
+ * `#include <emmintrin.h>` as well.
47
+ */
48
+
49
+ #ifndef SDL_intrin_h_
50
+ #define SDL_intrin_h_
51
+
52
+ #include <SDL3/SDL_stdinc.h>
53
+
54
+ #ifdef SDL_WIKI_DOCUMENTATION_SECTION
55
+
56
+ /**
57
+ * Defined if (and only if) the compiler supports Loongarch LSX intrinsics.
58
+ *
59
+ * If this macro is defined, SDL will have already included `<lsxintrin.h>`
60
+ *
61
+ * \since This macro is available since SDL 3.2.0.
62
+ *
63
+ * \sa SDL_LASX_INTRINSICS
64
+ */
65
+ #define SDL_LSX_INTRINSICS 1
66
+
67
+ /**
68
+ * Defined if (and only if) the compiler supports Loongarch LSX intrinsics.
69
+ *
70
+ * If this macro is defined, SDL will have already included `<lasxintrin.h>`
71
+ *
72
+ * \since This macro is available since SDL 3.2.0.
73
+ *
74
+ * \sa SDL_LASX_INTRINSICS
75
+ */
76
+ #define SDL_LASX_INTRINSICS 1
77
+
78
+ /**
79
+ * Defined if (and only if) the compiler supports ARM NEON intrinsics.
80
+ *
81
+ * If this macro is defined, SDL will have already included `<armintr.h>`
82
+ * `<arm_neon.h>`, `<arm64intr.h>`, and `<arm64_neon.h>`, as appropriate.
83
+ *
84
+ * \since This macro is available since SDL 3.2.0.
85
+ */
86
+ #define SDL_NEON_INTRINSICS 1
87
+
88
+ /**
89
+ * Defined if (and only if) the compiler supports PowerPC Altivec intrinsics.
90
+ *
91
+ * If this macro is defined, SDL will have already included `<altivec.h>`
92
+ *
93
+ * \since This macro is available since SDL 3.2.0.
94
+ */
95
+ #define SDL_ALTIVEC_INTRINSICS 1
96
+
97
+ /**
98
+ * Defined if (and only if) the compiler supports Intel MMX intrinsics.
99
+ *
100
+ * If this macro is defined, SDL will have already included `<mmintrin.h>`
101
+ *
102
+ * \since This macro is available since SDL 3.2.0.
103
+ *
104
+ * \sa SDL_SSE_INTRINSICS
105
+ */
106
+ #define SDL_MMX_INTRINSICS 1
107
+
108
+ /**
109
+ * Defined if (and only if) the compiler supports Intel SSE intrinsics.
110
+ *
111
+ * If this macro is defined, SDL will have already included `<xmmintrin.h>`
112
+ *
113
+ * \since This macro is available since SDL 3.2.0.
114
+ *
115
+ * \sa SDL_SSE2_INTRINSICS
116
+ * \sa SDL_SSE3_INTRINSICS
117
+ * \sa SDL_SSE4_1_INTRINSICS
118
+ * \sa SDL_SSE4_2_INTRINSICS
119
+ */
120
+ #define SDL_SSE_INTRINSICS 1
121
+
122
+ /**
123
+ * Defined if (and only if) the compiler supports Intel SSE2 intrinsics.
124
+ *
125
+ * If this macro is defined, SDL will have already included `<emmintrin.h>`
126
+ *
127
+ * \since This macro is available since SDL 3.2.0.
128
+ *
129
+ * \sa SDL_SSE_INTRINSICS
130
+ * \sa SDL_SSE3_INTRINSICS
131
+ * \sa SDL_SSE4_1_INTRINSICS
132
+ * \sa SDL_SSE4_2_INTRINSICS
133
+ */
134
+ #define SDL_SSE2_INTRINSICS 1
135
+
136
+ /**
137
+ * Defined if (and only if) the compiler supports Intel SSE3 intrinsics.
138
+ *
139
+ * If this macro is defined, SDL will have already included `<pmmintrin.h>`
140
+ *
141
+ * \since This macro is available since SDL 3.2.0.
142
+ *
143
+ * \sa SDL_SSE_INTRINSICS
144
+ * \sa SDL_SSE2_INTRINSICS
145
+ * \sa SDL_SSE4_1_INTRINSICS
146
+ * \sa SDL_SSE4_2_INTRINSICS
147
+ */
148
+ #define SDL_SSE3_INTRINSICS 1
149
+
150
+ /**
151
+ * Defined if (and only if) the compiler supports Intel SSE4.1 intrinsics.
152
+ *
153
+ * If this macro is defined, SDL will have already included `<smmintrin.h>`
154
+ *
155
+ * \since This macro is available since SDL 3.2.0.
156
+ *
157
+ * \sa SDL_SSE_INTRINSICS
158
+ * \sa SDL_SSE2_INTRINSICS
159
+ * \sa SDL_SSE3_INTRINSICS
160
+ * \sa SDL_SSE4_2_INTRINSICS
161
+ */
162
+ #define SDL_SSE4_1_INTRINSICS 1
163
+
164
+ /**
165
+ * Defined if (and only if) the compiler supports Intel SSE4.2 intrinsics.
166
+ *
167
+ * If this macro is defined, SDL will have already included `<nmmintrin.h>`
168
+ *
169
+ * \since This macro is available since SDL 3.2.0.
170
+ *
171
+ * \sa SDL_SSE_INTRINSICS
172
+ * \sa SDL_SSE2_INTRINSICS
173
+ * \sa SDL_SSE3_INTRINSICS
174
+ * \sa SDL_SSE4_1_INTRINSICS
175
+ */
176
+ #define SDL_SSE4_2_INTRINSICS 1
177
+
178
+ /**
179
+ * Defined if (and only if) the compiler supports Intel AVX intrinsics.
180
+ *
181
+ * If this macro is defined, SDL will have already included `<immintrin.h>`
182
+ *
183
+ * \since This macro is available since SDL 3.2.0.
184
+ *
185
+ * \sa SDL_AVX2_INTRINSICS
186
+ * \sa SDL_AVX512F_INTRINSICS
187
+ */
188
+ #define SDL_AVX_INTRINSICS 1
189
+
190
+ /**
191
+ * Defined if (and only if) the compiler supports Intel AVX2 intrinsics.
192
+ *
193
+ * If this macro is defined, SDL will have already included `<immintrin.h>`
194
+ *
195
+ * \since This macro is available since SDL 3.2.0.
196
+ *
197
+ * \sa SDL_AVX_INTRINSICS
198
+ * \sa SDL_AVX512F_INTRINSICS
199
+ */
200
+ #define SDL_AVX2_INTRINSICS 1
201
+
202
+ /**
203
+ * Defined if (and only if) the compiler supports Intel AVX-512F intrinsics.
204
+ *
205
+ * AVX-512F is also sometimes referred to as "AVX-512 Foundation."
206
+ *
207
+ * If this macro is defined, SDL will have already included `<immintrin.h>`
208
+ *
209
+ * \since This macro is available since SDL 3.2.0.
210
+ *
211
+ * \sa SDL_AVX_INTRINSICS
212
+ * \sa SDL_AVX2_INTRINSICS
213
+ */
214
+ #define SDL_AVX512F_INTRINSICS 1
215
+ #endif
216
+
217
+ /* Need to do this here because intrin.h has C++ code in it */
218
+ /* Visual Studio 2005 has a bug where intrin.h conflicts with winnt.h */
219
+ #if defined(_MSC_VER) && (_MSC_VER >= 1500) && (defined(_M_IX86) || defined(_M_X64))
220
+ /* As of Clang 11, '_m_prefetchw' is conflicting with the winnt.h's version,
221
+ so we define the needed '_m_prefetch' here as a pseudo-header, until the issue is fixed. */
222
+ #if defined(__clang__) && !SDL_HAS_BUILTIN(_m_prefetch)
223
+ #ifndef __PRFCHWINTRIN_H
224
+ #define __PRFCHWINTRIN_H
225
+ static __inline__ void __attribute__((__always_inline__, __nodebug__))
226
+ _m_prefetch(void *__P)
227
+ {
228
+ __builtin_prefetch (__P, 0, 3 /* _MM_HINT_T0 */);
229
+ }
230
+ #endif /* __PRFCHWINTRIN_H */
231
+ #endif /* __clang__ */
232
+ #include <intrin.h>
233
+
234
+ #elif defined(__MINGW64_VERSION_MAJOR)
235
+ #include <intrin.h>
236
+ #if defined(__ARM_NEON) && !defined(SDL_DISABLE_NEON)
237
+ # define SDL_NEON_INTRINSICS 1
238
+ # include <arm_neon.h>
239
+ #endif
240
+
241
+ #else
242
+ /* altivec.h redefining bool causes a number of problems, see bugs 3993 and 4392, so you need to explicitly define SDL_ENABLE_ALTIVEC to have it included. */
243
+ #if defined(__ALTIVEC__) && defined(SDL_ENABLE_ALTIVEC)
244
+ #define SDL_ALTIVEC_INTRINSICS 1
245
+ #include <altivec.h>
246
+ #endif
247
+ #ifndef SDL_DISABLE_NEON
248
+ # ifdef __ARM_NEON
249
+ # define SDL_NEON_INTRINSICS 1
250
+ # include <arm_neon.h>
251
+ # elif defined(SDL_PLATFORM_WINDOWS)
252
+ /* Visual Studio doesn't define __ARM_ARCH, but _M_ARM (if set, always 7), and _M_ARM64 (if set, always 1). */
253
+ # ifdef _M_ARM
254
+ # define SDL_NEON_INTRINSICS 1
255
+ # include <armintr.h>
256
+ # include <arm_neon.h>
257
+ # define __ARM_NEON 1 /* Set __ARM_NEON so that it can be used elsewhere, at compile time */
258
+ # endif
259
+ # if defined (_M_ARM64)
260
+ # define SDL_NEON_INTRINSICS 1
261
+ # include <arm64intr.h>
262
+ # include <arm64_neon.h>
263
+ # define __ARM_NEON 1 /* Set __ARM_NEON so that it can be used elsewhere, at compile time */
264
+ # define __ARM_ARCH 8
265
+ # endif
266
+ # endif
267
+ #endif
268
+ #endif /* compiler version */
269
+
270
+ #ifdef SDL_WIKI_DOCUMENTATION_SECTION
271
+
272
+ /**
273
+ * A macro to decide if the compiler supports `__attribute__((target))`.
274
+ *
275
+ * Even though this is defined in SDL's public headers, it is generally not
276
+ * used directly by apps. Apps should probably just use SDL_TARGETING
277
+ * directly, instead.
278
+ *
279
+ * \since This macro is available since SDL 3.2.0.
280
+ *
281
+ * \sa SDL_TARGETING
282
+ */
283
+ #define SDL_HAS_TARGET_ATTRIBS
284
+ #elif defined(__loongarch64) && defined(__GNUC__) && (__GNUC__ >= 15)
285
+ /* LoongArch requires GCC 15+ for target attribute support */
286
+ # define SDL_HAS_TARGET_ATTRIBS
287
+ #elif defined(__clang__) && defined(__has_attribute)
288
+ # if __has_attribute(target)
289
+ # define SDL_HAS_TARGET_ATTRIBS
290
+ # endif
291
+ #elif defined(__GNUC__) && !defined(__loongarch64) && (__GNUC__ + (__GNUC_MINOR__ >= 9) > 4) /* gcc >= 4.9 */
292
+ # define SDL_HAS_TARGET_ATTRIBS
293
+ #elif defined(__ICC) && __ICC >= 1600
294
+ # define SDL_HAS_TARGET_ATTRIBS
295
+ #endif
296
+
297
+
298
+ #ifdef SDL_WIKI_DOCUMENTATION_SECTION
299
+
300
+ /**
301
+ * A macro to tag a function as targeting a specific CPU architecture.
302
+ *
303
+ * This is a hint to the compiler that a function should be built with support
304
+ * for a CPU instruction set that might be different than the rest of the
305
+ * program.
306
+ *
307
+ * The particulars of this are explained in the GCC documentation:
308
+ *
309
+ * https://gcc.gnu.org/onlinedocs/gcc/Common-Function-Attributes.html#index-target-function-attribute
310
+ *
311
+ * An example of using this feature is to turn on SSE2 support for a specific
312
+ * function, even if the rest of the source code is not compiled to use SSE2
313
+ * code:
314
+ *
315
+ * ```c
316
+ * #ifdef SDL_SSE2_INTRINSICS
317
+ * static void SDL_TARGETING("sse2") DoSomethingWithSSE2(char *x) {
318
+ * ...use SSE2 intrinsic functions, etc...
319
+ * }
320
+ * #endif
321
+ *
322
+ * // later...
323
+ * #ifdef SDL_SSE2_INTRINSICS
324
+ * if (SDL_HasSSE2()) {
325
+ * DoSomethingWithSSE2(str);
326
+ * }
327
+ * #endif
328
+ * ```
329
+ *
330
+ * The application is, on a whole, built without SSE2 instructions, so it will
331
+ * run on Intel machines that don't support SSE2. But then at runtime, it
332
+ * checks if the system supports the instructions, and then calls into a
333
+ * function that uses SSE2 opcodes. The ifdefs make sure that this code isn't
334
+ * used on platforms that don't have SSE2 at all.
335
+ *
336
+ * On compilers without target support, this is defined to nothing.
337
+ *
338
+ * This symbol is used by SDL internally, but apps and other libraries are
339
+ * welcome to use it for their own interfaces as well.
340
+ *
341
+ * \since This macro is available since SDL 3.2.0.
342
+ */
343
+ #define SDL_TARGETING(x) __attribute__((target(x)))
344
+
345
+ #elif defined(SDL_HAS_TARGET_ATTRIBS)
346
+ # define SDL_TARGETING(x) __attribute__((target(x)))
347
+ #else
348
+ # define SDL_TARGETING(x)
349
+ #endif
350
+
351
+ #ifdef __loongarch64
352
+ # ifndef SDL_DISABLE_LSX
353
+ # define SDL_LSX_INTRINSICS 1
354
+ # include <lsxintrin.h>
355
+ # endif
356
+ # ifndef SDL_DISABLE_LASX
357
+ # define SDL_LASX_INTRINSICS 1
358
+ # include <lasxintrin.h>
359
+ # endif
360
+ #endif
361
+
362
+ #if defined(__x86_64__) || defined(_M_X64) || defined(__i386__) || defined(_M_IX86)
363
+ # if ((defined(_MSC_VER) && !defined(_M_X64)) || defined(__MMX__) || defined(SDL_HAS_TARGET_ATTRIBS)) && !defined(SDL_DISABLE_MMX)
364
+ # define SDL_MMX_INTRINSICS 1
365
+ # include <mmintrin.h>
366
+ # endif
367
+ # if (defined(_MSC_VER) || defined(__SSE__) || defined(SDL_HAS_TARGET_ATTRIBS)) && !defined(SDL_DISABLE_SSE)
368
+ # define SDL_SSE_INTRINSICS 1
369
+ # include <xmmintrin.h>
370
+ # endif
371
+ # if (defined(_MSC_VER) || defined(__SSE2__) || defined(SDL_HAS_TARGET_ATTRIBS)) && !defined(SDL_DISABLE_SSE2)
372
+ # define SDL_SSE2_INTRINSICS 1
373
+ # include <emmintrin.h>
374
+ # endif
375
+ # if (defined(_MSC_VER) || defined(__SSE3__) || defined(SDL_HAS_TARGET_ATTRIBS)) && !defined(SDL_DISABLE_SSE3)
376
+ # define SDL_SSE3_INTRINSICS 1
377
+ # include <pmmintrin.h>
378
+ # endif
379
+ # if (defined(_MSC_VER) || defined(__SSE4_1__) || defined(SDL_HAS_TARGET_ATTRIBS)) && !defined(SDL_DISABLE_SSE4_1)
380
+ # define SDL_SSE4_1_INTRINSICS 1
381
+ # include <smmintrin.h>
382
+ # endif
383
+ # if (defined(_MSC_VER) || defined(__SSE4_2__) || defined(SDL_HAS_TARGET_ATTRIBS)) && !defined(SDL_DISABLE_SSE4_2)
384
+ # define SDL_SSE4_2_INTRINSICS 1
385
+ # include <nmmintrin.h>
386
+ # endif
387
+ # if defined(__clang__) && (defined(_MSC_VER) || defined(__SCE__)) && !defined(__AVX__) && !defined(SDL_DISABLE_AVX)
388
+ # define SDL_DISABLE_AVX /* see https://reviews.llvm.org/D20291 and https://reviews.llvm.org/D79194 */
389
+ # endif
390
+ # if (defined(_MSC_VER) || defined(__AVX__) || defined(SDL_HAS_TARGET_ATTRIBS)) && !defined(_M_ARM64EC) && !defined(SDL_DISABLE_AVX)
391
+ # define SDL_AVX_INTRINSICS 1
392
+ # include <immintrin.h>
393
+ # endif
394
+ # if defined(__clang__) && (defined(_MSC_VER) || defined(__SCE__)) && !defined(__AVX2__) && !defined(SDL_DISABLE_AVX2)
395
+ # define SDL_DISABLE_AVX2 /* see https://reviews.llvm.org/D20291 and https://reviews.llvm.org/D79194 */
396
+ # endif
397
+ # if (defined(_MSC_VER) || defined(__AVX2__) || defined(SDL_HAS_TARGET_ATTRIBS)) && !defined(_M_ARM64EC) && !defined(SDL_DISABLE_AVX2)
398
+ # define SDL_AVX2_INTRINSICS 1
399
+ # include <immintrin.h>
400
+ # endif
401
+ # if defined(__clang__) && (defined(_MSC_VER) || defined(__SCE__)) && !defined(__AVX512F__) && !defined(SDL_DISABLE_AVX512F)
402
+ # define SDL_DISABLE_AVX512F /* see https://reviews.llvm.org/D20291 and https://reviews.llvm.org/D79194 */
403
+ # endif
404
+ # if (defined(_MSC_VER) || defined(__AVX512F__) || defined(SDL_HAS_TARGET_ATTRIBS)) && !defined(_M_ARM64EC) && !defined(SDL_DISABLE_AVX512F)
405
+ # define SDL_AVX512F_INTRINSICS 1
406
+ # include <immintrin.h>
407
+ # endif
408
+ #endif /* defined(__x86_64__) || defined(_M_X64) || defined(__i386__) || defined(_M_IX86) */
409
+
410
+ #endif /* SDL_intrin_h_ */