5bdad5210f
Sync SDL3 wiki -> header
2023-08-27 20:55:12 +00:00
58c859f64d
audio: Rename SDL_GetAudioStreamBinding to SDL_GetAudioStreamDevice.
2023-08-27 16:54:30 -04:00
efd2023a72
audio: Fixed documentation.
2023-08-27 16:54:30 -04:00
1e775e0eef
audio: Replace SDL_CreateAndBindAudioStream with SDL_OpenAudioDeviceStream.
...
This is meant to offer a simplified API for people that are either migrating
directly from SDL2 with minimal effort or just want to make noise without
any of the fancy new API features.
Users of this API can just deal with a single SDL_AudioStream as their only
object/handle into the audio subsystem.
They are still allowed to open multiple devices (or open the same device
multiple times), but cannot change stream bindings on logical devices opened
through this function.
Destroying the single audio stream will also close the logical device behind
the scenes.
2023-08-27 16:54:30 -04:00
e7d56dd0b2
audio: Renamed new API SDL_UnpauseAudioDevice to SDL_ResumeAudioDevice.
2023-08-05 19:20:14 -04:00
4bb426abad
Sync SDL3 wiki -> header
2023-08-05 17:45:14 +00:00
3a752ce650
Reapply "Changed 'freesrc' parameter from int to SDL_bool" to SDL_wave.c
...
Commit bea99d4905c4ff
2023-08-05 13:44:48 -04:00
c0a88930bf
Sync SDL3 wiki -> header
2023-08-04 01:28:15 +00:00
db39cbf208
audio: Allow SDL_GetAudioDeviceFormat() to query the default devices.
...
Officially removed SDL_GetDefaultAudioInfo(), as its functionality that
isn't obsolete is now offered elsewhere.
2023-07-30 11:55:55 -04:00
464640440f
audio: Added SDL_GetAudioStreamBinding.
...
Now you can open a device, bind a stream, and forget about the device ID
until you're ready to shutdown, where you can query the stream for it.
2023-07-30 11:55:54 -04:00
01f7b53865
audio: Readded (logical) device pausing.
2023-07-30 11:55:53 -04:00
fd4c9f4e11
audio: documentation improvements.
2023-07-30 11:55:53 -04:00
b2e020958f
audio: Wrap device access in opening of logical devices.
...
Now you open an audio device and attach streams, as planned, but each
open generates a new logical device. Each logical device has its own
streams that are managed as a group, but all streams on all logical
devices are mixed into a single buffer for a single OS-level open of
the physical device.
This allows multiple opens of a device that won't interfere with each
other and also clean up just what the opener assigned to their logical
device, so all their streams will go away on close but other opens will
continue to mix as they were.
More or less, this makes things work as expected at the app level, but
also gives them the power to group audio streams, and (once added) pause
them all at once, etc.
2023-07-30 11:55:53 -04:00
3d65a2cefe
audio: Made SDL_LoadWAV a real function, not just a macro.
2023-07-30 11:55:52 -04:00
26525f5fd3
audio: Readd SDL_AudioSpec, but just with format/channels/freq fields.
2023-07-30 11:55:52 -04:00
e6aaed7d79
include: Audio is not, and has not been, a raw mixing buffer for a long time.
2023-07-30 11:55:52 -04:00
56b1bc2198
audio: SDL_AudioStream now has callbacks for Get and Put operations.
...
This allows code to feed a stream (or feed from a stream) on-demand,
which is to say: it can efficiently simulate the SDL2 audio callback.
2023-07-30 11:55:51 -04:00
905c4fff5b
audio: First shot at the SDL3 audio subsystem redesign!
...
This is a work in progress! (and this commit will probably get
force-pushed over at some point).
2023-07-30 11:55:51 -04:00
550c84b4df
Sync SDL3 wiki -> header
2023-07-09 20:50:16 +00:00
bea99d48f2
Changed 'freesrc' parameter from int to SDL_bool
2023-07-09 13:49:04 -07:00
627165a2b2
Fix comments
2023-06-22 15:44:48 +02:00
9786d8ac40
Sync SDL3 wiki -> header
2023-05-09 18:27:15 +00:00
2b6cb7bfb2
include: SDL_ConvertAudioSamples docs now warn about converting in chunks.
...
Fixes #7154 .
2023-05-09 14:24:22 -04:00
079ae065f1
Added SDL prefix AUDIO_* constants
2023-05-02 08:09:06 -07:00
60c5888423
Sync SDL3 wiki -> header
2023-04-27 22:36:15 +00:00
e5a6c24c82
audio: Redesigned audio conversion code for SDL3.
...
- SDL_AudioCVT is gone, even internally.
- libsamplerate is gone (I suspect our resampler is finally Good Enough).
- Cleanups and improvements to audio conversion interfaces.
- SDL_AudioStream can change its input/output format/rate/channels on the fly!
2023-04-27 18:35:15 -04:00
e1b8a03239
testsurround: fix channel names
...
Used table in include/SDL3/SDL_audio.h as reference.
2023-03-28 16:59:27 +00:00
f48d0cc164
audio: Remove AUDIO_U16* support.
...
It wasn't heavily used, and you can't use memset to silence a U16 buffer.
Fixes #7380 .
2023-03-01 10:26:01 -05:00
0598ecc150
Sync wiki -> headers.
2023-02-24 11:49:41 -05:00
549cedfa88
include: add \brief to includes
2023-02-19 10:01:33 -08:00
49e47b523a
Update `\returns` to the generic form
2023-02-12 08:21:02 -08:00
43c08170af
Add missing '\param' documentation
2023-02-12 09:42:13 +01:00
ce366facaa
Add missing \returns, change "return" to "returns" to have same naming
2023-02-12 09:22:25 +01:00
5b77ad54c4
Fixed order and constness of parameters to SDL_ConvertAudioSamples()
2023-02-09 17:49:35 -08:00
e2e5e670bf
Remove returns int from Destroy/Close/Unlock functions
2023-02-09 07:57:14 -08:00
3bd737d44c
Add error returns to void functions that can fail/set errors.
...
This takes care of the last set of void functions that could
potentially be shifted to instead return an int indicating success and
setting an error in case of an error.
2023-02-09 07:23:21 -08:00
b305d9e3c0
Change return type from void to int for audio function. Eventually set invalid parameter error.
2023-02-08 17:43:44 -08:00
c5c94a6be6
Change return type from void to int, for functions that set an error
...
(SDL_SetError(), SDL_OutOfMemory(), SDL_Unsupported(), SDL_InvalidParam())
Update prototype to forward errors to generic layer, for the functions:
MoveCursor, WarpMouse, GL_DeleteContext, GetDisplayModes.
Check invalid parameter in SDL_SetTextInputRect() generic layer.
2023-02-07 13:51:45 -08:00
197340ea1c
Sync wiki -> headers.
2023-01-25 13:01:40 -05:00
052b14eb65
Add SDL_ConvertAudioSamples() helper function
2023-01-24 08:26:09 -08:00
64bc0a1612
Remove AudioCVT interface in favor of SDL_AudioStream
2023-01-22 11:31:30 -05:00
fde78d12f2
Updated copyright for 2023
2023-01-09 09:41:41 -08:00
93e2903ac5
Add SDL_PlayAudioDevice() to play audio. Remove pause_on param from SDL_PauseAudioDevice()
2023-01-06 09:15:39 -08:00
2d7f8d7d51
Remove legacy SDL_Audio functions that acts on device id == 1
2023-01-05 09:40:06 -05:00
701e965235
Removed leading underscore in structure names
...
Fixes https://github.com/libsdl-org/SDL/issues/6856
Closes https://github.com/libsdl-org/SDL/pull/6914
Closes https://github.com/libsdl-org/SDL/pull/6915
Closes https://github.com/libsdl-org/SDL/pull/6916
Closes https://github.com/libsdl-org/SDL/pull/6917
Closes https://github.com/libsdl-org/SDL/pull/6918
Closes https://github.com/libsdl-org/SDL/pull/6919
2022-12-27 10:35:53 -08:00
713ba2e31a
SDL API renaming: SDL_audio.h
...
Fixes https://github.com/libsdl-org/SDL/issues/6879
2022-12-27 05:32:55 -08:00
9625fb2832
Documentation cleanup
2022-12-27 05:28:18 -08:00
47170d288e
Don't export SDL_AudioInit/Quit, use SDL_InitSubsystem instead ( #6912 )
...
* Don't export SDL_AudioInit/Quit, use SDL_InitSubsystem instead
* Update README
Co-authored-by: Sam Lantinga <slouken@libsdl.org>
2022-12-27 05:22:22 -08:00
3fb0c8b54a
Remove/Rename SDL_FreeWAV() to SDL_free()
2022-12-27 05:14:52 -08:00
63724c113b
Removed the vi format comments from the source
...
Vim users can use the [editorconfig plugin](https://github.com/editorconfig/editorconfig-vim ) to automatically set tab spacing for the SDL coding style.
Fixes https://github.com/libsdl-org/SDL/issues/6903
2022-12-26 11:17:23 -08:00
SDL Wiki Bot
Ryan C. Gordon
meyraud705
Sam Lantinga
Sylvain
Brick
Anonymous Maarten
Linus Probert