Control_Surface_Class.hpp

Go to the documentation of this file.

/* ✔ */
 
#pragma once
 
#include <AH/Containers/Updatable.hpp>
#include <AH/Hardware/FilteredAnalog.hpp>
#include <AH/Timing/MillisMicrosTimer.hpp>
#include <Display/DisplayElement.hpp>
#include <Display/DisplayInterface.hpp>
#include <MIDI_Interfaces/MIDI_Interface.hpp>
#include <Settings/SettingsWrapper.hpp>
 
BEGIN_CS_NAMESPACE
 
using AH::FilteredAnalog;
using AH::NormalUpdatable;
using AH::Timer;
using AH::Updatable;
 
class Control_Surface_ : public MIDI_Sender<Control_Surface_>,
                         public TrueMIDI_SinkSource {
 
    friend class MIDI_Sender<Control_Surface_>;
 
 
  public:
    Control_Surface_(Control_Surface_ const &) = delete;
    Control_Surface_ &operator=(Control_Surface_ const &) = delete;
 
    static Control_Surface_ &getInstance();
 
  private:
    Control_Surface_() = default;
 
 
  public:
    void begin();
 
    void loop();
 
    bool connectDefaultMIDI_Interface();
 
    void disconnectMIDI_Interfaces();
 
    void updateMidiInput();
    void updateInputs();
    void beginDisplays();
    void updateDisplays();
 
  private:
    void sendChannelMessageImpl(ChannelMessage);
    void sendSysCommonImpl(SysCommonMessage);
    void sendSysExImpl(SysExMessage);
    void sendRealTimeImpl(RealTimeMessage);
    void sendNowImpl() { /* TODO */ }
 
  private:
    void sinkMIDIfromPipe(ChannelMessage msg) override;
    void sinkMIDIfromPipe(SysExMessage msg) override;
    void sinkMIDIfromPipe(SysCommonMessage msg) override;
    void sinkMIDIfromPipe(RealTimeMessage msg) override;
 
  private:
    Timer<micros> displayTimer = {1000000UL / MAX_FPS};
 
  public:
 
    using ChannelMessageCallback = bool (*)(ChannelMessage);
    using SysExMessageCallback = bool (*)(SysExMessage);
    using SysCommonMessageCallback = bool (*)(SysCommonMessage);
    using RealTimeMessageCallback = bool (*)(RealTimeMessage);
 
    void
    setMIDIInputCallbacks(ChannelMessageCallback channelMessageCallback,
                          SysExMessageCallback sysExMessageCallback,
                          SysCommonMessageCallback sysCommonMessageCallback,
                          RealTimeMessageCallback realTimeMessageCallback) {
        this->channelMessageCallback = channelMessageCallback;
        this->sysExMessageCallback = sysExMessageCallback;
        this->sysCommonMessageCallback = sysCommonMessageCallback;
        this->realTimeMessageCallback = realTimeMessageCallback;
    }
 
 
  private:
    ChannelMessageCallback channelMessageCallback = nullptr;
    SysExMessageCallback sysExMessageCallback = nullptr;
    SysCommonMessageCallback sysCommonMessageCallback = nullptr;
    RealTimeMessageCallback realTimeMessageCallback = nullptr;
    MIDI_Pipe inpipe, outpipe;
};
 
#if CS_TRUE_CONTROL_SURFACE_INSTANCE || defined(DOXYGEN)
extern Control_Surface_ &Control_Surface;
#else
// This is not a clean solution, but it's the only way to get the linker to 
// optimize away all Control Surface-related code if the `Control_Surface` 
// instance is never used.
// Even if it isn't used, and even though it's a global, the compiler has to 
// generate the constructor and destructor, which pulls in variables and vtables
// from throughout the library, using a significant amount of memory.
// By using a macro here, Control_Surface is only constructed (and destructed)
// if it is used in user code.
#define Control_Surface (Control_Surface_::getInstance())
#endif
 
END_CS_NAMESPACE