NAME¶
WildMidi_SetOption - Set a library option for a specific midi
LIBRARY¶
libWildMidi
SYNOPSIS¶
#include <wildmidi_lib.h>
int WildMidi_SetOption (midi *handle, unsigned short int
options, unsigned short int setting)
DESCRIPTION¶
Set a library option for a specific midi.
- handle
- The identifier obtained from opening a midi file with
WildMidi_Open(3) or
WildMidi_OpenBuffer(3)
options The option or options you wish to change.
- 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.
- setting
- To turn on an option, repeat that option here. To turn off an option, do
not put the option here.
- Example: To turn on Reverb
- WildMidi_SetOption(handle, WM_MO_REVERB, WM_MO_REVERB);
- Example: To turn off Reverb
- WildMidi_SetOption(handle, WM_MO_REVERB, 0);
- Example: To turn on Reverb and Enhanced Resampling
- WildMidi_SetOption(handle, (WM_MO_REVERB | WM_MO_ENHANCED_RESAMPLING),
(WM_MO_REVERB | WM_MO_ENHANCED_RESAMPLING));
RETURN VALUE¶
Returns -1 on error, otherwise returns 0.
SEE ALSO¶
WildMidi_GetString(3), WildMidi_Init(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.cfg(5)
AUTHOR¶
Chris Ison <wildcode@users.sf.net> Bret Curtis <psi29a@gmail.com>
COPYRIGHT¶
Copyright (C) Chris Ison 2001-2010 Copyright (C) Bret Curtis 2013-2014
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 Foundation, 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, California, 94105,
USA.