midiator 0.3.0 → 0.3.1

data/examples/amen_break.rb

@@ -0,0 +1,157 @@
+#!/usr/bin/env ruby
+#
+# Plays the amen break.  Demonstrates playing on a different channel and use
+# of the MIDIator::Drums and MIDIator::Durations mixins.
+#
+# == Authors
+#
+# * Ben Bleything <ben@bleything.net>
+#
+# == Copyright
+#
+# Copyright (c) 2009 Ben Bleything
+#
+# This code released under the terms of the MIT license.
+#
+
+require 'midiator'
+
+@midi = MIDIator::Interface.new
+# @midi.autodetect_driver
+@midi.use :dls_synth
+
+# let's get some drums!
+include MIDIator::Drums
+@midi.control_change 32, 10, 1 # TR-808 is Program 26 in LSB bank 1
+@midi.program_change 10, 26
+
+# set up some tempo constants
+tempo = 120
+QuarterNote   = 60.0 / tempo
+EighthNote    = QuarterNote / 2
+SixteenthNote = EighthNote / 2
+
+# a helper method!
+def beat( note, duration = EighthNote )
+  @midi.play note, duration, 10
+end
+
+# instrument shortcuts
+bass   = BassDrum1
+snare  = SnareDrum1
+cymbal = RideCymbal1
+
+# "chord" shortcuts
+bass_cymbal  = [ bass,  cymbal ]
+snare_cymbal = [ snare, cymbal ]
+
+# as transcribed at http://www.onlinedrumlessons.com/main/2005/09/classic-break-beat.htm
+loop do
+
+  # first measure is repeated 
+  2.times do
+    # beat 1
+    beat bass_cymbal
+    beat bass_cymbal
+  
+    # beat 2
+    beat snare_cymbal
+    @midi.rest SixteenthNote
+    beat snare, SixteenthNote
+  
+    # beat 3
+    beat cymbal,      SixteenthNote
+    beat snare,       SixteenthNote
+    beat bass_cymbal, SixteenthNote
+    beat bass,        SixteenthNote
+  
+    # beat 4
+    beat snare_cymbal
+    beat cymbal, SixteenthNote
+    beat snare,  SixteenthNote
+  end
+  
+  # third measure starts out like the first...
+  # beat 1
+  beat bass_cymbal
+  beat bass_cymbal
+
+  # beat 2
+  beat snare_cymbal
+  @midi.rest SixteenthNote
+  beat snare, SixteenthNote
+
+  # beat 3
+  beat cymbal, SixteenthNote
+  beat snare,  SixteenthNote
+  beat bass_cymbal
+  
+  # beat 4
+  beat cymbal
+  beat snare_cymbal
+  
+  # and then the fourth measure goes off the rails
+  # beat 1
+  beat cymbal, SixteenthNote
+  beat snare,  SixteenthNote
+  beat bass_cymbal, SixteenthNote
+  beat bass,        SixteenthNote
+  
+  # beat 2
+  beat snare_cymbal
+  beat cymbal, SixteenthNote
+  beat snare,  SixteenthNote
+  
+  # beat 3
+  beat cymbal, SixteenthNote
+  beat snare,  SixteenthNote
+  beat 
+end
+
+
+exit
+
+loop do
+  # first bar is repeated twice
+  2.times do
+    @midi.play BassDrum1,  EighthNote,    9
+    @midi.play BassDrum1,  EighthNote,    9
+    @midi.play SnareDrum1, EighthNote,    9
+    @midi.rest             SixteenthNote
+    @midi.play SnareDrum1, SixteenthNote, 9
+    @midi.rest             SixteenthNote
+    @midi.play SnareDrum1, SixteenthNote, 9
+    @midi.play BassDrum1,  SixteenthNote, 9
+    @midi.play BassDrum1,  SixteenthNote, 9
+    @midi.play SnareDrum1, EighthNote,    9
+    @midi.rest             EighthNote
+  end
+
+  # bar 3
+  @midi.play BassDrum1,  EighthNote,    9
+  @midi.play BassDrum1,  EighthNote,    9
+  @midi.play SnareDrum1, EighthNote,    9
+  @midi.rest             SixteenthNote
+  @midi.play SnareDrum1, SixteenthNote, 9
+  @midi.rest             SixteenthNote
+  @midi.play SnareDrum1, SixteenthNote, 9
+  @midi.play BassDrum1,  EighthNote,    9
+  @midi.rest             EighthNote
+  @midi.play SnareDrum1, EighthNote,    9
+
+  # bar 4
+  @midi.rest             EighthNote
+  @midi.play BassDrum1,  SixteenthNote, 9
+  @midi.play BassDrum1,  SixteenthNote, 9
+  @midi.play SnareDrum1, EighthNote,    9
+  @midi.rest             SixteenthNote
+  @midi.play SnareDrum1, SixteenthNote, 9
+  @midi.rest             SixteenthNote
+  @midi.play SnareDrum1, SixteenthNote, 9
+  @midi.play BassDrum1,  EighthNote,    9
+  @midi.rest             EighthNote
+  @midi.play BassDrum1,  EighthNote,    9
+
+  # a little break
+  @midi.rest HalfNote
+end

