.\" Generated by the Allegro makedoc utility
.TH play_midi 3alleg4 "version 4.4.3" "Allegro" "Allegro manual"
.SH NAME
play_midi \- Starts playing the specified MIDI file. Allegro game programming library.\&
.SH SYNOPSIS
.B #include <allegro.h>

.sp
.B int play_midi(MIDI *midi, int loop);
.SH 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.
.SH "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 :-)

.SH SEE ALSO
.BR install_sound (3alleg4),
.BR load_midi (3alleg4),
.BR play_looped_midi (3alleg4),
.BR stop_midi (3alleg4),
.BR midi_pause (3alleg4),
.BR midi_seek (3alleg4),
.BR midi_pos (3alleg4),
.BR midi_time (3alleg4),
.BR midi_msg_callback (3alleg4),
.BR exmidi (3alleg4)