Provided by: libwildmidi1_0.2.3.4-1_i386 bug

NAME

       wildmidi.cfg - Config file for libWildMidi

LIBRARY

       libWildMidi

DESCRIPTION

       Contains the patch configuration for libWildMidi and location of Gravis
       Ultrasound compatible patch files.

       dir ~/guspats/

       source /etc/wildmidi.cfg

       bank 0
       0 acpiano.pat amp=110 env_time4=300
       1 brpiano.pat amp=100

       drumset 0
       25 snarerol keep=env amp=225 note=60
       26 snap   note=65

SYNTAX

       guspat_editor_author_cant_read_so_fix_release_time_for_me
              Some patch file editors switch the 4th and 5th envelopes  around
              making  the sould play much longer than intended in players that
              stuck to the Gravis Ultrasound patch  standard.  Including  this
              option  in the config enables a fix that detects this oversight,
              playing the sound samples as if they were correct.

              NOTE: This is a global setting. If it is found  to  affect  good
              patch  samples  it  will  be  moved  to a per patch setting in a
              future version.

       auto_amp
              Forces WildMIDI  to  amplify  samples  to  their  maximum  level
              ignoring the amp=% in the patch lines of the config.

       auto_amp_with_amp
              Forces  WildMIDI  to amplify samples to their maximum level then
              apply the amp=% in the patch lines of the config.

       dir dir-name
              Change the search path for config and patch files  to  dir-name.
              This  is  specific to the current config file and carried to any
              included config file unless they have their own dir setting. Any
              included  file  that has its own dir setting does not effect the
              dir setting of the current config file.

       source include-confg
              Include the settings from include-config. Any patch already  set
              will be over-ridden by the included config file.

       bank N The  patches  following  this  setting belong to MIDI instrument
              bank N.

       drumset N
              The patches following this setting belong to MIDI drum bank N.

       patchno patchfile [amp=volume] [note=miodinte]  [keep=loop]  [keep=env]
       [remove=sustain]         [remove=clamped]        [env_level[0-5]=level]
       [env_time[0-5]=time]

       Example: 0 acpiano.pat amp=110

              patchno
                     This is the MIDI patch number the instrument belongs to.

              patchfile
                     The filename of the Gravis Ulstrasound  compatible  patch
                     file.  If  the  filename  is  missing the .pat extension,
                     libWildMidi will add .pat when  attempting  to  load  the
                     file.

              amp=volume
                     Force  the  volume of the samples in this patch to volume
                     prior to using it.

              note=midinote
                     Use note midinote when playing the samples in this patch.
                     NOTE: this is for instruments listed under drumset.

              keep=loop
                     Play  the  samples  in  this  patch  with  the loop, when
                     normally we would not for this instrument.

              keep=env
                     Use the envelope data in this  patch,  when  normally  we
                     wouldn't for this instrument.

              remove=sustain
                     Do  note  hold the note after the 3rd envelope until note
                     off, which is what happens if the sustain bit is  set  in
                     the patch file.

              remove=clamped
                     Do  not  jump  to 6th envelope on note off, which is what
                     happens if the clamped bit is set in the patch file.

              env_level[0-5]=level
                     Set the envelope level to level with 1.0  being  maximum,
                     and 0.0 being minimum.

                     Example:    set    5th    envelope   level   to   10%   -
                     env_level[0-5]=0.1

              env_time[0-5]=time
                     Set the envelope  time  to  time  with  a  resolution  of
                     1/1000th  of a second. This setting is the time it should
                     take for the envelope to reach maximum level.

                     Example: set 1st enevelope time to 1sec - env_time0=1000

                     Example: set 3rd enevelope time to 0.5secs- env_time2=500

       reverb_room_width fval
              Set the room width for the reverb engine in meters.  fval  is  a
              float  value  in  meters. Minimum setting is 1.0 meters, maximum
              setting is 100.0 meters, and default is 15.0 meters.

              Example: set room width to 30 meters - reverb_room_width 30

       reverb_room_length fval
              Set the room length for the reverb engine in meters. fval  is  a
              float  value in meters. . Minimum setting is 1.0 meters, maximum
              setting is 100.0 meters, and default is 20.0 meters.

              Example: set room length to 40 meters - reverb_room_length 40

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)

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.

                                 09 July 2010                  wildmidi.cfg(5)