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 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,  play-
	      ing 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 ver-
	      sion.

       auto_amp
	      Forces WildMIDI to amplify samples to their maximum level ignoring 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, libWildMidi 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 normally 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 set-
	      ting is 100.0 meters, and default is 20.0 meters.

	      Example: set room length to 40 meters - reverb_room_length 40

SEE ALSO

       WildMidi_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), WildMidi_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 Creative Commons, 171 Second Street, Suite 300, San Francisco,  Califor-
       nia, 94105, USA.

								   09 July 2010 						   wildmidi.cfg(5)