NAME

       WildMidi_Open - Open a midi file for processing

LIBRARY

       libWildMidi

SYNOPSIS

       #include <wildmidi_lib.h>

       midi *WildMidi_Open (const char *midifile)

DESCRIPTION

       Open a MIDI file pointed to by midifile for processing. This file must be in standard midi
       format.

RETURN VALUE

       Returns NULL on error and sends a message to stderr, otherwise returns a  handle  for  the
       midi  file  opened. This handle is used by most functions in libWildMidi to identify which
       midi file we are refering to.

SEE ALSO

       WildMidi_GetString(3), WildMidi_Init(3), WildMidi_MasterVolume(3), WildMidi_OpenBuffer(3),
       WildMidi_SetOption(3),  WildMidi_GetOutput(3),  WildMidi_GetInfo(3), WildMidi_FastSeek(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_Open(3)