midi-message 0.2.2

data/lib/midi.yml

@@ -0,0 +1,337 @@
+Status:
+  Note Off: 0x8
+  Note On: 0x9
+  Polyphonic Aftertouch: 0xA
+  Control Change: 0xB
+  Program Change: 0xC
+  Channel Aftertouch: 0xD
+  Pitch Bend: 0xE
+  System Exclusive: 0xF0
+  System Common: [0xF1, 0xF2, 0xF3, 0xF4, 0xF5, 0xF6]
+  System Realtime: [0xF8, 0xF9, 0xFA, 0xFB, 0xFC, 0xFD, 0xFE, 0xFF]
+  
+Control Change:
+  Bank Select: 0
+  Modulation Wheel: 1
+  Breath Controller: 2
+  Foot Controller: 4
+  Portamento Time: 5
+  Data Entry MSB: 6
+  Channel Volume: 7
+  Balance: 8
+  Pan: 10
+  Expression Controller: 11
+  General Purpose Controllers: 16
+  General Purpose Controllers: 17
+  General Purpose Controllers: 18
+  General Purpose Controllers: 19
+  LSB for controller 0: 32
+  LSB for controller 1: 33
+  LSB for controller 2: 34
+  LSB for controller 3: 35
+  LSB for controller 4: 36
+  LSB for controller 5: 37
+  LSB for controller 6: 38
+  LSB for controller 7: 39
+  LSB for controller 8: 40
+  LSB for controller 9: 41
+  LSB for controller 10: 42
+  LSB for controller 11: 43
+  LSB for controller 12: 44
+  LSB for controller 13: 45
+  LSB for controller 14: 46
+  LSB for controller 15: 47
+  LSB for controller 16: 48
+  LSB for controller 17: 49
+  LSB for controller 18: 50
+  LSB for controller 19: 51
+  LSB for controller 20: 52
+  LSB for controller 21: 53
+  LSB for controller 22: 54
+  LSB for controller 23: 55
+  LSB for controller 24: 56
+  LSB for controller 25: 57
+  LSB for controller 26: 58
+  LSB for controller 27: 59
+  LSB for controller 28: 60
+  LSB for controller 29: 61
+  LSB for controller 30: 62
+  LSB for controller 31: 63
+  Sustain: 64
+  Hold Pedal: 64
+  Portamento: 65
+
+Control Mode:
+  All Sound Off: 120
+  All Controllers Off: 121
+  Local Keyboard Toggle: 122
+  All Notes Off: 123
+  Omni Off: 124
+  Omni On: 125
+  Mono: 126
+  Poly: 127
+  
+System Common:
+  Song Position Pointer: 0x2
+  Song Select: 0x3
+  Tune Request: 0x6
+
+System Realtime:
+  Start: 0xA
+  Clock: 0x8
+  Continue: 0xB
+  Stop: 0xC
+  ActiveSense: 0xE
+  Reset: 0xF  
+
+Manufacturer:
+
+  SequentialCircuits: 1
+  BigBriar: 2
+  Octave: 3
+  Moog: 4
+  Passport: 5
+  Lexicon: 6
+
+  PAIA: 0x11
+  Simmons: 0x12
+  GentleElectric: 0x13
+  Fairlight: 0x14
+  BonTempi: 0x20
+  SIEL: 0x21
+  SyntheAxe: 0x23
+
+  Kawai: 0x40
+  Roland: 0x41
+  Korg: 0x42
+  Yamaha: 0x43
+  Casio: 0x44
+  Akai: 0x47
+
+  Emagic: [0x00, 0x20, 0x31]
+  Behringer: [0x00, 0x20, 0x32]
+
+Note:
+  C-1: 0
+  C#-1: 1
+  Db-1: 1
+  D-1: 2
+  Eb-1: 3
+  D#-1: 3
+  E-1: 4
+  Fb-1: 4
+  F-1: 5
+  E#-1: 5
+  F#-1: 6
+  Gb-1: 6
+  G-1: 7
+  G#-1: 8
+  Ab-1: 8
+  A-1: 9
+  A#-1: 10
+  Bb-1: 10
+  B-1: 11
+  Cb0: 11
+  C0: 12
+  B#-1: 12
+  C#0: 13
+  Db0: 13
+  D0: 14
+  D#0: 15
+  Eb0: 15
+  E0: 16
+  Fb0: 16
+  F0: 17
+  E#0: 17
+  F#0: 18
+  Gb0: 18
+  G0: 19
+  Ab0: 20
+  G#0: 20
+  A0: 21
+  Bb0: 22
+  A#0: 22
+  B0: 23
+  Cb1: 23
+  C1: 24
+  B#0: 24
+  Db1: 25
+  C#1: 25
+  D1: 26
+  D#1: 27
+  Eb1: 27
+  E1: 28
+  Fb1: 28
+  F1: 29
+  E#1: 29
+  F#1: 30
+  Gb1: 30
+  G1: 31
+  Ab1: 32
+  G#1: 32
+  A1: 33
+  A#1: 34
+  Bb1: 34
+  B1: 35
+  Cb2: 35
+  C2: 36
+  B#1: 36
+  Db2: 37
+  C#2: 37
+  D2: 38
+  D#2: 39
+  Eb2: 39
+  E2: 40
+  Fb2: 40
+  F2: 41
+  E#2: 41
+  F#2: 42
+  Gb2: 42
+  G2: 43
+  G#2: 44
+  Ab2: 44
+  A2: 45
+  A#2: 46
+  Bb2: 46
+  B2: 47
+  Cb3: 47
+  C3: 48
+  B#2: 48
+  C#3: 49
+  Db3: 49
+  D3: 50
+  Eb3: 51
+  D#3: 51
+  E3: 52
+  Fb3: 52
+  F3: 53
+  E#3: 53
+  F#3: 54
+  Gb3: 54
+  G3: 55
+  Ab3: 56
+  G#3: 56
+  A3: 57
+  A#3: 58
+  Bb3: 58
+  B3: 59
+  Cb4: 59
+  C4: 60
+  B#3: 60
+  C#4: 61
+  Db4: 61
+  D4: 62
+  D#4: 63
+  Eb4: 63
+  E4: 64
+  Fb4: 64
+  F4: 65
+  E#4: 65
+  Gb4: 66
+  F#4: 66
+  G4: 67
+  Ab4: 68
+  G#4: 68
+  A4: 69
+  A#4: 70
+  Bb4: 70
+  B4: 71
+  Cb5: 71
+  C5: 72
+  B#4: 72
+  C#5: 73
+  Db5: 73
+  D5: 74
+  Eb5: 75
+  D#5: 75
+  E5: 76
+  Fb5: 76
+  F5: 77
+  E#5: 77
+  F#5: 78
+  Gb5: 78
+  G5: 79
+  Ab5: 80
+  G#5: 80
+  A5: 81
+  A#5: 82
+  Bb5: 82
+  B5: 83
+  Cb6: 83
+  C6: 84
+  B#5: 84
+  C#6: 85
+  Db6: 85
+  D6: 86
+  D#6: 87
+  Eb6: 87
+  E6: 88
+  Fb6: 88
+  F6: 89
+  E#6: 89
+  Gb6: 90
+  F#6: 90
+  G6: 91
+  Ab6: 92
+  G#6: 92
+  A6: 93
+  A#6: 94
+  Bb6: 94
+  B6: 95
+  Cb7: 95
+  C7: 96
+  B#6: 96
+  C#7: 97
+  Db7: 97
+  D7: 98
+  D#7: 99
+  Eb7: 99
+  E7: 100
+  Fb7: 100
+  F7: 101
+  E#7: 101
+  Gb7: 102
+  F#7: 102
+  G7: 103
+  Ab7: 104
+  G#7: 104
+  A7: 105
+  A#7: 106
+  Bb7: 106
+  B7: 107
+  Cb8: 107
+  C8: 108
+  B#7: 108
+  C#8: 109
+  Db8: 109
+  D8: 110
+  D#8: 111
+  Eb8: 111
+  E8: 112
+  Fb8: 112
+  F8: 113
+  E#8: 113
+  Gb8: 114
+  F#8: 114
+  G8: 115
+  Ab8: 116
+  G#8: 116
+  A8: 117
+  A#8: 118
+  Bb8: 118
+  B8: 119
+  Cb9: 119
+  C9: 120
+  B#8: 120
+  C#9: 121
+  Db9: 121
+  D9: 122
+  D#9: 123
+  Eb9: 123
+  E9: 124
+  Fb9: 124
+  F9: 125
+  E#9: 125
+  Gb9: 126
+  F#9: 126
+  G9: 127

