Class MIDI::IO::MIDIFile
In: lib/midilib/io/midifile.rb
Parent: Object

A MIDIFile parses a MIDI file and calls methods when it sees MIDI events. Most of the methods are stubs. To do anything interesting with the events, override these methods (those between the "The rest of these are NOPs by default" and "End of NOPs" comments).

See SeqReader for a subclass that uses these methods to create Event objects.

Methods

arbitrary   bad_byte   chan_message   chan_pressure   controller   end_track   eot   error   get_bytes   getc   handle_arbitrary   handle_sysex   header   key_signature   meta_event   meta_misc   msg   msg_add   msg_init   msg_read   new   note_off   note_on   pitch_bend   pressure   program   read16   read32   read_from   read_header   read_mt_header_string   read_track   read_var_len   sequence_number   sequencer_specific   smpte   start_track   sysex   tempo   text   time_signature   write16   write32   write_var_len  

Constants

MThd_BYTE_ARRAY = [77, 84, 104, 100]
MTrk_BYTE_ARRAY = [77, 84, 114, 107]
NUM_DATA_BYTES = [ 0, 0, 0, 0, 0, 0, 0, 0, # 0x00 - 0x70 2, 2, 2, 2, 1, 1, 2, 0   This array is indexed by the high half of a status byte. Its value is either the number of bytes needed (1 or 2) for a channel message, or 0 if it‘s not a channel message.

Attributes

bytes_to_be_read  [RW] 
curr_ticks  [RW] 
no_merge  [RW] 
raw_data  [RW] 
raw_time_stamp_data  [RW]  Raw data info
raw_var_num_data  [RW] 
skip_init  [RW] 
ticks_so_far  [RW] 

Public Class methods

Public Instance methods

bad_byte(c)

Handle an unexpected byte.

chan_message(running, status, c1, c2)

Handle a channel message (note on, note off, etc.)

error(str)

The default error handler.

get_bytes(n)

Return the next n bytes from @io as an array.

getc()

This default getc implementation tries to read a single byte from io and returns it as an integer.

handle_arbitrary(msg)

Copy message into raw data array, then call arbitrary().

handle_sysex(msg)

Copy message into raw data array, then call sysex().

meta_event(type)

Handle a meta event.

msg()

Return a copy of the internal message buffer.

msg_add(c)

Add a byte to the current message buffer.

msg_init()

Initialize the internal message buffer.

msg_read(n_bytes)

Read and add a number of bytes to the message buffer. Return the last byte (so we can see if it‘s an EOX or not).

read16()

Read and return a sixteen bit value.

read32()

Read and return a 32-bit value.

read_from(io)

The only public method. Each MIDI event in the file causes a method to be called.

read_header()

Read a header chunk.

read_mt_header_string(bytes, skip)

Read through ‘MThd’ or ‘MTrk’ header string. If skip is true, attempt to skip initial trash. If there is an error, error is called.

read_track()

Read a track chunk.

read_var_len()

Read a varlen value.

write16(val)

Write a sixteen-bit value.

write32(val)

Write a 32-bit value.

write_var_len(val)

Write a variable length value.

[Validate]