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,  unsigned  short  int  rate,
15       unsigned short int options)
16

DESCRIPTION

18       Intializes 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  contans  the  instrument  configuation  for the
23              library.
24
25       rate   The sound rate you want the the  audio  data  output  at.  Rates
26              accepted by libWildMidi are 11000 - 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

SEE ALSO

50       WildMidi_GetString(3),   WildMidi_MasterVolume(3),    WildMidi_Open(3),
51       WildMidi_OpenBuffer(3),  WildMidi_SetOption(3),  WildMidi_GetOutput(3),
52       WildMidi_GetInfo(3),  WildMidi_FastSeek(3),  WildMidi_Close(3),   Wild‐
53       Midi_Shutdown(3), wildmidi(1), wildmidi.cfg(5)
54

AUTHOR

56       Chris Ison <wildcode@users.sourceforge.net>
57
59       Copyright (C) Chris Ison 2001-2010
60
61       This file is part of WildMIDI.
62
63       WildMIDI  is  free  software:  you  can  redistribute and/or modify the
64       player under the terms of the GNU General Public License  and  you  can
65       redistribute  and/or  modify  the  library  under  the terms of the GNU
66       Lesser General Public License as published by the Free Software Founda‐
67       tion,  either  version  3 of the licenses, or(at your option) any later
68       version.
69
70       WildMIDI is distributed in the hope that it will be useful, but WITHOUT
71       ANY  WARRANTY;  without even the implied warranty of MERCHANTABILITY or
72       FITNESS FOR A PARTICULAR PURPOSE. See the GNU  General  Public  License
73       and the GNU Lesser General Public License for more details.
74
75       You  should  have received a copy of the GNU General Public License and
76       the GNU Lesser General Public License along with WildMIDI. If not,  see
77       <http://www.gnu.org/licenses/>.
78
79       This  manpage  is licensed under the Creative Commons Attribution-Share
80       Alike 3.0 Unported License. To view  a  copy  of  this  license,  visit
81       http://creativecommons.org/licenses/by-sa/3.0/ or send a letter to Cre‐
82       ative Commons, 171 Second Street, Suite 300, San Francisco, California,
83       94105, USA.
84
85                                 05 June 2010                 WildMidi_Init(3)
Impressum