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

NAME

6       WildMidi_SetOption - Set a library option for a specific midi
7

LIBRARY

9       libWildMidi
10

SYNOPSIS

12       #include <wildmidi_lib.h>
13
14       int  WildMidi_SetOption  (midi  *handle,  unsigned  short  int options,
15       unsigned short int setting)
16

DESCRIPTION

18       Set a library option for a specific midi.
19
20       handle The indentifier obtained from opening a  midi  file  with  Wild‐
21              Midi_Open(3) or WildMidi_OpenBuffer(3)
22
23       options The option or options you wish to change.
24
25              WM_MO_LOG_VOLUME
26                     By  default  the  library uses linear volume levels typi‐
27                     cally used in computer MIDI  players.  These  can  differ
28                     somewhat  to  volume  levels  found on some midi hardware
29                     which may use a volume  curve  based  on  decibels.  This
30                     option  sets  the  volume  levels to what you'd expect on
31                     such devices.
32
33              WM_MO_ENHANCED_RESAMPLING
34                     By default libWildMidi uses linear interpolation for  the
35                     resampling  of  the  sound  samples.  Setting this option
36                     enables the library  to  use  a  resampling  method  that
37                     attempts to fill in the gaps giving richer sound.
38
39              WM_MO_REVERB
40                     libWildMidi  has  an 8 reflection reverb engine. Use this
41                     option to give more depth to the output.
42
43       setting
44              To turn on an option, repeat that option here. To  turn  off  an
45              option, do not put the option here.
46
47       Example:
48              WildMidi_SetOption(handle, WM_MO_REVERB, WM_MO_REVERB);
49
50       Example:
51              WildMidi_SetOption(handle, WM_MO_REVERB, NULL);
52
53       Example:
54              WildMidi_SetOption(handle, (WM_MO_REVERB | WM_MO_ENHANCED_RESAM‐
55              PLING), (WM_MO_REVERB | WM_MO_ENHANCED_RESAMPLING));
56

RETURN VALUE

58       returns -1 on error, otherwise returns 0
59

SEE ALSO

61       WildMidi_GetString(3),   WildMidi_Init(3),    WildMidi_MasterVolume(3),
62       WildMidi_Open(3),  WildMidi_OpenBuffer(3), WildMidi_SetOption(3), Wild‐
63       Midi_GetOutput(3),  WildMidi_GetInfo(3),  WildMidi_FastSeek(3),   Wild‐
64       Midi_Close(3), WildMidi_Shutdown(3), wildmidi(1), wildmidi.cfg(5)
65

AUTHOR

67       Chris Ison <wildcode@users.sourceforge.net>
68

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