data/examples/chords.rb

@@ -0,0 +1,34 @@
+#!/usr/bin/env ruby
+#
+# A simple example of playing chords with MIDIator
+#
+# == Authors
+#
+# * David Brady <dbrady@shinybit.com>
+#
+# == Copyright
+#
+# Copyright (c) 2008 David Brady
+#
+# This code released under the terms of the MIT license.
+#
+
+require 'rubygems'
+require 'midiator'
+ 
+midi = MIDIator::Interface.new
+midi.autodetect_driver
+
+include MIDIator::Notes
+
+C4MAJ = [ C4, E4, G4 ]
+F4MAJII = [ C4, F4, A4 ]
+G4MAJ = [ D4, G4, B4 ]
+
+song = [ C3, C4MAJ, C3, C4MAJ, F3, F4MAJII, F3, F4MAJII, G3, G4MAJ, G3, G4MAJ, C5, C4MAJ, C2, C4MAJ]
+
+4.times do
+  song.each do |note|
+    midi.play note, 0.25
+  end
+end

data/examples/chromatic_scale.rb

@@ -27,9 +27,9 @@ scale = [ C4, Cs4, D4, Eb4, E4, F4, Fs4, G4, Gs4, A4, Bb4, B4,
           C5, Cs5, D5, Eb5, E5, F5, Fs5, G5, Gs5, A5, Bb5, B5 ]
 
 scale.each do |note|
-	midi.play note
+  midi.play note
 end
 
 scale.reverse.each do |note|
-	midi.play note
+  midi.play note
 end

data/examples/drum_chords.rb

@@ -0,0 +1,49 @@
+#!/usr/bin/env ruby
+#
+# Plays a simple polyphonic drumbeat.
+#
+# == Authors
+#
+# * David Brady <dbrady@shinybit.com>
+#
+# == Copyright
+#
+# Copyright (c) 2008 David Brady
+#
+# This code released under the terms of the MIT license.
+#
+
+require 'rubygems'
+require 'midiator'
+ 
+midi = MIDIator::Interface.new
+midi.autodetect_driver
+ 
+midi.control_change 32, 10, 1 # TR-808 is Program 26 in LSB bank 1
+midi.program_change 10, 26
+ 
+include MIDIator::Drums
+ 
+song = [ BassDrum1,
+  [BassDrum2, SnareDrum1],
+  BassDrum1,
+  [BassDrum1, SnareDrum1, SnareDrum2, CrashCymbal1]
+]
+riff = [ HighTom1, HighTom2, LowTom1, LowTom2 ]
+ 
+# This starts to push the usability limit of play.
+4.times do
+  song.each do |note|
+    midi.play note, 0.25, 10
+  end
+end
+riff.each do |note|
+  midi.play note, 0.067, 10
+end
+midi.play CrashCymbal2, 0.25, 10
+ 
+4.times do
+  song.each do |note|
+    midi.play note, 0.25, 10
+  end
+end

data/examples/metronome.rb

@@ -28,15 +28,15 @@
 @tempo = 120.0
 
 if input = ARGV[0]
-	begin
-		@tempo = Float( input )
-	rescue ArgumentError => e
-		$stderr.puts "'#{input}' is not a valid tempo.\n"
-		$stderr.puts "Please specify the tempo in beats per minute " +
-			"(bpm).  Fractional values are allowed!"
+  begin
+    @tempo = Float( input )
+  rescue ArgumentError => e
+    $stderr.puts "'#{input}' is not a valid tempo.\n"
+    $stderr.puts "Please specify the tempo in beats per minute " +
+      "(bpm).  Fractional values are allowed!"
 
-		exit 1
-	end
+    exit 1
+  end
 end
 
 require 'rubygems'
