midievents

MIDIEvents

MIDIEvents is a helper intended to help working with MIDI events. MIDIEvents is the base project for MIDIFile and MIDIPlayer.

MIDIEvents can be used either in modern browsers (pick the last bundle) or with NodeJS by installing the following NPM module :

npm install midievents

What it does

• Decode midi events
• Check midi events (using strictMode)
• Calculate needed buffer to encode midi events
• Encode midi events

What it doesn't do

• Reading MIDI files. It's the role of the MIDIFile project.
• Playing MIDI files. It's the role of the MIDIPlayer project.

Usage

// Your variable with an ArrayBuffer instance containing your MIDI events
var anyBuffer;

// MIDI events parser
var event, events=[], parser;
parser=new MIDIEvents.createParser(
  new DataView(anyBuffer),
    0, false);
event=parser.next();
do {
  events.push(event);
  event=parser.next();
} while(event);

// Check bufffer size before encodng
if(anyBuffer.length >= MIDIEvents.getRequiredBufferLength(events)) {
  console.log('ok');
}

// Encode MIDI events
var destination = new Uint8Array(anyBuffer);
MIDIEvents.writeToTrack(events, destination);

Contributing / Testing

Install them and run the following command :

npm install --dev
su npm install grunt-cli -g
grunt test

Contributing

• Feel free to PR
• If you find MIDI events the library can't read, create a test an do a pull request. I'll work on it asap.

License

Copyright Nicolas Froidure 2013. MIT licence.