data/test/helper.rb

@@ -0,0 +1,11 @@
+#!/usr/bin/env ruby
+
+dir = File.dirname(File.expand_path(__FILE__))
+$LOAD_PATH.unshift dir + '/../lib'
+
+require 'test/unit'
+require 'midi-message'
+
+module TestHelper
+  
+end

data/test/test_constants.rb

@@ -0,0 +1,48 @@
+#!/usr/bin/env ruby
+
+require 'helper'
+
+class ConstantsTest < Test::Unit::TestCase
+
+  include MIDIMessage
+  include TestHelper        
+   
+  def test_note_on
+    msg = NoteOn["c3"].new(0, 100)
+    assert_equal(NoteOn, msg.class)
+    assert_equal("C3", msg.name)
+    assert_equal("C", msg.note_name)
+    assert_equal([0x90, 0x30, 100], msg.to_a)  
+  end 
+  
+  def test_control_change
+    msg = NoteOn["C3"].new(0, 100)
+    assert_equal(NoteOn, msg.class)
+    assert_equal("C3", msg.name)
+    assert_equal([0x90, 0x30, 100], msg.to_a)      
+  end
+  
+  def test_control_change
+    msg = ControlChange["Modulation Wheel"].new(2, 0x20)
+    assert_equal(ControlChange, msg.class)
+    assert_equal(msg.channel, 2)
+    assert_equal(0x01, msg.index)
+    assert_equal(0x20, msg.value)
+    assert_equal([0xB2, 0x01, 0x20], msg.to_a)    
+  end
+
+  def test_system_realtime
+    msg = SystemRealtime["Stop"].new
+    assert_equal(SystemRealtime, msg.class)
+    assert_equal("Stop", msg.name)
+    assert_equal([0xFC], msg.to_a)     
+  end  
+  
+  def test_system_common
+    msg = SystemCommon["Song Select"].new
+    assert_equal(SystemCommon, msg.class)
+    assert_equal("Song Select", msg.name)
+    assert_equal([0xF3], msg.to_a)      
+  end  
+  
+end

