.TH wildmidi.cfg 5 "10 March 2016" "" "WildMidi Config File" .SH NAME wildmidi.cfg \- Config file for libWildMidi .PP .SH LIBRARY .B libWildMidi .PP .SH DESCRIPTION Contains the patch configuration for libWildMidi and location of Gravis Ultrasound compatible patch files. .PP .nf 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 .fi .PP .SH SYNTAX .IP "\fBguspat_editor_author_cant_read_so_fix_release_time_for_me\fP" 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. .IP 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. .PP .IP "\fBauto_amp\fP" Forces WildMIDI to amplify samples to their maximum level ignoring the amp=% in the patch lines of the config. .PP .IP "\fBauto_amp_with_amp\fP" Forces WildMIDI to amplify samples to their maximum level then apply the amp=% in the patch lines of the config. .PP .IP "\fBdir\fP \fIdir\-name\fP" Change the search path for config and patch files to \fIdir\-name\fP. This is specific to the current config file and carried to any included config file unless they have their own \fBdir\fP setting. Any included file that has its own \fBdir\fP setting does not effect the \fBdir\fP setting of the current config file. .PP .IP "\fBsource\fP \fIinclude\-confg\fP" Include the settings from \fIinclude\-config\fP. Any patch already set will be over\-ridden by the included config file. .PP .IP "\fBbank\fP \fIN\fP" The patches following this setting belong to MIDI instrument bank \fIN\fP. .PP .IP "\fBdrumset\fP \fIN\fP" The patches following this setting belong to MIDI drum bank \fIN\fP. .PP .IP "\fIpatchno\fP \fIpatchfile\fP [\fBamp=\fP\fIvolume\fP] [\fBnote=\fP\fImiodinte\fP] [\fBkeep=loop\fP] [\fBkeep=env\fP] [\fBremove=sustain\fP] [\fBremove=clamped\fP] [\fBenv_level\fP[\fI0\-5\fP]\fB=\fP\fIlevel\fP] [\fBenv_time\fP[\fI0\-5\fP]\fB=\fP\fItime\fP]" .PP Example: 0 acpiano.pat amp=110 .PP .RS .IP "\fIpatchno\fP" This is the MIDI patch number the instrument belongs to. .PP .IP "\fIpatchfile\fP" The filename of the Gravis Ultrasound compatible patch file. If the filename is missing the .pat extension, libWildMidi will add .pat when attempting to load the file. .PP .IP "\fBamp=\fP\fIvolume\fP" Force the volume of the samples in this patch to \fIvolume\fP% prior to using it. .PP .IP "\fBnote=\fP\fImidinote\fP" Use note \fImidinote\fP when playing the samples in this patch. NOTE: this is for instruments listed under drumset. .PP .IP "\fBkeep=loop\fP" Play the samples in this patch with the loop, when normally we would not for this instrument. .PP .IP "\fBkeep=env\fP" Use the envelope data in this patch, when normally we wouldn't for this instrument. .PP .IP "\fBremove=sustain\fP" 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. .PP .IP "\fBremove=clamped\fP" Do not jump to 6th envelope on note off, which is what happens if the clamped bit is set in the patch file. .PP .IP "\fBenv_level\fP[\fI0\-5\fP]\fB=\fP\fIlevel\fP" Set the envelope level to \fIlevel\fP with 1.0 being maximum, and 0.0 being minimum. .IP Example: set 5th envelope level to 10% \- \fBenv_level[0\-5]=\fP0.1 .PP .IP "\fBenv_time\fP[\fI0\-5\fP]\fB=\fP\fItime\fP" Set the envelope time to \fItime\fP with a resolution of 1/1000th of a second. This setting is the time it should take for the envelope to reach maximum level. .IP Example: set 1st envelope time to 1sec \- \fBenv_time0=\fP1000 .IP Example: set 3rd envelope time to 0.5secs \- \fBenv_time2=\fP500 .RE .PP .IP "\fBreverb_room_width\fP \fIfval\fP" Set the room width for the reverb engine in meters. \fIfval\fP is a float value in meters. Minimum setting is 1.0 meter, maximum setting is 100.0 meters, and default is 15.0 meters. .IP Example: set room width to 30 meters \- \fBreverb_room_width 30\fP .PP .IP "\fBreverb_room_length\fP \fIfval\fP" Set the room length for the reverb engine in meters. \fIfval\fP is a float value in meters. Minimum setting is 1.0 meter, maximum setting is 100.0 meters, and default is 20.0 meters. .IP Example: set room length to 40 meters \- \fBreverb_room_length 40\fP .PP .SH SEE ALSO .BR wildmidi (1) .PP .SH AUTHOR Chris Ison Bret Curtis .PP .SH COPYRIGHT Copyright (C) Chris Ison 2001\-2010 Copyright (C) Bret Curtis 2013\-2016 .PP This file is part of WildMIDI. .PP 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. .PP 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. .PP 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 . .PP 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. .PP