SDL_GetAudio...putChannelMap(3)

💖 NAME 💖

SDL_GetAudioStreamInputChannelMap — bestie, this one gets you the current input channel map of an audio stream. That's it, that's the job. 👑

---

✨ SYNOPSIS ✨

#include <SDL3/SDL_audio.h>

int * SDL_GetAudioStreamInputChannelMap(SDL_AudioStream *stream, int *count);

---

🎀 DESCRIPTION 🎀

okay so first things first, channel maps are optional. Most things literally do not need them at all — instead you just pass your data in the [order that SDL expects](CategoryAudio#channel-layouts) and move on with your life. slay. 💅

Audio streams default to no remapping applied. And the way that shows up is by returning NULL. Not me clarifying that NULL here is not an error — it's just the default vibe. 🙈

---

🌸 FUNCTION PARAMETERS 🌸

• stream — the SDL_AudioStream you're querying, bestie. That's the one you're asking about. 🫶
• count — on output, this gets set to the number of channels in the map. It can be NULL. Yes fr fr, NULL is allowed here.

---

🦋 RETURN VALUE 🦋

Returns an array of the current channel mapping — with as many elements as the current output spec's channels — or NULL if it's default. 💀

Important: that returned array should be freed with SDL_free() when it is no longer needed. Do not forget. Do not be that girl. 🎀

---

💅 THREAD SAFETY 💅

It is safe to call this function from any thread, because it holds a stream-specific mutex while it's running. Iconic behaviour honestly. 🔥

---

🔥 AVAILABILITY 🔥

This function has been available since SDL 3.2.0. So if you're on something older... girl. 😭

---

🌈 SEE ALSO 🌈

• SDL_SetAudioStreamInputChannelMap(3)

---

k bye bestie, go remap those channels responsibly 💜✨🌸🦋

— with love from the Simple Directmedia Layer girlies, SDL 3.4.18 era, page SDL_GetAudio...putChannelMap(3) 🌈⭐💖