5b3ee51c6c
Updated copyright for 2024
2024-01-01 13:15:26 -08:00
c53843a961
docs: Remove Doxygen `\brief` tags.
...
Doxygen and the wiki bridge don't need them; they'll both just use the first
line/sentence instead.
Fixes #8446 .
2023-11-06 10:26:06 -05:00
1a8bf31a69
include: Fixing whitespace on SDL_MixAudioFormat.
2023-11-04 15:06:41 -04:00
142366c837
Sync SDL3 wiki -> header
2023-10-19 14:03:06 +00:00
b45a0d9016
Updated the documentation for SDL_LoadWAV_RW()
2023-10-17 20:27:49 -07:00
ac71831350
Sync wiki -> headers
2023-10-12 15:20:53 -04:00
4368f70ff9
Added properties to various SDL objects
...
The following objects now have properties that can be user modified:
* SDL_AudioStream
* SDL_Gamepad
* SDL_Joystick
* SDL_RWops
* SDL_Renderer
* SDL_Sensor
* SDL_Surface
* SDL_Texture
* SDL_Window
2023-10-11 22:38:00 -07:00
a4541a255e
audio: SDL_GetAudioStreamQueued now returns bytes, not frames.
...
Reference #8266 .
2023-09-20 14:15:47 -04:00
703aefbce0
Sync SDL3 wiki -> header
2023-09-20 14:08:32 -04:00
34b931f7eb
audio: Added SDL_GetAudioStreamQueued
2023-09-20 10:15:03 -04:00
9f17d1a9d8
Don't reference the same function in "see also"
2023-09-13 11:01:00 -07:00
86505ea630
fix SDL_AudioStreamCallback documentation
2023-09-13 18:35:30 +03:00
d885d5c310
Sync SDL3 wiki -> header
2023-09-13 15:04:13 +00:00
2f43f7bc53
audio: Allow querying of device buffer size.
2023-09-13 11:03:17 -04:00
8b26e95f91
audio: Change SDL_AudioStreamCallback
...
Now it offers the total requested bytes in addition to the amount
immediately needed (and immediately needed might be zero if the stream
already has enough queued to satisfy the request.
2023-09-13 10:11:23 -04:00
cd633b9a88
Renamed SDL_IsAudioDevicePaused() to SDL_AudioDevicePaused()
...
This aligns with the SDL3 convention of removing "Is" from self-explanatory function names
Also improved some documentation in SDL_audio.h
2023-09-12 12:11:09 -07:00
a6e52f9e48
Sync SDL3 wiki -> header
2023-09-12 14:27:21 -04:00
3a992af446
audio: Added a postmix callback to logical devices.
...
You can see it in action in testaudio by mousing over a logical device; it
will show a visualizer for the current PCM (whatever is currently being
recorded on a capture device, or whatever is being mixed for output on
playback devices).
Fixes #8122 .
2023-09-09 16:26:37 -04:00
116b0ec977
include: minor tweak to audio API documentation
2023-09-07 10:45:45 -04:00
f2ca9a615b
Added SDL_AUDIO_FRAMESIZE
2023-09-05 17:56:58 -07:00
53122593f8
Added SDL_AUDIO_BYTESIZE
2023-09-05 17:56:58 -07:00
3a932141e4
Restore audio format binary compatibility with SDL 2.0
2023-09-04 10:16:53 -07:00
233789b0d1
Audio types have the same naming convention as other SDL endian types, e.g. [S|U][BITS][LE|BE]
...
Native endian types have no LE/BE suffix
2023-09-04 09:48:44 -07:00
36b5f3e35c
Sync SDL3 wiki -> header
2023-09-04 14:47:15 +00:00
0e552761b7
Renamed AudioStreamSpeed to AudioStreamFrequencyRatio
2023-09-04 07:46:18 -07:00
e55844274d
Added SDL_(Get|Set)AudioStreamSpeed
2023-09-01 14:38:45 -04:00
82db2b58f9
Renamed audio stream callback and moved the userdata parameter first
...
In general SDL API callbacks are called with the userdata paramter first, to mimic C++ method call convention
2023-08-27 14:43:21 -07:00
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
Sam Lantinga
Ryan C. Gordon
SDL Wiki Bot
Ozkan Sezer
Brick
meyraud705
Sylvain