wildmidi.cfg(5) WildMidi Config File wildmidi.cfg(5)NAMEwildmidi.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 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 Ulstrasound 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 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 ALSOWildMidi_GetString(3), WildMidi_Init(3), WildMidi_MasterVolume(3),
WildMidi_Open(3), WildMidi_OpenBuffer(3), WildMidi_SetOption(3), Wild‐
Midi_GetOutput(3), WildMidi_GetInfo(3), WildMidi_FastSeek(3), Wild‐
Midi_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 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.
09 July 2010 wildmidi.cfg(5)