bionic (3) play_midi.3alleg4.gz

Provided by: allegro4-doc_4.4.2-10_all bug

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)