rtmidioutput.h

Go to the documentation of this file.

/*
    Drumstick MIDI realtime input-output
    Copyright (C) 2009-2024 Pedro Lopez-Cabanillas <plcl@users.sf.net>
 
    This program is free software; you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation; either version 3 of the License, or
    (at your option) any later version.
 
    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.
 
    You should have received a copy of the GNU General Public License
    along with this program. If not, see <http://www.gnu.org/licenses/>.
*/
 
#ifndef MIDIOUTPUT_H
#define MIDIOUTPUT_H
 
#include <QObject>
#include <QString>
#include <QStringList>
#include <QtPlugin>
#include <QSettings>
#include "macros.h"
 
#if defined(DRUMSTICK_STATIC)
#define DRUMSTICK_RT_EXPORT
#else
#if defined(drumstick_rt_EXPORTS)
#define DRUMSTICK_RT_EXPORT Q_DECL_EXPORT
#else
#define DRUMSTICK_RT_EXPORT Q_DECL_IMPORT
#endif
#endif
 
namespace drumstick { namespace rt {
 
const quint8 MIDI_STD_CHANNELS              = 16; 
const quint8 MIDI_GM_STD_DRUM_CHANNEL       = (10-1); 
const quint8 MIDI_CONTROL_MSB_BANK_SELECT   = 0x00; 
const quint8 MIDI_CONTROL_MSB_MAIN_VOLUME   = 0x07; 
const quint8 MIDI_CONTROL_LSB_BANK_SELECT   = 0x20; 
const quint8 MIDI_CONTROL_REVERB_SEND       = 0x5b; 
const quint8 MIDI_CONTROL_ALL_SOUNDS_OFF    = 0x78; 
const quint8 MIDI_CONTROL_ALL_NOTES_OFF     = 0x7b; 
const quint8 MIDI_CONTROL_RESET_CONTROLLERS = 0x79; 
 
const quint8 MIDI_STATUS_NOTEOFF         = 0x80; 
const quint8 MIDI_STATUS_NOTEON          = 0x90; 
const quint8 MIDI_STATUS_KEYPRESURE      = 0xa0; 
const quint8 MIDI_STATUS_CONTROLCHANGE   = 0xb0; 
const quint8 MIDI_STATUS_PROGRAMCHANGE   = 0xc0; 
const quint8 MIDI_STATUS_CHANNELPRESSURE = 0xd0; 
const quint8 MIDI_STATUS_PITCHBEND       = 0xe0; 
const quint8 MIDI_STATUS_SYSEX           = 0xf0; 
const quint8 MIDI_STATUS_ENDSYSEX        = 0xf7; 
const quint8 MIDI_STATUS_REALTIME        = 0xf8; 
 
const quint8 MIDI_STATUS_MASK            = 0xf0; 
const quint8 MIDI_CHANNEL_MASK           = 0x0f; 
 
const quint8 MIDI_COMMON_QTRFRAME        = 0xF1; 
const quint8 MIDI_COMMON_SONGPP          = 0xF2; 
const quint8 MIDI_COMMON_SONGSELECT      = 0xF3; 
const quint8 MIDI_COMMON_TUNEREQ         = 0xF6; 
 
const quint8 MIDI_REALTIME_CLOCK         = 0xF8; 
const quint8 MIDI_REALTIME_START         = 0xFA; 
const quint8 MIDI_REALTIME_CONTINUE      = 0xFB; 
const quint8 MIDI_REALTIME_STOP          = 0xFC; 
const quint8 MIDI_REALTIME_SENSING       = 0xFE; 
const quint8 MIDI_REALTIME_RESET         = 0xFF; 
 
inline int MIDI_LSB(int x)
{
    return (x % 0x80);
}
 
inline int MIDI_MSB(int x)
{
    return (x / 0x80);
}
 
    typedef QPair<QString,QVariant> MIDIConnection;
 
    class DRUMSTICK_RT_EXPORT MIDIOutput : public QObject
    {
        Q_OBJECT
 
    public:
        explicit MIDIOutput(QObject *parent = nullptr) : QObject(parent) {}
        virtual ~MIDIOutput() = default;
        virtual void initialize(QSettings* settings) = 0;
        virtual QString backendName() = 0;
        virtual QString publicName() = 0;
        virtual void setPublicName(QString name) = 0;
        virtual QList<MIDIConnection> connections(bool advanced = false) = 0;
        virtual void setExcludedConnections(QStringList conns) = 0;
        virtual void open(const MIDIConnection& conn) = 0;
        virtual void close() = 0;
        virtual MIDIConnection currentConnection() = 0;
 
    public Q_SLOTS:
        virtual void sendNoteOff(int chan, int note, int vel) = 0;
 
        virtual void sendNoteOn(int chan, int note, int vel) = 0;
 
        virtual void sendKeyPressure(int chan, int note, int value) = 0;
 
        virtual void sendController(int chan, int control, int value) = 0;
 
        virtual void sendProgram(int chan, int program) = 0;
 
        virtual void sendChannelPressure(int chan, int value) = 0;
 
        virtual void sendPitchBend(int chan, int value) = 0;
 
        virtual void sendSysex(const QByteArray& data) = 0;
 
        virtual void sendSystemMsg(const int status) = 0;
    };
 
}} // namespace drumstick::rt
 
Q_DECLARE_INTERFACE(drumstick::rt::MIDIOutput, "net.sourceforge.drumstick.rt.MIDIOutput/2.0")
Q_DECLARE_METATYPE(drumstick::rt::MIDIConnection)
 
#endif /* MIDIOUTPUT_H */