WildMidi_FastSeek

Section: WildMidi Programmer's Manual (3)
Updated: 10 March 2016
Page Index

NAME

WildMidi_FastSeek - Move to a position in a midi file

LIBRARY

libWildMidi

SYNOPSIS

#include <wildmidi_lib.h>

int WildMidi_FastSeek (midi *handle, unsigned long 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 identifier 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 that's already been passed forcing the library to start from the beginning.

AUTHOR

Chris Ison <chrisisonwildcode@gmail.com> Bret Curtis <psi29a@gmail.com>

COPYRIGHT

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.