dwww Home | Manual pages | Find package

wildmidi.cfg(5)              WildMidi Config File              wildmidi.cfg(5)

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 sound 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 fu-
              ture version.

       auto_amp
              Forces WildMIDI to amplify samples to their maximum level ignor-
              ing 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  Ultrasound  compatible  patch
                     file. If the filename is missing the .pat extension, lib-
                     WildMidi 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  nor-
                     mally 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 envelope time to 1sec - env_time0=1000

                     Example: set 3rd envelope 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  meter,  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  meter,  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(1)

AUTHOR
       Chris Ison <wildcode@users.sf.net> Bret Curtis <psi29a@gmail.com>

COPYRIGHT
       Copyright (C) Chris Ison  2001-2010 Copyright (C) Bret Curtis 2013-2016

       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 Founda-
       tion,  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 Cre-
       ative Commons, 171 Second Street, Suite 300, San Francisco, California,
       94105, USA.

                                 10 March 2016                 wildmidi.cfg(5)

Generated by dwww version 1.15 on Wed Jun 26 05:46:47 CEST 2024.