bionic (3) midi_seek.3alleg4.gz

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

NAME
       midi_seek - Seeks to the given midi_pos in the current MIDI file. Allegro game programming library.


SYNOPSIS
       #include <allegro.h>

       int midi_seek(int target);


DESCRIPTION
       Seeks  to  the  given  midi_pos  in  the current MIDI file. If the target is earlier in the file than the
       current midi_pos it seeks from the beginning; otherwise it seeks from the current position.


RETURN VALUE
       Returns zero if it could successfully seek to the requested position.  Otherwise, a  return  value  of  1
       means  it  stopped  playing,  and midi_pos is set to the negative length of the MIDI file (so you can use
       this function to determine the length of a MIDI file). A return value of 2 means  the  MIDI  file  looped
       back to the start.


SEE ALSO
       play_midi(3alleg4), midi_pos(3alleg4)