mididevice.h

Go to the documentation of this file.

#ifndef MIDIDEVICE_H_
#define MIDIDEVICE_H_

#include <QStringList>
#include <QVector>
#include <QMap>
#include <QString>
#include <QObject>

#include "score/diatonicpitch.h"

class CASheet;
class CADiatonicKey;

class CAMidiDevice : public QObject {
#ifndef SWIG
        Q_OBJECT
#endif

        friend void rtMidiInCallback( double deltatime, std::vector< unsigned char > *message, void *userData );
public:
        enum CAMidiDeviceType {
                RtMidiDevice,
                MidiExportDevice
        };

        CAMidiDevice();

        enum midiCommands {
                Meta_Text        = 0x01,
                Meta_Copyright   = 0x02,
                Meta_SeqTrkName  = 0x03,
                Meta_InstrName   = 0x04,
                Meta_Lyric       = 0x05,
                Meta_Marker      = 0x06,
                Meta_CuePoint    = 0x07,
                Meta_Tempo       = 0x51, // len=03 tt tt tt microseconds per midi quarter note
                Meta_SMPTEOffs   = 0x54, // len=05 hr mn se fr ff SMPTE Offset
                Meta_Timesig     = 0x58,
                Meta_Keysig      = 0x59,
                Meta_Track_End   = 0x2f,

                Midi_Ctl_Reverb  = 0x5b,
                Midi_Ctl_Chorus  = 0x5d,
                Midi_Ctl_Pan     = 0x0a,
                Midi_Ctl_Volume  = 0x07,
                Midi_Ctl_Sustain = 0x40,
                Midi_Ctl_Event   = 0xff,
                        // Events with midi channel on the low nibble:
                Midi_Note_Off    = 0x80,                // 3 byte
                Midi_Note_On     = 0x90,
                Midi_Prog_Change = 0xc0,                // 2 byte
                Midi_Control_Chg = 0xb0                 // 3 byte
        };


        static QStringList gmInstrumentList() { return CAMidiDevice::GM_INSTRUMENTS; }
        
        static QString instrumentName( int midiProgram );
        static QStringList instrumentNames();
        
        static unsigned char freeMidiChannel( CASheet* );

        virtual ~CAMidiDevice() {};

        inline CAMidiDeviceType midiDeviceType() { return _midiDeviceType; };

        bool isRealTime() { return _realTime; }
        virtual QMap<int, QString> getOutputPorts() = 0;
        virtual QMap<int, QString> getInputPorts() = 0;

        virtual bool openOutputPort(int port) = 0;      // return true on success, false otherwise
        virtual bool openInputPort(int port) = 0;       // return true on success, false otherwise
        virtual void closeOutputPort() = 0;
        virtual void closeInputPort() = 0;
        virtual void send(QVector<unsigned char> message, int time) = 0;     // message and absolute canorus time (independent of tempo)
        virtual void sendMetaEvent(int time, int event, int a, int b, int c ) = 0; // absolute time of the meta event which is meant only for midi file export

#ifndef SWIG
signals:
        void midiInEvent( QVector< unsigned char > message );
#endif

protected:
        void setRealTime( bool r ) { _realTime = r; }
        inline void setMidiDeviceType( CAMidiDeviceType t ) { _midiDeviceType = t; }
        CAMidiDeviceType _midiDeviceType;
        bool _realTime;  // is the device
        
private:
        static QStringList GM_INSTRUMENTS;
};

#endif /* MIDIDEVICE_H_ */