MIX_TrackMSToFrames(3)

✨ MIX_TrackMSToFrames(3) ✨

okay bestie, so this one lives in the SDL_mixer3 FUNCTIONS section of the manual, and it's literally the glow-up translator between milliseconds and sample frames 💖

---

🎀 NAME 🎀

MIX_TrackMSToFrames — convert milliseconds to sample frames for a track's current format 💅

---

🦋 SYNOPSIS 🦋

#include <SDL3_mixer/SDL_mixer.h>

Sint64 MIX_TrackMSToFrames(MIX_Track *track, Sint64 ms);

---

🌸 DESCRIPTION 🌸

So here's the tea: this function does the math based on the track's current input format. And no cap, that format can change — it changes whenever the track's input changes, and it also changes if that input switches formats mid-stream (the iconic example: decoding a file that's literally two MP3s concatenated together 🫠). So it's giving "read the room, not your assumptions."

Now, the sad part 😭 — on various errors it returns -1:

• MIX_Init() was not called
• the track is NULL

Also, if the track has no input, it returns -1. And if ms is < 0, it returns -1 too. Basically if anything is off, it's a -1, periodt.

---

💜 FUNCTION PARAMETERS 💜

• track — the track to query 👑
• ms — the milliseconds to convert to track-specific sample frames ⏱️

---

⭐ RETURN VALUE ⭐

Returns the converted number of sample frames, or -1 for errors / no input. When you get that -1, call SDL_GetError() for the details, bestie 🔍

---

🧚 THREAD SAFETY 🧚

It is safe to call this function from any thread 🌈 — go off, no gatekeeping here.

---

👑 AVAILABILITY 👑

This function is available since SDL_mixer 3.0.0 ⭐

---

🍓 SEE ALSO 🍓

• MIX_TrackFramesToMS(3) — the reverse trip, iykyk 💫

---

mwah 💋 that's the whole page, and it's from SDL_mixer 3.2.4, dated SDL_mixer — the OG source/version and date line, but make it cute. stay slay, go convert some frames 🎀✨