native_audio 0.3.0 → 0.4.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 (138) hide show
  1. checksums.yaml +4 -4
  2. data/LICENSE +21 -0
  3. data/README.md +87 -0
  4. data/ext/audio/audio.c +321 -47
  5. data/ext/audio/extconf.rb +12 -110
  6. data/ext/audio/miniaudio.h +95844 -0
  7. data/lib/dummy_audio.rb +49 -0
  8. data/lib/native_audio.rb +22 -7
  9. metadata +7 -132
  10. data/assets/include/SDL2/SDL.h +0 -233
  11. data/assets/include/SDL2/SDL_assert.h +0 -326
  12. data/assets/include/SDL2/SDL_atomic.h +0 -415
  13. data/assets/include/SDL2/SDL_audio.h +0 -1500
  14. data/assets/include/SDL2/SDL_bits.h +0 -126
  15. data/assets/include/SDL2/SDL_blendmode.h +0 -198
  16. data/assets/include/SDL2/SDL_clipboard.h +0 -141
  17. data/assets/include/SDL2/SDL_config.h +0 -61
  18. data/assets/include/SDL2/SDL_config_android.h +0 -194
  19. data/assets/include/SDL2/SDL_config_emscripten.h +0 -218
  20. data/assets/include/SDL2/SDL_config_iphoneos.h +0 -217
  21. data/assets/include/SDL2/SDL_config_macosx.h +0 -277
  22. data/assets/include/SDL2/SDL_config_minimal.h +0 -95
  23. data/assets/include/SDL2/SDL_config_ngage.h +0 -89
  24. data/assets/include/SDL2/SDL_config_os2.h +0 -207
  25. data/assets/include/SDL2/SDL_config_pandora.h +0 -141
  26. data/assets/include/SDL2/SDL_config_windows.h +0 -331
  27. data/assets/include/SDL2/SDL_config_wingdk.h +0 -253
  28. data/assets/include/SDL2/SDL_config_winrt.h +0 -220
  29. data/assets/include/SDL2/SDL_config_xbox.h +0 -235
  30. data/assets/include/SDL2/SDL_copying.h +0 -20
  31. data/assets/include/SDL2/SDL_cpuinfo.h +0 -594
  32. data/assets/include/SDL2/SDL_egl.h +0 -2352
  33. data/assets/include/SDL2/SDL_endian.h +0 -348
  34. data/assets/include/SDL2/SDL_error.h +0 -163
  35. data/assets/include/SDL2/SDL_events.h +0 -1166
  36. data/assets/include/SDL2/SDL_filesystem.h +0 -149
  37. data/assets/include/SDL2/SDL_gamecontroller.h +0 -1074
  38. data/assets/include/SDL2/SDL_gesture.h +0 -117
  39. data/assets/include/SDL2/SDL_guid.h +0 -100
  40. data/assets/include/SDL2/SDL_haptic.h +0 -1341
  41. data/assets/include/SDL2/SDL_hidapi.h +0 -451
  42. data/assets/include/SDL2/SDL_hints.h +0 -2569
  43. data/assets/include/SDL2/SDL_image.h +0 -2173
  44. data/assets/include/SDL2/SDL_joystick.h +0 -1066
  45. data/assets/include/SDL2/SDL_keyboard.h +0 -353
  46. data/assets/include/SDL2/SDL_keycode.h +0 -358
  47. data/assets/include/SDL2/SDL_loadso.h +0 -115
  48. data/assets/include/SDL2/SDL_locale.h +0 -103
  49. data/assets/include/SDL2/SDL_log.h +0 -404
  50. data/assets/include/SDL2/SDL_main.h +0 -275
  51. data/assets/include/SDL2/SDL_messagebox.h +0 -193
  52. data/assets/include/SDL2/SDL_metal.h +0 -113
  53. data/assets/include/SDL2/SDL_misc.h +0 -79
  54. data/assets/include/SDL2/SDL_mixer.h +0 -2784
  55. data/assets/include/SDL2/SDL_mouse.h +0 -465
  56. data/assets/include/SDL2/SDL_mutex.h +0 -471
  57. data/assets/include/SDL2/SDL_name.h +0 -33
  58. data/assets/include/SDL2/SDL_opengl.h +0 -2132
  59. data/assets/include/SDL2/SDL_opengl_glext.h +0 -13209
  60. data/assets/include/SDL2/SDL_opengles.h +0 -39
  61. data/assets/include/SDL2/SDL_opengles2.h +0 -52
  62. data/assets/include/SDL2/SDL_opengles2_gl2.h +0 -656
  63. data/assets/include/SDL2/SDL_opengles2_gl2ext.h +0 -4033
  64. data/assets/include/SDL2/SDL_opengles2_gl2platform.h +0 -27
  65. data/assets/include/SDL2/SDL_opengles2_khrplatform.h +0 -311
  66. data/assets/include/SDL2/SDL_pixels.h +0 -644
  67. data/assets/include/SDL2/SDL_platform.h +0 -261
  68. data/assets/include/SDL2/SDL_power.h +0 -88
  69. data/assets/include/SDL2/SDL_quit.h +0 -58
  70. data/assets/include/SDL2/SDL_rect.h +0 -376
  71. data/assets/include/SDL2/SDL_render.h +0 -1919
  72. data/assets/include/SDL2/SDL_revision.h +0 -6
  73. data/assets/include/SDL2/SDL_rwops.h +0 -841
  74. data/assets/include/SDL2/SDL_scancode.h +0 -438
  75. data/assets/include/SDL2/SDL_sensor.h +0 -322
  76. data/assets/include/SDL2/SDL_shape.h +0 -155
  77. data/assets/include/SDL2/SDL_stdinc.h +0 -830
  78. data/assets/include/SDL2/SDL_surface.h +0 -997
  79. data/assets/include/SDL2/SDL_system.h +0 -623
  80. data/assets/include/SDL2/SDL_syswm.h +0 -386
  81. data/assets/include/SDL2/SDL_test.h +0 -69
  82. data/assets/include/SDL2/SDL_test_assert.h +0 -105
  83. data/assets/include/SDL2/SDL_test_common.h +0 -236
  84. data/assets/include/SDL2/SDL_test_compare.h +0 -69
  85. data/assets/include/SDL2/SDL_test_crc32.h +0 -124
  86. data/assets/include/SDL2/SDL_test_font.h +0 -168
  87. data/assets/include/SDL2/SDL_test_fuzzer.h +0 -386
  88. data/assets/include/SDL2/SDL_test_harness.h +0 -134
  89. data/assets/include/SDL2/SDL_test_images.h +0 -78
  90. data/assets/include/SDL2/SDL_test_log.h +0 -67
  91. data/assets/include/SDL2/SDL_test_md5.h +0 -129
  92. data/assets/include/SDL2/SDL_test_memory.h +0 -63
  93. data/assets/include/SDL2/SDL_test_random.h +0 -115
  94. data/assets/include/SDL2/SDL_thread.h +0 -464
  95. data/assets/include/SDL2/SDL_timer.h +0 -222
  96. data/assets/include/SDL2/SDL_touch.h +0 -150
  97. data/assets/include/SDL2/SDL_ttf.h +0 -2316
  98. data/assets/include/SDL2/SDL_types.h +0 -29
  99. data/assets/include/SDL2/SDL_version.h +0 -204
  100. data/assets/include/SDL2/SDL_video.h +0 -2150
  101. data/assets/include/SDL2/SDL_vulkan.h +0 -215
  102. data/assets/include/SDL2/begin_code.h +0 -187
  103. data/assets/include/SDL2/close_code.h +0 -40
  104. data/assets/macos/universal/lib/libFLAC.a +0 -0
  105. data/assets/macos/universal/lib/libSDL2.a +0 -0
  106. data/assets/macos/universal/lib/libSDL2_mixer.a +0 -0
  107. data/assets/macos/universal/lib/libmodplug.a +0 -0
  108. data/assets/macos/universal/lib/libmpg123.a +0 -0
  109. data/assets/macos/universal/lib/libogg.a +0 -0
  110. data/assets/macos/universal/lib/libvorbis.a +0 -0
  111. data/assets/macos/universal/lib/libvorbisfile.a +0 -0
  112. data/assets/windows/mingw-w64-ucrt-x86_64/lib/libFLAC.a +0 -0
  113. data/assets/windows/mingw-w64-ucrt-x86_64/lib/libSDL2.a +0 -0
  114. data/assets/windows/mingw-w64-ucrt-x86_64/lib/libSDL2_mixer.a +0 -0
  115. data/assets/windows/mingw-w64-ucrt-x86_64/lib/libmodplug.a +0 -0
  116. data/assets/windows/mingw-w64-ucrt-x86_64/lib/libmpg123.a +0 -0
  117. data/assets/windows/mingw-w64-ucrt-x86_64/lib/libogg.a +0 -0
  118. data/assets/windows/mingw-w64-ucrt-x86_64/lib/libopus.a +0 -0
  119. data/assets/windows/mingw-w64-ucrt-x86_64/lib/libopusfile.a +0 -0
  120. data/assets/windows/mingw-w64-ucrt-x86_64/lib/libsndfile.a +0 -0
  121. data/assets/windows/mingw-w64-ucrt-x86_64/lib/libstdc++.a +0 -0
  122. data/assets/windows/mingw-w64-ucrt-x86_64/lib/libvorbis.a +0 -0
  123. data/assets/windows/mingw-w64-ucrt-x86_64/lib/libvorbisfile.a +0 -0
  124. data/assets/windows/mingw-w64-ucrt-x86_64/lib/libz.a +0 -0
  125. data/assets/windows/mingw-w64-x86_64/lib/libFLAC.a +0 -0
  126. data/assets/windows/mingw-w64-x86_64/lib/libSDL2.a +0 -0
  127. data/assets/windows/mingw-w64-x86_64/lib/libSDL2_mixer.a +0 -0
  128. data/assets/windows/mingw-w64-x86_64/lib/libmodplug.a +0 -0
  129. data/assets/windows/mingw-w64-x86_64/lib/libmpg123.a +0 -0
  130. data/assets/windows/mingw-w64-x86_64/lib/libogg.a +0 -0
  131. data/assets/windows/mingw-w64-x86_64/lib/libopus.a +0 -0
  132. data/assets/windows/mingw-w64-x86_64/lib/libopusfile.a +0 -0
  133. data/assets/windows/mingw-w64-x86_64/lib/libsndfile.a +0 -0
  134. data/assets/windows/mingw-w64-x86_64/lib/libstdc++.a +0 -0
  135. data/assets/windows/mingw-w64-x86_64/lib/libvorbis.a +0 -0
  136. data/assets/windows/mingw-w64-x86_64/lib/libvorbisfile.a +0 -0
  137. data/assets/windows/mingw-w64-x86_64/lib/libz.a +0 -0
  138. data/ext/audio/extconf.h +0 -3
