play_midi(3)

💖 play_midi(3) 💖

okay bestie, welcome to the Allegro manual, and today's main character is play_midi — she starts playing the specified MIDI file. Allegro game programming library, you know the vibe 🎀

✨ SYNOPSIS ✨

#include <allegro.h>

int play_midi(MIDI *midi, int loop);

🌸 DESCRIPTION 🌸

So like, play_midi starts playing the specified MIDI file. but first?? it stops whatever music was previously playing. no overlap, no chaos, we are not doing two songs at once, that's not the vibe 💅

If the loop flag is set to non-zero, the data will be repeated until replaced with something else — infinite loop era, main character energy, she will literally never stop until you give her something new to play 🔥

Otherwise (loop = 0, the chill path), it will stop at the end of the file. natural ending, credits roll, beautiful 🦋

And okay this part is lowkey iconic: passing a NULL pointer will stop whatever music is currently playing. yes bestie, silence is also a valid request, we respect it 💜

⭐ RETURN VALUE ⭐

Returns non-zero if an error occurs 😭

When might that happen?? well, it may happen if a patch-caching wavetable driver is unable to load the required samples. or at least it might in the future when somebody writes some patch-caching wavetable drivers :-) — that's literally what the docs say, i'm not making this up, the parentheses smiley is canon 🙈

🫶 SEE ALSO 🫶

• install_sound(3)
• load_midi(3)
• play_looped_midi(3)
• stop_midi(3)
• midi_pause(3)
• midi_seek(3)
• midi_pos(3)
• midi_time(3)
• midi_msg_callback(3)
• exmidi(3)

and that's the whole page, bestie 🌈 this one came from the Allegro manual, version 4.4.3 — go read the whole crew, they all ate 💖✨🎀