Page tree
Skip to end of metadata
Go to start of metadata

Description

MIDI Files are managed through a special predefined table: the MIDI sequence table. This table allows you to change values and add or remove notes like with normal Lua tables, but the structure of that table must remain as defined below.

Available in: Controller.

MIDI Sequence Fields

.format

The MIDI file format. It can be determined via names or indices.

  • MidiFileFormat.singleMultiChannelTrack or 0 = Format 0 (one single multi-channel track)
  • MidiFileFormat.simultaneousTracks or 1 = Format 1 (one or more tracks to be played simultaneously)

The default is format 0. See MIDI File Format Types for details.

enum or number
.smpteformat

The SMPTE format.

  • 0 = Ticks per beat
  • -24 = Ticks per frame at 24 frames per second
  • -25 = Ticks per frame at 25 frames per second
  • -29 = Ticks per frame at 30 frames per second, drop frame
  • -30 = Ticks per frame at 30 frames per second, non-drop frame

The default format is 0.

number
.divisionSpecifies the ticks used for the SMPTE format. The default is 480 ticks.number
.tempoThe original tempo in beats per minute. The default is 120 BPM.number
.signatureThe time signature of the MIDI file as a table. Numerator and denominator are separate fields of that table (see Signature Table below).table
.songnameThe name of the song.

string

.tracksThe tracks of the MIDI file as an array with the index starting at 1. Name, channel and event are separate fields of that table (see Tracks Table below)table

Signature Table

.numeratorThe numerator of the time signature. The default is 4.number
.denominatorThe denominator of the time signature. The default is 4.number

Tracks Table

.nameThe name of the track.string
.channelThe MIDI channel of the track. The default is 1.number
.eventsThe events of the track as an array with the index starting at 1. The events are stored as Event objects.table

Example

To explore the following script:

  1. Download C Major Scale.mid.
  2. Create an empty program and add a script module.
  3. Paste the script into the text editor of the script module and adjust the file path of readMidiFile to the location of the file on your system.
  4. Execute the script.

 

-- read information from a MIDI file
midiseq = readMidiFile("c:/temp/C Major Scale.mid") --[[ please set the file path to the location
                                                         of the file on your system before you run
                                                         the script ]]
-- information from the header chunk
print("Standard MIDI File Format:", midiseq.format)
print("SMPTE:", midiseq.smpteformat)
print("Division:", midiseq.division)

-- information from the track chunk
print("Tempo:", midiseq.tempo)
print("Signature:", midiseq.signature.numerator, "/", midiseq.signature.denominator)
print("Song Name:", midiseq.songname)
print("Number of Tracks:", #midiseq.tracks)
print("Name of 1st Track:", midiseq.tracks[1].name)
print("Channel of 1st Track:", midiseq.tracks[1].channel)
print("Number of Events in 1st Track", #midiseq.tracks[1].events, "\n")

1 Comment