NAME¶
play_midi - Starts playing the specified MIDI file. Allegro game programming
library.
SYNOPSIS¶
#include <allegro.h>
int play_midi(MIDI *midi, int loop);
DESCRIPTION¶
Starts playing the specified MIDI file, first stopping whatever music was
previously playing. If the loop flag is set to non-zero, the data will be
repeated until replaced with something else, otherwise it will stop at the end
of the file. Passing a NULL pointer will stop whatever music is currently
playing.
RETURN VALUE¶
Returns non-zero if an error occurs (this 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 :-)
SEE ALSO¶
install_sound(3alleg4), load_midi(3alleg4),
play_looped_midi(3alleg4), stop_midi(3alleg4),
midi_pause(3alleg4), midi_seek(3alleg4),
midi_pos(3alleg4), midi_time(3alleg4),
midi_msg_callback(3alleg4), exmidi(3alleg4)