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)