@@ -1,404 +0,0 @@
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_log.h
24
- *
25
- * Simple log messages with categories and priorities.
26
- *
27
- * By default logs are quiet, but if you're debugging SDL you might want:
28
- *
29
- * SDL_LogSetAllPriority(SDL_LOG_PRIORITY_WARN);
30
- *
31
- * Here's where the messages go on different platforms:
32
- * Windows: debug output stream
33
- * Android: log output
34
- * Others: standard error output (stderr)
35
- */
36
-
37
- #ifndef SDL_log_h_
38
- #define SDL_log_h_
39
-
40
- #include "SDL_stdinc.h"
41
-
42
- #include "begin_code.h"
43
- /* Set up for C function definitions, even when using C++ */
44
- #ifdef __cplusplus
45
- extern "C" {
46
- #endif
47
-
48
-
49
- /**
50
- * \brief The maximum size of a log message prior to SDL 2.0.24
51
- *
52
- * As of 2.0.24 there is no limit to the length of SDL log messages.
53
- */
54
- #define SDL_MAX_LOG_MESSAGE 4096
55
-
56
- /**
57
- * \brief The predefined log categories
58
- *
59
- * By default the application category is enabled at the INFO level,
60
- * the assert category is enabled at the WARN level, test is enabled
61
- * at the VERBOSE level and all other categories are enabled at the
62
- * CRITICAL level.
63
- */
64
- typedef enum
65
- {
66
- SDL_LOG_CATEGORY_APPLICATION,
67
- SDL_LOG_CATEGORY_ERROR,
68
- SDL_LOG_CATEGORY_ASSERT,
69
- SDL_LOG_CATEGORY_SYSTEM,
70
- SDL_LOG_CATEGORY_AUDIO,
71
- SDL_LOG_CATEGORY_VIDEO,
72
- SDL_LOG_CATEGORY_RENDER,
73
- SDL_LOG_CATEGORY_INPUT,
74
- SDL_LOG_CATEGORY_TEST,
75
-
76
- /* Reserved for future SDL library use */
77
- SDL_LOG_CATEGORY_RESERVED1,
78
- SDL_LOG_CATEGORY_RESERVED2,
79
- SDL_LOG_CATEGORY_RESERVED3,
80
- SDL_LOG_CATEGORY_RESERVED4,
81
- SDL_LOG_CATEGORY_RESERVED5,
82
- SDL_LOG_CATEGORY_RESERVED6,
83
- SDL_LOG_CATEGORY_RESERVED7,
84
- SDL_LOG_CATEGORY_RESERVED8,
85
- SDL_LOG_CATEGORY_RESERVED9,
86
- SDL_LOG_CATEGORY_RESERVED10,
87
-
88
- /* Beyond this point is reserved for application use, e.g.
89
- enum {
90
- MYAPP_CATEGORY_AWESOME1 = SDL_LOG_CATEGORY_CUSTOM,
91
- MYAPP_CATEGORY_AWESOME2,
92
- MYAPP_CATEGORY_AWESOME3,
93
- ...
94
- };
95
- */
96
- SDL_LOG_CATEGORY_CUSTOM
97
- } SDL_LogCategory;
98
-
99
- /**
100
- * \brief The predefined log priorities
101
- */
102
- typedef enum
103
- {
104
- SDL_LOG_PRIORITY_VERBOSE = 1,
105
- SDL_LOG_PRIORITY_DEBUG,
106
- SDL_LOG_PRIORITY_INFO,
107
- SDL_LOG_PRIORITY_WARN,
108
- SDL_LOG_PRIORITY_ERROR,
109
- SDL_LOG_PRIORITY_CRITICAL,
110
- SDL_NUM_LOG_PRIORITIES
111
- } SDL_LogPriority;
112
-
113
-
114
- /**
115
- * Set the priority of all log categories.
116
- *
117
- * \param priority the SDL_LogPriority to assign
118
- *
119
- * \since This function is available since SDL 2.0.0.
120
- *
121
- * \sa SDL_LogSetPriority
122
- */
123
- extern DECLSPEC void SDLCALL SDL_LogSetAllPriority(SDL_LogPriority priority);
124
-
125
- /**
126
- * Set the priority of a particular log category.
127
- *
128
- * \param category the category to assign a priority to
129
- * \param priority the SDL_LogPriority to assign
130
- *
131
- * \since This function is available since SDL 2.0.0.
132
- *
133
- * \sa SDL_LogGetPriority
134
- * \sa SDL_LogSetAllPriority
135
- */
136
- extern DECLSPEC void SDLCALL SDL_LogSetPriority(int category,
137
- SDL_LogPriority priority);
138
-
139
- /**
140
- * Get the priority of a particular log category.
141
- *
142
- * \param category the category to query
143
- * \returns the SDL_LogPriority for the requested category
144
- *
145
- * \since This function is available since SDL 2.0.0.
146
- *
147
- * \sa SDL_LogSetPriority
148
- */
149
- extern DECLSPEC SDL_LogPriority SDLCALL SDL_LogGetPriority(int category);
150
-
151
- /**
152
- * Reset all priorities to default.
153
- *
154
- * This is called by SDL_Quit().
155
- *
156
- * \since This function is available since SDL 2.0.0.
157
- *
158
- * \sa SDL_LogSetAllPriority
159
- * \sa SDL_LogSetPriority
160
- */
161
- extern DECLSPEC void SDLCALL SDL_LogResetPriorities(void);
162
-
163
- /**
164
- * Log a message with SDL_LOG_CATEGORY_APPLICATION and SDL_LOG_PRIORITY_INFO.
165
- *
166
- * = * \param fmt a printf() style message format string
167
- *
168
- * \param ... additional parameters matching % tokens in the `fmt` string, if
169
- * any
170
- *
171
- * \since This function is available since SDL 2.0.0.
172
- *
173
- * \sa SDL_LogCritical
174
- * \sa SDL_LogDebug
175
- * \sa SDL_LogError
176
- * \sa SDL_LogInfo
177
- * \sa SDL_LogMessage
178
- * \sa SDL_LogMessageV
179
- * \sa SDL_LogVerbose
180
- * \sa SDL_LogWarn
181
- */
182
- extern DECLSPEC void SDLCALL SDL_Log(SDL_PRINTF_FORMAT_STRING const char *fmt, ...) SDL_PRINTF_VARARG_FUNC(1);
183
-
184
- /**
185
- * Log a message with SDL_LOG_PRIORITY_VERBOSE.
186
- *
187
- * \param category the category of the message
188
- * \param fmt a printf() style message format string
189
- * \param ... additional parameters matching % tokens in the **fmt** string,
190
- * if any
191
- *
192
- * \since This function is available since SDL 2.0.0.
193
- *
194
- * \sa SDL_Log
195
- * \sa SDL_LogCritical
196
- * \sa SDL_LogDebug
197
- * \sa SDL_LogError
198
- * \sa SDL_LogInfo
199
- * \sa SDL_LogMessage
200
- * \sa SDL_LogMessageV
201
- * \sa SDL_LogWarn
202
- */
203
- extern DECLSPEC void SDLCALL SDL_LogVerbose(int category, SDL_PRINTF_FORMAT_STRING const char *fmt, ...) SDL_PRINTF_VARARG_FUNC(2);
204
-
205
- /**
206
- * Log a message with SDL_LOG_PRIORITY_DEBUG.
207
- *
208
- * \param category the category of the message
209
- * \param fmt a printf() style message format string
210
- * \param ... additional parameters matching % tokens in the **fmt** string,
211
- * if any
212
- *
213
- * \since This function is available since SDL 2.0.0.
214
- *
215
- * \sa SDL_Log
216
- * \sa SDL_LogCritical
217
- * \sa SDL_LogError
218
- * \sa SDL_LogInfo
219
- * \sa SDL_LogMessage
220
- * \sa SDL_LogMessageV
221
- * \sa SDL_LogVerbose
222
- * \sa SDL_LogWarn
223
- */
224
- extern DECLSPEC void SDLCALL SDL_LogDebug(int category, SDL_PRINTF_FORMAT_STRING const char *fmt, ...) SDL_PRINTF_VARARG_FUNC(2);
225
-
226
- /**
227
- * Log a message with SDL_LOG_PRIORITY_INFO.
228
- *
229
- * \param category the category of the message
230
- * \param fmt a printf() style message format string
231
- * \param ... additional parameters matching % tokens in the **fmt** string,
232
- * if any
233
- *
234
- * \since This function is available since SDL 2.0.0.
235
- *
236
- * \sa SDL_Log
237
- * \sa SDL_LogCritical
238
- * \sa SDL_LogDebug
239
- * \sa SDL_LogError
240
- * \sa SDL_LogMessage
241
- * \sa SDL_LogMessageV
242
- * \sa SDL_LogVerbose
243
- * \sa SDL_LogWarn
244
- */
245
- extern DECLSPEC void SDLCALL SDL_LogInfo(int category, SDL_PRINTF_FORMAT_STRING const char *fmt, ...) SDL_PRINTF_VARARG_FUNC(2);
246
-
247
- /**
248
- * Log a message with SDL_LOG_PRIORITY_WARN.
249
- *
250
- * \param category the category of the message
251
- * \param fmt a printf() style message format string
252
- * \param ... additional parameters matching % tokens in the **fmt** string,
253
- * if any
254
- *
255
- * \since This function is available since SDL 2.0.0.
256
- *
257
- * \sa SDL_Log
258
- * \sa SDL_LogCritical
259
- * \sa SDL_LogDebug
260
- * \sa SDL_LogError
261
- * \sa SDL_LogInfo
262
- * \sa SDL_LogMessage
263
- * \sa SDL_LogMessageV
264
- * \sa SDL_LogVerbose
265
- */
266
- extern DECLSPEC void SDLCALL SDL_LogWarn(int category, SDL_PRINTF_FORMAT_STRING const char *fmt, ...) SDL_PRINTF_VARARG_FUNC(2);
267
-
268
- /**
269
- * Log a message with SDL_LOG_PRIORITY_ERROR.
270
- *
271
- * \param category the category of the message
272
- * \param fmt a printf() style message format string
273
- * \param ... additional parameters matching % tokens in the **fmt** string,
274
- * if any
275
- *
276
- * \since This function is available since SDL 2.0.0.
277
- *
278
- * \sa SDL_Log
279
- * \sa SDL_LogCritical
280
- * \sa SDL_LogDebug
281
- * \sa SDL_LogInfo
282
- * \sa SDL_LogMessage
283
- * \sa SDL_LogMessageV
284
- * \sa SDL_LogVerbose
285
- * \sa SDL_LogWarn
286
- */
287
- extern DECLSPEC void SDLCALL SDL_LogError(int category, SDL_PRINTF_FORMAT_STRING const char *fmt, ...) SDL_PRINTF_VARARG_FUNC(2);
288
-
289
- /**
290
- * Log a message with SDL_LOG_PRIORITY_CRITICAL.
291
- *
292
- * \param category the category of the message
293
- * \param fmt a printf() style message format string
294
- * \param ... additional parameters matching % tokens in the **fmt** string,
295
- * if any
296
- *
297
- * \since This function is available since SDL 2.0.0.
298
- *
299
- * \sa SDL_Log
300
- * \sa SDL_LogDebug
301
- * \sa SDL_LogError
302
- * \sa SDL_LogInfo
303
- * \sa SDL_LogMessage
304
- * \sa SDL_LogMessageV
305
- * \sa SDL_LogVerbose
306
- * \sa SDL_LogWarn
307
- */
308
- extern DECLSPEC void SDLCALL SDL_LogCritical(int category, SDL_PRINTF_FORMAT_STRING const char *fmt, ...) SDL_PRINTF_VARARG_FUNC(2);
309
-
310
- /**
311
- * Log a message with the specified category and priority.
312
- *
313
- * \param category the category of the message
314
- * \param priority the priority of the message
315
- * \param fmt a printf() style message format string
316
- * \param ... additional parameters matching % tokens in the **fmt** string,
317
- * if any
318
- *
319
- * \since This function is available since SDL 2.0.0.
320
- *
321
- * \sa SDL_Log
322
- * \sa SDL_LogCritical
323
- * \sa SDL_LogDebug
324
- * \sa SDL_LogError
325
- * \sa SDL_LogInfo
326
- * \sa SDL_LogMessageV
327
- * \sa SDL_LogVerbose
328
- * \sa SDL_LogWarn
329
- */
330
- extern DECLSPEC void SDLCALL SDL_LogMessage(int category,
331
- SDL_LogPriority priority,
332
- SDL_PRINTF_FORMAT_STRING const char *fmt, ...) SDL_PRINTF_VARARG_FUNC(3);
333
-
334
- /**
335
- * Log a message with the specified category and priority.
336
- *
337
- * \param category the category of the message
338
- * \param priority the priority of the message
339
- * \param fmt a printf() style message format string
340
- * \param ap a variable argument list
341
- *
342
- * \since This function is available since SDL 2.0.0.
343
- *
344
- * \sa SDL_Log
345
- * \sa SDL_LogCritical
346
- * \sa SDL_LogDebug
347
- * \sa SDL_LogError
348
- * \sa SDL_LogInfo
349
- * \sa SDL_LogMessage
350
- * \sa SDL_LogVerbose
351
- * \sa SDL_LogWarn
352
- */
353
- extern DECLSPEC void SDLCALL SDL_LogMessageV(int category,
354
- SDL_LogPriority priority,
355
- const char *fmt, va_list ap);
356
-
357
- /**
358
- * The prototype for the log output callback function.
359
- *
360
- * This function is called by SDL when there is new text to be logged.
361
- *
362
- * \param userdata what was passed as `userdata` to SDL_LogSetOutputFunction()
363
- * \param category the category of the message
364
- * \param priority the priority of the message
365
- * \param message the message being output
366
- */
367
- typedef void (SDLCALL *SDL_LogOutputFunction)(void *userdata, int category, SDL_LogPriority priority, const char *message);
368
-
369
- /**
370
- * Get the current log output function.
371
- *
372
- * \param callback an SDL_LogOutputFunction filled in with the current log
373
- * callback
374
- * \param userdata a pointer filled in with the pointer that is passed to
375
- * `callback`
376
- *
377
- * \since This function is available since SDL 2.0.0.
378
- *
379
- * \sa SDL_LogSetOutputFunction
380
- */
381
- extern DECLSPEC void SDLCALL SDL_LogGetOutputFunction(SDL_LogOutputFunction *callback, void **userdata);
382
-
383
- /**
384
- * Replace the default log output function with one of your own.
385
- *
386
- * \param callback an SDL_LogOutputFunction to call instead of the default
387
- * \param userdata a pointer that is passed to `callback`
388
- *
389
- * \since This function is available since SDL 2.0.0.
390
- *
391
- * \sa SDL_LogGetOutputFunction
392
- */
393
- extern DECLSPEC void SDLCALL SDL_LogSetOutputFunction(SDL_LogOutputFunction callback, void *userdata);
394
-
395
-
396
- /* Ends C function definitions when using C++ */
397
- #ifdef __cplusplus
398
- }
399
- #endif
400
- #include "close_code.h"
401
-
402
- #endif /* SDL_log_h_ */
403
-
404
- /* vi: set ts=4 sw=4 expandtab: */
@@ -1,275 +0,0 @@
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_main_h_
23
- #define SDL_main_h_
24
-
25
- #include "SDL_stdinc.h"
26
-
27
- /**
28
- * \file SDL_main.h
29
- *
30
- * Redefine main() on some platforms so that it is called by SDL.
31
- */
32
-
33
- #ifndef SDL_MAIN_HANDLED
34
- #if defined(__WIN32__)
35
- /* On Windows SDL provides WinMain(), which parses the command line and passes
36
- the arguments to your main function.
37
-
38
- If you provide your own WinMain(), you may define SDL_MAIN_HANDLED
39
- */
40
- #define SDL_MAIN_AVAILABLE
41
-
42
- #elif defined(__WINRT__)
43
- /* On WinRT, SDL provides a main function that initializes CoreApplication,
44
- creating an instance of IFrameworkView in the process.
45
-
46
- Please note that #include'ing SDL_main.h is not enough to get a main()
47
- function working. In non-XAML apps, the file,
48
- src/main/winrt/SDL_WinRT_main_NonXAML.cpp, or a copy of it, must be compiled
49
- into the app itself. In XAML apps, the function, SDL_WinRTRunApp must be
50
- called, with a pointer to the Direct3D-hosted XAML control passed in.
51
- */
52
- #define SDL_MAIN_NEEDED
53
-
54
- #elif defined(__GDK__)
55
- /* On GDK, SDL provides a main function that initializes the game runtime.
56
-
57
- Please note that #include'ing SDL_main.h is not enough to get a main()
58
- function working. You must either link against SDL2main or, if not possible,
59
- call the SDL_GDKRunApp function from your entry point.
60
- */
61
- #define SDL_MAIN_NEEDED
62
-
63
- #elif defined(__IPHONEOS__)
64
- /* On iOS SDL provides a main function that creates an application delegate
65
- and starts the iOS application run loop.
66
-
67
- If you link with SDL dynamically on iOS, the main function can't be in a
68
- shared library, so you need to link with libSDLmain.a, which includes a
69
- stub main function that calls into the shared library to start execution.
70
-
71
- See src/video/uikit/SDL_uikitappdelegate.m for more details.
72
- */
73
- #define SDL_MAIN_NEEDED
74
-
75
- #elif defined(__ANDROID__)
76
- /* On Android SDL provides a Java class in SDLActivity.java that is the
77
- main activity entry point.
78
-
79
- See docs/README-android.md for more details on extending that class.
80
- */
81
- #define SDL_MAIN_NEEDED
82
-
83
- /* We need to export SDL_main so it can be launched from Java */
84
- #define SDLMAIN_DECLSPEC DECLSPEC
85
-
86
- #elif defined(__NACL__)
87
- /* On NACL we use ppapi_simple to set up the application helper code,
88
- then wait for the first PSE_INSTANCE_DIDCHANGEVIEW event before
89
- starting the user main function.
90
- All user code is run in a separate thread by ppapi_simple, thus
91
- allowing for blocking io to take place via nacl_io
92
- */
93
- #define SDL_MAIN_NEEDED
94
-
95
- #elif defined(__PSP__)
96
- /* On PSP SDL provides a main function that sets the module info,
97
- activates the GPU and starts the thread required to be able to exit
98
- the software.
99
-
100
- If you provide this yourself, you may define SDL_MAIN_HANDLED
101
- */
102
- #define SDL_MAIN_AVAILABLE
103
-
104
- #elif defined(__PS2__)
105
- #define SDL_MAIN_AVAILABLE
106
-
107
- #define SDL_PS2_SKIP_IOP_RESET() \
108
- void reset_IOP(); \
109
- void reset_IOP() {}
110
-
111
- #elif defined(__3DS__)
112
- /*
113
- On N3DS, SDL provides a main function that sets up the screens
114
- and storage.
115
-
116
- If you provide this yourself, you may define SDL_MAIN_HANDLED
117
- */
118
- #define SDL_MAIN_AVAILABLE
119
-
120
- #endif
121
- #endif /* SDL_MAIN_HANDLED */
122
-
123
- #ifndef SDLMAIN_DECLSPEC
124
- #define SDLMAIN_DECLSPEC
125
- #endif
126
-
127
- /**
128
- * \file SDL_main.h
129
- *
130
- * The application's main() function must be called with C linkage,
131
- * and should be declared like this:
132
- * \code
133
- * #ifdef __cplusplus
134
- * extern "C"
135
- * #endif
136
- * int main(int argc, char *argv[])
137
- * {
138
- * }
139
- * \endcode
140
- */
141
-
142
- #if defined(SDL_MAIN_NEEDED) || defined(SDL_MAIN_AVAILABLE)
143
- #define main SDL_main
144
- #endif
145
-
146
- #include "begin_code.h"
147
- #ifdef __cplusplus
148
- extern "C" {
149
- #endif
150
-
151
- /**
152
- * The prototype for the application's main() function
153
- */
154
- typedef int (*SDL_main_func)(int argc, char *argv[]);
155
- extern SDLMAIN_DECLSPEC int SDL_main(int argc, char *argv[]);
156
-
157
-
158
- /**
159
- * Circumvent failure of SDL_Init() when not using SDL_main() as an entry
160
- * point.
161
- *
162
- * This function is defined in SDL_main.h, along with the preprocessor rule to
163
- * redefine main() as SDL_main(). Thus to ensure that your main() function
164
- * will not be changed it is necessary to define SDL_MAIN_HANDLED before
165
- * including SDL.h.
166
- *
167
- * \since This function is available since SDL 2.0.0.
168
- *
169
- * \sa SDL_Init
170
- */
171
- extern DECLSPEC void SDLCALL SDL_SetMainReady(void);
172
-
173
- #if defined(__WIN32__) || defined(__GDK__)
174
-
175
- /**
176
- * Register a win32 window class for SDL's use.
177
- *
178
- * This can be called to set the application window class at startup. It is
179
- * safe to call this multiple times, as long as every call is eventually
180
- * paired with a call to SDL_UnregisterApp, but a second registration attempt
181
- * while a previous registration is still active will be ignored, other than
182
- * to increment a counter.
183
- *
184
- * Most applications do not need to, and should not, call this directly; SDL
185
- * will call it when initializing the video subsystem.
186
- *
187
- * \param name the window class name, in UTF-8 encoding. If NULL, SDL
188
- * currently uses "SDL_app" but this isn't guaranteed.
189
- * \param style the value to use in WNDCLASSEX::style. If `name` is NULL, SDL
190
- * currently uses `(CS_BYTEALIGNCLIENT | CS_OWNDC)` regardless of
191
- * what is specified here.
192
- * \param hInst the HINSTANCE to use in WNDCLASSEX::hInstance. If zero, SDL
193
- * will use `GetModuleHandle(NULL)` instead.
194
- * \returns 0 on success, -1 on error. SDL_GetError() may have details.
195
- *
196
- * \since This function is available since SDL 2.0.2.
197
- */
198
- extern DECLSPEC int SDLCALL SDL_RegisterApp(const char *name, Uint32 style, void *hInst);
199
-
200
- /**
201
- * Deregister the win32 window class from an SDL_RegisterApp call.
202
- *
203
- * This can be called to undo the effects of SDL_RegisterApp.
204
- *
205
- * Most applications do not need to, and should not, call this directly; SDL
206
- * will call it when deinitializing the video subsystem.
207
- *
208
- * It is safe to call this multiple times, as long as every call is eventually
209
- * paired with a prior call to SDL_RegisterApp. The window class will only be
210
- * deregistered when the registration counter in SDL_RegisterApp decrements to
211
- * zero through calls to this function.
212
- *
213
- * \since This function is available since SDL 2.0.2.
214
- */
215
- extern DECLSPEC void SDLCALL SDL_UnregisterApp(void);
216
-
217
- #endif /* defined(__WIN32__) || defined(__GDK__) */
218
-
219
-
220
- #ifdef __WINRT__
221
-
222
- /**
223
- * Initialize and launch an SDL/WinRT application.
224
- *
225
- * \param mainFunction the SDL app's C-style main(), an SDL_main_func
226
- * \param reserved reserved for future use; should be NULL
227
- * \returns 0 on success or -1 on failure; call SDL_GetError() to retrieve
228
- * more information on the failure.
229
- *
230
- * \since This function is available since SDL 2.0.3.
231
- */
232
- extern DECLSPEC int SDLCALL SDL_WinRTRunApp(SDL_main_func mainFunction, void * reserved);
233
-
234
- #endif /* __WINRT__ */
235
-
236
- #if defined(__IPHONEOS__)
237
-
238
- /**
239
- * Initializes and launches an SDL application.
240
- *
241
- * \param argc The argc parameter from the application's main() function
242
- * \param argv The argv parameter from the application's main() function
243
- * \param mainFunction The SDL app's C-style main(), an SDL_main_func
244
- * \return the return value from mainFunction
245
- *
246
- * \since This function is available since SDL 2.0.10.
247
- */
248
- extern DECLSPEC int SDLCALL SDL_UIKitRunApp(int argc, char *argv[], SDL_main_func mainFunction);
249
-
250
- #endif /* __IPHONEOS__ */
251
-
252
- #ifdef __GDK__
253
-
254
- /**
255
- * Initialize and launch an SDL GDK application.
256
- *
257
- * \param mainFunction the SDL app's C-style main(), an SDL_main_func
258
- * \param reserved reserved for future use; should be NULL
259
- * \returns 0 on success or -1 on failure; call SDL_GetError() to retrieve
260
- * more information on the failure.
261
- *
262
- * \since This function is available since SDL 2.24.0.
263
- */
264
- extern DECLSPEC int SDLCALL SDL_GDKRunApp(SDL_main_func mainFunction, void *reserved);
265
-
266
- #endif /* __GDK__ */
267
-
268
- #ifdef __cplusplus
269
- }
270
- #endif
271
- #include "close_code.h"
272
-
273
- #endif /* SDL_main_h_ */
274
-
275
- /* vi: set ts=4 sw=4 expandtab: */