data/test/test_context.rb

@@ -0,0 +1,86 @@
+#!/usr/bin/env ruby
+
+require 'helper'
+
+class ContextTest < Test::Unit::TestCase
+
+  include MIDIMessage
+  include TestHelper
+  def test_note_off
+    msg = with(:channel => 0, :velocity => 64) do
+      note_off(55)
+    end
+    assert_equal(0, msg.channel)
+    assert_equal(55, msg.note)
+    assert_equal(64, msg.velocity)
+    assert_equal([128, 55, 64], msg.to_a)
+    assert_equal("803740", msg.to_bytestr)
+  end
+
+  def test_note_on
+    msg = with(:channel => 0, :velocity => 64) do
+      note_on(55)
+    end
+    assert_equal(0, msg.channel)
+    assert_equal(55, msg.note)
+    assert_equal(64, msg.velocity)
+    assert_equal([144, 55, 64], msg.to_a)
+    assert_equal("903740", msg.to_bytestr)
+  end
+
+  def test_control_change
+    msg = with(:channel => 2) do
+      control_change(0x20, 0x30)
+    end
+    assert_equal(msg.channel, 2)
+    assert_equal(0x20, msg.index)
+    assert_equal(0x30, msg.value)
+    assert_equal([0xB2, 0x20, 0x30], msg.to_a)
+    assert_equal("B22030", msg.to_bytestr)
+
+  end
+
+  def test_polyphonic_aftertouch
+    msg = with(:channel => 1) do
+      polyphonic_aftertouch(0x40, 0x40)
+    end
+    assert_equal(1, msg.channel)
+    assert_equal(0x40, msg.note)
+    assert_equal(0x40, msg.value)
+    assert_equal([0xA1, 0x40, 0x40], msg.to_a)
+    assert_equal("A14040", msg.to_bytestr)
+  end
+
+  def test_program_change
+    msg = with(:channel => 3) do
+      program_change(0x40)
+    end
+    assert_equal(3, msg.channel)
+    assert_equal(0x40, msg.program)
+    assert_equal([0xC3, 0x40], msg.to_a)
+    assert_equal("C340", msg.to_bytestr)
+
+  end
+
+  def test_channel_aftertouch
+    msg = with(:channel => 3) do
+      channel_aftertouch(0x50)
+    end
+    assert_equal(3, msg.channel)
+    assert_equal(0x50, msg.value)
+    assert_equal([0xD3, 0x50], msg.to_a)
+    assert_equal("D350", msg.to_bytestr)
+  end
+
+  def test_pitch_bend
+    msg = with(:channel => 0) do
+      pitch_bend(0x50, 0xA0)
+    end
+    assert_equal(0, msg.channel)
+    assert_equal(0x50, msg.low)
+    assert_equal(0xA0, msg.high)
+    assert_equal([0xE0, 0x50, 0xA0], msg.to_a)
+    assert_equal("E050A0", msg.to_bytestr)
+  end
+
+end

