Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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,  uint16_t rate, uint16_t op-
       tions)

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

       config-file
	      The file that contains the instrument configuration for the  li-
	      brary.

       rate   The  sound rate you want the the audio data output at. Rates ac-
	      cepted by	libWildMidi are	11025 -	65000.

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

	      WM_MO_LOG_VOLUME
		     By	default	the library uses linear	 volume	 levels	 typi-
		     cally  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 op-
		     tion 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  en-
		     ables  the	 library  to  use a resampling method that at-
		     tempts 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.

	      WM_MO_WHOLETEMPO
		     Ignores  the  fractional  or decimal part of a tempo set-
		     ting.   If	  you	are   having   timing	 issues	   try
		     WM_MO_ROUNDTEMPO  before  trying this option. This	option
		     added due to some software	not supporting fractional tem-
		     pos allowable in the MIDI specification.

	      WM_MO_ROUNDTEMPO
		     Rounds the	fractional or decimal part of a	tempo setting.
		     Try this option is	you are	having timing issues, if  this
		     fails then	try WM_MO_WHOLETEMPO. This option added	due to
		     some  software not	supporting fractional tempos allowable
		     in	the MIDI specification.

SEE ALSO
       WildMidi_GetVersion(3),	 WildMidi_MasterVolume(3),   WildMidi_Open(3),
       WildMidi_OpenBuffer(3),	WildMidi_SetOption(3),	WildMidi_GetOutput(3),
       WildMidi_GetMidiOutput(3),  WildMidi_GetInfo(3),	 WildMidi_FastSeek(3),
       WildMidi_Close(3), WildMidi_Shutdown(3),	wildmidi.cfg(5)

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

COPYRIGHT
       Copyright (C) WildMidi Developers 2001-2016

       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 Cre-
       ative Commons, 171 Second Street, Suite 300, San	Francisco, California,
       94105, USA.

				 10 March 2016		      WildMidi_Init(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=WildMidi_Init&sektion=3&manpath=FreeBSD+Ports+14.3.quarterly>

home | help