@@ -66,10 +66,10 @@ Signal.trap( "INT" ) { @timer.thread.exit! }
 @timer = MIDIator::Timer.new( @interval / 10 )
 
 def register_next_bang( time )
-	@timer.at( time ) do |yielded_time|
-		register_next_bang yielded_time + @interval
-		@midi.play MiddleC
-	end
+  @timer.at( time ) do |yielded_time|
+    register_next_bang yielded_time + @interval
+    @midi.play MiddleC
+  end
 end
 
 puts "Starting metronome running at #{@tempo} bpm."

data/examples/synth.rb

@@ -0,0 +1,34 @@
+#!/usr/bin/env ruby
+#
+# A copy of the chromatic scale example which uses the OS X built-in synth.
+#
+# == Authors
+#
+# * Ben Bleything <ben@bleything.net>
+#
+# == Copyright
+#
+# Copyright (c) 2008 Ben Bleything
+#
+# This code released under the terms of the MIT license.
+#
+
+require 'rubygems'
+require 'midiator'
+
+midi = MIDIator::Interface.new
+midi.use :dls_synth
+midi.instruct_user!
+
+include MIDIator::Notes
+
+scale = [ C4, Cs4, D4, Eb4, E4, F4, Fs4, G4, Gs4, A4, Bb4, B4,
+          C5, Cs5, D5, Eb5, E5, F5, Fs5, G5, Gs5, A5, Bb5, B5 ]
+
+scale.each do |note|
+  midi.play note
+end
+
+scale.reverse.each do |note|
+  midi.play note
+end

data/examples/twinkle.rb

@@ -26,9 +26,9 @@ scale = [ C4, Cs4, D4, Eb4, E4, F4, Fs4, G4, Gs4, A4, Bb4, B4,
           C5, Cs5, D5, Eb5, E5, F5, Fs5, G5, Gs5, A5, Bb5, B5 ]
 
 scale.each do |note|
-	midi.play note
+  midi.play note
 end
 
 scale.reverse.each do |note|
-	midi.play note
+  midi.play note
 end

data/lib/midiator.rb

@@ -14,22 +14,22 @@
 #
 
 module MIDIator
-	VERSION = "0.3.0"
+  VERSION = "0.3.1"
 end
 
 #####################################################################
-###	E X T E R N A L   D E P E N D E N C I E S
+###  E X T E R N A L   D E P E N D E N C I E S
 #####################################################################
 require 'rubygems'
 require 'platform'
 
 #####################################################################
-###	C O R E   L I B R A R Y   E X T E N S I O N S
+###  C O R E   L I B R A R Y   E X T E N S I O N S
 #####################################################################
 require 'string_extensions'
 
 #####################################################################
-###	M I D I A T O R   C O R E
+###  M I D I A T O R   C O R E
 #####################################################################
 require 'midiator/driver'
 require 'midiator/driver_registry'

data/lib/midiator/driver.rb

@@ -22,127 +22,127 @@ require 'midiator/driver_registry'
 
 class MIDIator::Driver
 
-	##########################################################################
-	### M I D I   C O M M A N D   C O N S T A N T S
-	##########################################################################
+  ##########################################################################
+  ### M I D I   C O M M A N D   C O N S T A N T S
+  ##########################################################################
 
-	# Note on
-	ON  = 0x90
+  # Note on
+  ON  = 0x90
 
-	# Note off
-	OFF = 0x80
+  # Note off
+  OFF = 0x80
 
-	# Polyphonic aftertouch
-	PA  = 0xa0
+  # Polyphonic aftertouch
+  PA  = 0xa0
 
-	# Control change
-	CC  = 0xb0
+  # Control change
+  CC  = 0xb0
 
-	# Program change
-	PC  = 0xc0
+  # Program change
+  PC  = 0xc0
 
-	# Channel aftertouch
-	CA  = 0xd0
+  # Channel aftertouch
+  CA  = 0xd0
 
-	# Pitch bend
-	PB  = 0xe0
+  # Pitch bend
+  PB  = 0xe0
 
-	##########################################################################
-	### M A G I C   H O O K S
-	##########################################################################
+  ##########################################################################
+  ### M A G I C   H O O K S
+  ##########################################################################
 
