sysex.h

Go to the documentation of this file.

/*
 *   NiCMidi - A C++ Class Library for MIDI
 *
 *   Copyright (C) 2004  J.D. Koftinoff Software, Ltd.
 *   www.jdkoftinoff.com jeffk@jdkoftinoff.com
 *   Copyright (C) 2010 V.R.Madgazin
 *   www.vmgames.com vrm@vmgames.com
 *   Copyright (C) 2021, 2022  Nicola Cassetta
 *   https://github.com/ncassetta/NiCMidi
 *
 *   This file is part of NiCMidi.
 *
 *   NiCMidi is free software: you can redistribute it and/or modify
 *   it under the terms of the GNU Lesser General Public License as
 *   published by the Free Software Foundation, either version 3 of
 *   the License, or (at your option) any later version.
 *
 *   NiCMidi 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 Lesser General Public License for more details.
 *
 *   You should have received a copy of the GNU Lesser General Public
 *   License along with NiCMidi. If not, see <http://www.gnu.org/licenses/>.
 */
 
 
 
 
#ifndef _NICMIDI_SYSEX_H
#define _NICMIDI_SYSEX_H
 
#include "midi.h"
#include <vector>
#include <cstring>          // for memcmp()
 
 
class  MIDISystemExclusive {
    public:
                                    MIDISystemExclusive(unsigned int len = 0);
                                    MIDISystemExclusive(const MIDISystemExclusive &e);
                                    MIDISystemExclusive(const unsigned char *buf, unsigned int len);
        virtual                     ~MIDISystemExclusive() {}
        MIDISystemExclusive&        operator= (const MIDISystemExclusive& se);
        bool                        operator== (const MIDISystemExclusive &se) const;
 
        void                        Clear()                                     { buffer.clear(); chk_sum = 0;  }
        void                        ClearChecksum()                     { chk_sum = 0; }
        unsigned char               GetChecksum() const         { return (unsigned char)(chk_sum & 0x7f); }
        int                                 GetLength() const           { return buffer.size(); }
        unsigned char               GetData(int i) const        { return buffer[i]; }
        //unsigned char*          GetBuffer()                 { return buffer; }
        const unsigned char*        GetBuffer() const           { return buffer.data(); }
        bool                        IsGMReset() const;
        bool                        IsGSReset() const;
        bool                        IsXGReset() const;
        void                        PutSysByte(unsigned char b) { buffer.push_back(b); }
        void                        PutByte(unsigned char b)    { PutSysByte(b); chk_sum += b; }
        void                        PutEXC()                    { PutSysByte(SYSEX_START); }
        void                        PutEOX()                    { PutSysByte(SYSEX_END); }
        void                        PutNibblizedByteLH(unsigned char b)
                                    { PutByte((unsigned char)(b & 0xf)); PutByte((unsigned char)(b >> 4)); }
        void                        PutNibblizedByteHL(unsigned char b)
                                    { PutByte((unsigned char)(b >> 4)); PutByte((unsigned char)(b & 0xf)); }
        void                        PutChecksum()               { PutByte((unsigned char)(chk_sum & 0x7f)); }
 
    protected:
        std::vector<unsigned char>  buffer;
        unsigned char               chk_sum;
 
        static const unsigned char  GMReset_data[];
        static const unsigned char  GSReset_data[];
        static const unsigned char  XGReset_data[];
        static const int            GMReset_len = 6;
        static const int            GSReset_len = 11;
        static const int            XGReset_len = 9;
};
 
 
 
#endif