data/test/test_filter.rb

@@ -0,0 +1,95 @@
+#!/usr/bin/env ruby
+
+require 'helper'
+
+class FilterTest < Test::Unit::TestCase
+
+  include MIDIMessage
+  include MIDIMessage::Process
+  include TestHelper
+
+  def test_high_pass_note_reject
+    msg = MIDIMessage::NoteOn["C0"].new(0, 100)
+    assert_equal(12, msg.note)
+    outp = HighPassFilter.new(msg, :note, 20).process
+    assert_equal(nil, outp)
+  end
+
+  def test_high_pass_note_accept
+    msg = MIDIMessage::NoteOn["C4"].new(0, 100)
+    assert_equal(60, msg.note)
+    outp = HighPassFilter.new(msg, :note, 20).process
+    assert_equal(msg, outp)
+  end
+
+  def test_low_pass_note_reject
+    msg = MIDIMessage::NoteOn["C4"].new(0, 100)
+    assert_equal(60, msg.note)
+    outp = LowPassFilter.new(msg, :note, 50).process
+    assert_equal(nil, outp)
+  end
+
+  def test_low_pass_note_accept
+    msg = MIDIMessage::NoteOn["C4"].new(0, 100)
+    assert_equal(60, msg.note)
+    outp = LowPassFilter.new(msg, :note, 100).process
+    assert_equal(msg, outp)
+  end
+
+  def test_band_pass_note_reject
+    msg = MIDIMessage::NoteOn["C4"].new(0, 100)
+    assert_equal(60, msg.note)
+    outp = BandPassFilter.new(msg, :note, (20..50)).process
+    assert_equal(nil, outp)
+  end
+
+  def test_band_pass_note_accept
+    msg = MIDIMessage::NoteOn["C4"].new(0, 100)
+    assert_equal(60, msg.note)
+    outp = BandPassFilter.new(msg, :note, (20..100)).process
+    assert_equal(msg, outp)
+  end
+  
+  def test_band_reject_note_reject
+    msg = MIDIMessage::NoteOn["C4"].new(0, 100)
+    assert_equal(60, msg.note)
+    outp = NotchFilter.new(msg, :note, (20..70)).process
+    assert_equal(nil, outp)
+  end
+
+  def test_band_reject_note_accept
+    msg = MIDIMessage::NoteOn["C4"].new(0, 100)
+    assert_equal(60, msg.note)
+    outp = NotchFilter.new(msg, :note, (20..50)).process
+    assert_equal(msg, outp)
+  end
+  
+  def test_multiband_note_reject
+    msg = MIDIMessage::NoteOn["C4"].new(0, 100)
+    assert_equal(60, msg.note)
+    outp = Filter.new(msg, :note, [(20..30), (40..50)]).process
+    assert_equal(nil, outp)
+  end
+
+  def test_multiband_note_accept
+    msg = MIDIMessage::NoteOn["C4"].new(0, 100)
+    assert_equal(60, msg.note)
+    outp = Filter.new(msg, :note, [(20..30), (50..70)]).process
+    assert_equal(msg, outp)
+  end
+  
+  def test_multinotch_note_reject
+    msg = MIDIMessage::NoteOn["C4"].new(0, 100)
+    assert_equal(60, msg.note)
+    outp = Filter.new(msg, :note, [(20..30), (55..65)], :reject => true).process
+    assert_equal(nil, outp)
+  end
+
+  def test_multinotch_note_accept
+    msg = MIDIMessage::NoteOn["C4"].new(0, 100)
+    assert_equal(60, msg.note)
+    outp = Filter.new(msg, :note, [(20..30), (40..50)], :reject => true).process
+    assert_equal(msg, outp)
+  end
+  
+end

data/test/test_limit.rb

@@ -0,0 +1,39 @@
+#!/usr/bin/env ruby
+
+require 'helper'
+
+class LimitTest < Test::Unit::TestCase
+
+  include MIDIMessage
+  include MIDIMessage::Process
+  include TestHelper
+
+  def test_low_note
+    msg = MIDIMessage::NoteOn["C0"].new(0, 100)
+    assert_equal(12, msg.note)
+    Limit.new(msg, :note, (20..50)).process
+    assert_equal(20, msg.note)
+  end
+
+  def test_high_note
+    msg = MIDIMessage::NoteOn["C6"].new(0, 100)
+    assert_equal(84, msg.note)
+    Limit.new(msg, :note, (20..50)).process
+    assert_equal(50, msg.note)
+  end
+
+  def test_low_velocity
+    msg = MIDIMessage::NoteOn["C0"].new(0, 10)
+    assert_equal(10, msg.velocity)
+    Limit.new(msg, :velocity, (30..110)).process
+    assert_equal(30, msg.velocity)
+  end
+
+  def test_high_velocity
+    msg = MIDIMessage::NoteOn["C6"].new(0, 120)
+    assert_equal(120, msg.velocity)
+    Limit.new(msg, :velocity, (25..75)).process
+    assert_equal(75, msg.velocity)
+  end
+  
+end

