NAME

       WildMidi_Init - Initialize the library

LIBRARY

       libWildMidi

SYNOPSIS

       #include <wildmidi_lib.h>

       WildMidi_Init  (const  char  *config_file,  unsigned  short  int  rate, unsigned short int
       options)

DESCRIPTION

       Intializes libWildMidi in preparation for playback. This function only needs to be  called
       once by the program using libWildMidi.

       config-file
              The file that contans the instrument configuation for the library.

       rate   The sound rate you want the the audio data output at. Rates accepted by libWildMidi
              are 11000 - 65000.

       options
              The initial options to set for the library. see below

              WM_MO_LOG_VOLUME
                     By default the library uses linear volume levels typically used in  computer
                     MIDI  players. These can differ somewhat to volume levels found on some midi
                     hardware which may use a volume curve based on decibels.  This  option  sets
                     the volume levels to what you'd expect on such devices.

              WM_MO_ENHANCED_RESAMPLING
                     By  default  libWildMidi uses linear interpolation for the resampling of the
                     sound samples. Setting this option enables the library to use  a  resampling
                     method that attempts to fill in the gaps giving richer sound.

              WM_MO_REVERB
                     libWildMidi  has an 8 reflection reverb engine. Use this option to give more
                     depth to the output.

SEE ALSO

       WildMidi_GetString(3), WildMidi_MasterVolume(3), WildMidi_Open(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_Init(3)