native_audio 0.2.0 → 0.3.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 (147) hide show
  1. checksums.yaml +4 -4
  2. data/assets/include/SDL2/SDL.h +233 -233
  3. data/assets/include/SDL2/SDL_assert.h +326 -326
  4. data/assets/include/SDL2/SDL_atomic.h +415 -415
  5. data/assets/include/SDL2/SDL_audio.h +1500 -1500
  6. data/assets/include/SDL2/SDL_bits.h +126 -126
  7. data/assets/include/SDL2/SDL_blendmode.h +198 -198
  8. data/assets/include/SDL2/SDL_clipboard.h +141 -141
  9. data/assets/include/SDL2/SDL_config.h +61 -61
  10. data/assets/include/SDL2/SDL_config_android.h +194 -194
  11. data/assets/include/SDL2/SDL_config_emscripten.h +218 -218
  12. data/assets/include/SDL2/SDL_config_iphoneos.h +217 -217
  13. data/assets/include/SDL2/SDL_config_macosx.h +277 -277
  14. data/assets/include/SDL2/SDL_config_minimal.h +95 -95
  15. data/assets/include/SDL2/SDL_config_ngage.h +89 -89
  16. data/assets/include/SDL2/SDL_config_os2.h +207 -207
  17. data/assets/include/SDL2/SDL_config_pandora.h +141 -141
  18. data/assets/include/SDL2/SDL_config_windows.h +331 -331
  19. data/assets/include/SDL2/SDL_config_wingdk.h +253 -253
  20. data/assets/include/SDL2/SDL_config_winrt.h +220 -220
  21. data/assets/include/SDL2/SDL_config_xbox.h +235 -235
  22. data/assets/include/SDL2/SDL_copying.h +20 -20
  23. data/assets/include/SDL2/SDL_cpuinfo.h +594 -594
  24. data/assets/include/SDL2/SDL_egl.h +2352 -2352
  25. data/assets/include/SDL2/SDL_endian.h +348 -348
  26. data/assets/include/SDL2/SDL_error.h +163 -163
  27. data/assets/include/SDL2/SDL_events.h +1166 -1166
  28. data/assets/include/SDL2/SDL_filesystem.h +149 -149
  29. data/assets/include/SDL2/SDL_gamecontroller.h +1074 -1074
  30. data/assets/include/SDL2/SDL_gesture.h +117 -117
  31. data/assets/include/SDL2/SDL_guid.h +100 -100
  32. data/assets/include/SDL2/SDL_haptic.h +1341 -1341
  33. data/assets/include/SDL2/SDL_hidapi.h +451 -451
  34. data/assets/include/SDL2/SDL_hints.h +2569 -2569
  35. data/assets/include/SDL2/SDL_image.h +2173 -2173
  36. data/assets/include/SDL2/SDL_joystick.h +1066 -1066
  37. data/assets/include/SDL2/SDL_keyboard.h +353 -353
  38. data/assets/include/SDL2/SDL_keycode.h +358 -358
  39. data/assets/include/SDL2/SDL_loadso.h +115 -115
  40. data/assets/include/SDL2/SDL_locale.h +103 -103
  41. data/assets/include/SDL2/SDL_log.h +404 -404
  42. data/assets/include/SDL2/SDL_main.h +275 -275
  43. data/assets/include/SDL2/SDL_messagebox.h +193 -193
  44. data/assets/include/SDL2/SDL_metal.h +113 -113
  45. data/assets/include/SDL2/SDL_misc.h +79 -79
  46. data/assets/include/SDL2/SDL_mixer.h +2784 -2784
  47. data/assets/include/SDL2/SDL_mouse.h +465 -465
  48. data/assets/include/SDL2/SDL_mutex.h +471 -471
  49. data/assets/include/SDL2/SDL_name.h +33 -33
  50. data/assets/include/SDL2/SDL_opengl.h +2132 -2132
  51. data/assets/include/SDL2/SDL_opengl_glext.h +13209 -13209
  52. data/assets/include/SDL2/SDL_opengles.h +39 -39
  53. data/assets/include/SDL2/SDL_opengles2.h +52 -52
  54. data/assets/include/SDL2/SDL_opengles2_gl2.h +656 -656
  55. data/assets/include/SDL2/SDL_opengles2_gl2ext.h +4033 -4033
  56. data/assets/include/SDL2/SDL_opengles2_gl2platform.h +27 -27
  57. data/assets/include/SDL2/SDL_opengles2_khrplatform.h +311 -311
  58. data/assets/include/SDL2/SDL_pixels.h +644 -644
  59. data/assets/include/SDL2/SDL_platform.h +261 -261
  60. data/assets/include/SDL2/SDL_power.h +88 -88
  61. data/assets/include/SDL2/SDL_quit.h +58 -58
  62. data/assets/include/SDL2/SDL_rect.h +376 -376
  63. data/assets/include/SDL2/SDL_render.h +1919 -1919
  64. data/assets/include/SDL2/SDL_revision.h +6 -6
  65. data/assets/include/SDL2/SDL_rwops.h +841 -841
  66. data/assets/include/SDL2/SDL_scancode.h +438 -438
  67. data/assets/include/SDL2/SDL_sensor.h +322 -322
  68. data/assets/include/SDL2/SDL_shape.h +155 -155
  69. data/assets/include/SDL2/SDL_stdinc.h +830 -830
  70. data/assets/include/SDL2/SDL_surface.h +997 -997
  71. data/assets/include/SDL2/SDL_system.h +623 -623
  72. data/assets/include/SDL2/SDL_syswm.h +386 -386
  73. data/assets/include/SDL2/SDL_test.h +69 -69
  74. data/assets/include/SDL2/SDL_test_assert.h +105 -105
  75. data/assets/include/SDL2/SDL_test_common.h +236 -236
  76. data/assets/include/SDL2/SDL_test_compare.h +69 -69
  77. data/assets/include/SDL2/SDL_test_crc32.h +124 -124
  78. data/assets/include/SDL2/SDL_test_font.h +168 -168
  79. data/assets/include/SDL2/SDL_test_fuzzer.h +386 -386
  80. data/assets/include/SDL2/SDL_test_harness.h +134 -134
  81. data/assets/include/SDL2/SDL_test_images.h +78 -78
  82. data/assets/include/SDL2/SDL_test_log.h +67 -67
  83. data/assets/include/SDL2/SDL_test_md5.h +129 -129
  84. data/assets/include/SDL2/SDL_test_memory.h +63 -63
  85. data/assets/include/SDL2/SDL_test_random.h +115 -115
  86. data/assets/include/SDL2/SDL_thread.h +464 -464
  87. data/assets/include/SDL2/SDL_timer.h +222 -222
  88. data/assets/include/SDL2/SDL_touch.h +150 -150
  89. data/assets/include/SDL2/SDL_ttf.h +2316 -2316
  90. data/assets/include/SDL2/SDL_types.h +29 -29
  91. data/assets/include/SDL2/SDL_version.h +204 -204
  92. data/assets/include/SDL2/SDL_video.h +2150 -2150
  93. data/assets/include/SDL2/SDL_vulkan.h +215 -215
  94. data/assets/include/SDL2/begin_code.h +187 -187
  95. data/assets/include/SDL2/close_code.h +40 -40
  96. data/assets/windows/mingw-w64-ucrt-x86_64/lib/libFLAC.a +0 -0
  97. data/assets/windows/mingw-w64-ucrt-x86_64/lib/libSDL2.a +0 -0
  98. data/assets/windows/mingw-w64-ucrt-x86_64/lib/libSDL2_mixer.a +0 -0
  99. data/assets/windows/mingw-w64-ucrt-x86_64/lib/libmodplug.a +0 -0
  100. data/assets/windows/mingw-w64-ucrt-x86_64/lib/libmpg123.a +0 -0
  101. data/assets/windows/mingw-w64-ucrt-x86_64/lib/libogg.a +0 -0
  102. data/assets/windows/mingw-w64-ucrt-x86_64/lib/libopus.a +0 -0
  103. data/assets/windows/mingw-w64-ucrt-x86_64/lib/libopusfile.a +0 -0
  104. data/assets/windows/mingw-w64-ucrt-x86_64/lib/libsndfile.a +0 -0
  105. data/assets/windows/mingw-w64-ucrt-x86_64/lib/libstdc++.a +0 -0
  106. data/assets/windows/mingw-w64-ucrt-x86_64/lib/libvorbis.a +0 -0
  107. data/assets/windows/mingw-w64-ucrt-x86_64/lib/libvorbisfile.a +0 -0
  108. data/assets/windows/mingw-w64-ucrt-x86_64/lib/libz.a +0 -0
  109. data/assets/windows/mingw-w64-x86_64/lib/libFLAC.a +0 -0
  110. data/assets/windows/mingw-w64-x86_64/lib/libSDL2.a +0 -0
  111. data/assets/windows/mingw-w64-x86_64/lib/libSDL2_mixer.a +0 -0
  112. data/assets/windows/mingw-w64-x86_64/lib/libmodplug.a +0 -0
  113. data/assets/windows/mingw-w64-x86_64/lib/libmpg123.a +0 -0
  114. data/assets/windows/mingw-w64-x86_64/lib/libogg.a +0 -0
  115. data/assets/windows/mingw-w64-x86_64/lib/libopus.a +0 -0
  116. data/assets/windows/mingw-w64-x86_64/lib/libopusfile.a +0 -0
  117. data/assets/windows/mingw-w64-x86_64/lib/libsndfile.a +0 -0
  118. data/assets/windows/mingw-w64-x86_64/lib/libstdc++.a +0 -0
  119. data/assets/windows/mingw-w64-x86_64/lib/libvorbis.a +0 -0
  120. data/assets/windows/mingw-w64-x86_64/lib/libvorbisfile.a +0 -0
  121. data/assets/windows/mingw-w64-x86_64/lib/libz.a +0 -0
  122. data/ext/{audio.c → audio/audio.c} +80 -80
  123. data/ext/{extconf.h → audio/extconf.h} +3 -3
  124. data/ext/audio/extconf.rb +115 -0
  125. data/lib/native_audio.rb +50 -50
  126. metadata +7 -27
  127. data/assets/include/GL/glew.h +0 -26427
  128. data/assets/include/GLES2/gl2.h +0 -656
  129. data/assets/include/GLES2/gl2ext.h +0 -3949
  130. data/assets/include/GLES2/gl2ext_angle.h +0 -701
  131. data/assets/include/GLES2/gl2platform.h +0 -27
  132. data/assets/include/GLES3/gl3.h +0 -1192
  133. data/assets/include/GLES3/gl31.h +0 -1507
  134. data/assets/include/GLES3/gl32.h +0 -1808
  135. data/assets/include/GLES3/gl3platform.h +0 -27
  136. data/assets/include/KHR/khrplatform.h +0 -290
  137. data/assets/macos/universal/lib/libSDL2_image.a +0 -0
  138. data/assets/macos/universal/lib/libSDL2_ttf.a +0 -0
  139. data/assets/windows/mingw-w64-ucrt-x86_64/lib/libglew32.a +0 -0
  140. data/assets/windows/mingw-w64-ucrt-x86_64/lib/libssp.a +0 -1
  141. data/assets/windows/mingw-w64-ucrt-x86_64/lib/libzstd.a +0 -0
  142. data/assets/windows/mingw-w64-x86_64/lib/libglew32.a +0 -0
  143. data/assets/windows/mingw-w64-x86_64/lib/libssp.a +0 -1
  144. data/assets/windows/mingw-w64-x86_64/lib/libzstd.a +0 -0
  145. data/ext/extconf.rb +0 -173
  146. data/lib/audio.bundle +0 -0
  147. data/lib/audio.so +0 -0
