1WildMidi_Init(3)         WildMidi Programmer's Manual         WildMidi_Init(3)
2
3
4

NAME

6       WildMidi_Init - Initialize the library
7

LIBRARY

9       libWildMidi
10

SYNOPSIS

12       #include <wildmidi_lib.h>
13
14       WildMidi_Init   (const   char  *config_file,  uint16_t  rate,  uint16_t
15       options)
16

DESCRIPTION

18       Initializes libWildMidi in preparation for playback. This function only
19       needs to be called once by the program using libWildMidi.
20
21       config-file
22              The  file  that  contains  the  instrument configuration for the
23              library.
24
25       rate   The sound rate you want the the  audio  data  output  at.  Rates
26              accepted by libWildMidi are 11025 - 65000.
27
28       options
29              The initial options to set for the library. see below.
30
31              WM_MO_LOG_VOLUME
32                     By  default  the  library uses linear volume levels typi‐
33                     cally used in computer MIDI  players.  These  can  differ
34                     somewhat  to  volume  levels  found on some midi hardware
35                     which may use a volume  curve  based  on  decibels.  This
36                     option  sets  the  volume  levels to what you'd expect on
37                     such devices.
38
39              WM_MO_ENHANCED_RESAMPLING
40                     By default libWildMidi uses linear interpolation for  the
41                     resampling  of  the  sound  samples.  Setting this option
42                     enables the library  to  use  a  resampling  method  that
43                     attempts to fill in the gaps giving richer sound.
44
45              WM_MO_REVERB
46                     libWildMidi  has  an 8 reflection reverb engine. Use this
47                     option to give more depth to the output.
48
49              WM_MO_WHOLETEMPO
50                     Ignores the fractional or decimal part of  a  tempo  set‐
51                     ting.    If    you   are   having   timing   issues   try
52                     WM_MO_ROUNDTEMPO before trying this option.  This  option
53                     added due to some software not supporting fractional tem‐
54                     pos allowable in the MIDI specification.
55
56              WM_MO_ROUNDTEMPO
57                     Rounds the fractional or decimal part of a tempo setting.
58                     Try  this option is you are having timing issues, if this
59                     fails then try WM_MO_WHOLETEMPO. This option added due to
60                     some  software not supporting fractional tempos allowable
61                     in the MIDI specification.
62

SEE ALSO

64       WildMidi_GetVersion(3),   WildMidi_MasterVolume(3),   WildMidi_Open(3),
65       WildMidi_OpenBuffer(3),  WildMidi_SetOption(3),  WildMidi_GetOutput(3),
66       WildMidi_GetMidiOutput(3),  WildMidi_GetInfo(3),  WildMidi_FastSeek(3),
67       WildMidi_Close(3), WildMidi_Shutdown(3), wildmidi.cfg(5)
68

AUTHOR

70       Chris Ison <chrisisonwildcode@gmail.com> Bret Curtis <psi29a@gmail.com>
71
73       Copyright (C) WildMidi Developers 2001-2016
74
75       This file is part of WildMIDI.
76
77       WildMIDI  is  free  software:  you  can  redistribute and/or modify the
78       player under the terms of the GNU General Public License  and  you  can
79       redistribute  and/or  modify  the  library  under  the terms of the GNU
80       Lesser General Public License as published by the Free Software Founda‐
81       tion,  either  version  3 of the licenses, or(at your option) any later
82       version.
83
84       WildMIDI is distributed in the hope that it will be useful, but WITHOUT
85       ANY  WARRANTY;  without even the implied warranty of MERCHANTABILITY or
86       FITNESS FOR A PARTICULAR PURPOSE. See the GNU  General  Public  License
87       and the GNU Lesser General Public License for more details.
88
89       You  should  have received a copy of the GNU General Public License and
90       the GNU Lesser General Public License along with WildMIDI. If not,  see
91       <http://www.gnu.org/licenses/>.
92
93       This  manpage  is licensed under the Creative Commons Attribution-Share
94       Alike 3.0 Unported License. To view  a  copy  of  this  license,  visit
95       http://creativecommons.org/licenses/by-sa/3.0/ or send a letter to Cre‐
96       ative Commons, 171 Second Street, Suite 300, San Francisco, California,
97       94105, USA.
98
99                                 10 March 2016                WildMidi_Init(3)
Impressum