-	### Auto-registers subclasses of MIDIator::Driver with the driver registry.
-	def self::inherited( driver_class )
-		driver_name = driver_class.to_s.underscore
-		MIDIator::DriverRegistry.instance.register( driver_name, driver_class )
-	end
+  ### Auto-registers subclasses of MIDIator::Driver with the driver registry.
+  def self::inherited( driver_class )
+    driver_name = driver_class.to_s.underscore
+    MIDIator::DriverRegistry.instance.register( driver_name, driver_class )
+  end
 
 
-	##########################################################################
-	### I N T E R F A C E   A P I
-	##########################################################################
-	# These methods are the same across all drivers and are the interface that
-	# MIDIator::Interface interacts with.
-	##########################################################################
+  ##########################################################################
+  ### I N T E R F A C E   A P I
+  ##########################################################################
+  # These methods are the same across all drivers and are the interface that
+  # MIDIator::Interface interacts with.
+  ##########################################################################
 
-	### Do any pre-open setup necessary.  Often will not be overridden.
-	def initialize
-		open
-	end
+  ### Do any pre-open setup necessary.  Often will not be overridden.
+  def initialize
+    open
+  end
 
 
-	### Shortcut to send a note_on message.
-	def note_on( note, channel, velocity )
-		message( ON | channel, note, velocity )
-	end
+  ### Shortcut to send a note_on message.
+  def note_on( note, channel, velocity )
+    message( ON | channel, note, velocity )
+  end
 
 
-	### Shortcut to send a note_off message.
-	def note_off( note, channel, velocity = 0 )
-		message( OFF | channel, note, velocity )
-	end
+  ### Shortcut to send a note_off message.
+  def note_off( note, channel, velocity = 0 )
+    message( OFF | channel, note, velocity )
+  end
 
 
-	### Shortcut to send a polyphonic aftertouch message for an individual note.
-	def aftertouch( note, channel, pressure )
-		message( PA | channel, note, pressure )
-	end
+  ### Shortcut to send a polyphonic aftertouch message for an individual note.
+  def aftertouch( note, channel, pressure )
+    message( PA | channel, note, pressure )
+  end
 
 
-	### Shortcut to send a control change.
-	def control_change( number, channel, value )
-		message( CC | channel, number, value )
-	end
+  ### Shortcut to send a control change.
+  def control_change( number, channel, value )
+    message( CC | channel, number, value )
+  end
 
 
-	### Shortcut to send a program_change message.
-	def program_change( channel, program )
-		message( PC | channel, program )
-	end
+  ### Shortcut to send a program_change message.
+  def program_change( channel, program )
+    message( PC | channel, program )
+  end
 
 
-	### Shortcut to send a channel aftertouch message.
-	def channel_aftertouch( channel, pressure )
-		message( CA | channel, pressure )
-	end
+  ### Shortcut to send a channel aftertouch message.
+  def channel_aftertouch( channel, pressure )
+    message( CA | channel, pressure )
+  end
 
 
-	### Shortcut to send a pitch bend message.
-	def pitch_bend( channel, value )
-		message( PB | channel, value )
-	end
-	alias bend pitch_bend
+  ### Shortcut to send a pitch bend message.
+  def pitch_bend( channel, value )
+    message( PB | channel, value )
+  end
+  alias bend pitch_bend
 
 
-	##########################################################################
-	### D R I V E R   A P I
-	##########################################################################
-	# subclasses must implement these methods.
-	##########################################################################
-	protected
-	##########################################################################
+  ##########################################################################
+  ### D R I V E R   A P I
+  ##########################################################################
+  # subclasses must implement these methods.
+  ##########################################################################
+  protected
+  ##########################################################################
 
-	### Open the channel to the MIDI service.
-	def open
-		raise NotImplementedError, "You must implement #open in your driver."
-	end
+  ### Open the channel to the MIDI service.
+  def open
+    raise NotImplementedError, "You must implement #open in your driver."
+  end
 
 
-	### Close the channel to the MIDI service.
-	def close
-		raise NotImplementedError, "You must implement #close in your driver."
-	end
+  ### Close the channel to the MIDI service.
+  def close
+    raise NotImplementedError, "You must implement #close in your driver."
+  end
 
 
-	### Send MIDI message to the MIDI service.
-	def message( *args )
-		raise NotImplementedError, "You must implement #message in your driver."
-	end
+  ### Send MIDI message to the MIDI service.
+  def message( *args )
+    raise NotImplementedError, "You must implement #message in your driver."
+  end
 
 
-	### The only non-required method.  Override this to give the user instructions
-	### if necessary.
-	def instruct_user!
-	end
+  ### The only non-required method.  Override this to give the user instructions
+  ### if necessary.
+  def instruct_user!
+  end
 
 end