MIX_TrackFramesToMS(3)

✨ MIX_TrackFramesToMS ✨

okay bestie, welcome to the SDL_mixer3 FUNCTIONS corner of the manual 💖 this one's called MIX_TrackFramesToMS, and it's genuinely one of the more useful little guys in here, no cap.

---

🌸 NAME 🌸

MIX_TrackFramesToMS — converts sample frames for a track's current format into milliseconds. 💅

---

🎀 SYNOPSIS 🎀

#include <SDL3_mixer/SDL_mixer.h>

Sint64 MIX_TrackFramesToMS(MIX_Track *track, Sint64 frames);

---

🦋 DESCRIPTION 🦋

so the vibe here is: this calculates time based on the track's current input format. and the tea is that format can literally change whenever the input does — and also if that input changes formats mid-stream. like, imagine you're decoding a file that's literally two MP3s concatenated together. yeah. that. 😭 the format can just swap on you partway through.

also important: sample frames are way more precise than milliseconds, so out of necessity this function approximates — it rounds down to the closest full millisecond. it's giving "close enough, bestie" 🫶

on various errors, it returns -1. specifically:

• MIX_Init() was not called
• the track is NULL
• the track has no input
• frames is < 0

all of those? -1. every time. 💀

---

🌈 FUNCTION PARAMETERS 🌈

• track — the track to query. that's the one you're asking about, bestie 🎯
• frames — the track-specific sample frames you want converted to milliseconds.

---

⭐ RETURN VALUE ⭐

returns the converted number of milliseconds, or -1 for errors / no input. and if you got a -1 and you're like "okay but why", go call SDL_GetError() for the details. it'll tell you. 🔍

---

💜 THREAD SAFETY 💜

it is safe to call this function from any thread. go off, multithreaded icon 👑

---

👑 AVAILABILITY 👑

this function is available since SDL_mixer 3.0.0. so if you're on anything newer, you're sooooo fine. ✨

---

🔥 SEE ALSO 🔥

• MIX_TrackMSToFrames(3) — the reverse girlypop, going the other direction 💫

---

and that's the whole page, bestie!! this was SDL_mixer 3.2.4 from the SDL_mixer manual, and you absolutely ate reading all of it. mwah 💖🎀🦋