1wildmidi.cfg(5) WildMidi Config File wildmidi.cfg(5)
2
6 wildmidi.cfg - Config file for libWildMidi
7
9 libWildMidi
10
12 Contains the patch configuration for libWildMidi and location of Gravis
13 Ultrasound compatable patch files.
14 dir ~/guspats/
16 source /etc/wildmidi.cfg
18 bank 0
20 0 acpiano.pat amp=110 env_time4=300
21 1 brpiano.pat amp=100
22 drumset 0
24 25 snarerol keep=env amp=225 note=60
25 26 snap note=65
26
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 sould 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 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 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 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 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 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 bank N The patches following this setting belong to MIDI instrument
59 bank N.
60 drumset N
62 The patches following this setting belong to MIDI drum bank N.
63 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 Example: 0 acpiano.pat amp=110
69 This is the MIDI patch number the instrument belongs to.
71 The filename of the Gravis Ulstrasound compatable patch file. If
73 the filename is missing the .pat extention, libWildMidi will add
74 .pat when attempting to load the file.
75 amp=volume
77 Force the volume of the samples in this patch to volume
78 prior to using it.
79 note=midinote
81 Use note midinote when playing the samples in this patch.
82 NOTE: this is for instruments listed under drumset.
83 keep=loop
85 Play the samples in this patch with the loop, when nor‐
86 mally we would not for this instrument.
87 keep=env
89 Use the envelope data in this patch, when normally we
90 wouldn't for this instrument.
91 remove=sustain
93 Do note hold the note after the 3rd envelope until note
94 off, which is what happens if the sustain bit is set in
95 the patch file.
96 remove=clamped
98 Do not jump to 6th envelope on note off, which is what
99 happens if the clamped bit is set in the patch file.
100 env_level[0-5]=level
102 Set the envelope level to level with 1.0 being maximum,
103 and 0.0 being minimum.
104 Example: set 5th envelope level to 10% -
106 env_level[0-5]=0.1
107 env_time[0-5]=time
109 Set the envelope time to time with a resolution of
110 1/1000th of a second. This setting is the time it should
111 take for the envelope to reach maximum level.
112 Example: set 1st enevelope time to 1sec - env_time0=1000
114 Example: set 3rd enevelope time to 0.5secs- env_time2=500
116 reverb_room_width fval
118 Set the room width for the reverb engine in meters. fval is a
119 float value in meters. Minimum setting is 1.0 meters, maximum
120 setting is 100.0 meters, and default is 15.0 meters.
121 Example: set room width to 30 meters - reverb_room_width 30
123 reverb_room_length fval
125 Set the room length for the reverb engine in meters. fval is a
126 float value in meters. . Minimum setting is 1.0 meters, maximum
127 setting is 100.0 meters, and default is 20.0 meters.
128 Example: set room length to 40 meters - reverb_room_length 40
130
132 WildMidi_GetString(3), WildMidi_Init(3), WildMidi_MasterVolume(3),
133 WildMidi_Open(3), WildMidi_OpenBuffer(3), WildMidi_SetOption(3), Wild‐
134 Midi_GetOutput(3), WildMidi_GetInfo(3), WildMidi_FastSeek(3), Wild‐
135 Midi_Close(3), WildMidi_Shutdown(3), wildmidi(1)
136
138 Chris Ison <wildcode@users.sourceforge.net>
139
141 Copyright (C) Chris Ison 2001-2010
142 This file is part of WildMIDI.
144 WildMIDI is free software: you can redistribute and/or modify the
146 player under the terms of the GNU General Public License and you can
147 redistribute and/or modify the library under the terms of the GNU
148 Lesser General Public License as published by the Free Software Founda‐
149 tion, either version 3 of the licenses, or(at your option) any later
150 version.
151 WildMIDI is distributed in the hope that it will be useful, but WITHOUT
153 ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
154 FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
155 and the GNU Lesser General Public License for more details.
156 You should have received a copy of the GNU General Public License and
158 the GNU Lesser General Public License along with WildMIDI. If not, see
159 <http://www.gnu.org/licenses/>.
160 This manpage is licensed under the Creative Commons Attribution-Share
162 Alike 3.0 Unported License. To view a copy of this license, visit
163 http://creativecommons.org/licenses/by-sa/3.0/ or send a letter to Cre‐
164 ative Commons, 171 Second Street, Suite 300, San Francisco, California,
165 94105, USA.
166 09 July 2010 wildmidi.cfg(5)