midi_seek(3alleg4)

💖 midi_seek — bestie edition 💖

okay so this is a page from the Allegro manual (the game programming library, you know the one ✨), and it's all about the midi_seek function. let's get into it 🎀

✨ SYNOPSIS ✨

#include <allegro.h>

int midi_seek(int target);

like. that's it. that's the whole vibe. one int in, one int out 🫶

🌸 DESCRIPTION 🌸

so midi_seek does exactly what the name says, no cap — it seeks to the given midi_pos in the current MIDI file. main character behaviour tbh.

and here's the lil detail that matters: it's smart about how it gets there 👑

• if your target is earlier in the file than the current midi_pos, it seeks from the beginning — like, rewind and start over bestie, we're going back
• otherwise (so, target is at or after where you already are) it seeks from the current position — just scooting forward from where you're standing 💅

so it's not always grinding from zero. only when it has to. iconic.

🔥 RETURN VALUE 🔥

okay this part is the actual tea, listen up, because the return value is doing a LOT of storytelling 📖✨

• 0 — slay! 💖 it successfully seeked to the position you asked for. we love a zero. zero is the good one.
• 1 — 😭 it stopped playing. AND — and this is the fun bit — midi_pos gets set to the negative length of the MIDI file. so like… plot twist, you can literally use this function to figure out how long a MIDI file is. sneaky. clever. obsessed. 🧚
• 2 — 💀 the MIDI file looped back to the start. it did a lil circle. it's back, babes. 🔁

fr fr, read those numbers carefully — 1 and 2 are not errors in the "something broke" sense, they're the function telling you what the music did. iykyk 🎵

🦋 SEE ALSO 🦋

• play_midi(3alleg4) — go make some noise bestie 🌈
• midi_pos(3alleg4) — the position variable this whole page is about ⭐

and that's the page!! this one came from the Allegro manual, version 4.4.3 — dated like an old classic but still serving 💜 thanks for reading, ily, go seek some midi 🎀✨💅