WildMidi_Init(3)					   WildMidi Programmer's Manual 					  WildMidi_Init(3)

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  Founda-
       tion, 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,  Califor-
       nia, 94105, USA.

								   05 June 2010 						  WildMidi_Init(3)