@@ -1,117 +1,117 @@
1
- /*
2
- Simple DirectMedia Layer
3
- Copyright (C) 1997-2022 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_gesture.h
24
- *
25
- * Include file for SDL gesture event handling.
26
- */
27
-
28
- #ifndef SDL_gesture_h_
29
- #define SDL_gesture_h_
30
-
31
- #include "SDL_stdinc.h"
32
- #include "SDL_error.h"
33
- #include "SDL_video.h"
34
-
35
- #include "SDL_touch.h"
36
-
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
- typedef Sint64 SDL_GestureID;
45
-
46
- /* Function prototypes */
47
-
48
- /**
49
- * Begin recording a gesture on a specified touch device or all touch devices.
50
- *
51
- * If the parameter `touchId` is -1 (i.e., all devices), this function will
52
- * always return 1, regardless of whether there actually are any devices.
53
- *
54
- * \param touchId the touch device id, or -1 for all touch devices
55
- * \returns 1 on success or 0 if the specified device could not be found.
56
- *
57
- * \since This function is available since SDL 2.0.0.
58
- *
59
- * \sa SDL_GetTouchDevice
60
- */
61
- extern DECLSPEC int SDLCALL SDL_RecordGesture(SDL_TouchID touchId);
62
-
63
-
64
- /**
65
- * Save all currently loaded Dollar Gesture templates.
66
- *
67
- * \param dst a SDL_RWops to save to
68
- * \returns the number of saved templates on success or 0 on failure; call
69
- * SDL_GetError() for more information.
70
- *
71
- * \since This function is available since SDL 2.0.0.
72
- *
73
- * \sa SDL_LoadDollarTemplates
74
- * \sa SDL_SaveDollarTemplate
75
- */
76
- extern DECLSPEC int SDLCALL SDL_SaveAllDollarTemplates(SDL_RWops *dst);
77
-
78
- /**
79
- * Save a currently loaded Dollar Gesture template.
80
- *
81
- * \param gestureId a gesture id
82
- * \param dst a SDL_RWops to save to
83
- * \returns 1 on success or 0 on failure; call SDL_GetError() for more
84
- * information.
85
- *
86
- * \since This function is available since SDL 2.0.0.
87
- *
88
- * \sa SDL_LoadDollarTemplates
89
- * \sa SDL_SaveAllDollarTemplates
90
- */
91
- extern DECLSPEC int SDLCALL SDL_SaveDollarTemplate(SDL_GestureID gestureId,SDL_RWops *dst);
92
-
93
-
94
- /**
95
- * Load Dollar Gesture templates from a file.
96
- *
97
- * \param touchId a touch id
98
- * \param src a SDL_RWops to load from
99
- * \returns the number of loaded templates on success or a negative error code
100
- * (or 0) on failure; call SDL_GetError() for more information.
101
- *
102
- * \since This function is available since SDL 2.0.0.
103
- *
104
- * \sa SDL_SaveAllDollarTemplates
105
- * \sa SDL_SaveDollarTemplate
106
- */
107
- extern DECLSPEC int SDLCALL SDL_LoadDollarTemplates(SDL_TouchID touchId, SDL_RWops *src);
108
-
109
- /* Ends C function definitions when using C++ */
110
- #ifdef __cplusplus
111
- }
112
- #endif
113
- #include "close_code.h"
114
-
115
- #endif /* SDL_gesture_h_ */
116
-
117
- /* vi: set ts=4 sw=4 expandtab: */
1
+ /*
2
+ Simple DirectMedia Layer
3
+ Copyright (C) 1997-2022 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_gesture.h
24
+ *
25
+ * Include file for SDL gesture event handling.
26
+ */
27
+
28
+ #ifndef SDL_gesture_h_
29
+ #define SDL_gesture_h_
30
+
31
+ #include "SDL_stdinc.h"
32
+ #include "SDL_error.h"
33
+ #include "SDL_video.h"
34
+
35
+ #include "SDL_touch.h"
36
+
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
+ typedef Sint64 SDL_GestureID;
45
+
46
+ /* Function prototypes */
47
+
48
+ /**
49
+ * Begin recording a gesture on a specified touch device or all touch devices.
50
+ *
51
+ * If the parameter `touchId` is -1 (i.e., all devices), this function will
52
+ * always return 1, regardless of whether there actually are any devices.
53
+ *
54
+ * \param touchId the touch device id, or -1 for all touch devices
55
+ * \returns 1 on success or 0 if the specified device could not be found.
56
+ *
57
+ * \since This function is available since SDL 2.0.0.
58
+ *
59
+ * \sa SDL_GetTouchDevice
60
+ */
61
+ extern DECLSPEC int SDLCALL SDL_RecordGesture(SDL_TouchID touchId);
62
+
63
+
64
+ /**
65
+ * Save all currently loaded Dollar Gesture templates.
66
+ *
67
+ * \param dst a SDL_RWops to save to
68
+ * \returns the number of saved templates on success or 0 on failure; call
69
+ * SDL_GetError() for more information.
70
+ *
71
+ * \since This function is available since SDL 2.0.0.
72
+ *
73
+ * \sa SDL_LoadDollarTemplates
74
+ * \sa SDL_SaveDollarTemplate
75
+ */
76
+ extern DECLSPEC int SDLCALL SDL_SaveAllDollarTemplates(SDL_RWops *dst);
77
+
78
+ /**
79
+ * Save a currently loaded Dollar Gesture template.
80
+ *
81
+ * \param gestureId a gesture id
82
+ * \param dst a SDL_RWops to save to
83
+ * \returns 1 on success or 0 on failure; call SDL_GetError() for more
84
+ * information.
85
+ *
86
+ * \since This function is available since SDL 2.0.0.
87
+ *
88
+ * \sa SDL_LoadDollarTemplates
89
+ * \sa SDL_SaveAllDollarTemplates
90
+ */
91
+ extern DECLSPEC int SDLCALL SDL_SaveDollarTemplate(SDL_GestureID gestureId,SDL_RWops *dst);
92
+
93
+
94
+ /**
95
+ * Load Dollar Gesture templates from a file.
96
+ *
97
+ * \param touchId a touch id
98
+ * \param src a SDL_RWops to load from
99
+ * \returns the number of loaded templates on success or a negative error code
100
+ * (or 0) on failure; call SDL_GetError() for more information.
101
+ *
102
+ * \since This function is available since SDL 2.0.0.
103
+ *
104
+ * \sa SDL_SaveAllDollarTemplates
105
+ * \sa SDL_SaveDollarTemplate
106
+ */
107
+ extern DECLSPEC int SDLCALL SDL_LoadDollarTemplates(SDL_TouchID touchId, SDL_RWops *src);
108
+
109
+ /* Ends C function definitions when using C++ */
110
+ #ifdef __cplusplus
111
+ }
112
+ #endif
113
+ #include "close_code.h"
114
+
115
+ #endif /* SDL_gesture_h_ */
116
+
117
+ /* vi: set ts=4 sw=4 expandtab: */
@@ -1,100 +1,100 @@
1
- /*
2
- Simple DirectMedia Layer
3
- Copyright (C) 1997-2022 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_guid.h
24
- *
25
- * Include file for handling ::SDL_GUID values.
26
- */
27
-
28
- #ifndef SDL_guid_h_
29
- #define SDL_guid_h_
30
-
31
- #include "SDL_stdinc.h"
32
- #include "SDL_error.h"
33
-
34
- #include "begin_code.h"
35
- /* Set up for C function definitions, even when using C++ */
36
- #ifdef __cplusplus
37
- extern "C" {
38
- #endif
39
-
40
- /**
41
- * An SDL_GUID is a 128-bit identifier for an input device that
42
- * identifies that device across runs of SDL programs on the same
43
- * platform. If the device is detached and then re-attached to a
44
- * different port, or if the base system is rebooted, the device
45
- * should still report the same GUID.
46
- *
47
- * GUIDs are as precise as possible but are not guaranteed to
48
- * distinguish physically distinct but equivalent devices. For
49
- * example, two game controllers from the same vendor with the same
50
- * product ID and revision may have the same GUID.
51
- *
52
- * GUIDs may be platform-dependent (i.e., the same device may report
53
- * different GUIDs on different operating systems).
54
- */
55
- typedef struct {
56
- Uint8 data[16];
57
- } SDL_GUID;
58
-
59
- /* Function prototypes */
60
-
61
- /**
62
- * Get an ASCII string representation for a given ::SDL_GUID.
63
- *
64
- * You should supply at least 33 bytes for pszGUID.
65
- *
66
- * \param guid the ::SDL_GUID you wish to convert to string
67
- * \param pszGUID buffer in which to write the ASCII string
68
- * \param cbGUID the size of pszGUID
69
- *
70
- * \since This function is available since SDL 2.24.0.
71
- *
72
- * \sa SDL_GUIDFromString
73
- */
74
- extern DECLSPEC void SDLCALL SDL_GUIDToString(SDL_GUID guid, char *pszGUID, int cbGUID);
75
-
76
- /**
77
- * Convert a GUID string into a ::SDL_GUID structure.
78
- *
79
- * Performs no error checking. If this function is given a string containing
80
- * an invalid GUID, the function will silently succeed, but the GUID generated
81
- * will not be useful.
82
- *
83
- * \param pchGUID string containing an ASCII representation of a GUID
84
- * \returns a ::SDL_GUID structure.
85
- *
86
- * \since This function is available since SDL 2.24.0.
87
- *
88
- * \sa SDL_GUIDToString
89
- */
90
- extern DECLSPEC SDL_GUID SDLCALL SDL_GUIDFromString(const char *pchGUID);
91
-
92
- /* Ends C function definitions when using C++ */
93
- #ifdef __cplusplus
94
- }
95
- #endif
96
- #include "close_code.h"
97
-
98
- #endif /* SDL_guid_h_ */
99
-
100
- /* vi: set ts=4 sw=4 expandtab: */
1
+ /*
2
+ Simple DirectMedia Layer
3
+ Copyright (C) 1997-2022 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_guid.h
24
+ *
25
+ * Include file for handling ::SDL_GUID values.
26
+ */
27
+
28
+ #ifndef SDL_guid_h_
29
+ #define SDL_guid_h_
30
+
31
+ #include "SDL_stdinc.h"
32
+ #include "SDL_error.h"
33
+
34
+ #include "begin_code.h"
35
+ /* Set up for C function definitions, even when using C++ */
36
+ #ifdef __cplusplus
37
+ extern "C" {
38
+ #endif
39
+
40
+ /**
41
+ * An SDL_GUID is a 128-bit identifier for an input device that
42
+ * identifies that device across runs of SDL programs on the same
43
+ * platform. If the device is detached and then re-attached to a
44
+ * different port, or if the base system is rebooted, the device
45
+ * should still report the same GUID.
46
+ *
47
+ * GUIDs are as precise as possible but are not guaranteed to
48
+ * distinguish physically distinct but equivalent devices. For
49
+ * example, two game controllers from the same vendor with the same
50
+ * product ID and revision may have the same GUID.
51
+ *
52
+ * GUIDs may be platform-dependent (i.e., the same device may report
53
+ * different GUIDs on different operating systems).
54
+ */
55
+ typedef struct {
56
+ Uint8 data[16];
57
+ } SDL_GUID;
58
+
59
+ /* Function prototypes */
60
+
61
+ /**
62
+ * Get an ASCII string representation for a given ::SDL_GUID.
63
+ *
64
+ * You should supply at least 33 bytes for pszGUID.
65
+ *
66
+ * \param guid the ::SDL_GUID you wish to convert to string
67
+ * \param pszGUID buffer in which to write the ASCII string
68
+ * \param cbGUID the size of pszGUID
69
+ *
70
+ * \since This function is available since SDL 2.24.0.
71
+ *
72
+ * \sa SDL_GUIDFromString
73
+ */
74
+ extern DECLSPEC void SDLCALL SDL_GUIDToString(SDL_GUID guid, char *pszGUID, int cbGUID);
75
+
76
+ /**
77
+ * Convert a GUID string into a ::SDL_GUID structure.
78
+ *
79
+ * Performs no error checking. If this function is given a string containing
80
+ * an invalid GUID, the function will silently succeed, but the GUID generated
81
+ * will not be useful.
82
+ *
83
+ * \param pchGUID string containing an ASCII representation of a GUID
84
+ * \returns a ::SDL_GUID structure.
85
+ *
86
+ * \since This function is available since SDL 2.24.0.
87
+ *
88
+ * \sa SDL_GUIDToString
89
+ */
90
+ extern DECLSPEC SDL_GUID SDLCALL SDL_GUIDFromString(const char *pchGUID);
91
+
92
+ /* Ends C function definitions when using C++ */
93
+ #ifdef __cplusplus
94
+ }
95
+ #endif
96
+ #include "close_code.h"
97
+
98
+ #endif /* SDL_guid_h_ */
99
+
100
+ /* vi: set ts=4 sw=4 expandtab: */