__________________________________________________________________________
	INFO ABOUT PERCUSSION MAPPING
	- - - - - - - - - - - - - - -

For each percussive note that tries to play, one of three things may
happen:

1. Bawami knows how to play this percussive note (e.g. 035 = Kick 1), and
   will play it (no percmap file is needed).
2. Bawami doesn't know how to play this percussive note, but it will act
   as if it is a different (supported) percussive note and play that other
   percussive note instead (e.g. play percussive note 016 as if it is 035
   = Kick 1).
3. Bawami doesn't know how to play this percussive note, and will act as
   if it is an ordinary tone instrument playing a specific note (e.g. play
   percussive note 085 as if it is instrument 123 (Bird Tweet) playing
   musical note G#1).

The files in this "percmap" folder specify how certain unsupported
percussive notes will be played (the filename specifies the percussive
note number, and must be padded to 3 digits).


__________________________________________________________________________
	REMAPPING TO A SUPPORTED PERCUSSIVE NOTE
	- - - - - - - - - - - - - - - - - - - - -

Files with the line "REMAP xxx" will cause a percussive note to play as if
it is percussive note "xxx". For example, a file named 016.txt, containing
the text:
REMAP 035
...will cause percussive note 016 (unsupported) to play as percussive note
035 (Kick 1). The number "xxx" must be padded to 3 digits.

Remapping to already-remapped (normally-unsupported) notes doesn't work.
Please only remap to percussive notes that are supported within Bawami, to
avoid notes not being played.

Supported percussive notes are:
	035 = Kick 1
	036 = Kick 2
	038 = Snare 1
	039 = Clap
	040 = Snare 2
	041 = Tom Floor-Low
	042 = Hihat Closed
	043 = Tom Floor-High
	044 = Hihat Pedal
	045 = Tom Low
	046 = Hihat Open
	047 = Tom Mid-Low
	048 = Tom Mid-High
	049 = Crash 1
	050 = Tom High
	051 = Ride Cymbal 1
	053 = Ride Bell 1
	057 = Crash 2
	059 = Ride Cymbal 2
	067 = Agogo High
	068 = Agogo Low
	069 = Cabasa
	070 = Maracas
	080 = Triangle Closed
	081 = Triangle Open
	082 = Shaker


__________________________________________________________________________
	REMAPPING TO A NOTE ON A TONE INSTRUMENT
	- - - - - - - - - - - - - - - - - - - - -

Files with the line "TONE xxx nnn" will cause a percussive note to play as
a specific note on a specific tone instrument (an instrument in the "inst"
folder in Bawami's program folder). The instrument can be a standard GM
instrument (one group of 3 digits), or a variation instrument (3 groups of
3 digits). For example, a file named 085.txt, containing the text:
TONE 123 020
...will cause percussive note 085 (unsupported) to play as instrument 123
(Bird Tweet) playing MIDI note 020 (musical note G#1).

A file named 091.txt, containing the text:
TONE 122_002_001 041
...will cause percussive note 091 (unsupported) to play as MIDI note 041
(musical note F3) on variation instrument 122_002_001 (Thunder).

NOTE: It is not possible to apply distortion to a single percussive note
      due to the fact that distortion is applied to whole MIDI channels.
      So, if you remap to a tone instrument that is supposed to use
      distortion, distortion will not be applied.

List of MIDI note numbers:
	000 = C 0         032 = G#2         064 = E 5         096 = C 8 
	001 = C#0         033 = A 2         065 = F 5         097 = C#8 
	002 = D 0         034 = A#2         066 = F#5         098 = D 8 
	003 = D#0         035 = B 2         067 = G 5         099 = D#8 
	004 = E 0         036 = C 3         068 = G#5         100 = E 8 
	005 = F 0         037 = C#3         069 = A 5         101 = F 8 
	006 = F#0         038 = D 3         070 = A#5         102 = F#8 
	007 = G 0         039 = D#3         071 = B 5         103 = G 8 
	008 = G#0         040 = E 3         072 = C 6         104 = G#8 
	009 = A 0         041 = F 3         073 = C#6         105 = A 8 
	010 = A#0         042 = F#3         074 = D 6         106 = A#8 
	011 = B 0         043 = G 3         075 = D#6         107 = B 8 
	012 = C 1         044 = G#3         076 = E 6         108 = C 9 
	013 = C#1         045 = A 3         077 = F 6         109 = C#9 
	014 = D 1         046 = A#3         078 = F#6         110 = D 9 
	015 = D#1         047 = B 3         079 = G 6         111 = D#9 
	016 = E 1         048 = C 4         080 = G#6         112 = E 9 
	017 = F 1         049 = C#4         081 = A 6         113 = F 9 
	018 = F#1         050 = D 4         082 = A#6         114 = F#9 
	019 = G 1         051 = D#4         083 = B 6         115 = G 9 
	020 = G#1         052 = E 4         084 = C 7         116 = G#9 
	021 = A 1         053 = F 4         085 = C#7         117 = A 9 
	022 = A#1         054 = F#4         086 = D 7         118 = A#9 
	023 = B 1         055 = G 4         087 = D#7         119 = B 9 
	024 = C 2         056 = G#4         088 = E 7         120 = C 10
	025 = C#2         057 = A 4         089 = F 7         121 = C#10
	026 = D 2         058 = A#4         090 = F#7         122 = D 10
	027 = D#2         059 = B 4         091 = G 7         123 = D#10
	028 = E 2         060 = C 5         092 = G#7         124 = E 10
	029 = F 2         061 = C#5         093 = A 7         125 = F 10
	030 = F#2         062 = D 5         094 = A#7         126 = F#10
	031 = G 2         063 = D#5         095 = B 7         127 = G 10


__________________________________________________________________________
	SETTING THE NAME OF THE PERCUSSIVE NOTE
	- - - - - - - - - - - - - - - - - - - -

Even if you have successfully remapped the unsupported percussive note to
a supported one, or to a note on a tone instrument, the note will still
show up with the name "Unsupported perc" (the contents of file 043.txt in
the folder "lang\English\message") on the MIDI Messages view. To give the
now-remapped percussive instrument your own name (this will not affect the
sound), you can create a text file in the folder "lang\English\percname".
The name of the file must be the percussive note number (padded to 3
digits), and the contents of the file will be shown as the percussive
note's name. For example, a file named 089.txt, containing the text:
Clock Tick
...will cause the note to show up as "(Clock Tick)" on the MIDI Messages
view (and in debuglog.txt, if logging of MIDI messages is enabled).

Note that this file should exist in "lang\English\percname" even if you
will be using a different language. "English" is a special-case, default
language that Bawami will look in if a file is missing from another
language. It will automatically be copied the folders of other languages
when the language is loaded (i.e. when you select the other language from
the configuration window, or when Bawami starts running).