data/test/test_mutability.rb

@@ -0,0 +1,28 @@
+#!/usr/bin/env ruby
+
+require 'helper'
+
+class MutabilityTest < Test::Unit::TestCase
+
+  include MIDIMessage
+  include TestHelper
+  
+  def test_note
+    msg = NoteOn["E4"].new(0, 100)
+    assert_equal(0x40, msg.note)
+    assert_equal("E4", msg.name)
+    msg.note += 5
+    assert_equal(0x45, msg.note)
+    assert_equal("A4", msg.name)     
+  end
+
+  def test_octave
+    msg = NoteOn["E4"].new(0, 100)
+    assert_equal(0x40, msg.note)
+    assert_equal("E4", msg.name)
+    msg.octave += 1
+    assert_equal(0x4C, msg.note)
+    assert_equal("E5", msg.name)     
+  end
+   
+end

data/test/test_parser.rb

@@ -0,0 +1,72 @@
+#!/usr/bin/env ruby
+
+require 'helper'
+
+class ParserTest < Test::Unit::TestCase
+
+  include MIDIMessage
+  include TestHelper
+  
+  def test_sysex
+    msg = MIDIMessage.parse(0xF0, 0x41, 0x10, 0x42, 0x12, 0x40, 0x00, 0x7F, 0x00, 0x41, 0xF7)
+    assert_equal(SystemExclusive::Command, msg.class)
+    assert_equal(SystemExclusive::Node, msg.node.class) 
+    assert_equal([0x40, 0x00, 0x7F], msg.address)
+    assert_equal([0xF0, 0x41, 0x10, 0x42, 0x12, 0x40, 0x00, 0x7F, 0x00, 0x41, 0xF7], msg.to_bytes)      
+  end        
+  
+  def test_note_off
+    msg = MIDIMessage.parse(0x80, 0x40, 0x40)
+    assert_equal(NoteOff, msg.class)
+    assert_equal([0x80, 0x40, 0x40], msg.to_a)
+  end
+  
+  def test_note_on
+    msg = MIDIMessage.parse(0x90, 0x40, 0x40)
+    assert_equal(NoteOn, msg.class)
+    assert_equal([0x90, 0x40, 0x40], msg.to_a)  
+  end  
+  
+  def test_polyphonic_aftertouch
+    msg = MIDIMessage.parse(0xA1, 0x40, 0x40)
+    assert_equal(PolyphonicAftertouch, msg.class)
+    assert_equal([0xA1, 0x40, 0x40], msg.to_a)      
+  end  
+  
+  def test_control_change
+    msg = MIDIMessage.parse(0xB2, 0x20, 0x20)
+    assert_equal(ControlChange, msg.class)
+    assert_equal([0xB2, 0x20, 0x20], msg.to_a)    
+  end
+  
+  def test_program_change
+    msg = MIDIMessage.parse(0xC3, 0x40)
+    assert_equal(ProgramChange, msg.class)
+    assert_equal("C340", msg.to_bytestr)
+  end
+  
+  def test_channel_aftertouch
+    msg = MIDIMessage.parse("D350")
+    assert_equal(ChannelAftertouch, msg.class)
+    assert_equal([0xD3, 0x50], msg.to_a)  
+  end  
+    
+  def test_pitch_bend
+    msg = MIDIMessage.parse("E050A0")
+    assert_equal(PitchBend, msg.class)
+    assert_equal([0xE0, 0x50, 0xA0], msg.to_a)      
+  end   
+   
+  def test_system_common
+    msg = MIDIMessage.parse([0xF1, 0x50, 0xA0])
+    assert_equal(SystemCommon, msg.class)
+    assert_equal([0xF1, 0x50, 0xA0], msg.to_a)   
+  end    
+  
+  def test_system_realtime
+    msg = MIDIMessage.parse(0xF8)
+    assert_equal(SystemRealtime, msg.class)
+    assert_equal([0xF8], msg.to_a)     
+  end        
+   
+end