1wildmidi.cfg(5)              WildMidi Config File              wildmidi.cfg(5)
2
3
4

NAME

6       wildmidi.cfg - Config file for libWildMidi
7

LIBRARY

9       libWildMidi
10

DESCRIPTION

12       Contains the patch configuration for libWildMidi and location of Gravis
13       Ultrasound compatible patch files.
14
15       dir ~/guspats/
16
17       source /etc/wildmidi.cfg
18
19       bank 0
20       0 acpiano.pat amp=110 env_time4=300
21       1 brpiano.pat amp=100
22
23       drumset 0
24       25 snarerol keep=env amp=225 note=60
25       26 snap   note=65
26

SYNTAX

28       guspat_editor_author_cant_read_so_fix_release_time_for_me
29              Some patch file editors switch the 4th and 5th envelopes  around
30              making  the sound play much longer than intended in players that
31              stuck to the Gravis Ultrasound patch  standard.  Including  this
32              option  in the config enables a fix that detects this oversight,
33              playing the sound samples as if they were correct.
34
35              NOTE: This is a global setting. If it is found  to  affect  good
36              patch  samples  it  will  be  moved  to a per patch setting in a
37              future version.
38
39       auto_amp
40              Forces WildMIDI to amplify samples to their maximum level ignor‐
41              ing the amp=% in the patch lines of the config.
42
43       auto_amp_with_amp
44              Forces  WildMIDI  to amplify samples to their maximum level then
45              apply the amp=% in the patch lines of the config.
46
47       dir dir-name
48              Change the search path for config and patch files  to  dir-name.
49              This  is  specific to the current config file and carried to any
50              included config file unless they have their own dir setting. Any
51              included  file  that has its own dir setting does not effect the
52              dir setting of the current config file.
53
54       source include-confg
55              Include the settings from include-config. Any patch already  set
56              will be over-ridden by the included config file.
57
58       bank N The  patches  following  this  setting belong to MIDI instrument
59              bank N.
60
61       drumset N
62              The patches following this setting belong to MIDI drum bank N.
63
64       patchno patchfile [amp=volume] [note=miodinte]  [keep=loop]  [keep=env]
65       [remove=sustain]         [remove=clamped]        [env_level[0-5]=level]
66       [env_time[0-5]=time]
67
68       Example: 0 acpiano.pat amp=110
69
70              patchno
71                     This is the MIDI patch number the instrument belongs to.
72
73              patchfile
74                     The filename of the Gravis  Ultrasound  compatible  patch
75                     file. If the filename is missing the .pat extension, lib‐
76                     WildMidi will add .pat when attempting to load the file.
77
78              amp=volume
79                     Force the volume of the samples in this patch to  volume%
80                     prior to using it.
81
82              note=midinote
83                     Use note midinote when playing the samples in this patch.
84                     NOTE: this is for instruments listed under drumset.
85
86              keep=loop
87                     Play the samples in this patch with the loop,  when  nor‐
88                     mally we would not for this instrument.
89
90              keep=env
91                     Use  the  envelope  data  in this patch, when normally we
92                     wouldn't for this instrument.
93
94              remove=sustain
95                     Do note hold the note after the 3rd envelope  until  note
96                     off,  which  is what happens if the sustain bit is set in
97                     the patch file.
98
99              remove=clamped
100                     Do not jump to 6th envelope on note off,  which  is  what
101                     happens if the clamped bit is set in the patch file.
102
103              env_level[0-5]=level
104                     Set  the  envelope level to level with 1.0 being maximum,
105                     and 0.0 being minimum.
106
107                     Example:   set   5th   envelope   level    to    10%    -
108                     env_level[0-5]=0.1
109
110              env_time[0-5]=time
111                     Set  the  envelope  time  to  time  with  a resolution of
112                     1/1000th of a second. This setting is the time it  should
113                     take for the envelope to reach maximum level.
114
115                     Example: set 1st envelope time to 1sec - env_time0=1000
116
117                     Example: set 3rd envelope time to 0.5secs - env_time2=500
118
119       reverb_room_width fval
120              Set  the  room  width for the reverb engine in meters. fval is a
121              float value in meters. Minimum setting  is  1.0  meter,  maximum
122              setting is 100.0 meters, and default is 15.0 meters.
123
124              Example: set room width to 30 meters - reverb_room_width 30
125
126       reverb_room_length fval
127              Set  the  room length for the reverb engine in meters. fval is a
128              float value in meters. Minimum setting  is  1.0  meter,  maximum
129              setting is 100.0 meters, and default is 20.0 meters.
130
131              Example: set room length to 40 meters - reverb_room_length 40
132

SEE ALSO

134       wildmidi(1)
135

AUTHOR

137       Chris Ison <wildcode@users.sf.net> Bret Curtis <psi29a@gmail.com>
138
140       Copyright (C) Chris Ison  2001-2010 Copyright (C) Bret Curtis 2013-2016
141
142       This file is part of WildMIDI.
143
144       WildMIDI  is  free  software:  you  can  redistribute and/or modify the
145       player under the terms of the GNU General Public License  and  you  can
146       redistribute  and/or  modify  the  library  under  the terms of the GNU
147       Lesser General Public License as published by the Free Software Founda‐
148       tion,  either  version  3 of the licenses, or(at your option) any later
149       version.
150
151       WildMIDI is distributed in the hope that it will be useful, but WITHOUT
152       ANY  WARRANTY;  without even the implied warranty of MERCHANTABILITY or
153       FITNESS FOR A PARTICULAR PURPOSE. See the GNU  General  Public  License
154       and the GNU Lesser General Public License for more details.
155
156       You  should  have received a copy of the GNU General Public License and
157       the GNU Lesser General Public License along with WildMIDI. If not,  see
158       <http://www.gnu.org/licenses/>.
159
160       This  manpage  is licensed under the Creative Commons Attribution-Share
161       Alike 3.0 Unported License. To view  a  copy  of  this  license,  visit
162       http://creativecommons.org/licenses/by-sa/3.0/ or send a letter to Cre‐
163       ative Commons, 171 Second Street, Suite 300, San Francisco, California,
164       94105, USA.
165
166                                 10 March 2016                 wildmidi.cfg(5)
Impressum