midi_file.h

Go to the documentation of this file.

/*
 * midi_file.h
 *
 * Copyright (c) 2003 Thomas A. Vaughan
 * All rights reserved.
 *
 * API for dealing with midi files.
 */

#ifndef __MIDI_FILE_H__
#define __MIDI_FILE_H__


// includes --------------------------------------------------------------------
#include <map>
#include <stdio.h>

#include "threadsafe/smart_ptr.h"

#include "wave-midi/midi.h"


// namespace
namespace media {


typedef std::multimap<unsigned long, MidiEvent> MidiEventMap;



/*
 * class: MidiFile
 *
 * A midi file object
 */
class MidiFile {
public:
        // virtual destructor --------------------------------------------------
        virtual ~MidiFile(void) throw() { }

        // media::MidiFile class interface methods -----------------------------
        virtual const MidiEventMap& getEvents(void) const throw() = 0;
        virtual void setPpqn(IN int ppqn) throw() = 0;
        virtual void setTempo(IN float bpm) throw() = 0;
        virtual void addEvent(IN unsigned long tick,
                IN const MidiEvent& event) = 0;
        virtual void write(IN const char * filename) const = 0;

        // public static methods (factory methods) -----------------------------
        static smart_ptr<MidiFile> create(void);
        static smart_ptr<MidiFile> load(IN const char * filename);
};



////////////////////////////////////////////////////////////////////////////////
//
//      Helper methods using the MidiFile object
//
////////////////////////////////////////////////////////////////////////////////

void
addNoteOn(IN MidiFile * file, dword_t tick, int channel, int note,
        int velocity);

void
addNoteOff(IN MidiFile * file, dword_t tick, int channel, int note,
        int velocity);


};      // media namespace

#endif  // __MIDI_FILE_H__