native_audio 0.1.0 → 0.2.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/GL/glew.h +26427 -26427
  3. data/assets/include/GLES2/gl2.h +656 -656
  4. data/assets/include/GLES2/gl2ext.h +3949 -3949
  5. data/assets/include/GLES2/gl2ext_angle.h +701 -701
  6. data/assets/include/GLES2/gl2platform.h +27 -27
  7. data/assets/include/GLES3/gl3.h +1192 -1192
  8. data/assets/include/GLES3/gl31.h +1507 -1507
  9. data/assets/include/GLES3/gl32.h +1808 -1808
  10. data/assets/include/GLES3/gl3platform.h +27 -27
  11. data/assets/include/KHR/khrplatform.h +290 -290
  12. data/assets/include/SDL2/SDL.h +233 -233
  13. data/assets/include/SDL2/SDL_assert.h +326 -326
  14. data/assets/include/SDL2/SDL_atomic.h +415 -415
  15. data/assets/include/SDL2/SDL_audio.h +1500 -1500
  16. data/assets/include/SDL2/SDL_bits.h +126 -126
  17. data/assets/include/SDL2/SDL_blendmode.h +198 -198
  18. data/assets/include/SDL2/SDL_clipboard.h +141 -141
  19. data/assets/include/SDL2/SDL_config.h +61 -61
  20. data/assets/include/SDL2/SDL_config_android.h +194 -194
  21. data/assets/include/SDL2/SDL_config_emscripten.h +218 -218
  22. data/assets/include/SDL2/SDL_config_iphoneos.h +217 -217
  23. data/assets/include/SDL2/SDL_config_macosx.h +277 -277
  24. data/assets/include/SDL2/SDL_config_minimal.h +95 -95
  25. data/assets/include/SDL2/SDL_config_ngage.h +89 -89
  26. data/assets/include/SDL2/SDL_config_os2.h +207 -207
  27. data/assets/include/SDL2/SDL_config_pandora.h +141 -141
  28. data/assets/include/SDL2/SDL_config_windows.h +331 -331
  29. data/assets/include/SDL2/SDL_config_wingdk.h +253 -253
  30. data/assets/include/SDL2/SDL_config_winrt.h +220 -220
  31. data/assets/include/SDL2/SDL_config_xbox.h +235 -235
  32. data/assets/include/SDL2/SDL_copying.h +20 -20
  33. data/assets/include/SDL2/SDL_cpuinfo.h +594 -594
  34. data/assets/include/SDL2/SDL_egl.h +2352 -2352
  35. data/assets/include/SDL2/SDL_endian.h +348 -348
  36. data/assets/include/SDL2/SDL_error.h +163 -163
  37. data/assets/include/SDL2/SDL_events.h +1166 -1166
  38. data/assets/include/SDL2/SDL_filesystem.h +149 -149
  39. data/assets/include/SDL2/SDL_gamecontroller.h +1074 -1074
  40. data/assets/include/SDL2/SDL_gesture.h +117 -117
  41. data/assets/include/SDL2/SDL_guid.h +100 -100
  42. data/assets/include/SDL2/SDL_haptic.h +1341 -1341
  43. data/assets/include/SDL2/SDL_hidapi.h +451 -451
  44. data/assets/include/SDL2/SDL_hints.h +2569 -2569
  45. data/assets/include/SDL2/SDL_image.h +2173 -2173
  46. data/assets/include/SDL2/SDL_joystick.h +1066 -1066
  47. data/assets/include/SDL2/SDL_keyboard.h +353 -353
  48. data/assets/include/SDL2/SDL_keycode.h +358 -358
  49. data/assets/include/SDL2/SDL_loadso.h +115 -115
  50. data/assets/include/SDL2/SDL_locale.h +103 -103
  51. data/assets/include/SDL2/SDL_log.h +404 -404
  52. data/assets/include/SDL2/SDL_main.h +275 -275
  53. data/assets/include/SDL2/SDL_messagebox.h +193 -193
  54. data/assets/include/SDL2/SDL_metal.h +113 -113
  55. data/assets/include/SDL2/SDL_misc.h +79 -79
  56. data/assets/include/SDL2/SDL_mixer.h +2784 -2784
  57. data/assets/include/SDL2/SDL_mouse.h +465 -465
  58. data/assets/include/SDL2/SDL_mutex.h +471 -471
  59. data/assets/include/SDL2/SDL_name.h +33 -33
  60. data/assets/include/SDL2/SDL_opengl.h +2132 -2132
  61. data/assets/include/SDL2/SDL_opengl_glext.h +13209 -13209
  62. data/assets/include/SDL2/SDL_opengles.h +39 -39
  63. data/assets/include/SDL2/SDL_opengles2.h +52 -52
  64. data/assets/include/SDL2/SDL_opengles2_gl2.h +656 -656
  65. data/assets/include/SDL2/SDL_opengles2_gl2ext.h +4033 -4033
  66. data/assets/include/SDL2/SDL_opengles2_gl2platform.h +27 -27
  67. data/assets/include/SDL2/SDL_opengles2_khrplatform.h +311 -311
  68. data/assets/include/SDL2/SDL_pixels.h +644 -644
  69. data/assets/include/SDL2/SDL_platform.h +261 -261
  70. data/assets/include/SDL2/SDL_power.h +88 -88
  71. data/assets/include/SDL2/SDL_quit.h +58 -58
  72. data/assets/include/SDL2/SDL_rect.h +376 -376
  73. data/assets/include/SDL2/SDL_render.h +1919 -1919
  74. data/assets/include/SDL2/SDL_revision.h +6 -6
  75. data/assets/include/SDL2/SDL_rwops.h +841 -841
  76. data/assets/include/SDL2/SDL_scancode.h +438 -438
  77. data/assets/include/SDL2/SDL_sensor.h +322 -322
  78. data/assets/include/SDL2/SDL_shape.h +155 -155
  79. data/assets/include/SDL2/SDL_stdinc.h +830 -830
  80. data/assets/include/SDL2/SDL_surface.h +997 -997
  81. data/assets/include/SDL2/SDL_system.h +623 -623
  82. data/assets/include/SDL2/SDL_syswm.h +386 -386
  83. data/assets/include/SDL2/SDL_test.h +69 -69
  84. data/assets/include/SDL2/SDL_test_assert.h +105 -105
  85. data/assets/include/SDL2/SDL_test_common.h +236 -236
  86. data/assets/include/SDL2/SDL_test_compare.h +69 -69
  87. data/assets/include/SDL2/SDL_test_crc32.h +124 -124
  88. data/assets/include/SDL2/SDL_test_font.h +168 -168
  89. data/assets/include/SDL2/SDL_test_fuzzer.h +386 -386
  90. data/assets/include/SDL2/SDL_test_harness.h +134 -134
  91. data/assets/include/SDL2/SDL_test_images.h +78 -78
  92. data/assets/include/SDL2/SDL_test_log.h +67 -67
  93. data/assets/include/SDL2/SDL_test_md5.h +129 -129
  94. data/assets/include/SDL2/SDL_test_memory.h +63 -63
  95. data/assets/include/SDL2/SDL_test_random.h +115 -115
  96. data/assets/include/SDL2/SDL_thread.h +464 -464
  97. data/assets/include/SDL2/SDL_timer.h +222 -222
  98. data/assets/include/SDL2/SDL_touch.h +150 -150
  99. data/assets/include/SDL2/SDL_ttf.h +2316 -2316
  100. data/assets/include/SDL2/SDL_types.h +29 -29
  101. data/assets/include/SDL2/SDL_version.h +204 -204
  102. data/assets/include/SDL2/SDL_video.h +2150 -2150
  103. data/assets/include/SDL2/SDL_vulkan.h +215 -215
  104. data/assets/include/SDL2/begin_code.h +187 -187
  105. data/assets/include/SDL2/close_code.h +40 -40
  106. data/assets/windows/mingw-w64-ucrt-x86_64/lib/libFLAC.a +0 -0
  107. data/assets/windows/mingw-w64-ucrt-x86_64/lib/libSDL2.a +0 -0
  108. data/assets/windows/mingw-w64-ucrt-x86_64/lib/libSDL2_mixer.a +0 -0
  109. data/assets/windows/mingw-w64-ucrt-x86_64/lib/libglew32.a +0 -0
  110. data/assets/windows/mingw-w64-ucrt-x86_64/lib/libmodplug.a +0 -0
  111. data/assets/windows/mingw-w64-ucrt-x86_64/lib/libmpg123.a +0 -0
  112. data/assets/windows/mingw-w64-ucrt-x86_64/lib/libogg.a +0 -0
  113. data/assets/windows/mingw-w64-ucrt-x86_64/lib/libopus.a +0 -0
  114. data/assets/windows/mingw-w64-ucrt-x86_64/lib/libopusfile.a +0 -0
  115. data/assets/windows/mingw-w64-ucrt-x86_64/lib/libsndfile.a +0 -0
  116. data/assets/windows/mingw-w64-ucrt-x86_64/lib/libssp.a +1 -1
  117. data/assets/windows/mingw-w64-ucrt-x86_64/lib/libstdc++.a +0 -0
  118. data/assets/windows/mingw-w64-ucrt-x86_64/lib/libvorbis.a +0 -0
  119. data/assets/windows/mingw-w64-ucrt-x86_64/lib/libvorbisfile.a +0 -0
  120. data/assets/windows/mingw-w64-ucrt-x86_64/lib/libz.a +0 -0
  121. data/assets/windows/mingw-w64-ucrt-x86_64/lib/libzstd.a +0 -0
  122. data/assets/windows/mingw-w64-x86_64/lib/libFLAC.a +0 -0
  123. data/assets/windows/mingw-w64-x86_64/lib/libSDL2.a +0 -0
  124. data/assets/windows/mingw-w64-x86_64/lib/libSDL2_mixer.a +0 -0
  125. data/assets/windows/mingw-w64-x86_64/lib/libglew32.a +0 -0
  126. data/assets/windows/mingw-w64-x86_64/lib/libmodplug.a +0 -0
  127. data/assets/windows/mingw-w64-x86_64/lib/libmpg123.a +0 -0
  128. data/assets/windows/mingw-w64-x86_64/lib/libogg.a +0 -0
  129. data/assets/windows/mingw-w64-x86_64/lib/libopus.a +0 -0
  130. data/assets/windows/mingw-w64-x86_64/lib/libopusfile.a +0 -0
  131. data/assets/windows/mingw-w64-x86_64/lib/libsndfile.a +0 -0
  132. data/assets/windows/mingw-w64-x86_64/lib/libssp.a +1 -1
  133. data/assets/windows/mingw-w64-x86_64/lib/libstdc++.a +0 -0
  134. data/assets/windows/mingw-w64-x86_64/lib/libvorbis.a +0 -0
  135. data/assets/windows/mingw-w64-x86_64/lib/libvorbisfile.a +0 -0
  136. data/assets/windows/mingw-w64-x86_64/lib/libz.a +0 -0
  137. data/assets/windows/mingw-w64-x86_64/lib/libzstd.a +0 -0
  138. data/ext/audio.c +80 -80
  139. data/ext/extconf.h +3 -3
  140. data/ext/extconf.rb +173 -177
  141. data/lib/audio.bundle +0 -0
  142. data/lib/audio.so +0 -0
  143. data/lib/native_audio.rb +50 -50
  144. metadata +4 -9
  145. data/ext/Makefile +0 -270
  146. data/ext/audio.o +0 -0
  147. data/ext/mkmf.log +0 -7
@@ -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: */