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,193 +1,193 @@
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
- #ifndef SDL_messagebox_h_
23
- #define SDL_messagebox_h_
24
-
25
- #include "SDL_stdinc.h"
26
- #include "SDL_video.h" /* For SDL_Window */
27
-
28
- #include "begin_code.h"
29
- /* Set up for C function definitions, even when using C++ */
30
- #ifdef __cplusplus
31
- extern "C" {
32
- #endif
33
-
34
- /**
35
- * SDL_MessageBox flags. If supported will display warning icon, etc.
36
- */
37
- typedef enum
38
- {
39
- SDL_MESSAGEBOX_ERROR = 0x00000010, /**< error dialog */
40
- SDL_MESSAGEBOX_WARNING = 0x00000020, /**< warning dialog */
41
- SDL_MESSAGEBOX_INFORMATION = 0x00000040, /**< informational dialog */
42
- SDL_MESSAGEBOX_BUTTONS_LEFT_TO_RIGHT = 0x00000080, /**< buttons placed left to right */
43
- SDL_MESSAGEBOX_BUTTONS_RIGHT_TO_LEFT = 0x00000100 /**< buttons placed right to left */
44
- } SDL_MessageBoxFlags;
45
-
46
- /**
47
- * Flags for SDL_MessageBoxButtonData.
48
- */
49
- typedef enum
50
- {
51
- SDL_MESSAGEBOX_BUTTON_RETURNKEY_DEFAULT = 0x00000001, /**< Marks the default button when return is hit */
52
- SDL_MESSAGEBOX_BUTTON_ESCAPEKEY_DEFAULT = 0x00000002 /**< Marks the default button when escape is hit */
53
- } SDL_MessageBoxButtonFlags;
54
-
55
- /**
56
- * Individual button data.
57
- */
58
- typedef struct
59
- {
60
- Uint32 flags; /**< ::SDL_MessageBoxButtonFlags */
61
- int buttonid; /**< User defined button id (value returned via SDL_ShowMessageBox) */
62
- const char * text; /**< The UTF-8 button text */
63
- } SDL_MessageBoxButtonData;
64
-
65
- /**
66
- * RGB value used in a message box color scheme
67
- */
68
- typedef struct
69
- {
70
- Uint8 r, g, b;
71
- } SDL_MessageBoxColor;
72
-
73
- typedef enum
74
- {
75
- SDL_MESSAGEBOX_COLOR_BACKGROUND,
76
- SDL_MESSAGEBOX_COLOR_TEXT,
77
- SDL_MESSAGEBOX_COLOR_BUTTON_BORDER,
78
- SDL_MESSAGEBOX_COLOR_BUTTON_BACKGROUND,
79
- SDL_MESSAGEBOX_COLOR_BUTTON_SELECTED,
80
- SDL_MESSAGEBOX_COLOR_MAX
81
- } SDL_MessageBoxColorType;
82
-
83
- /**
84
- * A set of colors to use for message box dialogs
85
- */
86
- typedef struct
87
- {
88
- SDL_MessageBoxColor colors[SDL_MESSAGEBOX_COLOR_MAX];
89
- } SDL_MessageBoxColorScheme;
90
-
91
- /**
92
- * MessageBox structure containing title, text, window, etc.
93
- */
94
- typedef struct
95
- {
96
- Uint32 flags; /**< ::SDL_MessageBoxFlags */
97
- SDL_Window *window; /**< Parent window, can be NULL */
98
- const char *title; /**< UTF-8 title */
99
- const char *message; /**< UTF-8 message text */
100
-
101
- int numbuttons;
102
- const SDL_MessageBoxButtonData *buttons;
103
-
104
- const SDL_MessageBoxColorScheme *colorScheme; /**< ::SDL_MessageBoxColorScheme, can be NULL to use system settings */
105
- } SDL_MessageBoxData;
106
-
107
- /**
108
- * Create a modal message box.
109
- *
110
- * If your needs aren't complex, it might be easier to use
111
- * SDL_ShowSimpleMessageBox.
112
- *
113
- * This function should be called on the thread that created the parent
114
- * window, or on the main thread if the messagebox has no parent. It will
115
- * block execution of that thread until the user clicks a button or closes the
116
- * messagebox.
117
- *
118
- * This function may be called at any time, even before SDL_Init(). This makes
119
- * it useful for reporting errors like a failure to create a renderer or
120
- * OpenGL context.
121
- *
122
- * On X11, SDL rolls its own dialog box with X11 primitives instead of a
123
- * formal toolkit like GTK+ or Qt.
124
- *
125
- * Note that if SDL_Init() would fail because there isn't any available video
126
- * target, this function is likely to fail for the same reasons. If this is a
127
- * concern, check the return value from this function and fall back to writing
128
- * to stderr if you can.
129
- *
130
- * \param messageboxdata the SDL_MessageBoxData structure with title, text and
131
- * other options
132
- * \param buttonid the pointer to which user id of hit button should be copied
133
- * \returns 0 on success or a negative error code on failure; call
134
- * SDL_GetError() for more information.
135
- *
136
- * \since This function is available since SDL 2.0.0.
137
- *
138
- * \sa SDL_ShowSimpleMessageBox
139
- */
140
- extern DECLSPEC int SDLCALL SDL_ShowMessageBox(const SDL_MessageBoxData *messageboxdata, int *buttonid);
141
-
142
- /**
143
- * Display a simple modal message box.
144
- *
145
- * If your needs aren't complex, this function is preferred over
146
- * SDL_ShowMessageBox.
147
- *
148
- * `flags` may be any of the following:
149
- *
150
- * - `SDL_MESSAGEBOX_ERROR`: error dialog
151
- * - `SDL_MESSAGEBOX_WARNING`: warning dialog
152
- * - `SDL_MESSAGEBOX_INFORMATION`: informational dialog
153
- *
154
- * This function should be called on the thread that created the parent
155
- * window, or on the main thread if the messagebox has no parent. It will
156
- * block execution of that thread until the user clicks a button or closes the
157
- * messagebox.
158
- *
159
- * This function may be called at any time, even before SDL_Init(). This makes
160
- * it useful for reporting errors like a failure to create a renderer or
161
- * OpenGL context.
162
- *
163
- * On X11, SDL rolls its own dialog box with X11 primitives instead of a
164
- * formal toolkit like GTK+ or Qt.
165
- *
166
- * Note that if SDL_Init() would fail because there isn't any available video
167
- * target, this function is likely to fail for the same reasons. If this is a
168
- * concern, check the return value from this function and fall back to writing
169
- * to stderr if you can.
170
- *
171
- * \param flags an SDL_MessageBoxFlags value
172
- * \param title UTF-8 title text
173
- * \param message UTF-8 message text
174
- * \param window the parent window, or NULL for no parent
175
- * \returns 0 on success or a negative error code on failure; call
176
- * SDL_GetError() for more information.
177
- *
178
- * \since This function is available since SDL 2.0.0.
179
- *
180
- * \sa SDL_ShowMessageBox
181
- */
182
- extern DECLSPEC int SDLCALL SDL_ShowSimpleMessageBox(Uint32 flags, const char *title, const char *message, SDL_Window *window);
183
-
184
-
185
- /* Ends C function definitions when using C++ */
186
- #ifdef __cplusplus
187
- }
188
- #endif
189
- #include "close_code.h"
190
-
191
- #endif /* SDL_messagebox_h_ */
192
-
193
- /* 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
+ #ifndef SDL_messagebox_h_
23
+ #define SDL_messagebox_h_
24
+
25
+ #include "SDL_stdinc.h"
26
+ #include "SDL_video.h" /* For SDL_Window */
27
+
28
+ #include "begin_code.h"
29
+ /* Set up for C function definitions, even when using C++ */
30
+ #ifdef __cplusplus
31
+ extern "C" {
32
+ #endif
33
+
34
+ /**
35
+ * SDL_MessageBox flags. If supported will display warning icon, etc.
36
+ */
37
+ typedef enum
38
+ {
39
+ SDL_MESSAGEBOX_ERROR = 0x00000010, /**< error dialog */
40
+ SDL_MESSAGEBOX_WARNING = 0x00000020, /**< warning dialog */
41
+ SDL_MESSAGEBOX_INFORMATION = 0x00000040, /**< informational dialog */
42
+ SDL_MESSAGEBOX_BUTTONS_LEFT_TO_RIGHT = 0x00000080, /**< buttons placed left to right */
43
+ SDL_MESSAGEBOX_BUTTONS_RIGHT_TO_LEFT = 0x00000100 /**< buttons placed right to left */
44
+ } SDL_MessageBoxFlags;
45
+
46
+ /**
47
+ * Flags for SDL_MessageBoxButtonData.
48
+ */
49
+ typedef enum
50
+ {
51
+ SDL_MESSAGEBOX_BUTTON_RETURNKEY_DEFAULT = 0x00000001, /**< Marks the default button when return is hit */
52
+ SDL_MESSAGEBOX_BUTTON_ESCAPEKEY_DEFAULT = 0x00000002 /**< Marks the default button when escape is hit */
53
+ } SDL_MessageBoxButtonFlags;
54
+
55
+ /**
56
+ * Individual button data.
57
+ */
58
+ typedef struct
59
+ {
60
+ Uint32 flags; /**< ::SDL_MessageBoxButtonFlags */
61
+ int buttonid; /**< User defined button id (value returned via SDL_ShowMessageBox) */
62
+ const char * text; /**< The UTF-8 button text */
63
+ } SDL_MessageBoxButtonData;
64
+
65
+ /**
66
+ * RGB value used in a message box color scheme
67
+ */
68
+ typedef struct
69
+ {
70
+ Uint8 r, g, b;
71
+ } SDL_MessageBoxColor;
72
+
73
+ typedef enum
74
+ {
75
+ SDL_MESSAGEBOX_COLOR_BACKGROUND,
76
+ SDL_MESSAGEBOX_COLOR_TEXT,
77
+ SDL_MESSAGEBOX_COLOR_BUTTON_BORDER,
78
+ SDL_MESSAGEBOX_COLOR_BUTTON_BACKGROUND,
79
+ SDL_MESSAGEBOX_COLOR_BUTTON_SELECTED,
80
+ SDL_MESSAGEBOX_COLOR_MAX
81
+ } SDL_MessageBoxColorType;
82
+
83
+ /**
84
+ * A set of colors to use for message box dialogs
85
+ */
86
+ typedef struct
87
+ {
88
+ SDL_MessageBoxColor colors[SDL_MESSAGEBOX_COLOR_MAX];
89
+ } SDL_MessageBoxColorScheme;
90
+
91
+ /**
92
+ * MessageBox structure containing title, text, window, etc.
93
+ */
94
+ typedef struct
95
+ {
96
+ Uint32 flags; /**< ::SDL_MessageBoxFlags */
97
+ SDL_Window *window; /**< Parent window, can be NULL */
98
+ const char *title; /**< UTF-8 title */
99
+ const char *message; /**< UTF-8 message text */
100
+
101
+ int numbuttons;
102
+ const SDL_MessageBoxButtonData *buttons;
103
+
104
+ const SDL_MessageBoxColorScheme *colorScheme; /**< ::SDL_MessageBoxColorScheme, can be NULL to use system settings */
105
+ } SDL_MessageBoxData;
106
+
107
+ /**
108
+ * Create a modal message box.
109
+ *
110
+ * If your needs aren't complex, it might be easier to use
111
+ * SDL_ShowSimpleMessageBox.
112
+ *
113
+ * This function should be called on the thread that created the parent
114
+ * window, or on the main thread if the messagebox has no parent. It will
115
+ * block execution of that thread until the user clicks a button or closes the
116
+ * messagebox.
117
+ *
118
+ * This function may be called at any time, even before SDL_Init(). This makes
119
+ * it useful for reporting errors like a failure to create a renderer or
120
+ * OpenGL context.
121
+ *
122
+ * On X11, SDL rolls its own dialog box with X11 primitives instead of a
123
+ * formal toolkit like GTK+ or Qt.
124
+ *
125
+ * Note that if SDL_Init() would fail because there isn't any available video
126
+ * target, this function is likely to fail for the same reasons. If this is a
127
+ * concern, check the return value from this function and fall back to writing
128
+ * to stderr if you can.
129
+ *
130
+ * \param messageboxdata the SDL_MessageBoxData structure with title, text and
131
+ * other options
132
+ * \param buttonid the pointer to which user id of hit button should be copied
133
+ * \returns 0 on success or a negative error code on failure; call
134
+ * SDL_GetError() for more information.
135
+ *
136
+ * \since This function is available since SDL 2.0.0.
137
+ *
138
+ * \sa SDL_ShowSimpleMessageBox
139
+ */
140
+ extern DECLSPEC int SDLCALL SDL_ShowMessageBox(const SDL_MessageBoxData *messageboxdata, int *buttonid);
141
+
142
+ /**
143
+ * Display a simple modal message box.
144
+ *
145
+ * If your needs aren't complex, this function is preferred over
146
+ * SDL_ShowMessageBox.
147
+ *
148
+ * `flags` may be any of the following:
149
+ *
150
+ * - `SDL_MESSAGEBOX_ERROR`: error dialog
151
+ * - `SDL_MESSAGEBOX_WARNING`: warning dialog
152
+ * - `SDL_MESSAGEBOX_INFORMATION`: informational dialog
153
+ *
154
+ * This function should be called on the thread that created the parent
155
+ * window, or on the main thread if the messagebox has no parent. It will
156
+ * block execution of that thread until the user clicks a button or closes the
157
+ * messagebox.
158
+ *
159
+ * This function may be called at any time, even before SDL_Init(). This makes
160
+ * it useful for reporting errors like a failure to create a renderer or
161
+ * OpenGL context.
162
+ *
163
+ * On X11, SDL rolls its own dialog box with X11 primitives instead of a
164
+ * formal toolkit like GTK+ or Qt.
165
+ *
166
+ * Note that if SDL_Init() would fail because there isn't any available video
167
+ * target, this function is likely to fail for the same reasons. If this is a
168
+ * concern, check the return value from this function and fall back to writing
169
+ * to stderr if you can.
170
+ *
171
+ * \param flags an SDL_MessageBoxFlags value
172
+ * \param title UTF-8 title text
173
+ * \param message UTF-8 message text
174
+ * \param window the parent window, or NULL for no parent
175
+ * \returns 0 on success or a negative error code on failure; call
176
+ * SDL_GetError() for more information.
177
+ *
178
+ * \since This function is available since SDL 2.0.0.
179
+ *
180
+ * \sa SDL_ShowMessageBox
181
+ */
182
+ extern DECLSPEC int SDLCALL SDL_ShowSimpleMessageBox(Uint32 flags, const char *title, const char *message, SDL_Window *window);
183
+
184
+
185
+ /* Ends C function definitions when using C++ */
186
+ #ifdef __cplusplus
187
+ }
188
+ #endif
189
+ #include "close_code.h"
190
+
191
+ #endif /* SDL_messagebox_h_ */
192
+
193
+ /* vi: set ts=4 sw=4 expandtab: */
@@ -1,113 +1,113 @@
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_metal.h
24
- *
25
- * Header file for functions to creating Metal layers and views on SDL windows.
26
- */
27
-
28
- #ifndef SDL_metal_h_
29
- #define SDL_metal_h_
30
-
31
- #include "SDL_video.h"
32
-
33
- #include "begin_code.h"
34
- /* Set up for C function definitions, even when using C++ */
35
- #ifdef __cplusplus
36
- extern "C" {
37
- #endif
38
-
39
- /**
40
- * \brief A handle to a CAMetalLayer-backed NSView (macOS) or UIView (iOS/tvOS).
41
- *
42
- * \note This can be cast directly to an NSView or UIView.
43
- */
44
- typedef void *SDL_MetalView;
45
-
46
- /**
47
- * \name Metal support functions
48
- */
49
- /* @{ */
50
-
51
- /**
52
- * Create a CAMetalLayer-backed NSView/UIView and attach it to the specified
53
- * window.
54
- *
55
- * On macOS, this does *not* associate a MTLDevice with the CAMetalLayer on
56
- * its own. It is up to user code to do that.
57
- *
58
- * The returned handle can be casted directly to a NSView or UIView. To access
59
- * the backing CAMetalLayer, call SDL_Metal_GetLayer().
60
- *
61
- * \since This function is available since SDL 2.0.12.
62
- *
63
- * \sa SDL_Metal_DestroyView
64
- * \sa SDL_Metal_GetLayer
65
- */
66
- extern DECLSPEC SDL_MetalView SDLCALL SDL_Metal_CreateView(SDL_Window * window);
67
-
68
- /**
69
- * Destroy an existing SDL_MetalView object.
70
- *
71
- * This should be called before SDL_DestroyWindow, if SDL_Metal_CreateView was
72
- * called after SDL_CreateWindow.
73
- *
74
- * \since This function is available since SDL 2.0.12.
75
- *
76
- * \sa SDL_Metal_CreateView
77
- */
78
- extern DECLSPEC void SDLCALL SDL_Metal_DestroyView(SDL_MetalView view);
79
-
80
- /**
81
- * Get a pointer to the backing CAMetalLayer for the given view.
82
- *
83
- * \since This function is available since SDL 2.0.14.
84
- *
85
- * \sa SDL_Metal_CreateView
86
- */
87
- extern DECLSPEC void *SDLCALL SDL_Metal_GetLayer(SDL_MetalView view);
88
-
89
- /**
90
- * Get the size of a window's underlying drawable in pixels (for use with
91
- * setting viewport, scissor & etc).
92
- *
93
- * \param window SDL_Window from which the drawable size should be queried
94
- * \param w Pointer to variable for storing the width in pixels, may be NULL
95
- * \param h Pointer to variable for storing the height in pixels, may be NULL
96
- *
97
- * \since This function is available since SDL 2.0.14.
98
- *
99
- * \sa SDL_GetWindowSize
100
- * \sa SDL_CreateWindow
101
- */
102
- extern DECLSPEC void SDLCALL SDL_Metal_GetDrawableSize(SDL_Window* window, int *w,
103
- int *h);
104
-
105
- /* @} *//* Metal support functions */
106
-
107
- /* Ends C function definitions when using C++ */
108
- #ifdef __cplusplus
109
- }
110
- #endif
111
- #include "close_code.h"
112
-
113
- #endif /* SDL_metal_h_ */
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_metal.h
24
+ *
25
+ * Header file for functions to creating Metal layers and views on SDL windows.
26
+ */
27
+
28
+ #ifndef SDL_metal_h_
29
+ #define SDL_metal_h_
30
+
31
+ #include "SDL_video.h"
32
+
33
+ #include "begin_code.h"
34
+ /* Set up for C function definitions, even when using C++ */
35
+ #ifdef __cplusplus
36
+ extern "C" {
37
+ #endif
38
+
39
+ /**
40
+ * \brief A handle to a CAMetalLayer-backed NSView (macOS) or UIView (iOS/tvOS).
41
+ *
42
+ * \note This can be cast directly to an NSView or UIView.
43
+ */
44
+ typedef void *SDL_MetalView;
45
+
46
+ /**
47
+ * \name Metal support functions
48
+ */
49
+ /* @{ */
50
+
51
+ /**
52
+ * Create a CAMetalLayer-backed NSView/UIView and attach it to the specified
53
+ * window.
54
+ *
55
+ * On macOS, this does *not* associate a MTLDevice with the CAMetalLayer on
56
+ * its own. It is up to user code to do that.
57
+ *
58
+ * The returned handle can be casted directly to a NSView or UIView. To access
59
+ * the backing CAMetalLayer, call SDL_Metal_GetLayer().
60
+ *
61
+ * \since This function is available since SDL 2.0.12.
62
+ *
63
+ * \sa SDL_Metal_DestroyView
64
+ * \sa SDL_Metal_GetLayer
65
+ */
66
+ extern DECLSPEC SDL_MetalView SDLCALL SDL_Metal_CreateView(SDL_Window * window);
67
+
68
+ /**
69
+ * Destroy an existing SDL_MetalView object.
70
+ *
71
+ * This should be called before SDL_DestroyWindow, if SDL_Metal_CreateView was
72
+ * called after SDL_CreateWindow.
73
+ *
74
+ * \since This function is available since SDL 2.0.12.
75
+ *
76
+ * \sa SDL_Metal_CreateView
77
+ */
78
+ extern DECLSPEC void SDLCALL SDL_Metal_DestroyView(SDL_MetalView view);
79
+
80
+ /**
81
+ * Get a pointer to the backing CAMetalLayer for the given view.
82
+ *
83
+ * \since This function is available since SDL 2.0.14.
84
+ *
85
+ * \sa SDL_Metal_CreateView
86
+ */
87
+ extern DECLSPEC void *SDLCALL SDL_Metal_GetLayer(SDL_MetalView view);
88
+
89
+ /**
90
+ * Get the size of a window's underlying drawable in pixels (for use with
91
+ * setting viewport, scissor & etc).
92
+ *
93
+ * \param window SDL_Window from which the drawable size should be queried
94
+ * \param w Pointer to variable for storing the width in pixels, may be NULL
95
+ * \param h Pointer to variable for storing the height in pixels, may be NULL
96
+ *
97
+ * \since This function is available since SDL 2.0.14.
98
+ *
99
+ * \sa SDL_GetWindowSize
100
+ * \sa SDL_CreateWindow
101
+ */
102
+ extern DECLSPEC void SDLCALL SDL_Metal_GetDrawableSize(SDL_Window* window, int *w,
103
+ int *h);
104
+
105
+ /* @} *//* Metal support functions */
106
+
107
+ /* Ends C function definitions when using C++ */
108
+ #ifdef __cplusplus
109
+ }
110
+ #endif
111
+ #include "close_code.h"
112
+
113
+ #endif /* SDL_metal_h_ */