.\" Generated by the Allegro makedoc utility
.TH get_midi_length 3alleg4 "version 4.4.3" "Allegro" "Allegro manual"
.SH NAME
get_midi_length \- Determines the total playing time of a midi, in seconds. Allegro game programming library.\&
.SH SYNOPSIS
.B #include <allegro.h>

.sp
.B int get_midi_length(MIDI *midi);
.SH DESCRIPTION
This function will simulate playing the given MIDI, from start to end, to
determine how long it takes to play. After calling this function, midi_pos
will contain the negative number of beats, and midi_time the length of the
midi, in seconds.

Note that any currently playing midi is stopped when you call this function.
Usually you would call it before play_midi, to get the length of the midi to
be played, like in this example:

.nf
   length = get_midi_length(my_midi);
   play_midi(my_midi);
   do {
      pos = midi_time;
      textprintf_ex(screen, font, 0, 0, c, -1, "%d:%02d / %d:%02d\\n",
         pos / 60, pos % 60, length / 60, length % 60);
      rest(100);
   } while(pos <= length);
.fi
.SH "RETURN VALUE"
Returns the value of midi_time, the length of the midi.

.SH SEE ALSO
.BR load_midi (3alleg4),
.BR midi_time (3alleg4),
.BR midi_pos (3alleg4),
.BR exmidi (3alleg4)