midiFileParser.h

Go to the documentation of this file.

#pragma once
 
//==============================================================================
// Includes
//==============================================================================
 
#include <stdint.h>
#include <stdbool.h>
 
//==============================================================================
// Enums
//==============================================================================
 
typedef enum
{
    MIDI_EVENT,
    META_EVENT,
    SYSEX_EVENT,
} midiEventType_t;
 
typedef enum
{
    SEQUENCE_NUMBER        = 0x00,
    TEXT                   = 0x01,
    COPYRIGHT              = 0x02,
    SEQUENCE_OR_TRACK_NAME = 0x03,
    INSTRUMENT_NAME        = 0x04,
    LYRIC                  = 0x05,
    MARKER                 = 0x06,
    CUE_POINT              = 0x07,
    // I'm not sure these are real???
    // PROGRAM_NAME,
    // DEVICE_NAME,
    CHANNEL_PREFIX = 0x20,
    PORT_PREFIX    = 0x21,
    END_OF_TRACK   = 0x2F,
    TEMPO          = 0x51,
    SMPTE_OFFSET   = 0x54,
    TIME_SIGNATURE = 0x58,
    KEY_SIGNATURE  = 0x59,
    PROPRIETARY    = 0x7F,
} metaEventType_t;
 
typedef enum
{
    MIDI_FORMAT_0 = 0,
    MIDI_FORMAT_1 = 1,
    MIDI_FORMAT_2 = 2,
} midiFileFormat_t;
 
//==============================================================================
// Structs
//==============================================================================
 
typedef struct
{
    uint32_t length;
 
    uint8_t* data;
} midiTrack_t;
 
typedef struct
{
    uint8_t* data;
 
    uint32_t length;
 
    midiFileFormat_t format;
 
    uint16_t timeDivision;
 
    uint16_t trackCount;
 
    midiTrack_t* tracks;
} midiFile_t;
 
typedef struct midiTrackState midiTrackState_t;
 
typedef struct
{
    const midiFile_t* file;
 
    bool handleMetaEvents;
 
    uint16_t division;
 
    uint8_t stateCount;
 
    midiTrackState_t* states;
} midiFileReader_t;
 
typedef struct
{
    uint8_t status;
 
    uint8_t data[2];
} midiStatusEvent_t;
 
typedef struct
{
    uint8_t numerator;
    uint8_t denominator;
    uint8_t midiClocksPerMetronomeTick;
    uint8_t num32ndNotesPerBeat;
} midiTimeSignature_t;
 
typedef struct
{
    metaEventType_t type;
 
    uint32_t length;
 
    union
    {
        const char* text;
 
        const uint8_t* data;
 
        uint32_t tempo;
 
        uint16_t sequenceNumber;
 
        uint8_t prefix;
 
        struct
        {
            uint8_t hour;
            uint8_t min;
            uint8_t sec;
            uint8_t frame;
            uint8_t frameHundredths;
        } startTime;
 
        midiTimeSignature_t timeSignature;
 
        struct
        {
            uint8_t flats;
 
            uint8_t sharps;
 
            bool minor;
        } keySignature;
    };
} midiMetaEvent_t;
 
typedef struct
{
    uint16_t manufacturerId;
 
    uint32_t length;
 
    uint8_t prefix;
 
    const uint8_t* data;
} midiSysexEvent_t;
 
typedef struct
{
    uint32_t deltaTime;
 
    uint32_t absTime;
 
    midiEventType_t type;
 
    uint8_t track;
 
    union
    {
        midiStatusEvent_t midi;
        midiMetaEvent_t meta;
        midiSysexEvent_t sysex;
    };
} midiEvent_t;
 
//==============================================================================
// Function Declarations
//==============================================================================
 
bool loadMidiFile(const char* name, midiFile_t* file, bool spiRam);
 
void unloadMidiFile(midiFile_t* file);
 
bool initMidiParser(midiFileReader_t* reader, const midiFile_t* file);
 
void midiParserSetFile(midiFileReader_t* reader, const midiFile_t* file);
 
void resetMidiParser(midiFileReader_t* reader);
 
void deinitMidiParser(midiFileReader_t* reader);
 
uint32_t midiNextEventTime(midiFileReader_t* reader);
 
bool midiNextEvent(midiFileReader_t* reader, midiEvent_t* event);
 
int midiWriteEvent(uint8_t* out, int max, const midiEvent_t* event);