play_midi (3) - Linux Manuals

play_midi: Starts playing the specified MIDI file. Allegro game programming library.

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(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)

Pages related to play_midi

  • play_memory_fli (3) - Plays a FLI or FLC animation from memory. Allegro game programming library.
  • play_audio_stream (3) - Creates a new audio stream and starts playing it. Allegro game programming library.
  • play_fli (3) - Plays a FLI or FLC animation from disk. Allegro game programming library.
  • play_looped_midi (3) - Starts playing a MIDI file with a user-defined loop position. Allegro game programming library.
  • play_sample (3) - Plays a sample. Allegro game programming library.