Klavar Ascii Notation (KAN)
===========================

What is it? KAN is sort of plain text Pianoroll Format.

Implemented is the span of the Yamaha HC-2 organ, note numbers 36-96.
Here is an example of a tiny piece of music with pedal, lower & upper
keyboard:

File 0 (1) 120
Track #0
  120 4: :  : : :  : :  :2: : 2: :3 : : : 1: :  : : :  : :  : : :  |
  120  : : 4: : :  : :  : :2: 2: : 2: :1: 1: :  : : :  : :  : : :  |
  120  : :  :4: :  : :  :2: :2 :2: 2:1: :1 : :  : : :  : :  : : :  |
  240 4: :  : : :  : :  :2: : 2: :3 :1: : 1: :  : : :  : :  : : :  |
Meta $2F(TrkEnd)

The ':' denote the positions of the black keys on the keyboard.
(I didn't use bars '|', since this messes up with the notes '1')
Hence KAN is similar to Klavarskribo (Ridderkerk, Holland), with
relative time intervals denoted leftmost - in decimal notation.

Fixed field width: take care that the Klavar bars all line up.
The program KAN2NUL is not very forgiving if you don't commit
exactly to the format: 5 characters for a time stamp, 1 blank,
5 octaves, vertical bar, followed by lyrics eventually.

KAN is for 0-type midifiles ONLY
--------------------------------
1, 2, 4, 8 denote  2 ^ (MIDI channel number - 1) , as follows:
 1  =  2 ^ 0  ->  channel 1 (e.g. Upper Keyboard)
 2  =  2 ^ 1  ->  channel 2 (e.g. Lower Keyboard)
 4  =  2 ^ 2  ->  channel 3 (e.g. Pedal Keyboard)
 8  =  2 ^ 3  ->  channel 4 (e.g. Lead Voices)
These numbers can be mixed by addition (hexadecimal notation):
 3  =  2 + 1  =   channel 1 and channel 0 same note
 F  =  8 + 4 + 2 + 1 = all channels 0 ... 3 unisono
As a consequence, the maximum number of channels equals four (!).

Summarizing:

0   1   1   1   1   1   1   1   1
1     2 2     2 2     2 2     2 2
2         4 4 4 4         4 4 4 4
3                 8 8 8 8 8 8 8 8
---------------------------------
  0 1 2 3 4 5 6 7 8 9 A B C D E F

For the computer nerds among us: this is known as hexadecimal notation.
[Especially take notice of the empty four (silence), which is hex '0']
Klavar Ascii Notation can be mixed with other Midi/Meta events
in plain text format. See the description of "DTN" for this.

Oh yeah, and (*) in the first column makes it a comment line.

First part of a KAN file with embedded (homophonic) Lyrics, where some
LilyPond convention is adopted i.e. blank is represented by underscore:

File 0 (1) 120
Track #0
Meta $3 "Titel: Groter dan ons hart"
Meta $3 "Tekst: Huub Oosterhuis"
Meta $3 "Muziek: Antoine Oomen"
Meta $51(Tempo) 700000
  240  : :  : : :  : :  : : :  : :  : : :  : :  : : :  : :  : : :  |
Control $0 $7(Volume) $5F
Control $1 $7(Volume) $5F
Control $2 $7(Volume) $5F
* ----------------------------------------------------------------- een.kan
  240  : :  : : :  : :  : : :  : :  : : :  : :  : : :  : :  : : :  |
   60  : :  : : :  : :  : : :  : :  :4: :  : :  : : :  : :  : : :  | _Gij
    0  : :  : : :  : :  : : :  : :  : : :  : :  : : :  : :  : : :  |
   60  : :  : : :  : :  : : :  : :  :4: :  : :  : : :  : :  : : :  | _die
    0  : :  : : :  : :  : : :  : :  : : :  : :  : : :  : :  : : :  |
   60  : :  : : :  : :  : : :  : :  :4: :  : :  : : :  : :  : : :  | _ge
    0  : :  : : :  : :  : : :  : :  : : :  : :  : : :  : :  : : :  |
   60  : :  : : :  : :  : : :  : :  :4: :  : :  : : :  : :  : : :  | roe
    0  : :  : : :  : :  : : :  : :  : : :  : :  : : :  : :  : : :  |
   60  : :  : : :  : :  : : :  : :  :4: :  : :  : : :  : :  : : :  | pen
    0  : :  : : :  : :  : : :  : :  : : :  : :  : : :  : :  : : :  |
   60  : :  : : :  : :  : : :  : :  : 4 :  : :  : : :  : :  : : :  | _hebt
    0  : :  : : :  : :  : : :  : :  : : :  : :  : : :  : :  : : :  |
  120  : :  : : :  : :  : : :  : :  : : 4  : :  : : :  : :  : : :  | _"licht"
    0  : :  : : :  : :  : : :  : :  : : :  : :  : : :  : :  : : :  |