.\" Generated by the Allegro makedoc utility
.TH load_midi 3alleg4 "version 4.4.2" "Allegro" "Allegro manual"
.SH NAME
load_midi \- Loads a MIDI file. Allegro game programming library.\&
.SH SYNOPSIS
.B #include <allegro.h>

.sp
.B MIDI *load_midi(const char *filename);
.SH DESCRIPTION
Loads a MIDI file (handles both format 0 and format 1). Example:

.nf
   MIDI *music;
   music = load_midi("backmus.mid");
   if (!music)
      abort_on_error("Couldn't load background music!");
.fi
.SH "RETURN VALUE"
Returns a pointer to a MIDI structure, or NULL on error. Remember to free
this MIDI file later to avoid memory leaks.

.SH SEE ALSO
.BR destroy_midi (3alleg4),
.BR play_midi (3alleg4),
.BR get_midi_length (3alleg4),
.BR exmidi (3alleg4)