Provided by: libwildmidi-dev_0.2.3.4-2.1_i386 bug

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  indentifier  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, NULL);

       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(1), wildmidi.cfg(5)

AUTHOR

       Chris Ison <wildcode@users.sourceforge.net>

COPYRIGHT

       Copyright (C) Chris Ison 2001-2010

       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.

                                 05 June 2010            WildMidi_SetOption(3)