manager.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) 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_MANAGER_H
#define _NICMIDI_MANAGER_H
 
#include "msg.h"
#include "driver.h"
#include "notifier.h"
#include "timer.h"
#include "tick.h"
 
 
#include <vector>
#include <thread>
#include <mutex>
 
 
class MIDIManager {
public:
                                MIDIManager() = delete;
 
    static void                 Reset();
 
    static unsigned int         GetNumMIDIIns();
    static const std::string&   GetMIDIInName(unsigned int n);
    static MIDIInDriver*        GetInDriver(unsigned int n);
    static bool                 IsValidInPortNumber(unsigned int n);
    static unsigned int         GetNumMIDIOuts();
    static const std::string&   GetMIDIOutName(unsigned int n);
    static MIDIOutDriver*       GetOutDriver(unsigned int n);
    static bool                 IsValidOutPortNumber(unsigned int n);
    static MIDISequencer*       GetSequencer();
 
/* TODO: are these useful?
    static bool                 StartTimer();
    static void                 StopTimer();
*/
    static void                 OpenInPorts();
    static void                 CloseInPorts();
    static void                 OpenOutPorts();
    static void                 CloseOutPorts();
    static void                 AllNotesOff();
    static void                 AddMIDITick(MIDITickComponent *tick);
    static bool                 RemoveMIDITick(MIDITickComponent *tick);
 
protected:
 
    static void                         TickProc(tMsecs sys_time_, void* p);
 
    static void                         Init();
 
    static void                         Exit();         // called at exit
 
    // WARNING! We MUST use pointers to avoid the "static inizialization order fiasco"
    static std::vector<MIDIOutDriver*>* MIDI_outs;      // A vector of MIDIOutDriver objects (one for each
                                                        // hardware port)
    static std::vector<std::string>*    MIDI_out_names; // The system names of hardware out ports
    static std::vector<MIDIInDriver*>*  MIDI_ins;       // A vector of MIDIInDriver objects (one for each
                                                        // hardware port)
    static std::vector<std::string>*    MIDI_in_names;  // The system names of hardware in ports
 
    static std::vector<MIDITickComponent*>*
                                        MIDITicks;      // The array of MIDITickCompnent objects, everyone
                                                        // of them has his StaticTickProc() callback
 
    static std::mutex*                  proc_lock;      // A mutex for thread safe processing
    static bool                         init;
};
 
 
 
#endif // _JDKMIDI_MANAGER_H