Description

Enumerator to identify the different MIDI file formats.

MidiFileFormat.singleMultiChannelTrack refers to format 0 and MidiFileFormat.simultaneousTracks to format 1.

Format 2 is seldomly used and therefore not supported.

Available in: Controller.

MIDI File Format Types

IndexName
0MidiFileFormat.singleMultiChannelTrack
1MidiFileFormat.simultaneousTracks

Example

To explore the following script:

  1. Download Format 0.mid and Format 1.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 files on your system.
  4. Execute the script.

 

-- detect the format of the MIDI files
midiseq = {}
midiseq[1] = readMidiFile("c:/temp/Format 0.mid")
midiseq[2] = readMidiFile("c:/temp/Format 1.mid") --[[ please set the file path to the location
                                                       of the files on your system before you run
                                                       the script ]]

for i, seq in ipairs(midiseq) do
    if seq.format == MidiFileFormat.singleMultiChannelTrack then
        print(seq.songname..".mid has MIDI file format 0.")
    elseif seq.format == MidiFileFormat.simultaneousTracks then
        print(seq.songname..".mid has MIDI file format 1.")
    else
        print("Midi file format of "..seq.songname.." not supported!")
    end
end

See Also: MIDI Sequence Table, readMidiFile, writeMidiFile, insertEvent, sortEvents