NAME

       WildMidi_FastSeek - Move to a position in a midi file

LIBRARY

       libWildMidi

SYNOPSIS

       #include <wildmidi_lib.h>

       int WildMidi_FastSeek (midi *handle, unsigned short int *sample_pos);

DESCRIPTION

       Resets  all  note  specific  midi  states  and  active notes before scanning to sample_pos
       samples from the beginning taking note of any changes to midi  channel  states.  The  next
       call  to  WildMidi_GetOutput(3)  will  behave as if you started to play the midi from that
       position.

       handle The indentifier  obtained  from  opening  a  midi  file  with  WildMidi_Open(3)  or
              WildMidi_OpenBuffer(3)

       sample_pos
              The number of samples from the beginning you want libWildMidi to seek to.

       NOTE: significant delay can occur when using this function. You can expect even more delay
       if you select a position thats already been passed forcing the library to start  from  the
       beginning.

SEE ALSO

       WildMidi_GetString(3),   WildMidi_Init(3),   WildMidi_MasterVolume(3),   WildMidi_Open(3),
       WildMidi_OpenBuffer(3), WildMidi_SetOption(3), WildMidi_GetOutput(3), WildMidi_GetInfo(3),
       WildMidi_Close(3), WildMidi_Shutdown(3), wildmidi(1), wildmidi.cfg(5)

AUTHOR

       Chris Ison <wildcode@users.sourceforge.net>

COPYRIGHT

       Copyright (C) Chris Ison 2001-2010

       This file is part of WildMIDI.

       WildMIDI  is  free software: you can redistribute and/or modify the player under the terms
       of the GNU General Public License and you can redistribute and/or modify the library under
       the  terms  of  the  GNU  Lesser  General Public License as published by the Free Software
       Foundation, either version 3 of the licenses, or(at your option) any later version.

       WildMIDI is distributed in the hope that it will be  useful,  but  WITHOUT  ANY  WARRANTY;
       without  even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
       See the GNU General Public License and the GNU Lesser  General  Public  License  for  more
       details.

       You  should  have  received  a  copy  of the GNU General Public License and the GNU Lesser
       General Public License along with WildMIDI. If not, see <http://www.gnu.org/licenses/>.

       This manpage is licensed under the Creative Commons Attribution-Share Alike  3.0  Unported
       License.  To  view  a  copy of this license, visit http://creativecommons.org/licenses/by-
       sa/3.0/ or send a letter to Creative Commons, 171 Second Street, Suite 300, San Francisco,
       California, 94105, USA.

                                           05 June 2010                      WildMidi_FastSeek(3)