MIX_AudioFramesToMS(3)

✨ MIX_AudioFramesToMS(3) ✨

okay bestie, welcome to SDL_mixer3 FUNCTIONS 💖 this one's a lil cutie from the SDL_mixer3 manual and it's literally about turning sample frames into milliseconds. yes queen, math but make it audio 🎀

---

🌸 NAME 🌸

MIX_AudioFramesToMS — convert sample frames for a MIX_Audio's format to milliseconds. that's the whole vibe. ⏱️✨

---

🦋 SYNOPSIS 🦋

#include <SDL3_mixer/SDL_mixer.h>

Sint64 MIX_AudioFramesToMS(MIX_Audio *audio, Sint64 frames);

---

💅 DESCRIPTION 💅

so here's the tea 🍓 — this calculates time based on the audio's initial format, even if the format would change mid-stream. like, it's committed to the original format, no cap, it does not switch up on you mid-way. 💀

sample frames are more precise than milliseconds, so out of necessity this function will approximate by rounding down to the closest full millisecond. it's giving "close enough bestie" energy, but only on purpose, don't come for it. 🙈

and if frames is < 0, this returns -1. periodt. that's the boundary, respect it. 🚫

---

🎀 FUNCTION PARAMETERS 🎀

• audio — the audio to query. your main character audio object, go off. 👑
• frames — the audio-specific sample frames to convert to milliseconds. hand it the frames, it handles the rest. 🔥

---

⭐ RETURN VALUE ⭐

Returns the converted number of milliseconds, or -1 for errors/no input — and yeah, call SDL_GetError() for the details, it'll spill everything. 😭

---

🧚 THREAD SAFETY 🧚

it is safe to call this function from any thread. go wild, bestie, no locking drama here. 🫶

---

🌈 AVAILABILITY 🌈

this function is available since SDL_mixer 3.0.0. OG status. 🌟

---

💜 SEE ALSO 💜

• MIX_AudioMSToFrames(3) — the reverse bestie, the remix, the other direction of the same slay ✨

---

mwah that's the whole page, you ate it fr fr. this lil icon lives in SDL_mixer 3.2.4, so go forth and convert your frames, queen 💅🎀🦋